Building Python Web Apps
Provides an opinionated reference architecture for production Python web apps — FastAPI + async SQLAlchemy + Postgres, pydantic-settings config, Stripe billing, server-rendered Jinja or a decoupled SPA, deployed as a single Docker image on a managed platform via Terraform. Use when starting a new SaaS/web app, choosing a stack, structuring routers/services/models, wiring Stripe webhooks, protecting FastAPI docs or OpenAPI routes, setting up config/secrets, or deciding how to deploy.
Install
/plugin marketplace add wdm0006/python-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add wdm0006/python-skills --skill building-python-web-appsgit clone --depth 1 https://github.com/wdm0006/python-skills.git /tmp/python-skills
mkdir -p ~/.claude/skills
cp -r /tmp/python-skills/skills/python/web-app-architecture ~/.claude/skills/building-python-web-appsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Building Python Web Apps An opinionated, batteries-included blueprint for shipping a small-to-mid SaaS app solo or with a small team. It favors **boring, well-understood pieces wired the same way every time** so a new app reaches "auth + billing + deploy" in hours, not weeks. ## The Default Stack | Concern | Default | |----------------|---------------------------------------------------------------| | Framework | **FastAPI** (async), `uvicorn[standard]` | | Packaging | **uv** + `pyproject.toml` + `uv.lock`, hatchling, `src/` layout | | Database | **Postgres 16** + `asyncpg`, **SQLAlchemy 2.0** async, **Alembic** | | Config | **pydantic-settings** `BaseSettings`, env-prefixed, `@lru_cache` | | Payments | **Stripe ≥15**, one signed webhook, idempotency table | | Auth | dependency guards + **bcrypt**; token scheme per app (see AUTH.md) | | Frontend | **Jinja2 + Tailwind (CDN) + Alpine.js**, *or* a decoupled SPA | | Background work | **cron-as-worker** (same image, different command) — no Celery | | Observability | **Sentry + PostHog**, both no-op until keyed | | Deploy | **Docker** → managed platform (Render-style) via **Terraform** | | Lint/test | **ruff** + **pytest** + `pytest-asyncio`, Makefile entrypoint | If you have no reason to deviate, use every row. The rest of this skill is the
Details
- Skill name
building-python-web-apps- Repository
- wdm0006/python-skills
- Path
skills/python/web-app-architecture/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
FAQ
What does the Building Python Web Apps skill do?
Provides an opinionated reference architecture for production Python web apps — FastAPI + async SQLAlchemy + Postgres, pydantic-settings config, Stripe billing, server-rendered Jinja or a decoupled SPA, deployed as a single Docker image on a managed platform via Terraform. Use when starting a new SaaS/web app, choosing a stack, structuring routers/services/models, wiring Stripe webhooks, protecting FastAPI docs or OpenAPI routes, setting up config/secrets, or deciding how to deploy.
How do I install the Building Python Web Apps skill?
Claude Code plugin: /plugin marketplace add wdm0006/python-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Building Python Web Apps popular?
It lives in wdm0006/python-skills, which has 115 GitHub stars and 18 forks.
Related skills
Auditing Python Security
115wdm0006/python-skills
Audits Python libraries for security vulnerabilities using Bandit, pip-audit, Semgrep, and detect-secrets. Identifies SQL injection, command injection, hardcoded credentials, secrets exposed through tracebacks, weak cryptography, and insecure deserialization. Use when reviewing library security, setting up security scanning in CI, or implementing secure coding patterns.
Building Accessible Interfaces
115wdm0006/python-skills
Makes web and app UIs usable by keyboard, screen-reader, low-vision and motion-sensitive users — semantic HTML before ARIA, labelled controls, visible focus, WCAG AA contrast measured rather than eyeballed, touch targets, reduced motion, and automated axe checks plus a manual keyboard pass in CI or before every UI PR. Use when building or restyling a screen, adding a form, modal, menu or custom control, choosing colors, or reviewing a UI change.
Building Browser Extensions
115wdm0006/python-skills
Builds and tests Manifest V3 browser extensions — service-worker message channels that survive teardown, chrome.storage read-modify-write safety, settings validation in the popup, and a Jest chrome mock that can actually fail. Use when writing or reviewing a background service worker, a popup that reads/writes chrome.storage, an extension's Jest suite, or debugging an extension whose UI silently stops responding.
Building Rust Crates
115wdm0006/python-skills
Sets up, tests, and publishes Rust crates — Cargo project layout, a fmt/clippy/test CI gate that actually gates, MSRV pinning, feature-flag hygiene, and crates.io publishing with cargo-release. Use when creating a Rust crate, wiring GitHub Actions for Rust, debugging a clippy or MSRV CI failure, or preparing a crates.io release.
Building Python Communities
115wdm0006/python-skills
Builds and manages open source Python library communities including CONTRIBUTING.md, CODE_OF_CONDUCT.md, issue/PR templates, contributor recognition, and GitHub automation. Use when setting up community infrastructure, improving contributor experience, or managing project governance.
Deferring Heavy Dependencies
115wdm0006/python-skills
Keep expensive resources — ML models, spellcheck dictionaries, embedded databases, large third-party imports — off code paths that never use them. Covers constructor work paid by every caller, one-size factories that load the heaviest member for the cheapest request, load-and-unload-per-call masquerading as a cache, measuring per-call cost in a fresh process, telling a one-time import from a repeated model load, and the test fallout (patches that only now take effect, autouse fixtures that hide the dependency). Use when a trivially cheap operation takes hundreds of milliseconds, when adding a
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.