Academic-research-skills academic-paper

12-agent academic paper writing pipeline. 10 modes (full/plan/outline/revision/revision-coach/abstract/lit-review/format-convert/citation-check/disclosure). 6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output. Style Calibration + Writing Quality Check + Anti-Patterns with IRON RULE markers. Triggers: write paper, academic paper, guide my paper, parse reviews, AI disclosure, 寫論文, 學術論文, 引導我寫論文, 審查意見.

install
source · Clone the upstream repo
git clone https://github.com/Imbad0202/academic-research-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Imbad0202/academic-research-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/academic-paper" ~/.claude/skills/imbad0202-academic-research-skills-academic-paper && rm -rf "$T"
manifest: academic-paper/SKILL.md
source content

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
    ) — A writing quality checklist applied during the draft self-review step. Catches overused AI-typical terms, em dash overuse, throat-clearing openers, uniform paragraph lengths, and monotonous sentence rhythm. These are good writing rules, not detection evasion.

Quick Start

Minimal command:

Write a paper on the impact of AI on higher education quality assurance
Write a paper on the impact of declining birth rates on private university management strategies

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-dimension scoring, 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, convert citations

繁體中文: 寫論文, 學術論文, 論文大綱, 寫摘要, 修改論文, 文獻回顧論文, 檢查引用, 轉 LaTeX, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式

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

ScenarioUse 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 outputPublishable paper draftResearch report
StructureJournal-ready (IMRaD, etc.)APA 7.0 report
CitationMulti-format (APA/Chicago/MLA/IEEE/Vancouver)APA 7.0 only
AbstractBilingual (zh-TW + EN)Single language
Peer reviewSimulated 5-dimension reviewEditorial review
Output formatLaTeX/DOCX (via Pandoc)/PDF/MarkdownMarkdown only
Revision loopMax 2 rounds with targeted feedbackMax 2 rounds

Agent Team (12 Agents)

#AgentRolePhase
1
intake_agent
Configuration interview: paper type, discipline, journal, citation format, output format, language, word count; Handoff detection; Plan mode simplified interviewPhase 0
2
literature_strategist_agent
Search strategy design, source screening, annotated bibliography, literature matrixPhase 1
3
structure_architect_agent
Paper structure selection, detailed outline, word count allocation, evidence mappingPhase 2
4
argument_builder_agent
Argument construction, claim-evidence chains, logical flow, counter-argument handling; Plan mode argument stress testPhase 3 / Plan Step 3
5
draft_writer_agent
Section-by-section full draft writing, discipline register adjustment, word count trackingPhase 4
6
citation_compliance_agent
Citation format verification, reference list completeness, DOI checkingPhase 5a
7
abstract_bilingual_agent
Bilingual abstract (zh-TW + EN), 5-7 keywords eachPhase 5b
8
peer_reviewer_agent
Simulated double-blind review, five-dimension scoring, 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 extractionPlan 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 integrationPhase 4 / Phase 7
12
revision_coach_agent
Parse unstructured reviewer comments into structured Revision Roadmap; classify, map, and prioritize comments; works standalone without prior pipeline executionRevision-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)

Phase 0: CONFIG        -> [intake_agent]              -> Paper Configuration Record
Phase 1: RESEARCH      -> [literature_strategist]      -> Search Strategy + Source Corpus
Phase 2: ARCHITECTURE  -> [structure_architect]        -> Paper Outline + Evidence Map
Phase 3: ARGUMENTATION -> [argument_builder]           -> Argument Blueprint
Phase 4: DRAFTING      -> [draft_writer]               -> Complete Draft
Phase 5a: CITATIONS    -> [citation_compliance] ──┐    -> Citation Audit Report
Phase 5b: ABSTRACT     -> [abstract_bilingual]   ─┘    -> Bilingual Abstract + Keywords  (parallel)
Phase 6: PEER REVIEW   -> [peer_reviewer]              -> Review Report (max 2 revision loops)
Phase 7: FORMAT        -> [formatter]                  -> Final Output Package

See

references/workflow_phase_details.md
for detailed per-phase agent behavior and output descriptions.

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
.

Operational Modes (10 Modes)

See

references/mode_selection_guide.md
for details.

