typst-paper — Claude Code skill for editing Typst papers
A skill for working on existing Typst manuscripts. Diagnoses builds, checks bibliographies, cleans grammar and AI traces in English and Chinese papers.
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a claude-codeWhat typst-paper does
typst-paper takes an existing Typst project and routes the request to the smallest useful module: compile, format, bibliography, grammar, logic, tables, pseudocode. Each module is a Python script run with uv run python from the project directory. The scripts read .typ files and return a diagnosis, not a rewrite — the agent does the rewriting.
The skill handles English and Chinese, so it also covers translation between the two. Pseudocode review supports algorithmic, algorithm-figure and lovelace blocks; bibliography validation covers BibTeX and Hayagriva. Venue formatting is tagged for IEEE, ACM, Springer and NeurIPS.
There are limits. LaTeX-first projects are out of scope — .tex needs a different skill. It does not plan papers from scratch or do literature research, only edits what is already written. Scoring and gate decisions belong to paper-audit. You need uv and Python on the machine.
What it helps with
- diagnose a Typst compile error
- validate BibTeX and Hayagriva against the manuscript
- restructure related work from a list into comparison and gap
- strip AI traces from English or Chinese prose
- check cross-references and numbering
Example prompts for the agent
- check references.bib against main.typ
- run check_format.py on main.typ for IEEE
- the related work reads like a list — rebuild it around themes, comparison and gap
How to install typst-paper
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a claude-code2Manually: put the files in place
~/.claude/skills/typst-paper/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/typst-paper/
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a codex2Manually: put the files in place
.agents/skills/typst-paper/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a cursor2Manually: put the files in place
.cursor/skills/typst-paper/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install bahayonghang/academic-writing-skills typst-paper2Manually: put the files in place
.github/skills/typst-paper/SKILL.md1Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a gemini-cli2Platform CLI
gemini skills install https://github.com/bahayonghang/academic-writing-skills --path academic-writing-skills/typst-paperManually: put the files in place
.devin/skills/typst-paper/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about typst-paper
How do I install typst-paper in Claude Code?
Run npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a claude-code. The skill lands at ~/.claude/skills/typst-paper/SKILL.md.
What does typst-paper do?
Works on existing Typst manuscripts: build diagnosis, venue formatting, BibTeX and Hayagriva validation, grammar, logic, tables, pseudocode, abstracts, translation and de-AI editing. LaTeX projects are not supported.
What do I need to run the skill's scripts?
The scripts run via uv run python from the project directory, so you need uv and Python installed.
