Typst Skill
claude-skill-typst
Скилл по Typst 0.15 с разборами таблиц, формул, шаблонов и пакетов, двумя субагентами проверки и поиском по API
- 139 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент запускает `typst compile` и пишет файлы PDF, PNG и HTML в рабочий каталог
Установка
- Работает в
Ручная установка
npx skills add https://github.com/lucifer1004/claude-skill-typstУниверсальная установка через skills.sh.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент запускает `typst compile` и пишет файлы PDF, PNG и HTML в рабочий каталог
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл учит агента писать и чинить документы на Typst, системе верстки с языком разметки и скриптов. Главный файл `SKILL.md` служит входом со справкой, а темы разнесены по отдельным файлам: основы языка и типы данных, оформление страниц и шрифтов, таблицы, научные работы с библиографией и теоремами, конвертация из Markdown и LaTeX, шаблоны и разработка пакетов. В папке `agents/` лежат два субагента. `typst-verify` проверяет результат сборки, а `typst-package-qa` проверяет пакеты. Проверять документ скилл советует тремя способами: выгрузкой в HTML, картинкой PNG для визуальной сверки и текстом через `pdftotext`. В репозитории есть поиск по пакетам и по API Typst через `just search-pkg` и `just search-api`, в том числе по именам из LaTeX. Главная ветка рассчитана на Typst 0.15, для 0.14.2 автор оставил тег `typst-0.14.2`.
Для кого. Авторам научных работ, отчетов и шаблонов, которые переходят с LaTeX на Typst и просят агента собирать документы.
Подходит, если
- Черновик на Markdown или LaTeX нужно перевести в файл `.typ` и убедиться, что он собирается
- Таблица с объединенными ячейками и рамками получается кривой, и агенту нужны правила сеток
- Статья требует библиографии, теорем и нумерованных формул в одном документе
- Пишется свой пакет Typst с тестами и публикацией, и надо проверить его по чек-листу
- Старый шаблон перестал собираться после перехода на Typst 0.15
Не подходит, если
- Документ остается на LaTeX: скилл целиком про Typst и LaTeX не покрывает
- Нужны правки в Word или Google Docs: Typst собирает файлы из исходников в PDF, PNG и HTML
- На машине стоит Typst 0.14.2: берите тег `typst-0.14.2`, главная ветка рассчитана на 0.15
Пример запроса к агенту
Переведи мой `draft.md` в Typst с оглавлением и таблицей на три колонки, собери PDF и покажи первую страницу картинкойОграничения
Скилл рассчитан на Typst 0.15 и новее, для версии 0.14.2 автор ведет отдельный тег. Сборка требует установленного Typst CLI, а проверка текста из PDF — утилиты `pdftotext`. Рецепты `just` для поиска пакетов и API нужны разработчикам скилла и работают при установленных `just` и `pixi`, обычному пользователю они не обязательны. Скилл включается сам при работе с файлами `.typ` или упоминании Typst, и справочные файлы подгружаются по теме, поэтому длинные темы займут часть контекста агента.
Как отключить. Удалите папку `~/.claude/skills/typst` или снимите скилл командой менеджера, которым ставили. Файлы `.typ` и собранные документы остаются нетронутыми.
Частые вопросы
Как поставить Typst Skill в Claude Code?
Выполните `npx skills add https://github.com/lucifer1004/claude-skill-typst`. Без менеджера склонируйте репозиторий в `~/.claude/skills/typst`.
Какая версия Typst нужна?
Главная ветка рассчитана на Typst 0.15 и новее. Для 0.14.2 переключитесь на тег `typst-0.14.2`.
Как агент проверяет, что документ собрался правильно?
Он выгружает HTML для чтения текста, строит PNG для визуальной сверки и вытаскивает текст из PDF через `pdftotext`. За это отвечает файл `debug.md` и субагент `typst-verify`.
Умеет ли скилл переводить LaTeX в Typst?
Да, этим занимается файл `conversion.md`: правила конвертации Markdown и LaTeX в Typst. Поиск по API Typst понимает и привычные имена из LaTeX, например `rightarrow`.
Нужно ли ставить Typst CLI отдельно?
Да, скилл не содержит компилятора: для сборки нужен Typst CLI версии 0.15 или новее, а для проверки текста из PDF — `pdftotext`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДва скилла для ИИ-агентов: пишут документы на Typst и слайды на Touying по локальной копии документации, а не по памяти модели
Восемь скиллов для готовых научных статей и диссертаций на LaTeX и Typst: компиляция, ссылки, правка языка, письмо в журнал и аудит как у рецензента
Набор из восьми скиллов для научных статей в LaTeX: от темы до PDF с проверенными ссылками BibTeX и поэтапным контролем
16 готовых скиллов для Cursor, Claude Code и Codex: диссертации, PDF и Office, схемы draw.io, документация проекта
Скилл для Claude Code: описываешь документ словами, получаешь готовый PDF на LaTeX. Шаблоны, скрипты компиляции, распознавание PDF и рукописных заметок
Скилл Claude Code для научных статей: пять этапов от опроса автора до сжатия, правила разделов и независимая проверка.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Typst Skill (эта карточка) | нет | 139 | ||
| LaTeX Document Skill | нет | 828 | скилл для документов на LaTeX, а здесь Typst с проверкой сборки субагентами | |
| mcp-pandoc | нет | не нужна | 587 | MCP-сервер Pandoc для конвертации форматов, а здесь правила верстки на Typst |
Коротко о README
README открывает установку одной командой и ручной копией, показывает минимальную сборку документа и таблицу файлов скилла с адресатами: пользователь, разработчик или оба. Дальше описаны поиск по пакетам и API, команды `just` для разработки, условия автоматического включения и требования к версиям.
Бейдж для README
Исходный 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.