claude-skill-typst

Typst Skill for Claude Code

A comprehensive skill for Typst document creation and package development. The current main branch targets Typst 0.15+.

Installation

One-line install:

npx skills add https://github.com/lucifer1004/claude-skill-typst

Manual install:

git clone https://github.com/lucifer1004/claude-skill-typst.git ~/.claude/skills/typst

Quick Start

# Compile a minimal document
cat > /tmp/hello.typ <<'EOF'
#set page(paper: "a4", margin: 2cm)
= Hello Typst

This is a minimal document.
EOF

typst compile /tmp/hello.typ

Verify output (HTML export for agents, PNG for visual checks):

typst compile /tmp/hello.typ /dev/stdout -f html --features html 2>/dev/null
typst compile /tmp/hello.typ "page-{p}.png" -f png

Contents

Search Tools

# Search Typst packages
just search-pkg "chart visualization"

# Search Typst API (functions, methods, types, symbols)
just search-api "image width fit"
just search-api "rightarrow" --kind symbol   # LaTeX names work
just search-api --name str.position -v       # Exact lookup
just search-api "asset"                      # Typst 0.15 default API

Development

just              # List all recipes
just check        # Run lint + test + validate
just test         # Run test suite
just validate     # Validate inline Typst code blocks in docs
just stats        # Show project stats

Usage

Once installed, Claude Code will automatically activate this skill when:

• Working with .typ files
• User mentions "typst" or related terms
• Creating or modifying Typst documents

Requirements

• Typst CLI 0.15+ recommended
• just (optional, for development)
• pixi (optional, for development)

For users who are still on Typst 0.14.2, use the typst-0.14.2 repository tag for the previous skill snapshot.

License

MIT