How do I install academic-writing-skills?

Run these in Claude Code: . Then prompt normally.

Does academic-writing-skills auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is academic-writing-skills free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Writing

Plugin

academic-writing-skills

This collection of skills grew out of my day-to-day paper-writing workflow and has been iteratively refined over time. It may still have shortcomings or rough edges; if needed, please fork it and adapt it yourself.

FLOW.md

bahayonghang@bahayonghang

GitHub

Plugin Signal77/100Solid

maintained99

capable62

documented75

adopted56

Stats

Python JavaScript Node Bash Markdown

+5 tags

LaTeX Anthropic OpenAI Gemini Slack

422

Stars

Forks

Active

Maintenance

Python

Language

7d ago

Last commit

7mo ago

Created

Repo: bahayonghang/academic-writing-skills

What's inside

Agent(19 agents)

claims_evidence_reviewer_agentAudit whether the claims in a cover letter are supported by visible evidence in the corresponding LaTeX manuscript.committee_editor_agentYou are an editor at the target journal screening a cover letter before deciding whether to send the manuscript to reviewers. You read the cover letter first; the manuscript is available for cross-reference but you do not read it line-by-line in this pass.committee_literature_agentYou audit whether the literature review actually constructs a research gap and honest novelty positioning. You are good at detecting pseudo-innovation and straw-man framing.committee_logic_agentYou do not care about the domain. You only care whether the argument is logically self-consistent. You audit paragraph-to-paragraph coherence, claim-evidence binding, and causal direction.committee_methodology_agentYou are a methodology reviewer with "pixel-level" transparency standards. Your job is to diagnose whether the paper's methods section is reproducible and defensible.committee_theory_agentYou are a top-venue theory reviewer. You care about conceptual clarity and genuine theory dialogue. You dislike papers that only describe phenomena or name-drop theories without building on them.

README

Read on GitHub

Academic Writing Skills for Claude Code

中文版

I have recently been writing my dissertation, so I will keep improving latex-thesis-zh based on actual usage. Note: paper-audit review reports are for reference only; please verify and evaluate them yourself.

Post-writing polish and validation for academic papers: format checks, bibliography search and verification, grammar analysis, de-AI editing, and experiment narrative review. Focused on improving existing drafts, not writing papers from scratch.

Recommended models: Claude Opus 4.6/fable5 · GPT 5.6 Sol Max/Xhigh · Gemini 3.1 PRO

Recommended platforms: Claude Code · Codex

Install

Install the repository with skills:

npx skills add bahayonghang/academic-writing-skills

Then open Claude Code or Codex in your manuscript project and ask for the task in natural language. The root README is only a routing guide; the authoritative usage details live in each SKILL.md file and in the docs site.

Choose A Skill

Skill	Use When	Main Inputs	Source Of Truth
`cover-letter`	Generate, optimize, align-check, preflight, or journal-fit-check a submission cover letter against an existing LaTeX manuscript.	`.tex`, optional `.md` or `.tex` letter draft	`cover-letter/SKILL.md`
`paper-audit`	Run reviewer-style critique, submission gates, blocker triage, revision roadmaps, journal-style reports, or re-audits.	`.tex`, `.typ`, `.pdf`	`paper-audit/SKILL.md`
`latex-paper-en`	Work on existing English LaTeX conference or journal papers: compile, formatting, grammar, logic, sections, references, figures, tables, pseudocode, title, translation, or de-AI polish.	`.tex`	`latex-paper-en/SKILL.md`
`latex-thesis-zh`	Work on existing Chinese LaTeX theses: compile diagnostics, GB/T 7714 references, university templates, chapter structure, terminology, logic, abstracts, titles, tables, and de-AI polish.	`.tex`	`latex-thesis-zh/SKILL.md`
`typst-paper`	Work on existing English or Chinese Typst manuscripts: compile/export diagnostics, venue formatting, references, grammar, logic, tables, pseudocode, title, translation, or de-AI polish.	`.typ`	`typst-paper/SKILL.md`
`bib-search-citation`	Search, filter, preview, export, or create LaTeX/Typst citation snippets from a local BibTeX or BibLaTeX library.	`.bib`	`bib-search-citation/SKILL.md`

Use the format-specific writing skills when you want source edits or polish. Use paper-audit when you want reviewer-style diagnosis without rewriting the source. Use bib-search-citation when the target is the bibliography library itself.

Typical Prompts

Compile my English LaTeX paper with latexmk and explain the first blocking error.

Check the introduction for logic gaps, citation stacking, and AI-like phrasing.

Run a paper-audit gate on main.tex and separate blockers from polish issues.

Search references.bib for recent Mamba forecasting papers with code and return LaTeX and Typst citation snippets.

Align-check this cover letter against main.tex and report unsupported claims only.

Safety And Outputs

The skills are for improving and validating existing academic material. They should not invent experiments, citations, policies, or unsupported claims.
Citation keys, DOI, arXiv IDs, URLs, and local .bib matches are provenance fields, not proof that a paper supports a manuscript claim.
Online checks are optional. When current venue rules or external metadata matter, verify them from the original source before treating them as binding.
Source-editing suggestions should preserve LaTeX and Typst syntax and mark required evidence as pending instead of filling it in.
Audit and helper-script outputs may be JSON, Markdown reports, or diff-comment style findings with severity and priority.

Example finding shape:

% <MODULE> (Line <N>) [Severity: Critical|Major|Minor] [Priority: P0|P1|P2]: <Issue summary>
% Before: <original text>
% After:  <suggested text>
% Rationale: <brief explanation>
% [PENDING VERIFICATION]: <if evidence or metrics are required>

Requirements

Python 3.10+
uv for running the bundled Python helpers
TeX Live or MiKTeX with latexmk and chktex for LaTeX workflows
XeLaTeX plus CJK fonts for Chinese LaTeX documents
Typst CLI for Typst workflows
pdfplumber for PDF-oriented audit workflows
Node.js and npm or just only when building the docs site locally

Repository Layout

academic-writing-skills/
├── academic-writing-skills/
│   └── <skill>/
│       ├── SKILL.md          # Skill entrypoint, triggers, routing, contracts
│       ├── scripts/          # Optional executable helpers
│       ├── references/       # Optional source-of-truth guidance
│       ├── examples/         # Optional example prompts or workflows
│       ├── templates/        # Optional output templates
│       ├── evals/            # Optional evaluation cases
│       └── agents/           # Optional agent metadata
├── docs/                     # Documentation site
├── tests/                    # Pytest coverage for contracts and helpers
├── ref/                      # Supporting reference repositories or material
├── .trellis/                 # Project workflow and guidance
├── README.md
└── README_CN.md

Do not rely on the root README for module internals. Open the relevant SKILL.md, references/, and docs page when a workflow needs exact routing, flags, or output contracts.

Documentation

Full documentation is in docs/ and docs/zh/.

Run locally:

just docs

Build the static site:

just doc-build

Contributing

Issues and pull requests are welcome. Keep changes scoped to the relevant skill, update tests or docs when behavior changes, and run just ci before submitting when feasible.

License

Academic Use Only — Not for commercial use.

File tree

bahayonghang/academic-writing-skillsView on GitHub

.gitattributes
.github/
  copilot-instructions.md
  workflows/
    deploy.yml
