with one click
paper-writing-contract-planner
// Create a paper writing contract before drafting. Use to lock venue, positioning, archetype, section order, paragraph roles, evidence slots, figure/table jobs, and forbidden claims.
// Create a paper writing contract before drafting. Use to lock venue, positioning, archetype, section order, paragraph roles, evidence slots, figure/table jobs, and forbidden claims.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | paper-writing-contract-planner |
| description | Create a paper writing contract before drafting. Use to lock venue, positioning, archetype, section order, paragraph roles, evidence slots, figure/table jobs, and forbidden claims. |
| argument-hint | [paper-dir-or-project-root] [--venue <venue>] [--archetype <type>] [--mode create|update|audit] |
| allowed-tools | Read, Write, Edit, Bash, Glob, WebSearch, WebFetch |
Create the paper's writing contract: a durable agreement about what the paper is, what each section must do, which claims are allowed, what evidence each claim requires, and how later writing skills should execute the draft. This skill plans the "paper formula" before prose writing.
Use this skill for:
paper/.agent/writing-contract.mdDo not use this skill to write full paper prose. Use paper-writing-assistant after the contract exists. Use paper-writing-memory-manager after creating or updating the contract so section status, dependencies, style rules, and open writing threads reflect the new agreement. Use paper-positioning-planner first if the primary contribution is still undecided. Use paper-evidence-board if the main task is a claim/evidence inventory. Use experiment-design-planner when missing evidence needs a runnable experiment plan.
<installed-skill-dir>/
āāā SKILL.md
āāā references/
ā āāā contract-schema.md
ā āāā update-protocol.md
āāā templates/
āāā writing-contract.md
references/contract-schema.md and templates/writing-contract.md.references/update-protocol.md when updating an existing contract or when the draft/results changed.paper-writing-assistant/references/evidence-recipes.md when available and the contract needs archetype-specific evidence slots.paper-writing-assistant/references/style-selection.md and paper-writing-assistant/references/exemplar-index.md when venue/topic style or exemplar patterns matter.paper/.agent/writing-memory/ through paper-writing-memory-manager when the contract changes section order, paragraph roles, claim strength, style rules, or forbidden claims.paper-positioning-planner outputs when present, such as positioning reports, claim decisions, or narrative architecture.Find:
paper/, current directory, or user-provided pathpaper/.agent/writing-contract.mdmain.tex, paper.tex, sections/*.texmemory/claim-board.md, memory/evidence-board.md, memory/action-board.mdpaper/.agent/paper-evidence-board.md, paper/.agent/paper-status.md, paper/.agent/provisional-results.mdIf the user provides only an idea, produce a draft contract and mark uncertain fields as TBD or needs-decision.
Use one of:
create: no contract exists or the paper is being repositionedupdate: revise an existing contract after new results, new venue, new claims, or draft changesaudit: check whether a contract matches the current draft and evidenceIf no mode is specified, default to create when no contract exists and update when one exists.
Read references/contract-schema.md.
Choose:
If the archetype is uncertain, write the competing options and the evidence needed to choose, but still pick a provisional primary archetype for the contract.
For every main and secondary claim, record:
- Claim ID:
- Claim wording:
- Allowed strength:
- Paper locations:
- Required evidence slots:
- Current evidence status:
- Missing evidence action:
- Forbidden overclaim:
Use evidence slot statuses: filled, user-stated, planned, running, provisional, missing, contradicted, or not-needed.
If an evidence slot is a blocker for the selected archetype, mark the corresponding claim as blocked or narrowed.
Specify:
Do not include long exemplar quotes.
Use templates/writing-contract.md.
Save to:
paper/.agent/writing-contract.md
If there is no paper/ directory and the current directory is the paper repo, save to:
.agent/writing-contract.md
When updating, preserve useful stable decisions and add a compact change note instead of rewriting history.
Route unresolved items:
paper-writing-assistant: write or revise sections under the contractpaper-writing-memory-manager: initialize or update writing memory after contract creation or revisionpaper-evidence-board: synchronize claim/evidence/action IDsexperiment-design-planner: plan missing evidence slotsbaseline-selection-audit: defend required baselinesfigure-results-review: validate figure jobs and captionstable-results-review: validate table jobs and provenancepaper-positioning-planner: revisit primary archetype or claim scopepaper-reviewer-simulator: stress-test the contract before full draftingBefore finalizing: