Typst document creation and package development. An agent skill from lucifer1004/claude-skill-typst.

MITAuto-check passedDocuments & Office

Install Typst

skills CLI
$ npx skills add lucifer1004/claude-skill-typst --skill typst -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lucifer1004/claude-skill-typst typst --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lucifer1004/claude-skill-typst.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/typst .claude/skills/typst && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
typst
GitHub stars
129
Token cost
~2.1k tokens
SKILL.md length
548 words
Files
48 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Typst document creation and package development. An agent skill from lucifer1004/claude-skill-typst.

  • Working with .typ files
  • SKILL.md covers Compilation, Minimal Document, Writing Documents and Developing Packages and…, plus 6 more sections
  • Calls python3, pdftotext and brew
  • User mentions typst

What it does

Typst is an agent skill from lucifer1004/claude-skill-typst. 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

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 49 other files, including scripts (for example `academic.md`, `advanced.md` and `agents/typst-package-qa.md`).

It sits in Documents & Office, covering LaTeX. It works with LaTeX. The repository describes itself as: Typst skill for agents. The licence is MIT.

When your agent uses it

  • Working with .typ files
  • User mentions typst
  • Using Typst packages
  • Developing document templates

Example prompts

  • “/typst”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 3d4fbe9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • pdftotext
    • brew
    • cargo
    • winget

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • typst.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Typst loads about 2.1k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 548 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from lucifer1004/claude-skill-typst at commit 3d4fbe9, republished under its MIT licence (© lucifer1004). 548 words, ~2,088 tokens.

Download SKILL.mdSave it as .claude/skills/typst/SKILL.md (or your agent's skills folder). This skill also uses 47 other files; get the full folder from GitHub.
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.

Agent verification — choose by what you need to check (see debug.md for details):

MethodCommandBest for
HTML exporttypst compile doc.typ /dev/stdout -f html --features html 2>/dev/nullText content, structure, headings, tables
PNG exporttypst compile doc.typ page-{p}.png -f pngVisual layout, alignment, spacing, fonts
pdftotexttypst 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 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 flowbasics.md
Learn data types, operators, string/array methodstypes.md
Style pages, headings, figures, layoutstyling.md
Tables, grids, cell spans, borders, data tablestables.md
Academic papers, bibliography, theorems, equationsacademic.md
Convert from Markdown or LaTeXconversion.md
Upgrade older Typst code, 0.15 breaking changesmigration.md
Use Typst CLI commands and build optionscli.md
Extract data from documents, multi-pass buildsquery.md

Developing Packages and Templates

When you need to...Read
State, counters, in-document query(), XMLadvanced.md
CLI introspection, metadata export, multi-passquery.md
Create a reusable template functiontemplate.md
Create or publish a packagepackage.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):

bash
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-categories

Common Errors

