Paper Narrative
Businesspaper-narrativePaper Narrative is an Agent Skill for business published in the companion-inc/feynman repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Shape the scientific story across a manuscript, abstract, figures, and evidence. Use when a task asks for paper structure, figure order, argument flow, missing analyses, or manuscript revision strategy.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/companion-inc/feynman/blob/HEAD/skills/paper-narrative/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/paper-narrative, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Paper Narrative
Use this skill to improve the argument a scientific paper makes.
Workflow:
- Extract the central claim, audience, evidence chain, figure order, and decision each figure must support.
- Identify gaps where a figure claims more than the data proves, where methods are missing, or where the sequence of evidence is weak.
- Reorder, merge, split, or cut sections and panels based on the argument, not surface polish.
- Send figure-level work to
figure-composerand single-panel plot work tofigure-style. - Save a revision plan or manuscript draft with source/provenance notes.
The output should read as a paper's evidence arc, not as a generic writing checklist.