name

ai-research-writing-skill

description

End-to-end research paper generation, review, and revision for ML/AI/CV/NLP projects from repositories, notes, experiment logs, drafts, and conference templates. Use when building a paper story, mapping claims to evidence, writing or revising sections, producing figures and tables, verifying citations, acting as a skeptical reviewer, running venue or build checks, or preparing a LaTeX/Overleaf/Git submission package.

AI Research Writing Skill

Mandate

Treat paper writing as claim-evidence engineering, not prose generation.

Ground claims in repository files, experiment artifacts, notes, or verified citations.
Never invent citations or numeric results. Mark missing evidence visibly and weaken unsupported claims.
For full papers, produce concrete LaTeX, BibTeX, figure, table, review, and build artifacts; do not stop at an outline.
Keep human judgment in the loop for scientific correctness, visual inspection, reviewer risk, and final submission decisions.

Route the Task

Choose the smallest route that covers the request. Load only the listed references first.

Route	Load first
Full paper or major revision	`references/workflow.md`, `references/artifacts.md`
Upstream research-system handoff	`references/research-handoff.md`, `references/artifacts.md`
Story, thesis, gap, or contribution	`references/paper-story.md`
Section writing or revision	`references/README.md`, then the section-specific reference
Figures and tables	`references/figure-workflow.md`, `references/figure-spec.md`
Citation search or repair	`references/citation-workflow.md`
Reviewer diagnosis	`references/reviewer-guidelines.md`, `references/reviewer-self-review.md`
Submission or camera-ready audit	`references/submission-packaging.md`, `references/citation-checklist.md`
Deterministic checks or formatting	`scripts/README.md`

Execution Contract

For full-paper and submission work:

Create paper_state.json from the contract in references/artifacts.md; declare mode, stage, venue, main TeX, bibliography, required artifacts, blockers, and build record.
If research_handoff.json exists, run check_research_handoff.py --require-unblocked first. Otherwise inventory the repository and experiments before drafting. Create one task packet and update plan/progress.md at the start and end.
Establish the story, claim boundaries, and literature position before long-form prose.
Follow the two-pass drafting order in references/workflow.md: write evidence-bearing core sections first, then finalize framing sections.
Run the mode-aware quality gate. A terminal stage is invalid when inputs are missing, claims/citations remain unresolved, verification is pending, blockers remain, or build hashes are stale.

Keep process instructions in plan/review files, never in manuscript prose.

Gates

Evidence: exact numbers must trace to data, logs, tables, notebooks, or scripts. Quantitative papers maintain numeric-evidence v2 selectors and recomputable aggregates.
Story: define thesis, gap, contribution boundary, and claims to avoid before a full draft.
Literature: position close work before writing Related Work.
Citation: scholarly verified records require citation_requests.json and a fresh citation_lock.json; metadata verification and sentence-level support are separate checks.
Figures: generated images may explain concepts but cannot create numeric evidence. For overview, method, framework, pipeline, architecture, and teaser figures, use built-in image generation as the default paper asset; use deterministic plots/tables for results.
Review: resolve high-severity reviewer objections or record them as blockers.
Build: compile the real package with record_build.py --run before submission-ready; preserve command, log, tool version, exit code, and hashes.
Completion: do not say "done" until required artifacts and checks pass or explicit blockers are reported.

Evidence Boundaries

Treat negative, mixed, missing-seed, or incomplete results as scope constraints, not material to hide.
Verify that each citation supports the attached sentence, not merely the topic.
Save important papers locally only when access and redistribution permit; otherwise record stable metadata and access status.
Generated diagrams communicate a workflow or idea; they are never experimental evidence.

Finish

Report the concrete artifacts changed, checks run, and remaining scientific risks. Preserve the author's intent, but not unsupported wording.

AI Research Writing Skill

Mandate

Treat paper writing as claim-evidence engineering, not prose generation.

Ground claims in repository files, experiment artifacts, notes, or verified citations.

Never invent citations or numeric results. Mark missing evidence visibly and weaken unsupported claims.

For full papers, produce concrete LaTeX, BibTeX, figure, table, review, and build artifacts; do not stop at an outline.

Keep human judgment in the loop for scientific correctness, visual inspection, reviewer risk, and final submission decisions.

Route the Task

Choose the smallest route that covers the request. Load only the listed references first.

Route

Load first

Full paper or major revision

references/workflow.md, references/artifacts.md

Upstream research-system handoff

references/research-handoff.md, references/artifacts.md

Story, thesis, gap, or contribution

references/paper-story.md

Section writing or revision

references/README.md, then the section-specific reference

Figures and tables

references/figure-workflow.md, references/figure-spec.md

Citation search or repair

references/citation-workflow.md

Reviewer diagnosis

references/reviewer-guidelines.md, references/reviewer-self-review.md

Submission or camera-ready audit

references/submission-packaging.md, references/citation-checklist.md

Deterministic checks or formatting

scripts/README.md

Execution Contract

For full-paper and submission work:

Create paper_state.json from the contract in references/artifacts.md; declare mode, stage, venue, main TeX, bibliography, required artifacts, blockers, and build record.

If research_handoff.json exists, run check_research_handoff.py --require-unblocked first. Otherwise inventory the repository and experiments before drafting. Create one task packet and update plan/progress.md at the start and end.

Establish the story, claim boundaries, and literature position before long-form prose.

Follow the two-pass drafting order in references/workflow.md: write evidence-bearing core sections first, then finalize framing sections.

Run the mode-aware quality gate. A terminal stage is invalid when inputs are missing, claims/citations remain unresolved, verification is pending, blockers remain, or build hashes are stale.

Keep process instructions in plan/review files, never in manuscript prose.

Gates

Evidence: exact numbers must trace to data, logs, tables, notebooks, or scripts. Quantitative papers maintain numeric-evidence v2 selectors and recomputable aggregates.

Story: define thesis, gap, contribution boundary, and claims to avoid before a full draft.

Literature: position close work before writing Related Work.

Citation: scholarly verified records require citation_requests.json and a fresh citation_lock.json; metadata verification and sentence-level support are separate checks.

Figures: generated images may explain concepts but cannot create numeric evidence. For overview, method, framework, pipeline, architecture, and teaser figures, use built-in image generation as the default paper asset; use deterministic plots/tables for results.

Review: resolve high-severity reviewer objections or record them as blockers.

Build: compile the real package with record_build.py --run before submission-ready; preserve command, log, tool version, exit code, and hashes.

Completion: do not say "done" until required artifacts and checks pass or explicit blockers are reported.

Evidence Boundaries

Treat negative, mixed, missing-seed, or incomplete results as scope constraints, not material to hide.

Verify that each citation supports the attached sentence, not merely the topic.

Save important papers locally only when access and redistribution permit; otherwise record stable metadata and access status.

Generated diagrams communicate a workflow or idea; they are never experimental evidence.

Finish

Report the concrete artifacts changed, checks run, and remaining scientific risks. Preserve the author's intent, but not unsupported wording.