Skip to content
Development
Skill

/report-writing

Guidelines for writing well-structured, cited research reports

From plugin
pydantic-deepagents
1.1k14 skills

Claude Code

$ npx -y skills add vstorm-co/pydantic-deepagents --skill report-writing --agent claude-code

SKILL.md

report-writing.SKILL.md
name: report-writing
description: Guidelines for writing well-structured, cited research reports
auto_load: false

Report Writing Guide

Report Structure

1. Title

  • Descriptive and specific
  • Include the scope or time frame if relevant
  • Example: "Advances in Protein Folding Since AlphaFold 3 (2024-2025)"

2. Executive Summary

  • 2-3 paragraphs summarizing key findings
  • Written last, after the full report is complete
  • Should stand alone — a reader should understand the main conclusions

3. Body Sections

  • Organize logically (chronological, thematic, or comparative)
  • Each section should address one sub-topic
  • Use inline citations [1][2] for every factual claim
  • Include data, statistics, and direct quotes where appropriate

4. Conclusions

  • Synthesize findings across all sections
  • Highlight key takeaways and implications
  • Note limitations of the research
  • Suggest areas for further investigation

5. References

  • Number references in order of first appearance
  • Format: `[N] Author/Organization, "Title", URL, Accessed: YYYY-MM-DD`

Writing Style

Clarity

  • Use clear, direct language
  • Define technical terms on first use
  • Prefer active voice over passive
  • Keep paragraphs focused on one idea

Objectivity

  • Present evidence before conclusions
  • Acknowledge counter-arguments
  • Use hedging language for uncertain claims ("suggests", "indicates", "appears to")
  • Distinguish between facts and interpretation

Citation Practices

  • Cite every factual claim, statistic, and quote
  • Use inline citations [N] immediately after the claim
  • Multiple citations for well-supported claims: [1][3][7]
  • Never present information without attribution

Formatting Tips

  • Use headers (##, ###) to create clear hierarchy
  • Use bullet points for lists of findings
  • Use tables for comparative data
  • Use blockquotes for direct quotes from sources
  • Bold key terms and important findings
Read more
@vstorm-co
Ships withpydantic-deepagents

Open-source, self-hosted Claude Code - a terminal AI assistant and the Python framework behind it. Tool-calling, sandboxed execution, multi-agent teams, skills, checkpoints, unlimited context - on Pydantic AI, any model.

Stars on GitHub

Momentum

stars in total
1.1k
Star history of vstorm-co/pydantic-deepagents on GitHub, a chart by star-history.com

Other skills on pydantic-deepagents.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc13d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react2d252k
@facebook@facebookInstall Skill

Questions about report-writing.

Which coding agents can use report-writing?
report-writing installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.