write-report

Write comprehensive self-contained scientific reports for zero-context human readers.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/jingtao-lbl/A2MC --skill write-report-jingtao-lbl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-report
Source: https://github.com/jingtao-lbl/A2MC/tree/main/.claude/skills/write-report
Command: npx skills add https://github.com/jingtao-lbl/A2MC --skill write-report-jingtao-lbl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Investigations, calibration campaigns, and mechanism studies produce scattered logs, figures, and phase artifacts that no outside reader can assemble into a coherent story. This Skill structures that raw material into an integrated, self-contained report that a PI, collaborator, or reviewer with zero project context can read end to end. ## Core Features & Use Cases - Zero-context structure: Enforces an outline, executive summary, sectioned narrative, embedded captioned figures, provenance, and references, with every codename defined inline on first use. - Evidence discipline: Requires every claim to carry finding, mechanism, and evidence, labels unverified claims as hypotheses, and demands uncertainty quantification on every number. - Recurring calibration deliverables: Defines the nested CYCLE report and ROUND report contracts, including the canonical seven-section round outline and the required upstream skills. - Use Case: After a calibration round closes, synthesize the cycle reports, the standardized round summary, and the cross-round comparison into a round report that states the mechanism learned, the ranked parameter sets, and the next-round plan. ## Quick Start Write an integrated report on the crash investigation for the PI, synthesizing the phase logs and figures into a self-contained narrative with provenance.

Frequently Asked Questions about write-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a report for someone with no project context?▼

Structure it as outline, executive summary, sectioned narrative, embedded figures with captions, and provenance. Define every codename inline on first use, state each claim as finding plus mechanism plus evidence, and apply the stranger test to every section.

What is the difference between a cycle report and a round report?▼

A cycle report covers one experiment cycle including every inner-loop iteration, hypothesis, and simulation result. A round report synthesizes the cycle reports into the arc across cycles, the mechanisms established, and the next-round plan, without re-deriving from raw logs.

When should I use write-report instead of summarize-calibration-round?▼

Use summarize-calibration-round for the standardized single-round bundle of ensemble figures and evaluation tables. Use write-report for the integrated narrative report; the standardized bundle supplies figures the round report cites.

Can a report cite internal logs in its References section?▼

No. References is reserved for published literature with a DOI or URL that you actually opened. Internal artifacts like logs, scripts, and commits belong in Provenance or Cross-references, never in author-year form.

Why must every quantitative claim include uncertainty?▼

An estimate without uncertainty misleads readers who cannot verify it against the data. Report mean plus or minus standard deviation or a confidence interval with n, and state which estimator was used when more than one is defensible.