Към всички skills

swagger-gen

sundial-org · Инструменти

Generate OpenAPI specs from Express routes. Use when documenting APIs.

Оригинален текст · няма потвърден превод на български

Първо прочетете инструкцията.

Файлът се зарежда от посочения източник само по ваше действие. Можете да го прочетете тук, да го копирате или да го запазите като .md.

Оригинален SKILL.md
GitHub хранилище
Звезди на репото
370
Лиценз
Не е посочен. Проверете в репозитория.
Последна проверка на записа
Няма посочена дата

Добавете в своя инструмент.

Командата отваря избора на skills от репозитория. Прочетете файла и условията на автора преди изпълнение.

npx skills add sundial-org/awesome-openclaw-skills

Страницата копира текст. Не инсталира и не изпълнява нищо на устройството ви.

Откъс от SKILL.md

Началото на файла на автора, без превод.

Swagger Generator

Your API has no documentation. This reads your Express routes and generates a complete OpenAPI 3.0 spec.

One command. Zero config. Just works.

Quick Start

npx ai-swagger ./src/routes/

What It Does

  • Reads your Express route files
  • Generates OpenAPI 3.0 specification
  • Documents request/response shapes
  • Ready for Swagger UI

Usage Examples

# Generate from routes
npx ai-swagger ./src/routes/

# Single file
npx ai-swagger ./src/routes/users.ts -o docs/api.yaml

Best Practices

  • Keep it updated - regenerate when routes change
  • Add descriptions - explain what endpoints do
  • Include examples - show sample requests
  • Document errors - not just happy paths

When to Use This

  • Creating API documentation
  • Setting up Swagger UI
  • Onboarding API consumers
  • API-first design

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

npx ai-swagger --help

How It Works

Parses your Express route definitions to extract endpoints, methods, and handler code. Then generates OpenAPI spec with proper types and descriptions.

License

MIT. Free forever. Use it however you want.

Целият SKILL.md в GitHub