agentleFS
aidlessaidless/research-writing-skill/skills/paper-orchestration/SKILL.md

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

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
  1. Very specific:

    Create plan/chapter-architecture.md before drafting.

    line 36
  2. Distinctive:

    If this file exists, the quality gate must treat extra or missing chapter files as failures.

    line 44
  3. Distinctive:

    create one task packet per major chapter.

    line 50
  4. Distinctive:

    If subagents are not available, stop and ask the user whether to continue in degraded single-agent mode.

    line 57
  5. Very specific:

    Before dispatching a section task, create a persistent packet under plan/task-packets/.

    line 76
  6. Distinctive:

    Every medium task needs two reviews before completion:

    line 103
  7. Distinctive:

    If either review fails, fix before moving to the next task.

    line 108

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.md
  • plan/outline.md
  • plan/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:

  1. Introduction, with related work integrated into the motivation and research-gap argument.
  2. Methodology.
  3. Dataset and Experimental Setting, either standalone or integrated into Methodology/Results when short.
  4. Experimental Results and Analysis.
  5. 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=no

If 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:

StageTriggerRequired next skill
S0 Scopetopic, target, structure unclearbrainstorming-research
S1 Evidencereferences, Introduction, Related Workevidence-driven-writing + literature-review
S2 Methodmodel, algorithm, system, method sectionwriting-chapters with method flow gate
S3 Experimentssetup, results, tables, chartsexperiment-results-planning + figures-python
S4 Draftingsection textwriting-chapters
S5 Reviewquality, consistency, submission riskpeer-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:

  1. Spec compliance review: did the output match the task packet and required artifacts?
  2. 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.