typst
Skill136 starsChanged 2 months agoMITView on GitHub
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
- Installs packages
11 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- RKelln/hermes_skillstheir own version, first seen Nov 7, 2026
- sghng/abstracttheir own version, first seen Oct 15, 2026
- zavu1on/typst-poly-templatesedited, first seen Jul 29, 2026
- Hemalv02/claude-skillstheir own version, first seen Jul 16, 2026
- PedroEvangelis/curr-mvpedited, first seen Jun 2, 2026
- statzhero/typst-skilltheir own version, first seen Apr 30, 2026
Other versions11 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- PedroEvangelis/curr-mvp★ 196% same
- zavu1on/typst-poly-templates★ 195% same
Wrote their own version · 9
- statzhero/typst-skill★ 12same name
- akilrammohan/typst-skill★ 7same name
- clearsmog/claude-skills★ 2same name
- tcztzy/skills★ 2same name
- Hemalv02/claude-skills★ 1same name
- Mineru98/typst-skills★ 0same name
- mj-deving/pai-skills★ 0same name
- RKelln/hermes_skills★ 0same name
- sghng/abstract★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repositoryOne other file it gives its agents.
- CLAUDE.mdCLAUDE.md
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 11 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 74
Search the embedded index of Typst Universe packages (updated weekly):
- Distinctive: line 124
Search the embedded index of Typst API functions, methods, and constructors:
“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
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+ introspectionFor command options beyond this quick reference, see cli.md.
Agent verification — choose by what you need to check (see 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
#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 below — it's faster than starting blank and each row names the docs to read next.
| When you need to... | Read |
| Learn syntax, imports, functions, control flow | basics.md |
| Learn data types, operators, string/array methods | types.md |
| Style pages, headings, figures, layout | styling.md |
| Tables, grids, cell spans, borders, data tables | tables.md |
| Academic papers, bibliography, theorems, equations | academic.md |
| Convert from Markdown or LaTeX | conversion.md |
| Upgrade older Typst code, 0.15 breaking changes | migration.md |
| Use Typst CLI commands and build options | cli.md |
| Extract data from documents, multi-pass builds | query.md |
Developing Packages and Templates
| When you need to... | Read |
State, counters, in-document query(), XML | advanced.md |
| CLI introspection, metadata export, multi-pass | query.md |
| Create a reusable template function | template.md |
| Create or publish a package | package.md |
| Verify output (HTML/PNG/pdftotext, repr) | debug.md |
| Profile performance (--timings, hotspots) | perf.md |
basics.md and types.md are also the foundation for developers.
Finding Packages
Search the embedded index of Typst Universe packages (updated weekly):
python3 scripts/search-packages.py "what you need"
python3 scripts/search-packages.py "chart" --category visualization
python3 scripts/search-packages.py --category cv --top 5
python3 scripts/search-packages.py --list-categoriesCommon Errors
| Error | Cause | Fix |
| "unknown variable" | Undefined identifier | Check spelling, ensure #let before use |
| "expected X, found Y" | Type mismatch | Check function signature in docs |
| "file not found" | Bad import path | Paths resolve relative to current file |
| "unknown font" | Font not installed | Use system fonts or web-safe alternatives |
| "maximum function call depth exceeded" | Deep recursion | Use iteration instead |
| "can only be used when context is known" | Missing context wrapper | Wrap in context { ... } |
| "unexpected argument" | = instead of : for args | Named args use : syntax: func(name: value) |
| "variables from outside are read-only" | Mutating captured variable | Use loop accumulation or state() — see advanced.md |
| "expected content, found string" (or vice versa) | Content/string type mismatch | Use [#str-var] to embed string in content |
| set/show rule has no effect | Rule placed after content | Place set/show rules before the content they target |
Examples
Copy the closest starter, adjust, compile. For CVs, letters, or slides, search packages: python3 scripts/search-packages.py --category cv (or letter, presentation).
| Example | Start here when you want... | Next read |
| basic-document.typ | A short note or memo | basics.md, styling.md |
| styled-document.typ | A multi-section report with page styling | styling.md, tables.md |
| template-report.typ | A reusable template for a series | template.md |
| tables-showcase.typ | A data-heavy doc (tables, CSV/JSON) | tables.md, types.md |
| academic-paper.typ | A paper with citations, theorems, math | academic.md |
| query-export.typ | Metadata export or multi-pass builds | query.md |
| package-example/ | A publishable package | package.md |
Dependencies
- typst CLI 0.15+ recommended: Install from https://typst.app or via package manager
- macOS:
brew install typst - Linux:
cargo install typst-cli - Windows:
winget install typst
- macOS:
- pdftotext (optional): For text-level output verification
- Python 3.10+ (optional): For package search and validation scripts
- jq (optional): For parsing JSON output from
typst evalin shell scripts
API Reference Search
Search the embedded index of Typst API functions, methods, and constructors:
python3 scripts/search-api.py "image width fit"
python3 scripts/search-api.py "color lighten" --kind method
python3 scripts/search-api.py --name str.position -v
python3 scripts/search-api.py "rightarrow" --kind symbol # LaTeX names work
python3 scripts/search-api.py --list-categoriesEcosystem Tools
Ecosystem tools: tinymist (LSP/editor), typstyle (formatter), typst-package-check (package validator), tytanic (visual test runner). For package tooling details, see package.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.