Python REST API Architect skill for Claude and Codex
Lays out a complete Python REST API project in Flask, FastAPI, or Django REST Framework: directory tree, every source file, a README, and an OpenAPI spec when…
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a whole Python REST API project in Flask, FastAPI, or Django REST Framework must be generated with auth, a database, and optionally an OpenAPI spec and async views. Do not use for a single FastAPI endpoint, or a Flask-only scaffold with blueprints and CORS. Related topics: coding, python.
What it will ask you for
- Framework (choose one: Flask, FastAPI, Django Rest Framework)
- Authentication method (choose one: JWT, OAuth2, API Key, None)
- Database type (choose one: PostgreSQL, MySQL, SQLite, MongoDB, None)
- Endpoint definitions (longer free text)
- Include OpenAPI spec (choose one: Yes, No)
- Use async (choose one: Yes, No)
How it works
- Lay out the directory tree in the convention of the chosen framework so the structure is recognizable.
- Derive models and schemas or serializers from the resources named in the endpoint list.
- Implement every endpoint with correct status codes and one shared validation error shape, honoring the async toggle where the framework allows.
- Add the chosen auth as a dependency or decorator on every non-public endpoint, including the route that issues credentials.
- Write the README with install and run steps and generate or hand-write the OpenAPI spec when requested, then output the full document.
What you get
One markdown document: directory tree, full source of every file in fenced blocks with language tags, a concise README with install and run steps, and the OpenAPI spec when requested.
What it watches out for
- Declaring async views on top of a synchronous database driver, which blocks the event loop and performs worse than sync.
- Hand-writing an OpenAPI file for FastAPI or DRF that drifts from the one the framework already generates.
- Leaving the token-issuing route out, so the auth dependency can never be satisfied.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.