Typst Skill
claude-skill-typst
A Typst 0.15 skill covering tables, equations, templates and packages, with two verification subagents and API search
- 139 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent runs `typst compile` and writes PDF, PNG and HTML files into the working folder
Install
- Works in
Manual install
npx skills add https://github.com/lucifer1004/claude-skill-typstUniversal install through skills.sh.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent runs `typst compile` and writes PDF, PNG and HTML files into the working folder
This is third-party code. Review the repository files before installing.
What it does
The skill teaches an agent to write and fix documents in Typst, a typesetting system with its own markup and scripting language. The main `SKILL.md` is the entry point with a quick reference, and topics are split into separate files: language basics and data types, page and font styling, tables, academic papers with bibliography and theorems, conversion from Markdown and LaTeX, templates and package development. The `agents/` folder holds two subagents. `typst-verify` checks the build result and `typst-package-qa` checks packages. The skill suggests three ways to verify a document: an HTML export, a PNG image for visual comparison, and text through `pdftotext`. The repository also has a search over Typst packages and the API through `just search-pkg` and `just search-api`, including lookups by LaTeX names. The main branch targets Typst 0.15, and for 0.14.2 the author kept the `typst-0.14.2` tag.
Who it is for. Authors of papers, reports and templates who are moving from LaTeX to Typst and ask an agent to build the documents.
Good fit when
- A Markdown or LaTeX draft has to become a `.typ` file that is confirmed to compile
- A table with merged cells and borders comes out crooked, and the agent needs the grid rules
- A paper needs a bibliography, theorems and numbered equations in one document
- You are writing your own Typst package with tests and publishing, and want it checked against a checklist
- An old template stopped building after moving to Typst 0.15
Not a fit when
- The document stays on LaTeX: the skill is entirely about Typst and does not cover LaTeX
- You need edits in Word or Google Docs: Typst builds files from sources into PDF, PNG and HTML
- The machine runs Typst 0.14.2: use the `typst-0.14.2` tag, because the main branch targets 0.15
Example request
Convert my `draft.md` to Typst with a table of contents and a three-column table, build the PDF and show the first page as an imageLimitations
The skill is built for Typst 0.15 and newer, and for 0.14.2 the author keeps a separate tag. Building needs the Typst CLI installed, and checking text from a PDF needs the `pdftotext` utility. The `just` recipes for package and API search are meant for the skill's developers and need `just` and `pixi`, so an ordinary user can skip them. The skill activates on its own when working with `.typ` files or mentioning Typst, and reference files load by topic, so long topics take part of the agent's context.
How to disable. Delete the `~/.claude/skills/typst` folder or remove the skill with the manager you installed it with. Your `.typ` files and built documents stay untouched.
FAQ
How do I install the Typst skill in Claude Code?
Run `npx skills add https://github.com/lucifer1004/claude-skill-typst`. Without a manager, clone the repository into `~/.claude/skills/typst`.
Which Typst version is required?
The main branch targets Typst 0.15 and newer. For 0.14.2 switch to the `typst-0.14.2` tag.
How does the agent check that the document built correctly?
It exports HTML to read the text, renders PNG for a visual check and pulls text out of the PDF with `pdftotext`. The `debug.md` file and the `typst-verify` subagent cover this.
Can the skill convert LaTeX to Typst?
Yes, the `conversion.md` file covers rules for converting Markdown and LaTeX to Typst. The Typst API search also understands familiar LaTeX names such as `rightarrow`.
Do I install the Typst CLI separately?
Yes, the skill does not contain the compiler: building needs the Typst CLI version 0.15 or newer, and checking text from a PDF needs `pdftotext`.
Discussion
No questions or reviews yet.
Related
SkillsTwo agent skills for writing Typst documents and Touying slides from a local copy of the docs instead of the model's memory
Eight skills for finished papers and theses in LaTeX and Typst: compile, references, language polish, cover letters and a reviewer-style audit
Eight skills for LaTeX research papers, from topic to compiled PDF, with verified BibTeX citations and gated steps
16 ready skills for Cursor, Claude Code and Codex: theses, PDF and Office, draw.io diagrams, project documentation
A Claude Code skill: describe a document in plain words and get a compiled LaTeX PDF. Templates, build scripts and OCR of PDFs and handwritten notes
A Claude Code skill for research papers: a five-stage pipeline, section rules, a style audit and an independent red-team review.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Typst Skill (this card) | no | 139 | ||
| LaTeX Document Skill | no | 828 | a skill for LaTeX documents, while this one covers Typst with build checks by subagents | |
| mcp-pandoc | no | not required | 587 | a Pandoc MCP server for format conversion, while this one holds Typst typesetting rules |
README in short
The README opens with a one-line install and a manual copy, shows a minimal document build and a table of skill files with their audience: user, developer or both. It then describes package and API search, `just` commands for development, activation conditions and version requirements.
README badge
Original SKILL.md
---
name: typst
description: 'Typst document creation and package development. Use when: (1) Working with .typ files, (2) User mentions typst, typst.toml, or typst-cli, (3) Creating or using Typst packages, (4) Developing document templates, (5) Converting Markdown/LaTeX to Typst'
---
# Typst
This skill targets Typst 0.15+. For Typst 0.14.2, use the `typst-0.14.2`
repository tag for the previous skill snapshot.
## Compilation
```bash
typst compile document.typ # compile once → PDF
typst compile document.typ output.pdf # explicit output path
typst compile document.typ -f png # export as PNG image
typst compile src/main.typ --root . # set project root for /path imports
typst watch document.typ # recompile on change
typst eval --in document.typ 'query(heading).len()' # Typst 0.15+ introspection
```
For command options beyond this quick reference, see [cli.md](cli.md).
Agent verification — choose by what you need to check (see [debug.md](debug.md) for details):
| Method | Command | Best for |
| ----------- | ----------------------------------------------------------------------- | ----------------------------------------- |
| HTML export | `typst compile doc.typ /dev/stdout -f html --features html 2>/dev/null` | Text content, structure, headings, tables |
| PNG export | `typst compile doc.typ page-{p}.png -f png` | Visual layout, alignment, spacing, fonts |
| pdftotext | `typst compile doc.typ && pdftotext doc.pdf -` | Fallback for page-specific content |
## Minimal Document
```typst
#set page(paper: "a4", margin: 2cm)
#set text(size: 11pt)
= Title
Content goes here.
```
## Writing Documents
**Starting a new document?** Copy the closest recipe from [Examples](#examples) below — it's faster than starting blank and each row names the docs to read next.