$npx -y skills add bahayonghang/academic-writing-skills --skill typst-paperTypst paper assistant for existing .typ manuscripts in English or Chinese. Use for compile/export diagnosis, venue formatting, BibTeX/Hayagriva checks, grammar, logic, abstract/title, tables, pseudocode, related work, research-gap framing, adaptation, de-AI polish, translation, a
| 1 | # Typst Academic Paper Assistant |
| 2 | |
| 3 | Use this skill for targeted work on an existing Typst paper project. Route requests to the smallest useful module and keep outputs compatible with Typst source review. |
| 4 | |
| 5 | ## Capability Summary |
| 6 | |
| 7 | - Compile Typst projects and diagnose Typst CLI issues; validate BibTeX and Hayagriva bibliographies. |
| 8 | - Audit format, grammar, sentences, logic, expression, tables, cross-references, abstracts, and AI traces. |
| 9 | - Diagnose and rewrite-plan literature review sections (theme clustering -> comparison -> gap derivation). |
| 10 | - Review IEEE-like pseudocode blocks (`algorithmic`, `algorithm-figure`, `lovelace`, captions, comment length). |
| 11 | - Improve titles, translation, and experiment-section clarity for Typst papers. |
| 12 | |
| 13 | ## Triggering |
| 14 | |
| 15 | Use this skill when the user has an existing `.typ` paper project and wants: compile/export fixes, venue/format compliance, BibTeX/Hayagriva validation, grammar/sentence/logic/expression review, related-work or research-gap restructuring, translation or bilingual polishing, title optimization, pseudocode review, de-AI editing, or experiment-section review. Full scenario list: `references/skill-routing-notes.md`. |
| 16 | |
| 17 | ## Do Not Use |
| 18 | |
| 19 | Not for: LaTeX-first projects; DOCX/PDF-only editing without Typst source; thesis template detection or GB/T 7714 thesis workflows; from-scratch paper planning or literature research; multi-perspective review/scoring/gate decisions (use `paper-audit`); standalone pseudocode drafting without a paper context. |
| 20 | |
| 21 | ## Module Router |
| 22 | |
| 23 | > `$SKILL_DIR` is this skill's install directory (e.g. `~/.claude/skills/typst-paper`); |
| 24 | > substitute it (and the input file name) when running a command. All commands |
| 25 | > are run with `uv run python` from the user's project directory. |
| 26 | |
| 27 | | Module | Use when | Primary command | Read next | |
| 28 | | -------------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------ | |
| 29 | | `compile` | Typst build, export, font, or watch issues | `uv run python $SKILL_DIR/scripts/compile.py main.typ` | `references/modules/COMPILE.md` | |
| 30 | | `format` | Venue/layout review for a Typst paper | `uv run python $SKILL_DIR/scripts/check_format.py main.typ` | `references/modules/FORMAT.md` | |
| 31 | | `bibliography` | BibTeX or Hayagriva validation | `uv run python $SKILL_DIR/scripts/verify_bib.py references.bib --typ main.typ` | `references/modules/BIBLIOGRAPHY.md` | |
| 32 | | `grammar` | Grammar cleanup on Typst prose | `uv run python $SKILL_DIR/scripts/analyze_grammar.py main.typ --section introduction` | `references/modules/GRAMMAR.md` | |
| 33 | | `sentences` | Long or dense sentence diagnostics | `uv run python $SKILL_DIR/scripts/analyze_sentences.py main.typ --section introduction` | `references/modules/SENTENCES.md` | |
| 34 | | `logic` | Argument flow, funnel, closure, abstract/conclusion alignment | `uv run python $SKILL_DIR/scripts/analyze_logic.py main.typ --section methods` | `references/modules/LOGIC.md` | |
| 35 | | `literature` | Related Work is list-like, under-compared, or missing a gap | `uv run python $SKILL_DIR/scripts/analyze_literature.py main.typ --section related` | `references/modules/LITERATURE.md` | |
| 36 | | `expression` | Tone and expression polishing | `uv run python $SKILL_DIR/scripts/improve_expression.py main.typ --section methods` | `references/modul |