academic-paper
12-agent academic paper writing pipeline. 11 modes (full/plan/outline/revision/revision-coach/abstract/lit-review/format-convert/citation-check/disclosure/rebuttal-audit). 6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output. Style Calibration + Writing Quality Ch
By imbad0202 · 9,168 installs
npx skills add imbad0202/academic-research-skills --skill academic-paper
Source repository · Upstream listing
Academic Paper — Academic Paper Writing Agent Team
A general purpose academic paper writing tool — 12 agent pipeline covering all disciplines, with higher education domain as the default reference.
v2.5 adds two writing quality features:
Style Calibration (intake Step 10, optional) — Provide 3+ past papers and the pipeline learns your writing voice (sentence rhythm, vocabulary preferences, citation integration style). Applied as a soft guide during drafting; discipline conventions always take priority. See shared/style calibration protocol.md .
Writing Quality Check ( references/writing quality check.md ) — Context sensitive writing diagnostics applied during the draft self review step: vague or overused terms, punctuation that interrupts the argument, throat clearing openers, paragraph and sentence shapes that impair clarity. Prompts for judgment subordinate to author and venue requirements, not quotas ( 825).
Routing discipline (v3.9.2): see .claude/CLAUDE.md "Routing Discipline (v3.9.2)" + shared/references/intent clarification protocol.md for cross skill routing rules. This skill assumes routing has already settled — ambiguous cross phase materials should have been clarified upstream.
Quick Start
Minimal command:
Execution flow:
1. Configuration interview — paper type, discipline, citation format, output format
2. Literature search — systematic search strategy, source screening
3. Architecture design — paper structure, outline, word count allocation
4. Argumentation construction — claim evidence chains, logical flow
5. Full text drafting — section by section draft, register adjustment
6. Citation compliance + bilingual abstract (parallel)
7. Peer review — five perspective categorical assessment, revision suggestions
8. Output formatting — LaTeX/DOCX (via Pandoc)/PDF/Markdown
Trigger Conditions
Trigger Keywords
English : write paper, academic paper, paper outline, write abstract, revise paper, literature review paper, check citations, convert to LaTeX, convert format, format paper, conference paper, journal article, thesis chapter, research paper, guide my paper, help me plan my paper, step by step paper, draft manuscript, write methodology, write discussion, parse reviews, revision roadmap, help me with my revision, I got reviewer comments, should we push back, conference rebuttal, grant panel response, convert citations
繁體中文 : 寫論文, 學術論文, 論文大綱, 寫摘要, 修改論文, 文獻回顧論文, 檢查引用, 轉 LaTeX, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式
한국어 : 논문 작성, 논문 초안, 논문 개요, 초록 작성, 논문 수정, 인용 확인, 인용 형식 검사, LaTeX 변환, 서식 변환, 학위논문 작성, 학술지 논문 작성, 학회 논문 작성, 논문 계획을 도와줘, 단계별로 논문 쓰기, 심사 의견을 받았어, 심사 의견 반영, 답변서 점검, AI 사용 고지
Plan Mode Activation
Activate plan mode when the user wants guidance, step by step planning, or expresses uncertainty about paper structure. Default rule : when ambiguous between plan and full , prefer plan .
See references/plan mode protocol.md for full intent signals and activation rules.
Does NOT Trigger
Scenario Use Instead
Deep research / fact checking (not paper writing) deep research
Reviewing a paper (structured review) academic paper reviewer
Full research to paper pipeline academic pipeline
Distinction from deep research
Feature academic paper deep research
Primary output Publishable paper draft Research report
Structure Journal ready (IMRaD, etc.) APA 7.0 report
Citation Multi format (APA/Chicago/MLA/IEEE/Vancouver) APA 7.0 only
Abstract Bilingual (zh TW + EN) Single language
Peer review Simulated 5 dimension review Editorial review
Output format LaTeX/DOCX (via Pandoc)/PDF/Markdown Markdown only
Revision loop Max 2 rounds with targeted feedback Max 2 rounds
Agent Team (12 Agents)
Agent Role Phase
1 intake agent Configuration interview: paper type, discipline, journal, citation format, output format, language, word count; Handoff detection; Plan mode simplified interview Phase 0
2 literature strategist agent Search strategy design, source screening, annotated bibliography, literature matrix Phase 1
3 structure architect agent Paper structure selection, detailed outline, word count allocation, evidence mapping Phase 2
4 argument builder agent Argument construction, claim evidence chains, logical flow, counter argument handling; Plan mode argument stress test Phase 3 / Plan Step 3
5 draft writer agent Section by section full draft writing, discipline register adjustment, word count tracking Phase 4
6 citation compliance agent Citation format verification, reference list completeness, DOI checking Phase 5a
7 abstract bilingual agent Bilingual abstract (zh TW + EN), 5 7 keywords each Phase 5b
8 peer reviewer agent Simulated double blind review, five perspective categorical assessment, revision suggestions (max 2 rounds) Phase 6
9 formatter agent Convert to LaTeX/DOCX (via Pandoc)/PDF/Markdown, journal formatting, cover letter, citation format conversion (APA 7 / Chicago / MLA / IEEE / Vancouver) Phase 7
10 socratic mentor agent Plan mode Socratic mentor: chapter by chapter guidance, convergence criteria (4 signals), question taxonomy (4 types), INSIGHT extraction Plan Step 0 3
11 visualization agent Parse paper data and generate publication quality figure code (Python matplotlib / R ggplot2) with APA 7.0 formatting, colorblind safe palettes, and LaTeX integration Phase 4 / Phase 7
12 revision coach agent Parse unstructured reviewer comments into a Revision Roadmap, or explicitly identified real committee comments into the separate 668 source accounted concern tracker; works standalone Revision Coach mode
Output Formats
Text Formats
LaTeX (.tex + .bib), DOCX (via Pandoc), PDF (via LaTeX or Pandoc), Markdown.
Figures
When the paper contains quantitative results, the visualization agent can generate publication ready figures in Python (matplotlib/seaborn) or R (ggplot2) with APA 7.0 formatting and colorblind safe palettes. Figures are delivered as runnable code + LaTeX \includegraphics integration code. See references/statistical visualization standards.md for chart type decision trees and code templates.
Citation Formats
APA 7.0 (default), Chicago (Author Date or Notes Bibliography), MLA 9, IEEE, Vancouver. The formatter agent supports late stage citation format conversion between any two supported formats via "Convert citations to [format]".
Orchestration Workflow (8 Phases)
See references/workflow phase details.md for detailed per phase agent behavior and output descriptions.
Review target criteria binding ( 684)
When Phase 0 has produced an author confirmed ReviewTargetContext ( 683), the
orchestrator initializes one pointer only ReviewCriteriaBindingManifest and
uses it unchanged across the formative, internal evaluator, and external panel
consumers. The normative lifecycle, exact marker, closed roles, and explicit
degraded path are defined in
shared/references/review criteria consumer protocol.md .
Phase 2 owns the FORMATIVE receipt. The Structure Architect maps selected
criterion ids to planned sections and evidence needs; later writing phases
reuse that receipt and do not re resolve the target.
Phase 6a receives the same pointer authority and Target Criteria Brief while
remaining paper blind; its pre commitment artifact owns the INTERNAL
receipt. Phase 6b receives that unchanged artifact, may assess applicability
after it sees the draft, and owns any Critical/Major constructive finding
sidecar.
Scientific validity, venue fit, and submission readiness remain distinct.
Criteria never authorize invented evidence, results, methods, or changes to
the author's contribution claim.
Binding validation is a handoff conformance check only. It never supplies an
editorial verdict, severity, checkpoint state, or author triage. If the binding
is unavailable, disclose criteria binding unavailable ; do not claim venue
alignment and do not silently reconstruct a target from model memory.
Checkpoint Rules
1. ⚠️ IRON RULE : User must confirm Paper Configuration Record before proceeding to Phase 1
2. Phase 2 3 : User must approve outline (can request restructuring)
3. ⚠️ IRON RULE : Max 2 revision loops; unresolved items "Acknowledged Limitations"
4. Peer Review Critical severity issues block progression to Phase 7
5. User can skip Phase 1 (literature) if providing own sources
v3.4.0 compliance (applies to full mode): Before finalization, compliance agent runs RAISE principles only check (warn only; primary research is outside PRISMA trAIce scope). Warnings are listed in the disclosure statement but never block the pipeline. See shared/raise framework.md §Scope disclaimer .
Phase by phase Invocation Contract (v3.9.2)
academic paper pipeline runs in 8 phases (Phase 0 intake → 7 formatting). Two invocation modes:
Mode A — orchestrator driven (default): pipeline orchestrator agent (in academic pipeline skill) runs all phases end to end with state tracking via Material Passport.
Mode B — phase by phase (cross session resume): User invokes one agent per phase across sessions for long running projects. Common pattern: write the draft in one session, return next week to citation check / abstract / peer review independently.
In Mode B, single phase agents (Bucket A per docs/design/2026 05 18 ars v3.9.2 agent phase classification.md ) stay strictly within their assigned phase for writes . The 7 Bucket A agents in academic paper are: literature strategist (P1), structure architect (P2), draft writer (P4/P6 per invocation), citation compliance (P5a), abstract bilingual (P5b), peer reviewer (P6), formatter (P7). Reads from upstream phases are allowed.
Multi phase agents (Bucket B: argument builder P3+Plan, visualization P4+P7) do exactly the work specified by the caller's invocation for that phase — no extension to other phases in the same call. The v3.6.6 generator evaluator contract below additionally constrains draft writer and peer reviewer sub phase behavior (Phase 4a/4b, Phase 6a/6b).
Routing into Mode B requires explicit user signal — /ars <mode slash command or [direct mode] prefix. Ambiguous cross phase input defaults to clarification per .claude/CLAUDE.md Routing Discipline + shared/references/intent clarification protocol.md .
Enforcement (v3.9.2): Phase Boundary blocks on Bucket A agents + advisory verifier ( scripts/check pipeline integrity.py ) + a deterministic PreToolUse write scope guard in hook enabled runtimes ( 134 rescope, PR 294). Multi phase envelope remains forward scope ( 134 Slices 3 5).
v3.6.6 Generator Evaluator Contract Protocol
Authoritative orchestration block for the v3.6.6 contract gated phase splits inside academic paper full mode. Schema 13.1 since v3.6.6 ( shared/sprint contract.schema.json ). Templates: shared/contracts/writer/full.json + shared/contracts/evaluator/full.json . Design spec: docs/design/2026 04 27 ars v3.6.6 generator evaluator contract design.md §5.
Applies to academic paper full mode only. Nine non full modes ( plan , outline only , revision , revision coach , abstract only , lit review , format convert , citation check , disclosure ) are byte equivalent across v3.6.5 → v3.6.6 and do not invoke this protocol. (The later added rebuttal audit mode is likewise non full and does not invoke this protocol.) Pipeline boundary unchanged: academic pipeline Stage 2 dispatches academic paper in plan or full mode (full only invokes this protocol); Stage 3 dispatches the separate academic paper reviewer skill (5 panel external editorial review). The in pair Phase 6 evaluator under t