python-api-endpoint-creator — Claude Code skill for FastAPI
Builds FastAPI endpoints and CRUD modules with separate router, service, and repository layers. Use it when adding a domain module and its tests.
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a claude-codeWhat python-api-endpoint-creator does
The skill lays out a module across Pydantic schemas, a SQLAlchemy model, repository, service, dependencies, router, and tests using httpx.AsyncClient. Database work is asynchronous, and the repository applies soft deletion. The router hands requests to the service rather than holding business logic.
Its conventions use GET for reads and POST for mutations, with IDs passed as query parameters. Endpoints are asynchronous unless CPU-bound. Set a response schema on each route: without response_model, FastAPI may serialize internal model fields such as hashed_password or deleted_at.
What it helps with
- add CRUD routes for a FastAPI domain entity
- organize an endpoint into router, service, and repository layers
- create Pydantic schemas and a SQLAlchemy model
- write async API tests with
httpx.AsyncClient
Example prompts for the agent
- Create FastAPI CRUD routes for an order entity and include tests.
- Scaffold a product API module with separate router, service, and repository files.
- Check the new routes for response schemas and suitable status codes.
How to install python-api-endpoint-creator
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a claude-code2Manually: put the files in place
~/.claude/skills/python-api-endpoint-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/python-api-endpoint-creator/
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a codex2Manually: put the files in place
.agents/skills/python-api-endpoint-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a cursor2Manually: put the files in place
.cursor/skills/python-api-endpoint-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install c0x12c/ai-toolkit python-api-endpoint-creator2Manually: put the files in place
.github/skills/python-api-endpoint-creator/SKILL.md1Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/c0x12c/ai-toolkit --path toolkit/skills/python-api-endpoint-creatorManually: put the files in place
.devin/skills/python-api-endpoint-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about python-api-endpoint-creator
How do I install python-api-endpoint-creator in Claude Code?
Run npx skills add c0x12c/ai-toolkit --skill python-api-endpoint-creator -a claude-code. The skill file is at ~/.claude/skills/python-api-endpoint-creator/SKILL.md.
What does python-api-endpoint-creator do?
It scaffolds FastAPI modules across schemas, models, repositories, services, dependencies, routers, and tests. It also sets conventions for HTTP methods and error handling.
How does the skill handle record deletion?
The repository uses soft deletion and filters out records with a set deleted_at value. The deletion route uses POST.