skill-creator — скиллы из OpenAPI, GraphQL и MCP
@asnd/skill-creator
Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.
- 622 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сгенерированная обертка вызывает API с вашими токенами из переменных окружения и может выполнять запросы, меняющие данные сервиса
- Для MCP по stdio команда запуска сервера передается строкой, а обертки запускают пакет через npx при каждом вызове
- Генератор записывает файлы в каталоги агента и ведет файл `lock.json` в домашней папке; скилл улучшения вправе править скиллы из этого файла
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/asnd-skill-creatorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сгенерированная обертка вызывает API с вашими токенами из переменных окружения и может выполнять запросы, меняющие данные сервиса
- Для MCP по stdio команда запуска сервера передается строкой, а обертки запускают пакет через npx при каждом вызове
- Генератор записывает файлы в каталоги агента и ведет файл `lock.json` в домашней папке; скилл улучшения вправе править скиллы из этого файла
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет добавляет агенту команду `/skill-creator`. Вы даете ей ссылку на спецификацию OpenAPI, схему GraphQL или MCP-сервер, а агент изучает источник, запускает генератор и собирает готовый скилл. Внутри скилла лежат файл SKILL.md, скрипт-обертка и копия спецификации в папке `references`. Следующим сессиям не нужно перечитывать документацию API: они вызывают обертку. У обертки четыре режима: `commands list` показывает команды, `commands search` ищет по слову, `commands help` объясняет одну команду, `run` выполняет ее. Секреты обертка читает из переменных окружения или файлов, в сгенерированные документы они не попадают. Обертка кэширует спецификации, схемы и списки инструментов MCP, а флаги задают срок хранения кэша и принудительное обновление. К команде прилагается скилл skill-creator-improvement. Он дописывает в раздел Gotchas (подводные камни) сгенерированного скилла то, что агент выяснил в работе: особые поля, исправленные команды, быстрые цепочки вызовов. Править он вправе только скиллы, записанные в файле `~/.skill-creator/lock.json`.
Для кого. Для разработчиков, которые работают с кодовым агентом и хотят один раз оформить доступ к своему API или MCP-серверу как скилл.
Подходит, если
- У внутреннего сервиса есть спецификация OpenAPI, и агент должен вызывать его без вставки документации в каждый чат
- Вы хотите превратить MCP-сервер в скилл с командами, чтобы его инструменты не висели в контексте постоянно
- Есть GraphQL-конечная точка, и агенту нужны готовые команды для запросов с выбором полей
- Команда использует один скилл в нескольких агентах: установка идет в Claude Code, Codex, Cursor и другие
- Скилл для сервиса должен улучшаться по мере работы, а правки копиться в разделе Gotchas
Не подходит, если
- Нужен постоянный MCP-сервер с подпиской и уведомлениями: сгенерированный скилл вызывает команды по запросу
- У сервиса нет ни OpenAPI, ни GraphQL, ни MCP: источника для генератора не будет
- Нужен скилл с авторской методикой работы: генератор строит обертку над API, а методику придется писать самому
- Окружение без Node.js нужной версии: пакет требует Node.js ^22.22.2, ^24.15.0 или 26 и новее
Пример запроса к агенту
/skill-creator --spec https://example.com/openapi.json --name youtube --agent claude-code --scope projectОграничения
Нужен Node.js версии ^22.22.2, ^24.15.0 или 26 и новее. Скрипты генерируются под выбранного агента: поддерживаются pi, claude-code, codex, cursor, opencode, gemini-cli, github-copilot, cline и windsurf; область установки задается флагом `--scope` со значением global или project. Сгенерированные обертки запускают пакет через `npx -y @asnd/skill-creator`, поэтому при каждом вызове нужен доступ к npm или заранее прогретый кэш.
Качество скилла зависит от источника: спецификация с плохими описаниями даст неудобные команды, и SKILL.md придется дорабатывать. Для источника MCP по stdio команду запуска сервера вы передаете строкой, и она выполняется на вашем компьютере. Версия пакета 0.2.0, репозиторий обновлялся в июне 2026 года.
Доступность npm и сервисов, к которым вы подключаете генератор, из России при подготовке карточки не проверялась.
Как отключить. Удалите файл команды и папку скилла skill-creator-improvement из каталога агента, например ~/.pi/agent/prompts и ~/.pi/agent/skills для pi. Сгенерированные скиллы лежат в своих папках, их удаляют вместе с записями в `~/.skill-creator/lock.json`. Кэш хранится в `~/.cache/skill-creator`.
Частые вопросы
Как поставить /skill-creator в Claude Code?
Выполните `npx @asnd/skill-creator command install --agent claude-code --scope project`, и команда появится в проекте. Флаг `--scope global` ставит ее для всех проектов, а `--no-improvement-skill` пропускает вспомогательный скилл улучшения.
Какие источники принимает генератор?
Спецификацию OpenAPI по файлу или адресу, GraphQL-конечную точку с необязательной схемой SDL или результатом интроспекции, MCP-сервер по HTTP со стримингом или SSE и MCP-сервер по stdio, который запускается строкой команды. Шаблоны называются openapi, graphql, mcp-http и mcp-stdio.
Что лежит в сгенерированном скилле?
Файл `SKILL.md`, папка `scripts` со скриптом-оберткой и папка `references` с копией спецификации, имя файла содержит дату. Обертка вызывается как скрипт с подкомандами `commands list`, `commands search`, `commands help` и `run`.
Как передать токен API, чтобы он не попал в скилл?
Флагом `--auth-header`: значение `Header:env:NAME` читает секрет из переменной окружения, `Header:file:/path/token` читает из файла. Секрет остается вне сгенерированных документов. Флаг можно повторять.
Что делает скилл skill-creator-improvement?
После работы со сгенерированным скиллом он дописывает проверенные находки в раздел Gotchas: корректные команды, особые поля, постраничные запросы. Он сверяется с файлом `lock.json` и не трогает скиллы, которых там нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыBuilder Skills
Skills for agents
Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные
Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
Agent Skills от Tech Leads Club
Agent Skills
Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету
Dimillian Skills
Skills
Набор из 16 инженерных скиллов для агентов: разработка под Apple, упаковка macOS, производительность React, ревью и рефакторинг кода
Softaworks Agent Toolkit
Softaworks Agent Skills
Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация
OpenClaw Agent Skills
openclaw-agent-skills
Общие скиллы для кодовых агентов, которые работают над проектами OpenClaw: ревью и другие рабочие процессы. Узкая тема для тех, кто пишет код OpenClaw
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| skill-creator — скиллы из OpenAPI, GraphQL и MCP (эта запись) | нет | 622 | |
| mcp2cli | нет | 2 424 | превращает MCP, OpenAPI или GraphQL в команды на лету, без оформления отдельного скилла |
| OpenAPI to CLI (ocli) | нет | 267 | делает из OpenAPI и Swagger команды CLI без кодогенерации |
Коротко о README
Документ объясняет идею: вместо вставки документации API в каждый чат агент получает скилл с готовыми командами. Описаны установка команды для разных агентов, примеры запуска для OpenAPI, GraphQL и MCP, структура сгенерированного скилла и схема цикла улучшения с файлом `lock.json`. Таблица флагов охватывает авторизацию, фильтры команд, выбор транспорта MCP и кэширование. Для CI приведены прямой запуск generate с шаблонами и перечень команд pnpm для разработки.