ModeTriggerAgentsOutput
full
"Write a paper"All 9 (+ 11 if quantitative)Complete paper draft (with figures if applicable)
outline-only
"Paper outline"1->2->3Detailed outline + evidence map
revision
"Revise paper"8->5->6Revised draft with tracked changes (uses
templates/revision_tracking_template.md
)
abstract-only
"Write abstract"1->7Bilingual abstract + keywords
lit-review
"Literature review"1->2Annotated bibliography + synthesis
format-convert
"Convert to LaTeX" / "Convert citations to [format]"9 onlyFormatted document; includes citation format conversion (APA 7 / Chicago / MLA / IEEE / Vancouver)
citation-check
"Check citations"6 onlyCitation error report
plan
"guide my paper" / "help me plan my paper"1->10->3->4Chapter Plan + INSIGHT Collection
revision-coach
"parse reviews" / "revision roadmap" / "I got reviewer comments"12 onlyRevision Roadmap + optional Tracking Template + Response Letter Skeleton
disclosure
(v3.2)
"AI disclosure for Nature" / "generate AI usage statement"9 onlyVenue-specific AI-usage disclosure paragraph(s) + placement instructions

Quick Mode Selection Guide

Your SituationRecommended ModeSpectrum
Starting from scratch with a clear RQ
full
balanced
Need help planning before writing
plan
originality
Just need an outline
outline-only
balanced
Have a draft, received review feedback
revision
fidelity
Have unstructured reviewer comments
revision-coach
balanced
Just need an abstract
abstract-only
fidelity
Need to check/fix citations
citation-check
fidelity
Need to convert format (LaTeX, DOCX) or citation style
format-convert
fidelity
Want a systematic literature review paper
lit-review
fidelity
Need a venue-specific AI-usage disclosure statement for submission
disclosure
fidelity

Spectrum (v3.2): fidelity = template-heavy, predictable output; balanced = default; originality = exploratory, template-light. See

shared/mode_spectrum.md
for the full cross-skill spectrum table.

Not sure? Start with

plan
— it will guide you step by step.
disclosure
is a finishing step — run it after the paper is drafted, targeting the venue you plan to submit to.

Mode Selection Logic

See

references/mode_selection_guide.md
for trigger-to-mode mappings and the full selection flowchart.


Plan Mode: Chapter-by-Chapter Guided Planning

Socratic mode that guides users through paper planning one chapter at a time. Builds a complete Paper Blueprint through structured dialogue.

See

references/plan_mode_protocol.md
for the full chapter-by-chapter dialogue flow and Paper Blueprint structure.


Handoff Protocol: deep-research -> academic-paper

intake_agent
automatically detects deep-research materials (RQ Brief / Bibliography / Synthesis / INSIGHT Collection) and skips redundant steps. See
deep-research/SKILL.md
Handoff Protocol for the complete handoff material format.


Failure Paths

See

references/failure_paths.md
for details. Quick reference:

Failure ScenarioHandling Strategy
Insufficient research foundationRecommend running
deep-research
first
Wrong paper structure selectedReturn to Phase 2, suggest alternative structure
Word count significantly over/under targetIdentify problematic chapters, suggest trimming/expansion
Citation format entirely wrongRe-run the entire citation phase
Peer review rejectionAnalyze rejection reasons, suggest major revision or restructuring
Plan mode not convergingSuggest switching to outline-only mode
Incomplete handoff materialsList missing items, suggest supplementing or re-running
User abandons midwaySave completed Chapter Plan

Full Academic Pipeline

See

academic-pipeline/SKILL.md
for the complete workflow.


Phase 0: Configuration Interview

See

agents/intake_agent.md
for the complete field definitions of the Phase 0 configuration interview. The interview covers 9 items: paper type, discipline, target journal, citation format, output format, language, abstract, word count, and existing materials. Outputs a Paper Configuration Record, awaiting user confirmation.


File Structure

Agent definitions:

agents/{agent_name}.md
— one file per agent (12 total, matching Agent Team table above).

References (19 files in

references/
):

  • Citation:
    apa7_extended_guide
    ,
    apa7_chinese_citation_guide
    ,
    citation_format_switcher
  • Writing:
    academic_writing_style
    ,
    writing_quality_check
    ,
    writing_judgment_framework
  • Structure:
    paper_structure_patterns
    (6 types),
    abstract_writing_guide
  • Domain:
    hei_domain_glossary
    (bilingual),
    journal_submission_guide
    ,
    latex_template_reference
  • Process:
    failure_paths
    (12 scenarios),
    mode_selection_guide
    (10 modes),
    plan_mode_protocol
    ,
    workflow_phase_details
  • Ethics:
    credit_authorship_guide
    (CRediT 14 roles),
    funding_statement_guide
    ,
    statistical_visualization_standards
  • Disclosure (v3.2):
    disclosure_mode_protocol
    (venue-specific AI-usage statement generation),
    venue_disclosure_policies
    (v1 database: ICLR, NeurIPS, Nature, Science, ACL, EMNLP)
  • Also:
    deep-research/references/apa7_style_guide.md
    (base reference, extended here)

