Python Flask API Boilerplate skill for Claude and Codex
Scaffolds a Flask REST API with an app factory, optional blueprints, your chosen ORM and auth layer, JSON error handlers, and CORS configured exactly as tight…
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 new Flask API needs an app factory scaffold with blueprints, an ORM, an auth decorator, JSON error handlers, and CORS set up from day one. Do not use for choosing between Flask and FastAPI, or generating endpoints from an endpoint list and data models. Related topics: coding, python, flask.
What it will ask you for
- Enable Blueprint routing (choose one: Yes, No)
- Database ORM (choose one: SQLAlchemy, MongoEngine, Raw SQL, None)
- Authentication (choose one: JWT, Session, API Key, None)
- Allow all origins (wildcard) (choose one: Yes, No)
- Specific origin (free text, e.g. "http://localhost:3000")
How it works
- Create the app factory with a Config and TestConfig read from environment variables so tests and production build the app the same way.
- Add the health and example routes as blueprint packages or a single module according to the toggle.
- Initialize the chosen ORM as a factory extension, or a per-request connection helper for raw SQL.
- Implement the chosen auth as a decorator applied to the example resource, with its login route where one is needed.
- Register uniform JSON error handlers, configure CORS from the origin inputs, and output the tree plus every file with requirements and run command.
What you get
A directory tree, then one fenced block per file headed by its path (app factory, config, routes or blueprints, extensions, auth, error handlers, requirements.txt, .env.example), ending with the run command.
What it watches out for
- Allowing all origins with credentials enabled, which browsers reject and which would expose session cookies if they did not.
- Creating the app at import time instead of in a factory, so tests cannot build an isolated instance.
- Comparing an API key with == rather than a constant-time compare, which leaks timing information.
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.