openapi-to-skills CLI
CLI превращает спецификацию OpenAPI в Agent Skill из markdown-файлов, которые агент читает по частям и экономит контекст.
- 342 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Команда читает спецификацию из файла или по URL и пишет файлы в указанный каталог.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/openapi-to-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Команда читает спецификацию из файла или по URL и пишет файлы в указанный каталог.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`openapi-to-skills` берет файл или URL со спецификацией OpenAPI и выводит каталог в формате Agent Skills: обзор, файлы ресурсов, отдельные файлы операций и схем. Агент начинает с обзора и открывает только нужные операции, а не грузит спецификацию целиком. Операции группируются по тегам или префиксу пути, схемы по префиксу имени. Фильтры отбирают теги, пути и устаревшие методы, шаблоны Eta переопределяются. Пакет экспортирует `convertOpenAPIToSkill` для сборочных конвейеров, а в `skills/openapi-to-skills` лежит скилл для генерации силами агента.
Для кого. Разработчики, которые хотят передать агенту знание о большом API без самописного MCP-сервера и раздутого контекста.
Подходит, если
- Спецификация на мегабайты не помещается в контекст агента целиком.
- Для внутреннего API нужен скилл, а писать MCP-инструменты долго.
- Из спецификации отбирают нужные теги и убирают устаревшие операции.
- Скилл по API пересобирается в конвейере после каждого обновления спецификации.
Не подходит, если
- Нужен клиент с готовыми вызовами эндпоинтов: на выходе документация в markdown.
- Спецификация опирается на внешние `$ref`: предупреждения о неразрешенных ссылках пока нет.
- Описания API в формате OpenAPI нет вовсе.
Пример запроса к агенту
Сконвертируй `./openapi.yaml` в скилл в папке `./output`, сгруппируй операции по тегам и исключи устаревшие.Ограничения
Результат — документация в markdown, а не исполняемый клиент. Неразрешенные внешние `$ref` пока не обнаруживаются: предупреждение значится в планах. Работа идет только с описанием API: сами запросы к сервису агент выполняет другими средствами. Большая спецификация превращается в тысячи файлов: у публичной коллекции API из 7,2 МБ вышло 2 135 файлов. Результат стоит просмотреть до подключения: структура и группировка зависят от тегов и префиксов путей в спецификации.
Как отключить. Удалите сгенерированный каталог скилла из папки агента и пакет `openapi-to-skills` из зависимостей, если ставили его в проект.
Частые вопросы
Откуда брать спецификацию?
Из локального файла или по URL: `npx openapi-to-skills https://example.com/openapi.yaml -o ./output`.
Что получается на выходе?
Каталог в формате Agent Skills: обзор, индексы ресурсов, отдельные файлы операций и схем.
Можно ли изменить оформление?
Да. Шаблоны Eta по умолчанию переопределяются, а теги, пути и устаревшие методы отбираются фильтрами.
Есть ли программный вызов?
Да. Пакет экспортирует `convertOpenAPIToSkill`, а также `createParser`, `createRenderer` и `createWriter`.
Как выглядит масштаб?
На коллекции публичных API один файл на 7,2 МБ стал 2 135 файлами: 588 операций и 1 468 схем лежат отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыskill-creator — скиллы из OpenAPI, GraphQL и MCP
@asnd/skill-creator
Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.
Свыше 1100 готовых скиллов для Claude Code, Codex, Gemini CLI и Cursor и MCP-сервер, который подбирает скилл под задачу
Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
skills-npm подключает скиллы агентов из зависимостей проекта в node_modules и из поля skills в package.json
Десятки скиллов инженера mizchi: аудит фронтенда, AWS, Cloudflare, SQL, Playwright и OpenTelemetry, ставятся по одному
Набор независимых скиллов против дрейфа в больших кодовых базах: hard-cut, поиск первопричины, тесты и проверка CI.
Коротко о README
Идея в том, что документацию OpenAPI агент читает по частям: сначала обзор, затем нужные операции и схемы. Чтение файлов есть у любого агента, поэтому особая интеграция не нужна.