skill-kit CLI
skill-kit собирает скиллы агентов как типизированные конечные автоматы на TypeScript с проверкой ответов схемами
- 70 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Инструмент собирает код и исполняемые файлы для скиллов, а собранный скилл запускает команды через оболочку `scripts/run`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/skill-kitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Инструмент собирает код и исполняемые файлы для скиллов, а собранный скилл запускает команды через оболочку `scripts/run`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
skill-kit — TypeScript-набор от Contentful для тех, кто пишет скиллы агентов. Обычный скилл на Markdown агент читает целиком. Для многошаговых процессов с ветвлением и проверкой это слабо, а большие справочники лучше подгружать по частям. skill-kit дает два вида скиллов. Рабочие процессы описывают шаги: у каждого есть промпт, схема ответа ArkType и явные переходы. Справочные скиллы подгружают темы по запросу. Определение выглядит как цепочка `skill()`, `.step()`, `.build()`. Агент видит один шаг за раз и возвращает структурированный ответ, а CLI решает, куда идти дальше. Составные скиллы объединяют несколько связанных скиллов с общими справочниками в один диспетчер. Скилл можно проверить без агента: `runSkill` и `mockModel` из `@contentful/skill-kit/test` подставляют готовые ответы модели. Команда `npx skill-kit build src/skill.ts -o skill` собирает папку по спецификации agentskills.io: сгенерированный `SKILL.md`, `package.json`, оболочку `scripts/run` и либо один бандл Node.js (`--mode node`), либо автономные исполняемые файлы Bun для платформ. Готовый скилл ставят через `skills add`, `agents-kit install` или `git clone`. Агент работает с ним командами `scripts/run topics` и `scripts/run topic <имя>`.
Для кого. Разработчикам, которые выпускают скиллы для своих продуктов и команд и хотят задать им шаги, проверки и тесты вместо длинного Markdown-файла.
Подходит, если
- Мастер настройки продукта должен идти по шагам с ветвлением, а ответ каждого шага проверяется схемой
- Справочник API на сто страниц агент должен читать по темам командой `scripts/run topic <имя>`
- Несколько родственных скиллов делят справочники и надо собрать их в один диспетчер
- Скилл нужно протестировать без агента с заготовленными ответами модели
- Результат должен лечь в папку по спецификации agentskills.io и уехать по `skills add`
Не подходит, если
- Скилл короткий и состоит из нескольких абзацев: хватит обычного `SKILL.md`
- Нужно просто пользоваться готовым скиллом: skill-kit нужен только его автору
- Вы пишете не на TypeScript: определения скиллов идут через пакет `@contentful/skill-kit`
- Нужен готовый скилл для Contentful: для этого есть пример `examples/contentful-help`
Пример запроса к агенту
Опиши скилл repo-doctor через skill-kit: шаг diagnose, ветка remediate при провалах и шаг report, затем собери его в папкуОграничения
- Набор рассчитан на авторов скиллов: пользователю готового скилла он не нужен: агент работает уже с собранной папкой.
- Сборка по умолчанию дает автономные исполняемые файлы Bun весом 50–100 МБ на платформу, легкий бандл Node.js (100–500 КБ) включают флагом `--mode node`.
- Схемы ответов описываются ArkType, а определения пишутся на TypeScript, поэтому знание этих инструментов обязательно.
- Пакет ставится через `pnpm add @contentful/skill-kit`, а тестовый набор лежит в отдельной точке входа `@contentful/skill-kit/test`.
Как отключить. Пакет удаляют из проекта командой `pnpm remove @contentful/skill-kit`. Уже собранные скиллы остаются самостоятельными папками и убираются из каталога скиллов агента вручную.
Частые вопросы
Как добавить skill-kit в проект?
Выполните `pnpm add @contentful/skill-kit`, опишите скилл цепочкой `skill()`, `.step()`, `.build()` и соберите командой `npx skill-kit build src/skill.ts -o skill`.
Чем workflow-скилл отличается от справочного?
Workflow-скилл ведет агента по шагам с проверяемым ответом и переходами. Справочный дает темы, которые агент загружает по одной командой `topic <имя>`, без состояния и истории.
Как проверить скилл без агента?
Через `runSkill` и `mockModel` из `@contentful/skill-kit/test`: вы задаете ответы модели для каждого шага и проверяете результат.
Что получится на выходе сборки?
Папка по спецификации agentskills.io: сгенерированный `SKILL.md`, `package.json`, `scripts/run` и бандл Node.js или автономные файлы Bun.
Для каких агентов подходят собранные скиллы?
Для любого агента, который читает `SKILL.md` и умеет запускать команды через Bash. Установка идет через `skills add`, `agents-kit install` или `git clone`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыskill-creator — скиллы из OpenAPI, GraphQL и MCP
@asnd/skill-creator
Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.
skills-npm подключает скиллы агентов из зависимостей проекта в node_modules и из поля skills в package.json
Менеджер скиллов и агентов с lock-файлом: ставит одни и те же наборы в Claude Code, Codex, Cursor и другие, не теряя ваших правок.
Builder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
Набор скиллов из реальной работы: аудит цепочки поставок npm, сборка CLI, релиз плагина Obsidian и иерархия AGENTS.md
Agent Skills от Tech Leads Club
Agent Skills
Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету
Коротко о README
README объясняет, чем типизированный рабочий процесс лучше Markdown, и сразу показывает пример. Затем идут быстрый старт, тест без агента, сборка скилла, виды скиллов (рабочие процессы, справочные, составные), примеры и справочник API.