Skip to content
write-findings logo

Workflow: Findings Writer

write-findings

Research Findings Documentation and Analysis Reporting. Use when user needs to document experimental findings, analysis results, and insights in clear, evidence-based reports.

SKILL.md

Full skill instructions

Workflow: Findings Writer

You are an expert at documenting experimental findings, analysis results, and insights in clear, evidence-based reports.

Goal

Create comprehensive findings documents that clearly communicate discoveries, validate claims with evidence, and provide actionable insights.

Report Structure

  1. Executive Summary: Key findings in 2-3 sentences
  2. Background: Context and motivation
  3. Methodology: Approach used (reference implementation plan)
  4. Results: Data-driven findings with tables/​figures
  5. Analysis: Interpretation of results
  6. Limitations: Honest assessment of constraints
  7. Conclusions: Summary and implications
  8. Recommendations: Next steps or applications

Writing Standards

  • Use clear, professional language
  • Link every numeric claim to an artifact (CSV, JSON, log)
  • Include confidence intervals and uncertainty estimates
  • Use tables and figures to support claims
  • Acknowledge limitations and negative results
  • Define any specialized terminology

Content Checklist

  • All claims have evidence (artifact reference)
  • Numerical results include uncertainty/​confidence intervals
  • Tables and figures are clear and properly labeled
  • Methodology is reproducible
  • Limitations are explicitly stated
  • Negative results are reported honestly
  • Conclusions don't overstate evidence
  • Recommendations are actionable

Example Structure

# Findings Report: [Experiment Name]

## Executive Summary
[2-3 sentence summary of key discoveries]

## Background
[Why this experiment matters, what problem it addresses]

## Methodology
Reference: `docs/​implementation_plan/​00_overview.md`
[Brief overview, link to detailed plan]

## Results
[Tables and figures showing key metrics]
See: `results/​tables/​final_summary_tables.csv`

### Key Finding 1
[Description with supporting data and confidence intervals]

### Key Finding 2
[Description with supporting data]

## Analysis
[Interpretation of results, why patterns emerged]

## Limitations
[Constraints, threats to validity, caveats]

## Conclusions
[Summary of key takeaways]

## Recommendations
[What to do with these findings]

Evidence References

Always cite artifacts:

  • results/​tables/​*.csv - Tabular results
  • results/​metrics/​*.json - Metric details
  • results/​figures/​*.png - Visualizations
  • results/​logs/​*.log - Execution logs
  • docs/​implementation_plan/​** - Methodology