report-writing

Report Writing Skill

This skill provides structured guidance for transforming research findings into well-organized, professional reports. It ensures consistency, clarity, and completeness across all research outputs.

When to Use This Skill

Invoke this skill when:

• Finalizing Research: Converting raw research notes and findings into a formal deliverable
• Creating Documentation: Producing technical documentation, white papers, or analysis reports
• Synthesizing Multiple Sources: Combining insights from various sub-agent research tasks into a unified narrative
• Stakeholder Communication: Preparing reports for executive review, technical teams, or external audiences
• Knowledge Preservation: Documenting research methodology and findings for future reference

Do NOT use this skill for:

• Quick summaries or informal notes (use simple markdown instead)
• Real-time status updates (use TODO lists)
• Raw data dumps (use structured data files)

---

Report Structure Template

Every research report MUST follow this hierarchical structure. Adapt section depth based on report complexity.

1. Executive Summary

Purpose: Provide a standalone overview for readers who may not read the full report.

Contents:

• Research objective (1-2 sentences)
• Key findings (3-5 bullet points)
• Primary recommendations or conclusions
• Critical limitations or caveats

Length: 150-300 words (1 page maximum)

Writing Tip: Write this section LAST, after all other sections are complete.

2. Introduction/Background

Purpose: Establish context and frame the research question.

Contents:

• Problem statement or research question
• Why this research matters (business/technical impact)
• Scope boundaries (what IS and IS NOT covered)
• Brief overview of approach taken

Length: 200-500 words

3. Methodology

Purpose: Enable reproducibility and establish credibility.

Contents:

• Data sources consulted (with dates accessed)
• Search strategies and queries used
• Selection criteria for sources
• Tools and techniques employed
• Limitations of the methodology