Swagger Documenter — Development agent for Claude Code
Enriches the FastAPI OpenAPI/Swagger docs of the BookShelf backend.
How to install Swagger Documenter
Installs to ~/.claude/agents/andrelup-bookshelf-swagger-documenter.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/andrelup/bookshelf/HEAD/.claude/agents/swagger-documenter.md -o ~/.claude/agents/andrelup-bookshelf-swagger-documenter.md Restart Claude Code, or start a new session, for it to be picked up.
What Swagger Documenter does
name: swagger-documenter description: Enriches the FastAPI OpenAPI/Swagger docs of the BookShelf backend. Adds summary, description, response_description and the real error `responses` to endpoints, plus Field descriptions and examples to Pydantic schemas — complementing, never duplicating, what FastAPI already infers. Use after adding or changing a router or schema, and before opening a PR that touches the API surface. tools: Read, Edit, Write, Grep, Glob, Bash model: sonnet
Role
Y
Alternatives in Development
- FastAPI Pro — You are a FastAPI expert specializing in high-performance, async-first API development with modern P... opus w 31.9k ★
- Codebase Mental Model Documenter — Use this agent when you need to create or update technical documentation that helps developers understand the 1.2k ★
- Python Backend Engineer — Expert Python backend developer proficient in FastAPI, Django, and async programming with SOLID principles 1.2k ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
API Docs Engineer
Enriches FastAPI OpenAPI documentation — adds descriptions, examples, response schemas, and tags to routes and
Endpoint Generator
CRUD and custom route generator for Hono APIs. Use when scaffolding new endpoints, implementing CRUD operation
FastAPI Expert
FastAPI development expert for BookShelf backend. Hexagonal Architecture, async SQLAlchemy, Alembic, structure
API Docs Specialist
Use this agent when you need to create, update, or enhance API documentation including OpenAPI/Swagger specifi
Endpoint Hunter
Hunts publicly-exposed sensitive endpoints and files for a previously-ingested program (/.env, /config., /.git
Arch Documenter
Use for generating architecture documentation, API specifications (OpenAPI), Architecture Decision Records (AD
Related Skills
API Documentation
Documents API endpoints with OpenAPI/Swagger format
Nbomber Skills
Claude skills for NBomber. nb-load-test-creator turns an OpenAPI/Swagger spec into a runnable C# NBomber load
Make Docs
Generate the Swagger / OpenAPI spec for the Briefed FastAPI app, pinned to release version 1.0.0.