Typst agent skills

Two agent skills for writing Typst documents and Touying slides from a local copy of the docs instead of the model's memory

  • 239 ★ on the repository
  • Last commit
Skill

Minimal access

Why this level

  • Holds only instructions, documentation and examples and runs nothing itself
  • For the formatting check the agent may run `typstyle` over your `.typ` files
All reasons and checks

apcamargo/typst-skills

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/typst-agent-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • Holds only instructions, documentation and examples and runs nothing itself
  • For the formatting check the agent may run `typstyle` over your `.typ` files

This is third-party code. Review the repository files before installing.

What it does

The repository holds two skills for agents that support the open Agent Skills standard. Models know Typst worse than LaTeX because the language is relatively new. The skills handle that by shipping local copies of the documentation and examples with the instructions, so the agent looks syntax up there instead of recalling outdated training data. `typst-author` covers general work on `.typ` files: creating a document, editing, troubleshooting and reference questions. It carries a full copy of the official documentation (reference, guides, tutorial), a minimal document example and workflows for a new project and for editing an existing one. After each `.typ` edit, if `typstyle` is installed, the skill tells the agent to check formatting. `touying-author` is for presentations with the Touying package. It holds a local copy of the Touying docs and examples: slides, animations and custom themes. The examples folder has ready styles such as aqua, dewdrop, metropolis, simple, stargazer and university. Installation comes down to copying the two folders into your agent's `skills/` directory.

Who it is for. People who typeset papers, reports and slides in Typst instead of LaTeX and are tired of fixing the agent's invented syntax.

Good fit when

  • The agent writes Typst with functions that do not exist or LaTeX syntax
  • A report or paper has to be assembled from `.typ` files with headings, tables and formulas
  • A talk needs Touying slides with a ready theme such as metropolis or university
  • A Typst document broke and you want to work through the compile error against the official reference
  • You work offline or in a closed environment: the documentation ships inside the skills

Not a fit when

  • Documents are written in LaTeX, Markdown or Word: the skills know only Typst
  • You need a fresh Typst release right after it ships: the bundled docs reflect the version at the time of copying
  • Slides use other packages instead of Touying: touying-author does not apply
  • You want a one-line install command: the README offers only manual folder copying

Example request

Build a 10-page Typst report with a table of contents and a results table, then Touying slides for the talk in the metropolis theme

Limitations

  • The repository has no license file, so the terms of use and redistribution are undefined. The authors copy the Typst and Touying documentation into the skills, and those projects' own licenses deserve a separate check.
  • Installation is manual: clone the repository and copy the `typst-author` and `touying-author` folders into your agent's skills directory. There is no `npx skills add` command in the description.
  • Documentation inside the skills updates with the repository, so it may lag behind a fresh Typst or Touying release. The last commit dates from September 2026.
  • The post-edit formatting check runs only when `typstyle` is installed.

How to disable. Delete the typst-author and touying-author folders from your agent's skills directory, for example ~/.claude/skills/.

FAQ

How do I install typst-skills in Claude Code?

Clone the repository and copy the `typst-author` and `touying-author` directories into `~/.claude/skills/`. The agent finds the skills on its next start and applies them to `.typ` files and slides.

How is typst-author different from touying-author?

`typst-author` handles general Typst documents, and `touying-author` covers presentations with the Touying package and ships theme and animation examples.

Why do the skills carry a copy of the documentation?

Models know Typst worse than LaTeX and invent functions. The local reference and examples give the agent a source to take syntax from.

Is typstyle required?

It is optional. If `typstyle` is installed the skill asks the agent to check formatting after each `.typ` edit.

Which slide themes are among the Touying examples?

The examples folder holds aqua (including a Chinese-language version), dewdrop, metropolis, simple, stargazer and university, plus a general example.

Discussion

No questions or reviews yet.

Skills

Typst Skill

claude-skill-typst

A Typst 0.15 skill covering tables, equations, templates and packages, with two verification subagents and API search

SkillExtended access139Repository stars

16 ready skills for Cursor, Claude Code and Codex: theses, PDF and Office, draw.io diagrams, project documentation

SkillExtended access3.2KRepository stars

21 skills for Chinese-language work: web material capture, documents and spreadsheets, audio, animated diagrams and book building

SkillExtended access649Repository stars

Eight skills for finished papers and theses in LaTeX and Typst: compile, references, language polish, cover letters and a reviewer-style audit

SkillExtended access549Repository stars

A skill set for building interactive MkDocs textbooks: concept graph, chapters, simulations, quizzes and glossary.

SkillExtended access111Repository stars

A skill that builds a PowerPoint deck with live text, charts and tables: an image model draws each slide, the agent rebuilds it.

SkillExtended access99Repository stars

README in short

The short page states the problem: models stumble over the syntax of a new language. It then lists two skills, typst-author with a mirror of the official docs and touying-author with the Touying docs, examples and themes. The usage section has two steps: clone the repository and copy the skill folders into the agent's `skills/` directory.

README badge

Original SKILL.md

---
name: typst-author
description: Generate idiomatic Typst (.typ) code, edit and troubleshoot Typst documents and projects, and answer Typst syntax/reference questions. Use when working with .typ files or when the user explicitly asks for Typst document creation, editing, debugging, compilation, formatting, template work, or package usage.
---

# typst-author skill

## Overview

This skill helps agents generate, edit, and reason about Typst documents. It provides quick‑start examples, detailed workflows, and links to the Typst documentation (overview, guides, tutorials, reference).

## Minimal document example

```typst
#set document(title: "My Document", author: "Author Name")
#set page(numbering: "1")
#set text(lang: "en")

// Enable paragraph justification and character-level justification
#set par(
  justify: true,
  justification-limits: (
    tracking: (min: -0.012em, max: 0.012em),
    spacing: (min: 75%, max: 120%),
  )
)

#title[My Document]

= Heading 1

This is a paragraph in Typst.

== Heading 2

#lorem(50)
```

## Workflows

- **Creating a new Typst project**:
  - Use the "Minimal document example" above as a starting point.
  - Skim the tutorial for the basics ([docs/tutorial/1-writing.md](docs/tutorial/1-writing.md)), then create the `.typ` file(s).
  - After each `.typ` edit, follow the post-edit formatting checks below when `typstyle` is available.
- **Editing existing content**:

Report a problem