mcpbeat

Academic Paper Writer

joshua-zyy/academic-paper-writer

Use when writing or revising CS/AI/ML papers from research notes, code repositories, local literature libraries, target venue requirements, or section-level drafting requests. Triggers include 写论文, 初稿, paper draft, write introduction, write method, full paper outline, section-by-section drafting, 证据闭环, 论文起草, 从零写论文, 逐节写作.

60k tokens
context cost
the whole folder, loaded on every use
35
files
instructions only
0
copies elsewhere
how many repositories repackaged it
104
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/joshua-zyy/academic-paper-writer --skill academic-paper-writer

What comes with it

234 287 bytes besides the instruction
agents/probe-agent.md
manifest.yaml
references/content-density.md
references/data-access-levels.md
references/evidence-classification.md
references/examples/example-usage.md
references/exemplar-abstract.md
references/exemplar-experiments.md
references/exemplar-introduction.md
references/exemplar-method.md
references/exemplar-related-work.md
references/figure-generation-guide.md
references/general-writing-guide.md
references/iteration-control.md
references/mode-spectrum.md
references/orchestration-workflow.md
references/paper-structure.md
references/paper-types.md
references/placeholder-guide.md
references/reporting-checklist.md
references/section-dependency-matrix.md
references/section-writing-contracts.md
references/standard-todo-template.md
references/test-scenarios.md
references/workflow-step-0-7.md
references/workflow-step-8-9.5.md
references/workflow-step-9.6-12.md
references/writing-guidelines.md
static/core/anti-patterns.md
static/core/orchestration.md
static/core/output-contract.md
static/core/red-lines.md
static/core/stance.md
static/core/workflow.md

The instruction itself

8 sections, as written by the author

Academic Paper Writer (Core Orchestrator)

证据闭环型、分节推进的论文编排代理。协调六个子技能:Step 0→1→2→3→4→5→6→7→8→9→10→11→12。

Router Protocol

  • Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
  • Read every file listed under always_load. These are the skill's binding rules — not reference material.
  • Apply the loaded material as constraints:
  • stance.md defines core rules, sub-skill boundary, and scope.
  • red-lines.md defines absolute prohibitions. Do not negotiate these.
  • output-contract.md defines file outputs, deliverables, and completion criteria.
  • anti-patterns.md defines known failure modes and their correct alternatives.
  • workflow.md defines the Step 0-12 sequence summary.
  • ../shared/core/ policies define evidence, non-invention, and output boundaries.
  • Detect mode, paper_type, section, and language using manifest axes.
  • Echo the detected mode to the user before executing.
  • Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Modes

| Mode | Purpose |

|---|---|

| full-paper-planning | From-scratch full paper (balanced spectrum) |

| section-drafting | Single section, narrowed evidence scope (balanced) |

| section-revision | Local evidence audit + rewrite (fidelity spectrum) |

| related-work-or-citation-pass | Delegate to academic-citation (fidelity spectrum) |

| experiment-evidence-pass | Delegate to academic-experiments (fidelity spectrum) |

Sub-Skill Dispatch

| Task | Sub-Skill | Step |

|---|---|---|

| Venue research | academic-venue-research | Step 4 |

| Evidence audit | Probe agent | Step 5 |

| Citation search | academic-citation | Step 6 |

| Experiment audit | academic-experiments | Step 7 |

| Figure generation | academic-figure | Step 9.4 |

| Prose polishing | academic-polishing | Step 9.6 (internal) |

| Draft review | academic-reviser | Step 9.5 / 9.8 |

Push Modes

| Mode | Behavior |

|---|---|

| auto (default) | Auto-advance after Verification; brief progress summary only |

| step-by-step | Pause after each section for user confirmation |

Switch anytime via user request.

Hard Gates (A-E)

| Gate | Trigger | Condition | Failure |

|---|---|---|---|

| E: Venue | Step 1→5 | 若用户提供本地 PDF 文献库,Step 2 已验证 MD 目录;venue-brief.md exists | Blocked |

| A: Evidence | Step 5→9 | >= 1 usable evidence | Degradation or blocked |

| B: Section Citation Readiness | Step 6→9 | Current section has VERIFIED citations, Citation-to-Claim Map, or explicit [REF_NEEDED] debt for key claims | Section-dependent: Intro/RW blocked, Method/Results may proceed with tracked debt |

| C: Verification | Step 9.8→10 | All hard debts closed + thin_draft=no | passed/failed/blocked |

| D: Full-Paper Citation Count | Step 11→output | Total >= min_citations | Warn, allow retry |

9.1 Pre-Draft Probe Rules

| Section | Probes to Dispatch | Strategy |

|---|---|---|

| Introduction | existing_material + local lit deep search + external lit search | Must parallel (3 Tasks) |

| Related Work | existing_material + local lit deep search + external lit search | Must parallel (3 Tasks) |

| Method | code_structure (Module Cards + tensor shapes + forward) + preprocessing | Must parallel |

| Experimental Setup | experiment_setup (hyperparams, dataset split, demographics) | Single probe |

| Results / Ablation | experiment_results (main results, baselines, ablation) | Single probe |

| Discussion | interpretability (interpretability results, network analysis) | Single probe |

Default Section Queue

Abstract is post-posed, not in initial queue. Default: Introduction → Related Work → Method → Experimental Setup → Results → Discussion → Conclusion → Abstract.

How to use it

Copy the folder

Take joshua-zyy/academic-paper-writer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.