{
  "markdown": "# Academic Writing Skills for Claude Code\n\n[中文版](README_CN.md)\n\nThis collection of skills grew out of my day-to-day paper-writing workflow and\nhas been iteratively refined over time. It may still have shortcomings or rough\nedges; if needed, please fork it and adapt it yourself.\n\n> I have recently been writing my dissertation, so I will keep improving\n> `latex-thesis-zh` based on actual usage.\n> Note: `paper-audit` review reports are for reference only; please verify and\n> evaluate them yourself.\n>\n> Post-writing polish and validation for academic papers: format checks,\n> bibliography search and verification, grammar analysis, de-AI editing, and\n> experiment narrative review. Focused on improving existing drafts, not writing\n> papers from scratch.\n>\n> Recommended models: **Claude Opus 4.6/fable5 · GPT 5.6 Sol Max/Xhigh · Gemini 3.1 PRO**\n>\n>\n> Recommended platforms: **Claude Code · Codex**\n\n## Install\n\nInstall the repository with skills:\n\n```bash\nnpx skills add bahayonghang/academic-writing-skills\n```\n\nThen open Claude Code or Codex in your manuscript project and ask for the task in\nnatural language. The root README is only a routing guide; the authoritative\nusage details live in each `SKILL.md` file and in the docs site.\n\n## Choose A Skill\n\n\n| Skill                                                                         | Use When                                                                                                                                                                                    | Main Inputs                                   | Source Of Truth                |\n| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------ |\n| [`cover-letter`](academic-writing-skills/cover-letter/SKILL.md)               | 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`        |\n| [`paper-audit`](academic-writing-skills/paper-audit/SKILL.md)                 | Run reviewer-style critique, submission gates, blocker triage, revision roadmaps, journal-style reports, or re-audits.                                                                      | `.tex`, `.typ`, `.pdf`                        | `paper-audit/SKILL.md`         |\n| [`latex-paper-en`](academic-writing-skills/latex-paper-en/SKILL.md)           | 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`      |\n| [`latex-thesis-zh`](academic-writing-skills/latex-thesis-zh/SKILL.md)         | Work on existing Chinese LaTeX theses: compile diagnostics, GB/T 7714 references, chapter structure, bilingual captions and rendered figure/table layout, evidence-faithful abstracts, summaries, literature synthesis, engineering-application chapters, results analysis, Chinese inter-sentence expression, and de-AI polish. | `.tex`                                        | `latex-thesis-zh/SKILL.md`     |\n| [`typst-paper`](academic-writing-skills/typst-paper/SKILL.md)                 | 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`         |\n| [`bib-search-citation`](academic-writing-skills/bib-search-citation/SKILL.md) | Search, filter, preview, export, or create LaTeX/Typst citation snippets from a local BibTeX or BibLaTeX library.                                                                           | `.bib`                                        | `bib-search-citation/SKILL.md` |\n\n\nUse the format-specific writing skills when you want source edits or polish. Use\n`paper-audit` when you want reviewer-style diagnosis without rewriting the\nsource. Use `bib-search-citation` when the target is the bibliography library\nitself.\n\n## Typical Prompts\n\n```text\nCompile my English LaTeX paper with latexmk and explain the first blocking error.\n```\n\n```text\nCheck the introduction for logic gaps, citation stacking, and AI-like phrasing.\n```\n\n```text\nRun a paper-audit gate on main.tex and separate blockers from polish issues.\n```\n\n```text\nSearch references.bib for recent Mamba forecasting papers with code and return LaTeX and Typst citation snippets.\n```\n\n```text\nAlign-check this cover letter against main.tex and report unsupported claims only.\n```\n\n## Safety And Outputs\n\n- The skills are for improving and validating existing academic material. They\nshould not invent experiments, citations, policies, or unsupported claims.\n- Citation keys, DOI, arXiv IDs, URLs, and local `.bib` matches are provenance\nfields, not proof that a paper supports a manuscript claim.\n- Online checks are optional. When current venue rules or external metadata\nmatter, verify them from the original source before treating them as binding.\n- Source-editing suggestions should preserve LaTeX and Typst syntax and mark\nrequired evidence as pending instead of filling it in.\n- Audit and helper-script outputs may be JSON, Markdown reports, or diff-comment\nstyle findings with severity and priority.\n\nExample finding shape:\n\n```latex\n% <MODULE> (Line <N>) [Severity: Critical|Major|Minor] [Priority: P0|P1|P2]: <Issue summary>\n% Before: <original text>\n% After:  <suggested text>\n% Rationale: <brief explanation>\n% [PENDING VERIFICATION]: <if evidence or metrics are required>\n```\n\n## Requirements\n\n- Python 3.10+\n- `uv` for running the bundled Python helpers\n- TeX Live or MiKTeX with `latexmk` and `chktex` for LaTeX workflows\n- XeLaTeX plus CJK fonts for Chinese LaTeX documents\n- Typst CLI for Typst workflows\n- `pdfplumber` for PDF-oriented audit workflows\n- Node.js and npm or `just` only when building the docs site locally\n\n## Repository Layout\n\n```text\nacademic-writing-skills/\n├── academic-writing-skills/\n│   └── <skill>/\n│       ├── SKILL.md          # Skill entrypoint, triggers, routing, contracts\n│       ├── scripts/          # Optional executable helpers\n│       ├── references/       # Optional source-of-truth guidance\n│       ├── examples/         # Optional example prompts or workflows\n│       ├── templates/        # Optional output templates\n│       ├── evals/            # Optional evaluation cases\n│       └── agents/           # Optional agent metadata\n├── docs/                     # Documentation site\n├── tests/                    # Pytest coverage for contracts and helpers\n├── ref/                      # Supporting reference repositories or material\n├── .trellis/                 # Project workflow and guidance\n├── README.md\n└── README_CN.md\n```\n\nDo not rely on the root README for module internals. Open the relevant\n`SKILL.md`, `references/`, and docs page when a workflow needs exact routing,\nflags, or output contracts.\n\n## Documentation\n\nFull documentation is in [`docs/`](docs/) and [`docs/zh/`](docs/zh/).\n\nRun locally:\n\n```bash\njust docs\n```\n\nBuild the static site:\n\n```bash\njust doc-build\n```\n\n## Contributing\n\nIssues and pull requests are welcome. Keep changes scoped to the relevant skill,\nupdate tests or docs when behavior changes, and run `just ci` before submitting\nwhen feasible.\n\n## License\n\nAcademic Use Only — Not for commercial use.\n",
  "bytes": 7798,
  "sha": "9f75b974f177ae70a6e7ab1c5228d869169b398d963a549bacb9b22b341e65cc",
  "repo_slug": "bahayonghang/academic-writing-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_bahayonghang_academic_writing_skills_bib_866c4ad0/readme"
}