report-findings

Structure and present research findings with source authority assessment, cross-referencing, and confidence calibration. Use when synthesizing multi-source research, presenting findings, comparing options, or when report, findings, synthesis, sources, or --report are mentioned. Micro-skill loaded by research-and-report, codebase-analysis, and other investigation skills.

⭐4stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025

When & Why to Use This Skill

The report-findings skill is a professional-grade research synthesis tool designed to transform multi-source information into structured, high-confidence reports. It implements a rigorous methodology for source authority assessment, cross-referencing, and confidence calibration. By enforcing a 'two-source minimum' for critical claims and providing clear attribution across four tiers of evidence, it ensures that findings are verifiable, balanced, and actionable, effectively eliminating the risks of single-source bias and unverified information.

Use Cases

  • Synthesizing multi-source research: Consolidating information from various technical documents, articles, and reports into a cohesive and structured summary.
  • Source authority assessment: Evaluating and tiering sources from primary official documentation to unverified community content to ensure evidence-based conclusions.
  • Cross-referencing and conflict resolution: Identifying discrepancies between sources and resolving them through date checks, authority comparison, or empirical verification.
  • Structured comparison analysis: Utilizing feature matrices and trade-off analyses to compare different products, technologies, or strategies systematically.
  • Confidence-calibrated reporting: Documenting research findings with explicit confidence levels (High/Moderate/Low) and transparently flagging caveats or uncertainties.
namereport-findings
version1.0.0
descriptionThis skill should be used when synthesizing multi-source research, presenting findings with attribution, or when "report", "findings", or "synthesis" are mentioned.

Report Findings

Multi-source gathering → authority assessment → cross-reference → synthesize → present with confidence.

  • Synthesizing research from multiple sources
  • Presenting findings with proper attribution
  • Comparing options with structured analysis
  • Assessing source credibility
  • Documenting research conclusions

NOT for: single-source summaries, opinion without evidence, rushing to conclusions

Tier Confidence Types Use For
1: Primary 90-100% Official docs, original research, direct observation Factual claims, guarantees
2: Secondary 70-90% Expert analysis, established publications, official guides Best practices, patterns
3: Community 50-70% Q&A sites, blogs, wikis, anecdotal evidence Workarounds, pitfalls
4: Unverified 0-50% Unattributed, outdated, content farms, unchecked AI Initial leads only

See source-tiers.md for detailed assessment criteria.

Two-Source Minimum

Never rely on single source for critical claims:

  1. Find claim in initial source
  2. Seek confirmation in independent source
  3. If sources conflict → investigate further
  4. If sources agree → moderate confidence
  5. If 3+ sources agree → high confidence

Conflict Resolution

When sources disagree:

  1. Check dates — newer information often supersedes
  2. Compare authority — higher tier beats lower tier
  3. Verify context — might both be right in different scenarios
  4. Test empirically — verify through direct observation if possible
  5. Document uncertainty — flag if unresolved

Triangulation

For complex questions, seek alignment across:

  • Official sources — what should happen
  • Direct evidence — what actually happens
  • Community reports — what people experience

All three align → high confidence. Mismatches → investigate the gap.

Three comparison methods:

Method When to Use
Feature Matrix Side-by-side capability comparison
Trade-off Analysis Strengths/weaknesses/use cases per option
Weighted Matrix Quantitative scoring with importance weights

See comparison-methods.md for templates and examples.

Extract Themes

Across sources, identify:

  • Consensus — what everyone agrees on
  • Disagreements — where opinions differ
  • Edge cases — nuanced situations

Present Findings

  1. Main answer — clear, actionable
  2. Supporting evidence — cite 2-3 strongest sources
  3. Caveats — limitations, context-specific notes
  4. Alternatives — other valid approaches
Level Indicator Criteria
High 90-100% 3+ tier-1 sources agree, empirically verified
Moderate 60-89% 2 tier-2 sources agree, some empirical support
Low Below 60% Single source or tier-3 only, unverified

Flag remaining uncertainties even at high confidence.

Standard report structure:

## Summary
{ 1-2 sentence answer }

## Key Findings
1. {FINDING} — evidence: {SOURCE}

## Comparison (if applicable)
{ matrix or trade-off analysis }

## Confidence Assessment
Overall: {LEVEL} {PERCENTAGE}%

## Sources
- [Source](url) — tier {N}

## Caveats
{ uncertainties, gaps, assumptions }

See output-template.md for full template with guidelines.

ALWAYS:

  • Assess source authority before citing
  • Cross-reference critical claims (2+ sources)
  • Include confidence levels with findings
  • Cite sources with proper attribution
  • Flag uncertainties

NEVER:

  • Cite single source for critical claims
  • Present tier-4 sources as authoritative
  • Skip confidence calibration
  • Hide conflicting sources
  • Omit caveats when uncertainty exists

Deep-dive documentation:

Related skills: