paper-writing-orchestrator
Skill0 starsChanged 27 days agoMITView on GitHub
Orchestrate a multi-stage academic manuscript workflow from authority and evidence intake through argument planning, section drafting, figures and tables, consistency checks, venue review, and final artifact validation. Use when the user asks to start, continue, revise, finish, or manage an end-to-end paper, determine its current stage, or coordinate multiple paper-related skills. Do not use for an isolated paper reading, one paragraph polish, one standalone figure or table, a slide deck, or a PDF-only task unless it is explicitly part of a broader manuscript workflow. 中文触发短语:开始写论文、继续写论文、论文写到哪一步了、稿件阶段、按审稿意见定点修改某一节、离投稿还差什么、协调图表、评审和写作、S0 到 S7。
1 other project uses a version of this.
Adopted by
Most recently taken up by
- RuinDow/chinese-information-science-paper-skillstheir own version, first seen Mar 17, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- RuinDow/chinese-information-science-paper-skills★ 9same name
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 repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- academic-humanizerSkill
- drawio-skillSkill
- innovation-exploreSkill
- paper-framingSkill
- paper-readingSkill
- paper-reviewSkill
- paper-storytellingSkill
- paper-style-profilerSkill
- publication-chart-skillSkill
- research-pipelineSkill
- scientific-visualizationSkill
- session-handoff-promptSkill
- task-forestSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
43 rules. About 0 are common, 26 are distinctive, and 17 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈26
Distinctive · estimate
This author's own choices. Worth a look.
17
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Distinctive: line 16
Treat the human authors as owners of the research question, scientific interpretation, claim strength, author order, disclosures, and …
- Distinctive: line 18
Do not add experiments, datasets, baselines, citations, results, threat models, or contributions that the user did not authorize and supply.
- Distinctive: line 35
Do not expand a focused request into the full pipeline.
- Very specific: line 38
When a figure or table is embedded in an active manuscript workflow, a request to restyle, highlight, reorder, or otherwise change its …
- Distinctive: line 49
Read the applicable AGENTS.md or CLAUDE.md and repository governance files.
- Distinctive: line 53
Follow any required connection or repository-specific skill.
- Very specific: line 79
Read stage playbook when starting, detecting, or advancing a stage.
- Very specific: line 92
Use another available Python 3 launcher when python3 is unavailable.
- Very specific: line 97
When the repository carries research/STATE.md, the $research-pipeline R stages own the science and this skill owns the manuscript, running …
- Distinctive: line 102
Verify provenance and status values.
- Distinctive: line 135
Never silently screen, relabel, merge, or omit them to improve the narrative.
- Distinctive: line 139
Read question-finding loop when the workflow includes research design, interpretation of an important finding, Results or Discussion …
- Distinctive: line 153
If a machine-readable question-finding ledger exists, run:
- Distinctive: line 164
Read skill routing when choosing a companion.
- Distinctive: line 165
Read external skill locks before invoking the installed figure, diagram, or table engines.
- Very specific: line 169
Use $paper-reading for source-grounded paper reading, comparison, and related-work analysis.
- Very specific: line 171
Use $paper-storytelling for the story spine, the six-step introduction, the Figure 1 judgment, Answer-to-RQ boxes, and the …
- Very specific: line 174
Use $paper-style-profiler to build, refresh, or audit the repository style contract before drafting.
- Very specific: line 176
Use $scientific-visualization for data-backed publication plots and their export, accessibility, metadata, and visual audits.
- Very specific: line 178
Use $drawio-skill for editable method, architecture, protocol, and workflow diagrams.
- Very specific: line 180
Use $publication-chart-skill to lock the evidence contract and decide figure versus table and the representation family.
- Very specific: line 185
Use $academic-humanizer only after the relevant claims and terminology are stable.
- Very specific: line 187
Use $paper-review for graded review (L1 framing and potential gate, L2 evidence chain, L3 pre-submission) of any target venue.
- Very specific: line 196
Use $pdf when final rendering or PDF layout matters.
- Very specific: line 197
Use $jupyter-notebook only when the requested deliverable or reproducibility workflow genuinely needs a notebook.
- Very specific: line 199
Use $Spreadsheets only when the requested deliverable is a workbook or spreadsheet, not merely because the paper contains a table.
- Distinctive: line 202
If the best companion is unavailable, state the gap and perform only the work that can be done reliably without pretending that the missing …
- Very specific: line 220
When paper/FIGURE_PLAN.md exists, render the planned figures and tables before the Results prose that depends on them, and write the prose …
- Distinctive: line 228
Before drafting a unit:
- Distinctive: line 243
Read narrative integrity and rebuttal when drafting or revising the title, abstract, introduction, or Figure 1.
- Distinctive: line 251
After drafting, compare source and output for numbers, direction, baseline, causal strength, uncertainty, scope, citations, and terminology.
- Very specific: line 254
Before claiming S4, run the $paper-storytelling experiment-report symptom checklist on the draft and confirm that every number in prose …
- Distinctive: line 262
Before producing a manuscript figure/table package, write a visual contract that gives each artifact and each panel a distinct question, …
- Distinctive: line 274
Do not subtract, merge, or compare values from incompatible pools, protocols, populations, or stages.
- Distinctive: line 276
Treat captions, notes, labels, axis titles, highlighting, and significance marks as claims subject to the same ceiling as prose.
- Distinctive: line 280
Keep the external engine responsible for rendering and format-specific QA.
- Distinctive: line 284
When the user explicitly requests strict independent review, freeze the rubric and artifact hashes before review.
- Distinctive: line 288
Use three or four separately executed reviewers covering visual-design, statistical-graphics, and venue-production roles.
- Distinctive: line 306
Do not obtain a pass by changing only the reviewers, weakening the rubric, averaging away a low score, or asking reviewers to raise scores.
- Distinctive: line 331
Never present a simulated decision as an acceptance probability.
- Distinctive: line 347
Do not upload, submit, email, publish, merge, or push unless the user explicitly requests that external action and the applicable …
- Distinctive: line 360
When the question-finding loop was invoked, also report its answerability and authorization disposition.
- Distinctive: line 364
After changes, report what changed, the evidence used, checks actually run, remaining unverified items, and the resulting stage.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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 Writing Orchestrator
Coordinate the paper as a staged, evidence-bounded workflow. A fluent draft is not evidence, a successful build is not scientific adequacy, and a completed review is not submission or acceptance.
Language and scope
- Communicate in the user's language. Preserve the manuscript's requested language and disciplinary register.
- Treat the human authors as owners of the research question, scientific interpretation, claim strength, author order, disclosures, and submission.
- Do not add experiments, datasets, baselines, citations, results, threat models, or contributions that the user did not authorize and supply.
- One-shot generation may produce a clearly labeled outline or disposable zero draft. It never creates an authoritative final manuscript.
Select the operating mode
Choose one mode before acting:
| Mode | Use when | Default action |
PIPELINE_START | A new paper or a full writing workflow begins | Resolve authority, evidence, target venue, and claim ceiling |
STAGE_DETECT | The user asks where the paper stands | Inspect only; report the current gate and next admissible step |
CONTINUE | A prior workflow should resume | Verify saved state against current files before continuing |
TARGETED_REVISION | The user names a section, finding, or reviewer issue | Make the smallest evidence-preserving change |
SUBMISSION_READINESS | The manuscript is near submission | Separate scientific, format, artifact, and author-side blockers |
Do not expand a focused request into the full pipeline. Do not edit when the user asks only for explanation, diagnosis, or review.
When a figure or table is embedded in an active manuscript workflow, a request
to restyle, highlight, reorder, or otherwise change its argumentative emphasis
remains a TARGETED_REVISION owned by this orchestrator. Route the rendering
work to the appropriate companion only after applying the manuscript evidence
and claim gates. A truly standalone exploratory figure or table bypasses this
orchestrator as described below.
Resolve authority before paper work
For a repository-backed paper:
- Read the applicable
AGENTS.mdorCLAUDE.mdand repository governance files. - Resolve the authoritative workspace, manuscript line, branch, HEAD, and working-tree state before editing.
- Follow any required connection or repository-specific skill. Never replace a prescribed route with an improvised remote command.
- Preserve unrelated changes. Do not edit archives, deprecated paper lines, or generated outputs when an editable source is authoritative.
For a file-only paper, identify the editable source, supplied evidence bundle, target venue, and intended output. If competing versions exist, stop and ask which is authoritative.
Use the stage gates
The workflow has eight monotonic stages:
S0_AUTHORITY_RESOLVEDS1_EVIDENCE_LOCKEDS2_ARGUMENT_LOCKEDS3_SECTION_DRAFTEDS4_MANUSCRIPT_INTEGRITY_CHECKEDS5_VENUE_REVIEWEDS6_ARTIFACT_VERIFIEDS7_SUBMISSION_READY
These names denote completed gates. When manuscript authority is not yet
resolved, report PRE_S0 with S0 gate unmet; do not label the paper
S0_AUTHORITY_RESOLVED or create a state file that claims that gate has passed.
Read stage playbook when starting, detecting, or
advancing a stage. Do not claim a later stage unless every earlier gate has
current evidence. SUBMITTED and ACCEPTED are external states and are never
inferred by this skill.
For long-running work, use the optional state contract in state and ledger contracts. If a state JSON exists, run:
python3 <skill-dir>/scripts/validate_paper_state.py <state.json>Use another available Python 3 launcher when python3 is unavailable. The
state file records evidence; it does not override current files or governance.
Inheriting research-pipeline artifacts
When the repository carries research/STATE.md, the $research-pipeline R
stages own the science and this skill owns the manuscript, running inside R4
and R5. Do not re-derive what an earlier R stage already decided:
S1inherits the R3 ledgers (paper/ledger/*,reports/<run>/RESULT.md). Verify provenance and status values; do not rebuild the ledger from prose.S2inheritspaper/FRAMING.mdandpaper/STORY_SPINE.mdas thesis, RQs, reader value, and narrative order. LockingS2additionally requires three items: a figure and table plan (paper/FIGURE_PLAN.md, one conclusion sentence per artifact, Figure 1 decided first), a style contract (the$paper-style-profilerbundle at.paper-style/withWRITING-CONTRACT.mdandSTYLE-STATE.json, its validator passing and theSTYLE-STATE.jsonstatus one ofPROFILE_SAVED,TARGET_AUDITED, orSTYLE_APPLIED), and a spine settlement check (the branch chosen inpaper/STORY_SPINE.mdafter R3 matches the ledger: the evidence its turning point relies on is stillVERIFIED_CURRENT, claim strength does not exceed the ledger, section order follows that branch, and the R1 version is archived).- A mismatch between an inherited artifact and current evidence is a rollback
to that R stage, recorded in
research/STATE.mdas回退到 R<n>, not a patch insideS2-S4. Weakening wording is admissible only when the ledger never allowed the stronger claim.
The full R-to-S table is in
research-pipeline/references/orchestrator-mapping.md.
Build the evidence and claim ledgers
Classify every material input as one of:
VERIFIED_CURRENT: current, traceable evidence admissible for the paper.CONTROLLED_OR_RETROSPECTIVE: usable only with its stated conditions.EXPLORATORY_OR_CANDIDATE: useful for planning, not for result claims.SUPERSEDED_OR_INVALID: retained as history, excluded from current claims.MISSING_OR_UNRESOLVED: unavailable or insufficiently verified.
For each material claim, record its source, population or corpus, protocol,
metric, comparison set, result, permitted wording, and prohibited upgrade.
Preserve abstain, unresolved, negative, invalidated, and superseded outcomes.
Never silently screen, relabel, merge, or omit them to improve the narrative.
Use a bounded question-finding loop
Read question-finding loop when the
workflow includes research design, interpretation of an important finding,
Results or Discussion restructuring, anomaly triage, experiment triage,
reviewer stress testing, or deadline convergence. Keep S0-S7 as the outer
stage system; do not add a later-stage label merely because the inner loop
generated another question.
Separate data, directly supported findings, bounded implications, and broader interpretations. Treat pre-protocol and post-finding literature checks differently. A technically answerable question does not authorize a new analysis or experiment: record a safe disposition, obtain user authorization, and freeze an outcome-independent protocol before execution. A general principle is optional and must not exceed the evidence or population.
If a machine-readable question-finding ledger exists, run:
python3 <skill-dir>/scripts/validate_question_finding_ledger.py <ledger.json>The validator checks structure and fail-closed state combinations; it does not prove scientific importance, truth, or necessity.
Route work to companion skills
Read skill routing when choosing a companion. Read external skill locks before invoking the installed figure, diagram, or table engines. Use only skills available in the current environment.
- Use
$paper-readingfor source-grounded paper reading, comparison, and related-work analysis. - Use
$paper-storytellingfor the story spine, the six-step introduction, the Figure 1 judgment, Answer-to-RQ boxes, and the experiment-report symptom checklist atS3andS4. - Use
$paper-style-profilerto build, refresh, or audit the repository style contract before drafting; the contract is anS2input. - Use
$scientific-visualizationfor data-backed publication plots and their export, accessibility, metadata, and visual audits. - Use
$drawio-skillfor editable method, architecture, protocol, and workflow diagrams. - Use
$publication-chart-skillto lock the evidence contract and decide figure versus table and the representation family; itspubtabbranch then owns publication tables, table conversion, and previews. Data plots still go to$scientific-visualization;pubfigoutput does not replace that integrity and export route. - Use
$academic-humanizeronly after the relevant claims and terminology are stable; its role is drafting or minimal prose repair, not scientific truth. - Use
$paper-reviewfor graded review (L1 framing and potential gate, L2 evidence chain, L3 pre-submission) of any target venue; it loads the venue profile named inpaper/VENUE_PROFILE.md(one file per venue under itsreferences/venues/) and falls back to its generic rubric otherwise. - For a security venue, still use
$paper-reviewwith the venue profile frompaper/VENUE_PROFILE.md; when that venue has no profile under itsreferences/venues/, also read security venue review as a supplement. Do not use an economics referee workflow. - Use
$pdfwhen final rendering or PDF layout matters. - Use
$jupyter-notebookonly when the requested deliverable or reproducibility workflow genuinely needs a notebook. - Use
$Spreadsheetsonly when the requested deliverable is a workbook or spreadsheet, not merely because the paper contains a table.
If the best companion is unavailable, state the gap and perform only the work that can be done reliably without pretending that the missing review or validation occurred.
An external skill's dependency-install default does not override repository or user authority. For repository-backed papers, do not install packages into the project interpreter, replace its lockfile, or bootstrap a new TeX distribution without explicit authorization. Probe first; use an isolated validation environment when practical; otherwise stop at a specification and report the missing runtime.
Draft in evidence-sized units
For an empirical paper, the default order is Methods and Results, then Discussion and Threats, then Introduction and Related Work, and finally Abstract, Conclusion, and title. Change this order when the existing manuscript or user request makes another sequence more coherent.
When paper/FIGURE_PLAN.md exists, render the planned figures and tables
before the Results prose that depends on them, and write the prose to the
rendered artifact rather than the reverse; the plan's one-sentence conclusion
becomes the caption opener. Introduction, abstract, and conclusion follow the
$paper-storytelling spine: a six-step introduction, an Answer-to-RQ box
after each research question, and a conclusion that restates the story
without repeating the numbers.
Before drafting a unit:
- Name its rhetorical job and admissible claims.
- Identify its supporting evidence and locked terminology.
- Mark missing citations, assumptions, or results instead of filling them.
- Decide whether the output is an outline, zero draft, revision, or candidate final text.
For a Results unit, distinguish the question, protocol, data, finding, and bounded implication when those layers exist. Use a neutral question heading when the result is negative, mixed, or unresolved; never make a heading stronger than its evidence. For Discussion, keep integrated interpretation, candidate explanations, limitations, and future-study designs visibly separate.
Read narrative integrity and rebuttal
when drafting or revising the title, abstract, introduction, or Figure 1; when
wording summarizes a quantity; when partner or restricted evidence is used;
when deadline pressure shapes decisions; or when preparing public materials,
research statements, or job talks.
Route reader-visibility decisions (problem naming, why-now, Figure 1 judgment,
main versus appendix allocation) to $paper-framing first.
After drafting, compare source and output for numbers, direction, baseline,
causal strength, uncertainty, scope, citations, and terminology. Keep edits
focused and reviewable. Do not rewrite competent text merely for variation.
Before claiming S4, run the $paper-storytelling experiment-report symptom
checklist on the draft and confirm that every number in prose traces to the
ledger or an output file.
Gate figures and tables as evidence
A figure or table is part of the scientific argument, not decoration.
Before producing a manuscript figure/table package, write a visual contract that gives each artifact and each panel a distinct question, evidence source, estimator, uncertainty rule, and manuscript role. Read figure and table quality gates when the package is multi-panel, mixes a figure and a table, highlights a preferred method, or the user requests iterative visual review.
- Route data plots through
$scientific-visualization, editable schematics through$drawio-skill, and publication tables through the table branch of$publication-chart-skill. - Tie every displayed value to an authoritative source and explicit transformation.
- Do not subtract, merge, or compare values from incompatible pools, protocols, populations, or stages.
- Treat captions, notes, labels, axis titles, highlighting, and significance marks as claims subject to the same ceiling as prose.
- Require source code or another reproducible construction path for data-backed visuals and tables.
- Keep the external engine responsible for rendering and format-specific QA; keep this orchestrator responsible for authority, evidence compatibility, claim ceilings, venue routing, and manuscript-wide consistency.
When the user explicitly requests strict independent review, freeze the rubric and artifact hashes before review. Unless the user separately defines a full-manuscript rubric, these scores apply only to the frozen figure/table artifact package and must not be reported as scores for the whole manuscript. Use three or four separately executed reviewers covering visual-design, statistical-graphics, and venue-production roles. Give each reviewer the same frozen artifacts, visual contract, and rubric in an isolated pass; do not share another reviewer's findings or scores until all reviews for that round are collected. Do not describe multiple role prompts from one uninterrupted self-review as independent. If separate review execution is unavailable, fail closed and report that the independence requirement was not met.
Bind every review round to the same rendered figure and table. A strict round passes only when each reviewer independently clears every requested score threshold and no hard gate or required change remains. Validate the round record with:
python3 <skill-dir>/scripts/validate_visual_review.py \
<review-record.json> --artifact-root <artifact-root>Do not obtain a pass by changing only the reviewers, weakening the rubric, averaging away a low score, or asking reviewers to raise scores. Revise the artifact or report an evidence-bound blocker.
Separate review from revision
- Review is read-only by default. Findings do not authorize manuscript edits or new experiments.
- Distinguish verified defects, reviewer inference, venue-fit judgment, and unresolved questions.
- A suggestion to add experiments must state the claim gap, minimal design, outcome-independent decision rule, and stop condition. It remains a proposal until the user authorizes it.
- Reviewer challenges must be classified before routing: already answered by frozen evidence, candidate analysis, candidate new experiment, bounded limitation, fatal claim gap, or unresolved reviewer inference. Do not hide a fatal claim gap in Limitations.
- For rebuttals and camera-ready work, diagnose verdicts such as "incremental" or "limited significance" before proposing experiments, promise actions rather than outcomes, keep a promise ledger, and never submit results with invalid provenance as preliminary evidence. See narrative integrity and rebuttal.
- For current venue scope, format, page limits, anonymity, data statements, AI disclosures, or submission fields, check primary official venue sources and record the verification date.
- Never present a simulated decision as an acceptance probability.
Final artifact and readiness gate
At S6_ARTIFACT_VERIFIED, verify the editable source, build log, citations and
references, figures and tables, fonts, clipping, page rendering, and artifact
manifest as applicable. Mechanical success proves only the checked condition.
At S7_SUBMISSION_READY, separately report:
- scientific blockers;
- manuscript-content blockers;
- format and artifact blockers;
- author-side metadata and disclosure blockers;
- external actions not yet performed.
Do not upload, submit, email, publish, merge, or push unless the user explicitly requests that external action and the applicable authorization gate passes.
Response contract
For stage detection or continuation, lead with:
Current stageVerified inputsUnknown or blockedNext admissible actionStop rule
When the question-finding loop was invoked, also report its answerability and authorization disposition. Do not describe a proposed analysis or experiment as work in progress.
After changes, report what changed, the evidence used, checks actually run, remaining unverified items, and the resulting stage. Distinguish local files, committed branch state, pushed remote state, and main-branch integration when repository status matters.
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.

