Генерация спецификаций OpenAPI
Командам API нужны точные контракты для документации, валидации и генерации SDK. Этот навык предоставляет шаблоны OpenAPI 3.1, образцы и рекомендации по инструментам.
Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.
Review the Skillstore skill "openapi-spec-generation" from https://skillstore.io/skills/wshobson-openapi-spec-generation.md and its manifest at https://skillstore.io/api/skills/wshobson-openapi-spec-generation/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.
Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.
Использование «openapi-spec-generation». Запрос на документирование API управления пользователями.
Ожидаемый результат:
Использование «openapi-spec-generation». Запрос на подготовку спецификации к генерации SDK.
Ожидаемый результат:
Использование «openapi-spec-generation». Запрос на улучшение существующего API-контракта.
Ожидаемый результат:
The flagged patterns are false positives from Markdown code fences, sample OpenAPI URLs, resource links, UUID schema examples, and generic error responses. No prompt injection, hidden command execution, credential access, or data exfiltration intent was found in SKILL.md.
Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.
https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/wshobson-openapi-spec-generation?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-openapi-spec-generation/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/wshobson-openapi-spec-generation.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>wshobson. (2026). openapi-spec-generation security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8@techreport{wshobson-wshobson-openapi-spec-generation-2026,
author = {wshobson},
title = {openapi-spec-generation security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "openapi-spec-generation security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "wshobson"
date-released: "2026-07-08"
url: "https://skillstore.io/skills/wshobson-openapi-spec-generation/audits/8"
identifiers:
- type: other
value: "skillstore:wshobson-openapi-spec-generation:audit:8"
description: "Skillstore immutable audit report identifier"
Навык каждого автора остаётся отдельным устанавливаемым вариантом. Рекомендуемый вариант ранжируется по данным Skillstore.
Почему этот вариант первый
sickn33-openapi-spec-generation
2026-09-09
wshobson-openapi-spec-generation
2026-09-09
Подготовить черновик спецификации OpenAPI 3.1 до реализации, включая пути, тела запросов, ошибки и аутентификацию.
Преобразовать шаблоны контроллеров FastAPI или TypeScript в согласованную спецификацию OpenAPI для внутренних и внешних потребителей.
Проверить, собрать и структурировать файл OpenAPI перед созданием клиентских библиотек для нескольких языков.
Создайте черновик OpenAPI 3.1 для простого ресурсного API. Включите пути, схемы, примеры, ошибки и bearer-аутентификацию.
Проверьте этот файл OpenAPI на отсутствующие operation IDs, неполное покрытие ответов, повторное использование схем и неясные описания.
Используйте этот код FastAPI или tsoa, чтобы спроектировать соответствующий контракт OpenAPI. Выделите расхождения между реализацией и документированным поведением.
Спроектируйте рабочий процесс валидации для этой спецификации OpenAPI с использованием линтинга, сборки, проверок критических изменений и готовности к генерации SDK.
Автор
wshobsonЛицензия
MIT
Ревизия Skillstore
r1
Примечание о версии
Автор не указал версию.
Репозиторий
https://github.com/wshobson/agents/tree/main/plugins/documentation-generation/skills/openapi-spec-generationСсылка
64ca8af0f54a325752f08bd54e52151061ea659a
Актуальность поддержки
22.07.2026
Использование
12 загрузок · 242 просмотров
Структура файлов
📄 SKILL.md
Оптимизация промптов LLM для продакшена
Промпты LLM часто дают сбой из-за неясных инструкций, примеров и критериев оценки. Этот навык предоставляет шаблоны и рабочие процессы для улучшения промптов в Claude, Codex, Claude Code и похожих инструментах.
Управление разработкой на основе контекста
Проекты с поддержкой ИИ теряют согласованность, когда продуктовые цели, выбор стека и правила рабочего процесса разрознены. Этот навык направляет Claude, Codex и Claude Code с помощью контекстных артефактов Conductor.
Создание финансовых моделей для стартапов
Командам стартапов нужны понятные прогнозы, прежде чем они смогут планировать найм, привлечение финансирования и использование денежных средств. Этот навык структурирует выручку, затраты, runway и сценарии в практические результаты для финансового планирования.
Проектируйте KPI-дашборды, которые помогают принимать решения
Команды часто создают дашборды, которые показывают множество чисел, но не помогают перейти к действию. Этот навык помогает Claude, Codex и Claude Code выбирать значимые KPI, структурировать представления и понятно представлять метрики.
Пишите безобвинительные постмортемы инцидентов
Разборы инцидентов часто становятся непоследовательными, сфокусированными на поиске виновных или сложными для практического применения. Этот навык помогает Claude, Codex и Claude Code составлять структурированные постмортемы с четкими таймлайнами, корневыми причинами и ответственными.
Создавайте понятные истории на основе данных
Сырые метрики часто не убеждают заинтересованные стороны и не помогают принимать решения. Этот skill помогает Claude, Codex и Claude Code превращать анализ в понятные повествования, визуализации и рекомендации.
Создание понятной документации API
от supercent-io
Командам API нужна точная документация, которая объясняет эндпоинты, схемы, аутентификацию и ошибки. Этот навык превращает сведения об API в структурированные справочники и руководства.
Создание точной документации API
от sickn33
Команды API теряют время, когда спецификации, примеры и порталы расходятся с реальным поведением. Этот навык помогает Claude, Codex и Claude Code создавать точную и поддерживаемую документацию API.
Создание понятной документации API
от sickn33
Команды, работающие с API, часто теряют время, когда поведение эндпоинтов неясно. Этот навык превращает код и примеры в структурированную, удобную для разработчиков документацию.
Создать документацию API
от zhangchenlai-dev
Ручная документация API отстает от кода и создает путаницу для разработчиков. Этот навык помогает создавать черновики OpenAPI, примеры запросов и рекомендации по коллекциям Postman на основе доступного кода или сведений об эндпоинтах.
Создание поддерживаемой документации к коду
от sickn33
Ручная документация часто отстает от активно развивающегося кода. Этот навык помогает Claude, Codex и Claude Code создавать понятную документацию и планы автоматизации.
Создание полной технической документации
от 89jobrien
Техническим командам нужна понятная документация для API, релизов и миграций. Этот навык создает структурированную документацию с шаблонами и практическими примерами.