paper-orchestration
Skill0 starsChanged 40 days agoMITView on GitHub
Use when a research-writing task spans multiple sections, medium-sized revisions, full-paper drafting, or repeated quality failures
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Norman-bury/articlewriting-skillword for word, first seen Oct 8, 2026
- Norman-bury/research-writing-skillword for word, first seen Oct 8, 2026
Other versions2 projects use a version of this.
Word for word · 2
- Norman-bury/research-writing-skill★ 3.4k100% same
- Norman-bury/articlewriting-skill★ 3.4k100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository21 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- research-writing-assistantSkill
- brainstorming-researchSkill
- environment-setupSkill
- evidence-driven-writingSkill
- experiment-results-planningSkill
- figures-diagramSkill
- figures-pythonSkill
- latex-outputSkill
- literature-reviewSkill
- peer-reviewSkill
- prompts-collectionSkill
- statistical-analysisSkill
- using-research-writingSkill
- verificationSkill
- writing-chaptersSkill
- writing-coreSkill
- writing-humanitiesSkill
- writing-lawSkill
- writing-medicalSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 36
Create plan/chapter-architecture.md before drafting.
- Distinctive: line 44
If this file exists, the quality gate must treat extra or missing chapter files as failures.
- Distinctive: line 50
create one task packet per major chapter.
- Distinctive: line 57
If subagents are not available, stop and ask the user whether to continue in degraded single-agent mode.
- Very specific: line 76
Before dispatching a section task, create a persistent packet under plan/task-packets/.
- Distinctive: line 103
Every medium task needs two reviews before completion:
- Distinctive: line 108
If either review fails, fix before moving to the next task.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Paper Orchestration
This skill controls the workflow around the writing skills. It prevents "one prompt writes the paper" behavior by forcing stage detection, task packets, review gates, and a capability-use audit.
Hard Gate
For any medium task or full-paper task, do not write manuscript text until these exist or are created:
plan/project-overview.mdplan/outline.mdplan/progress.md- a task packet for the current section or deliverable
- for full-paper drafting or redrafting,
plan/chapter-architecture.md
Medium task means any request that affects more than one paragraph, one subsection, one chapter, one figure/table set, or any claim tied to references or experiments.
Full-Paper Redraft Gate
For a full-paper draft, the controller must first lock the chapter architecture. Do not inherit an old chapter split if the user, target venue, or paper type implies a different structure.
For computer science / engineering SCI papers, use this body structure unless the user or target template explicitly requires otherwise:
- Introduction, with related work integrated into the motivation and research-gap argument.
- Methodology.
- Dataset and Experimental Setting, either standalone or integrated into Methodology/Results when short.
- Experimental Results and Analysis.
- Discussion.
Abstract, Conclusion, and References may be generated as supporting files, but they must not hide weak body chapters or inflate the chapter count. A standalone Related Work chapter is only allowed when the target outline explicitly demands it.
Create plan/chapter-architecture.md before drafting. It must list the exact required chapter files, target role, minimum body length, owner agent, and whether the chapter may use planning placeholders.
## Required chapter files
- chapters/01_Introduction.md | min_chars=4500 | agent=required | placeholders=no
- chapters/02_Methodology.md | min_chars=4500 | agent=required | placeholders=noIf this file exists, the quality gate must treat extra or missing chapter files as failures.
Multi-Agent Chapter Gate
For any full-paper draft or redraft, the controller must not write all chapters itself. It must:
- create one task packet per major chapter;
- dispatch a separate fresh agent for each major chapter;
- give each agent only the relevant task packet, source excerpts, evidence map, experiment protocol, and hard rejection checks;
- assign disjoint write ownership so that two agents never edit the same chapter file;
- record the agent, prompt summary, inputs, output path, and review status in
plan/chapter-agent-provenance.md; - perform a controller review after agent output before claiming progress.
If subagents are not available, stop and ask the user whether to continue in degraded single-agent mode. Do not silently fall back to one-pass generation.
Stage Detection
Classify the current work before acting:
| Stage | Trigger | Required next skill |
| S0 Scope | topic, target, structure unclear | brainstorming-research |
| S1 Evidence | references, Introduction, Related Work | evidence-driven-writing + literature-review |
| S2 Method | model, algorithm, system, method section | writing-chapters with method flow gate |
| S3 Experiments | setup, results, tables, charts | experiment-results-planning + figures-python |
| S4 Drafting | section text | writing-chapters |
| S5 Review | quality, consistency, submission risk | peer-review + verification |
Record the stage in plan/progress.md.
Task Packet
Before dispatching a section task, create a persistent packet under plan/task-packets/. Conversation-only packets are not acceptable for medium or full-paper work because they cannot be audited later.
## Task Packet
- Scope:
- Files to read:
- Files allowed to edit:
- Required skills:
- Evidence/data inputs:
- Required artifacts:
- Rejection checks:
- Validation commands:Subagents must receive the task packet, not the entire vague project. If subagents are available, split independent work into literature mapping, method architecture, experiment planning, figure generation, and review. Do not let multiple agents edit the same file.
For chapter-writing packets, add:
- Target chapter file and exclusive owner.
- Required argument chain, in paragraph roles rather than bullet content.
- Minimum prose length.
- Required sources and data artifacts.
- Prohibited structure, especially bullet-like lists, process notes, and old chapter scaffolding.
- Required handoff format: status, file path changed, unresolved evidence/data gaps, and self-review.
Review Gates
Every medium task needs two reviews before completion:
- Spec compliance review: did the output match the task packet and required artifacts?
- Quality review: are claims supported, section logic coherent, and manuscript pollution absent?
If either review fails, fix before moving to the next task.
Capability-Use Audit
At the end of every medium task, write a short audit in plan/progress.md:
### Capability-use audit
- Required skills:
- Skills actually used:
- Inputs consumed:
- Inputs not used and why:
- Artifacts produced:
- Verification run:
- Remaining risk:The task is not complete without this audit.
Common Failures
- Treating user instructions as manuscript content. Convert instructions into structure or edits; never paste them into the body.
- Claiming a section is "done" when it only has headings and placeholders.
- Running style checks while skipping evidence, data, and claim checks.
- Producing tables instead of prose to hide weak argumentation.
- Keeping an old chapter split after the user rejects it. Rebuild the chapter architecture first.
- Letting the controller write a full manuscript sequentially instead of using one independent agent per major chapter.
- Accepting short, enumerative prose because it passes keyword checks. Length, paragraph flow, evidence use, and agent provenance must all be reviewed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

