SkillFoxx
Telegram

Typst agent skills

Два скилла для ИИ-агентов: пишут документы на Typst и слайды на Touying по локальной копии документации, а не по памяти модели

  • 239 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Содержит только инструкции, документацию и примеры, сами ничего не запускает
  • При проверке форматирования агент может запустить `typstyle` по вашим `.typ`-файлам
Все причины и проверки

apcamargo/typst-skillsАвтор:apcamargo

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/typst-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Содержит только инструкции, документацию и примеры, сами ничего не запускает
  • При проверке форматирования агент может запустить `typstyle` по вашим `.typ`-файлам

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Репозиторий содержит два скилла для агентов, которые поддерживают открытый стандарт `Agent Skills`. Модели хуже знают `Typst`, чем `LaTeX`, потому что язык относительно новый. Скиллы решают это так: вместе с инструкциями в них лежат локальные копии документации и примеры, и агент ищет синтаксис в них, а не вспоминает устаревшие данные из обучения. `typst-author` отвечает за общую работу с `.typ`-файлами: создание документа, правку, разбор ошибок и вопросы по справочнику. В скилле есть полная копия официальной документации (справка, руководства, учебник), пример минимального документа и порядок действий для нового проекта и для правки существующего. После каждой правки `.typ`, если установлен `typstyle`, скилл предписывает проверить форматирование. `touying-author` предназначен для презентаций на пакете `Touying`. В нем лежит локальная копия документации `Touying` и примеры: слайды, анимации и собственные темы. В папке примеров есть готовые оформления, например `aqua`, `dewdrop`, `metropolis`, `simple`, `stargazer` и `university`. Установка сводится к копированию двух папок в каталог `skills/` вашего агента.

Для кого. Тем, кто верстает статьи, отчеты и слайды на `Typst` вместо `LaTeX` и устал исправлять за агентом выдуманный синтаксис.

Подходит, если

  • Агент выдает код на `Typst` с несуществующими функциями или синтаксисом из `LaTeX`
  • Отчет или статью надо собрать из `.typ`-файлов с заголовками, таблицами и формулами
  • Для доклада нужны слайды на `Touying` с готовой темой вроде `metropolis` или `university`
  • Документ на `Typst` сломался, и нужно разобрать ошибку компиляции по официальному справочнику
  • Работа идет офлайн или в закрытом контуре: документация лежит в самих скиллах

Не подходит, если

  • Документы пишутся на `LaTeX`, Markdown или в Word: скиллы знают только `Typst`
  • Нужен свежий выпуск `Typst` сразу после релиза: документация в скилле отражает версию на момент копирования
  • Презентации собирают в других пакетах: `touying-author` к ним неприменим
  • Нужна установка одной командой: в описании есть только ручное копирование папок

Пример запроса к агенту

Собери на `Typst` отчет на 10 страниц с оглавлением и таблицей результатов, а потом слайды для доклада на `Touying` в теме `metropolis`

Ограничения

  • В репозитории нет файла лицензии, поэтому условия использования и распространения материалов не определены. Документацию `Typst` и `Touying` авторы копируют внутрь скиллов, а их собственные лицензии стоит проверить отдельно.
  • Установка ручная: склонировать репозиторий и скопировать папки `typst-author` и `touying-author` в каталог скиллов своего агента. Команды вроде `npx skills add` в описании нет.
  • Документация внутри скиллов обновляется вместе с репозиторием, поэтому может отставать от свежей версии `Typst` или `Touying`. Последний коммит сделан в сентябре 2026 года.
  • Проверка форматирования после правок срабатывает только при установленном `typstyle`.

Как отключить. Удалите папки `typst-author` и `touying-author` из каталога скиллов вашего агента, например из ~/.claude/`skills/`.

Частые вопросы

Как поставить typst-skills в Claude Code?

Склонируйте репозиторий и скопируйте каталоги `typst-author` и `touying-author` в `~/.claude/skills/`. Агент обнаружит скиллы при следующем запуске и применит их к `.typ`-файлам и слайдам.

Чем `typst-author` отличается от `touying-author`?

`typst-author` ведет общую работу с документами `Typst`, а `touying-author` отвечает за презентации на пакете `Touying` и содержит примеры тем и анимаций.

Зачем скиллам копия документации?

Модели хуже знают `Typst`, чем `LaTeX`, и подставляют выдуманные функции. Локальные справочник и примеры дают агенту источник, из которого он берет синтаксис.

Нужен ли `typstyle`?

Он необязателен. Если `typstyle` установлен, скилл просит проверять форматирование после каждой правки `.typ`.

Какие темы слайдов есть среди примеров `Touying`?

В папке примеров лежат `aqua` (в том числе версия для китайского языка), `dewdrop`, `metropolis`, `simple`, `stargazer` и `university`, а также общий пример.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Typst Skill

claude-skill-typst

Скилл по Typst 0.15 с разборами таблиц, формул, шаблонов и пакетов, двумя субагентами проверки и поиском по API

СкиллРасширенный доступ139

16 готовых скиллов для Cursor, Claude Code и Codex: диссертации, PDF и Office, схемы draw.io, документация проекта

СкиллРасширенный доступ3,2 тыс.

21 скилл для китайскоязычной работы: сбор материалов с сайтов, документы и таблицы, озвучка, диаграммы и сборка книг из текстов

СкиллРасширенный доступ649

Восемь скиллов для готовых научных статей и диссертаций на LaTeX и Typst: компиляция, ссылки, правка языка, письмо в журнал и аудит как у рецензента

СкиллРасширенный доступ549

Набор скиллов для создания интерактивных учебников на MkDocs: граф понятий, главы, симуляции, тесты и глоссарий.

СкиллРасширенный доступ111

Скилл собирает презентацию PowerPoint с живыми текстом, диаграммами и таблицами: макет слайда рисует генератор изображений.

СкиллРасширенный доступ99

Коротко о README

Краткая страница объясняет проблему: модели путаются в синтаксисе нового языка. Затем перечисляет два скилла, `typst-author` с зеркалом официальной документации и `touying-author` с документацией `Touying`, примерами и темами. Раздел об использовании состоит из двух шагов: клонировать репозиторий и скопировать папки скиллов в каталог `skills/` агента.

Бейдж для README

Исходный 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**:

Сообщить о проблеме