Templates (11 files in

templates/
):
imrad
,
literature_review
,
case_study
,
theoretical_paper
,
policy_brief
,
conference_paper
,
latex_article_template.tex
,
bilingual_abstract
,
credit_statement
,
funding_statement
,
revision_tracking
(4 status types).

Examples (5 files in

examples/
):
imrad_hei_example
,
literature_review_example
,
plan_mode_guided_writing
,
chinese_paper_example
,
revision_mode_example
.


Anti-Patterns

Explicit prohibitions to prevent common failure modes:

#Anti-PatternWhy It FailsCorrect Behavior
1AI-typical overused terms"delve into", "crucial", "it is important to note" = instant AI detectionUse discipline-specific vocabulary; see
references/writing_quality_check.md
2Em dash abuseMore than 2 em dashes per page signals AI writingUse parentheses, commas, or restructure the sentence
3Throat-clearing openers"In this section, we will discuss..." adds no informationStart with the claim or finding directly
4Uniform paragraph lengthsEvery paragraph is 4-5 sentences = monotonous AI rhythmVary paragraph length naturally (2-8 sentences)
5⚠️ IRON RULE: Fabricated citationsInventing plausible-sounding references that don't existEvery citation must be verified via DOI or WebSearch; see
academic-pipeline/agents/integrity_verification_agent.md
6Sycophantic revisionAccepting all reviewer feedback without critical evaluationUse REVIEWER_DISAGREE status when reviewer is wrong; justify with evidence
7Scope creep during revisionAdding unrequested sections/analyses to "improve" the paperRevision addresses reviewer concerns only; new content requires explicit user approval
8Ignoring failure pathsContinuing despite desk-reject signals or fatal methodology flawsCheck
references/failure_paths.md
; invoke F11 Desk-Reject Recovery when triggered

Quality Standards

Writing Quality

  1. Every claim must have a citation or be supported by the paper's own data
  2. Zero citation orphans — in-text citations <-> reference list must perfectly match
  3. Consistent register — academic tone appropriate for the discipline
  4. Logical flow — clear transitions between paragraphs and sections
  5. Word count compliance — within +/-10% of target

Bilingual Abstract Quality

  1. Independent writing — zh-TW and EN abstracts are independently composed, NOT mechanical translations
  2. Structural alignment — both abstracts cover the same key points in the same order
  3. Keywords — 5-7 per language, reflecting the paper's core concepts
  4. Word count — EN: 150-300 words; zh-TW: 300-500 characters

Citation Quality

  1. Format compliance — 100% adherence to selected citation style
  2. ⚠️ IRON RULE: DOI inclusion — every source with a DOI must include it; every citation must be verified via DOI or WebSearch
  3. Currency — flag sources older than 10 years (unless seminal works)
  4. Self-citation ratio — flag if >15%

Peer Review

  1. Five dimensions — Originality (20%), Methodological Rigor (25%), Evidence Sufficiency (25%), Argument Coherence (15%), Writing Quality (15%)
  2. Actionable feedback — every criticism must include a specific suggestion
  3. Max 2 revision rounds — unresolved items become Acknowledged Limitations

Mandatory Inclusions

⚠️ IRON RULE: Every paper MUST include: Data Availability Statement, Ethics Declaration, Author Contributions (CRediT), Conflict of Interest Statement, Funding Acknowledgment. 17. AI disclosure statement — every paper must include a statement on AI tool usage 18. Limitations section — explicitly discuss study limitations 19. Ethics statement — when applicable (human subjects, sensitive data)


Output Language

Follows the user's language. Academic terminology is kept in English. Bilingual abstracts are always provided regardless of the main text language.


Integration with Other Skills

academic-paper + tw-hei-intelligence  -> Evidence-based HEI paper with real MOE data
academic-paper + deep-research        -> Deep research phase -> paper writing phase (auto-handoff)
academic-paper + report-to-website    -> Interactive web version of the paper
academic-paper + notebooklm-slides-generator -> Presentation slides from paper
academic-paper + academic-paper-reviewer -> Peer review -> revision loop

Version Info

ItemContent
Skill Version3.1.0
Last Updated2026-04-20
MaintainerCheng-I Wu
Dependent Skillsdeep-research v1.0+ (upstream), academic-paper-reviewer v1.0+ (downstream)

Version History

See

references/changelog.md
for full version history.