# typst-paper

A skill for working on existing Typst manuscripts. Diagnoses builds, checks bibliographies, cleans grammar and AI traces in English and Chinese papers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 installs · ★ 519
- Author: bahayonghang
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bahayonghang/academic-writing-skills/tree/HEAD/academic-writing-skills/typst-paper/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/typst-paper

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/typst-paper/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/typst-paper/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/typst-paper/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/typst-paper/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bahayonghang/academic-writing-skills typst-paper
```

2. **Manually: put the files in place**
- File: `.github/skills/typst-paper/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bahayonghang/academic-writing-skills --path academic-writing-skills/typst-paper
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/typst-paper/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bahayonghang/academic-writing-skills --skill typst-paper -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bahayonghang/academic-writing-skills/tree/HEAD/academic-writing-skills/typst-paper/SKILL.md

## When to use it
- 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
- 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

## Similar
- [typst](https://affpapa.org/en/nevibecode/skills/typst.md) — skill · 2000 installs
- [nature-polishing](https://affpapa.org/en/nevibecode/skills/nature-polishing.md) — skill · 17500 installs
- [paper-polish](https://affpapa.org/en/nevibecode/skills/paper-polish.md) — skill · 532 installs
- [academic-paper](https://affpapa.org/en/nevibecode/skills/academic-paper.md) — skill · 10800 installs
- [paper-writing-section](https://affpapa.org/en/nevibecode/skills/paper-writing-section.md) — skill · 1800 installs
- [academic-paper-writer](https://affpapa.org/en/nevibecode/skills/academic-paper-writer.md) — skill · 519 installs

From the same set: [bahayonghang/academic-writing-skills](https://affpapa.org/en/nevibecode/by/bahayonghang/academic-writing-skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md