.gitignore
.python-version
.trellis/
  .gitignore
  .template-hashes.json
  .version
  agents/
    check.md
    implement.md
  config.yaml
  scripts/
    __init__.py
    add_session.py
    common/
      __init__.py
      active_task.py
      cli_adapter.py
      config.py
      developer.py
      git_context.py
      git.py
      io.py
      log.py
      packages_context.py
      paths.py
      safe_commit.py
      session_context.py
      task_context.py
      task_queue.py
      task_store.py
      task_utils.py
      tasks.py
      trellis_config.py
      types.py
      workflow_phase.py
    get_context.py
    get_developer.py
    hooks/
      linear_sync.py
    init_developer.py
    task.py
  spec/
    academic-writing-skills/
      cover-letter-contracts.md
      defensive-ai-rhetoric-contract.md
      docs-bilingual-resources.md
      index.md
      paper-audit-boundary-contracts.md
      polish-rewrite-contract.md
      spec-checklist-convention.md
      testing-and-tooling.md
    claude-scholar/
      backend/
        database-guidelines.md
        directory-structure.md
        error-handling.md
        index.md
        logging-guidelines.md
        quality-guidelines.md
      frontend/
        component-guidelines.md
        directory-structure.md
        hook-guidelines.md
        index.md
        quality-guidelines.md
        state-management.md
        type-safety.md
    guides/
      code-reuse-thinking-guide.md
      cross-layer-thinking-guide.md
      index.md
    PaperSpine/
      backend/
        database-guidelines.md
        directory-structure.md
        error-handling.md
        index.md
        logging-guidelines.md
        quality-guidelines.md
      frontend/
        component-guidelines.md
        directory-structure.md
        hook-guidelines.md
        index.md
        quality-guidelines.md
        state-management.md
        type-safety.md
    Research-Paper-Writing-Skills/
      backend/
        database-guidelines.md
        directory-structure.md
        error-handling.md
        index.md
        logging-guidelines.md
        quality-guidelines.md
      frontend/
        component-guidelines.md
        directory-structure.md
        hook-guidelines.md
        index.md
        quality-guidelines.md
        state-management.md
        type-safety.md
  tasks/
    archive/
      2026-06/
        00-bootstrap-guidelines/
          prd.md
          task.json
        06-05-paper-section-reference-integration/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-07-academic-writing-skill-supplement/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-07-latex-paper-en-writing-supplement/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-07-latex-thesis-zh-writing-supplement/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-12-five-skills-optimization/
          check.jsonl
          implement.jsonl
          prd.md
          research/
            bib-search-citation-audit.md
            cover-letter-audit.md
            cover-letter-policy-research.md
            latex-paper-en-audit.md
            latex-paper-en-venue-factcheck.md
            paper-audit-audit.md
            typst-paper-audit.md
          task.json
        06-12-latex-thesis-zh-chapter-intro/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-12-latex-thesis-zh-optimization/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-12-zh-checker-precision/
          check.jsonl
          design.md
          implement.jsonl
          prd.md
          task.json
        06-12-zh-fixtures-evals/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-12-zh-gb7714-validation/
          check.jsonl
          design.md
          implement.jsonl
          prd.md
          task.json
        06-12-zh-parsers-multifile/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-12-zh-router-cli-alignment/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-12-zh-template-knowledge/
          check.jsonl
          design.md
          implement.jsonl
          prd.md
          task.json
        06-13-bib-robustness/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-13-cover-letter-compliance/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-13-en-family-parsers/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-13-en-paper-precision/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-13-paper-audit-integrity/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-13-typst-reality/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-14-latex-thesis-zh-heading-structure-optimization/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          research/
            current-skill-gap.md
            reference-thesis-toc-patterns.md
            skill-creator-eval-notes.md
          task.json
        06-15-optimize-latex-thesis-zh-formulas/
          check.jsonl
          check.md
          design.md
          implement.jsonl
          implement.md
          prd.md
          research/
            formula-layout-standards.md
          task.json
        06-18-latex-thesis-zh-chapter-summary-guidance/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          research/
            chapter-summary-guidance.md
          task.json
        06-20-06-20-borrow-writing-judgment-assets/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        06-20-06-20-six-skills-deep-review/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        06-20-tense-reviewer-overclaim/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
      2026-07/
        07-05-academic-deai-humanization/
          check.jsonl
          check.md
          design.md
          implement.jsonl
          implement.md
          prd.md
          research.md
          task.json
        07-05-cover-letter-bib-fixes/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-05-cover-letter-deai-enhancement/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        07-05-deai-alignment-lock/
          check.jsonl
          implement.jsonl
          prd.md
          research/
            probe_alignment.py
            probe_classify_out.txt
            probe_classify.py
            probe_diffs.py
          task.json
        07-05-docs-metadata-consistency/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-05-paper-audit-scoring-fixes/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-05-skills-deep-analysis-optimization/
          check.jsonl
          implement.jsonl
          prd.md
          research/
            bib-cover-findings.md
            crosscut-findings.md
            en-typst-findings.md
            paper-audit-findings.md
            zh-findings.md
          task.json
        07-05-typst-deai-sync/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-05-zh-abstract-tense-gating/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-07-reorganize-tests-structure/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        07-08-blind-review/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        07-08-spec-check-blind-review/
          check.jsonl
          implement.jsonl
          prd.md
          research/
            yanshan-2024-spec-extracted.txt
          task.json
        07-08-spec-final-check/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        07-08-template-checklists/
          check.jsonl
          implement.jsonl
          implement.md
          prd.md
          research/
            baseline-detect-template.json
            baseline-yanshan-checkspec.json
            gbt7713-generic-items.md
            missing-evidence.md
            pku-grad-spec.md
            thuthesis-manual-facts.md
            tsinghua-grad-spec.md
          task.json
        07-09-skill-md-token-slimming/
          check.jsonl
          implement.jsonl
          prd.md
          task.json
        07-10-thesis-zh-intro-optimization/
          check.jsonl
          design.md
          implement.jsonl
          implement.md
          prd.md
          task.json
        07-11-thesis-zh-process-chapter/
          check.jsonl
          design.md
          implement.jsonl
... 1457 more

FAQ

academic-writing-skills is a Claude Code plugin with hand-picked skills for writing work, indexed on Flowy. Install it with the command on its page. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is academic-writing-skills?: This collection of skills grew out of my day-to-day paper-writing workflow and has been iteratively refined over time. It may still have shortcomings or rough edges; if needed, please fork it and adapt it yourself.
How do I install academic-writing-skills?: Run these in Claude Code: . Then prompt normally.
Does academic-writing-skills auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is academic-writing-skills free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.