ai-research-writing-skill

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:

1. Create paper_state.json from the contract in references/artifacts.md; declare mode, stage, venue, main TeX, bibliography, required artifacts, blockers, and build record.
2. 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.
3. Establish the story, claim boundaries, and literature position before long-form prose.
4. Follow the two-pass drafting order in references/workflow.md: write evidence-bearing core sections first, then finalize framing sections.
5. 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.