ErrorCauseFix
"unknown variable"Undefined identifierCheck spelling, ensure #let before use
"expected X, found Y"Type mismatchCheck function signature in docs
"file not found"Bad import pathPaths resolve relative to current file
"unknown font"Font not installedUse system fonts or web-safe alternatives
"maximum function call depth exceeded"Deep recursionUse iteration instead
"can only be used when context is known"Missing context wrapperWrap in context { ... }
"unexpected argument"= instead of : for argsNamed args use : syntax: func(name: value)
"variables from outside are read-only"Mutating captured variableUse loop accumulation or state() — see advanced.md
"expected content, found string" (or vice versa)Content/string type mismatchUse [#str-var] to embed string in content
set/show rule has no effectRule placed after contentPlace set/show rules before the content they target
Show full SKILL.md (168 more words)Show less

Examples

Copy the closest starter, adjust, compile. For CVs, letters, or slides, search packages: python3 scripts/search-packages.py --category cv (or letter, presentation).

ExampleStart here when you want...Next read
basic-document.typA short note or memobasics.md, styling.md
styled-document.typA multi-section report with page stylingstyling.md, tables.md
template-report.typA reusable template for a seriestemplate.md
tables-showcase.typA data-heavy doc (tables, CSV/JSON)tables.md, types.md
academic-paper.typA paper with citations, theorems, mathacademic.md
query-export.typMetadata export or multi-pass buildsquery.md
package-example/A publishable packagepackage.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
  • 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 eval in shell scripts

Search the embedded index of Typst API functions, methods, and constructors:

bash
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-categories

Ecosystem Tools

Ecosystem tools: tinymist (LSP/editor), typstyle (formatter), typst-package-check (package validator), tytanic (visual test runner). For package tooling details, see package.md.

© lucifer1004, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 47 other files (scripts) in skills/typst of lucifer1004/claude-skill-typst.

  • SKILL.md
  • LICENSE
  • academic.md
  • advanced.md
  • agents/typst-package-qa.md
  • agents/typst-verify.md
  • basics.md
  • cli.md
  • conversion.md
  • data/api-0.15.0-bm25.json
  • data/api-0.15.0.json
  • data/api-0.15.1-bm25.json
  • data/api-0.15.1.json
  • data/api-bm25.json
  • data/api-main-bm25.json
  • data/api-main.json
  • data/api.json
  • data/packages-bm25.json
  • data/packages.json
  • … and 29 more

Open the folder on GitHubat commit 3d4fbe9

Compare with similar skills

Typst next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Typst compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Typst this skilllucifer1004/claude-skill-typst129—~2.1kAutomated safety check: PassMIT
Research Writingalfonso0512/research-writing-skill4871 repos~818Automated safety check: PassMIT
Paper WritingMLNLP-World/Paper-Writing-Tips4.7k—~630Automated safety check: PassNone
Evomath TaoEvoScientist/EvoSkills4752 repos~3.8kAutomated safety check: PassApache-2.0
PaperjurySpark-To-Paper-Skills/paperjury1.2k—~5.3kAutomated safety check: PassMIT
Thesis Defense PPTX Builderzouchenzhen/thesis-defense-pptx-skill266—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Research Writing

    alfonso0512/research-writing-skill

    科研论文写作助手,提供 30 个 Prompt 模板覆盖论文写作全流程. An agent skill from alfonso0512/research-writing-skill.

    487 GitHub starsUsed in 1 repo~818 tokens
    Documents & OfficeAuto-check passed
  • Paper Writing

    MLNLP-World/Paper-Writing-Tips

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    4.7k GitHub stars~630 tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Evomath Tao

    EvoScientist/EvoSkills

    A skill your agent uses whenever the user submits a non-trivial mathematical claim that needs a rigorous proof or audit.

    475 GitHub starsUsed in 2 repos~3.8k tokens
    Documents & OfficeAuto-check passed
  • Paperjury

    Spark-To-Paper-Skills/paperjury

    Three modes for CS-conference papers (CVPR/ICCV/ECCV vision, ACL/EMNLP/NAACL NLP, ICLR/NeurIPS/ICML/AAAI ML).

    1.2k GitHub stars~5.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Thesis Defense PPTX Builder

    zouchenzhen/thesis-defense-pptx-skill

    Builds an editable thesis defense PowerPoint from a thesis PDF or LaTeX project while preserving a supplied university or lab template, then runs a visual quality check.

    266 GitHub stars~2.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 13 days ago
    Documents & OfficeAuto-check passed

Works with

Questions about Typst

What does Typst do?

Typst document creation and package development. An agent skill from lucifer1004/claude-skill-typst. Typst is an agent skill from lucifer1004/claude-skill-typst. Typst document creation and package development.

When should I use Typst?

Typst fits situations like: working with .typ files; user mentions typst; using Typst packages; developing document templates.

How do I install Typst in Claude Code?

Run `npx skills add lucifer1004/claude-skill-typst --skill typst -a claude-code`. Or copy the skill folder (skills/typst in lucifer1004/claude-skill-typst) into .claude/skills/typst in your project. Claude Code loads it when a task matches its description.

How do I install Typst in Codex?

Run `npx skills add lucifer1004/claude-skill-typst --skill typst -a codex`. Or copy the skill folder (skills/typst in lucifer1004/claude-skill-typst) into .agents/skills/typst in your project. Codex loads it when a task matches its description.

Can I use Typst in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lucifer1004/claude-skill-typst --skill typst -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/typst, .gemini/skills/typst, .github/skills/typst and .opencode/skills/typst in your project.

What does Typst need to run?

Going by SKILL.md and its folder, Typst needs the command-line tools its instructions call (python3, pdftotext, brew, cargo and winget). Our summary lists: Python 3.

Does Typst access the network?

SKILL.md names 1 domain. As links in the text: typst.app. This is read from the text; nothing was executed.

Is Typst safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Typst use?

Typst is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Typst use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Typst?

Skills that share tags, products or a category with Typst: Research Writing (alfonso0512/research-writing-skill, 487 stars), Paper Writing (MLNLP-World/Paper-Writing-Tips, 4.7k stars), Evomath Tao (EvoScientist/EvoSkills, 475 stars) and Paperjury (Spark-To-Paper-Skills/paperjury, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Typst?

lucifer1004 (a GitHub user) maintains it in lucifer1004/claude-skill-typst, which has 129 GitHub stars. The repository was last updated on October 5, 2026.

Source: lucifer1004/claude-skill-typst on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.