Skip to main content
skill CX Codex

report-writing · vstorm-co — Claude Code skill: what it does, how to install

report-writing provides guidelines for structuring analytical reports, drafting stand-alone executive summaries, and citing sources.

MIT ★ 1,125 updated 2026-10-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vstorm-co/pydantic-deepagents --skill report-writing -a claude-code
Open on GitHub

What report-writing does

This skill outlines a standard architecture for research documents. It splits reports into five parts: a scoped title, an executive summary of two to three paragraphs, logically ordered body sections, conclusions noting study limitations, and an ordered reference list.

Citations follow a strict template: [N] Author/Organization, "Title", URL, Accessed: YYYY-MM-DD. Every numeric claim, quote, or factual statement must feature an inline reference tag immediately after the claim. The guide also asks the model to separate facts from interpretations and write in active voice.

Because the frontmatter specifies auto_load: false, Claude Code does not keep these instructions permanently in its context window. You need to invoke the skill directly when working on research drafts.

What it helps with

  • structure raw research into a standardized five-part report
  • apply inline numerical citations [1][2] to all factual claims and data
  • format bibliographic references with author, title, URL, and access date
  • draft a stand-alone executive summary summarizing finished sections

Example prompts for the agent

  • Use the report-writing guidelines to turn these raw notes into a cited research report
  • Format our research summary following the report-writing rules and add the reference list

How to install report-writing

1Skills CLI (Vercel)

npx skills add vstorm-co/pydantic-deepagents --skill report-writing -a claude-code

2Manually: put the files in place

~/.claude/skills/report-writing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/report-writing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about report-writing

How to install report-writing in Claude Code?

Run npx skills add vstorm-co/pydantic-deepagents --skill report-writing -a claude-code in your terminal. You can also place the skill file directly at ~/.claude/skills/report-writing/SKILL.md.

What does report-writing do?

It provides writing rules for research reports, setting formatting conventions, citation requirements, and section hierarchies.

Does this skill load automatically?

No. The skill configuration sets auto_load: false, so it activates only when explicitly called in your prompt.

Source text

SKILL.md · MIT
---
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

© vstorm-co · MIT · vstorm-co/pydantic-deepagents

Similar skills

All skills for Writing and docs →

report-writing by other authors comes first.

report-writing Sachin Sharma report-writing structures confirmed vulnerability reports for bug bounty platforms, from impact statements to severity rationale. Use it to draft a finding before submission. CX Codex +1 ★ 16,193repo stars report-generator davila7 report-generator converts collected research notes into an organized Markdown document with numbered citations. It takes over at the final stage once all investigation data is ready. CX Codex 1,930installs render-html wanshuiyin render-html turns ARIS Markdown and JSON artifacts into a single HTML file for human reading. Use it for reports, plans, reviews, and research summaries. CX Codex +1 421installs academic-writing jamditis academic-writing guides scholarly drafting with IMRaD paper structuring, FINER research questions, and database search strategies for literature reviews. CX Codex +1 3,000installs oma-academic-writing First Fluke oma-academic-writing — a skill for Claude Code and Codex drafts and polishes academic prose to meet strict rubric standards. It checks sentence variety, calibrates hedging, and links each claim to source data. CX Codex +1 ★ 1,472repo stars research-writing-literature hanhuark research-writing-literature guides academic manuscripts, literature syntheses, methodology sections, and figure discussions into evidence-backed research narratives. CX Codex +1 ★ 26repo stars github-deep-research bytedance github-deep-research runs multi-round research on any GitHub repository and writes a structured markdown report with a timeline, metrics and Mermaid diagrams. CX Codex +1 2,900installs

From the same set14

The whole set →
code-review code-review is a Claude Code skill that checks code for bugs, security issues, style, and performance problems. Ask for a review to run it. CX Codex +1 ★ 1,125repo stars test-writer test-writer generates structured test suites for existing code matching your active testing framework. CX Codex +1 ★ 1,125repo stars skill-creator skill-creator is a Claude Code skill that turns a recurring task from a conversation into reusable instructions for an AI agent. It captures workflows for future sessions. CX Codex +1 ★ 1,125repo stars environment-discovery The environment-discovery skill trains Claude Code to systematically explore unfamiliar environments before making changes. It checks file structure, data formats, available tools, and existing code—saving debugging time. CX Codex +1 ★ 1,125repo stars build-and-compile The build-and-compile skill helps Claude Code choose build commands from a project's files and troubleshoot compiler or dependency errors. Use it when a build fails or the project setup is unclear. CX Codex +1 ★ 1,125repo stars research-methodology research-methodology — a skill with methodology for structured research: three-phase search, source reliability ranking, and note-taking with confidence levels for each finding. CX Codex +1 ★ 1,125repo stars performant-code performant-code guides Claude Code to write fast routines for large files and strict memory caps. Helps prevent runtime timeouts on heavy workloads. CX Codex +1 ★ 1,125repo stars data-formats The data-formats skill guides file inspection before parsing, from checking binary signatures to sampling large structured files. Use it when a file’s format is unclear. CX Codex +1 ★ 1,125repo stars

Project sponsors

Companies that keep this analytics open