Agent skill

python3-web

Python web and API development with strong request boundaries, typed validation, and maintainable service design. Activates on FastAPI, Starlette, Django, Flask, HTTP endpoints, request models, authentication flows, or web framework tasks.

View SKILL.md on GitHub Repository
Stars 33
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/python-engineering/skills/python3-web

SKILL.md

Python Web

Load python3-core for standing defaults. Load python3-typing for request/response modeling. Load python3-testing for endpoint and auth tests.

Quality Checklist

  • Route handlers contain NO business logic — only validation, delegation, response mapping
  • No framework objects (Request, Response, ORM models) leak into domain layer
  • model_config = {"strict": True} on all request models
  • Separate request and response models per endpoint — never reuse ORM models as API schemas
  • Auth resolved at edge; domain functions receive typed identity, never raw tokens
  • Domain exceptions mapped to HTTP status codes at boundary, not scattered through handlers
  • Async handlers use httpx.AsyncClient — never requests (blocks event loop)
  • Background tasks hold no references to request-scoped objects

Gotchas

Trap What to do instead
FastAPI dep ordering assumptions Dependencies resolve by graph, not definition order — chain explicitly if order matters
Pydantic v1/v2 method mixing v2: model_dump(), model_dump_json(), model_validate() — never .dict() / .json()
import requests in async handler requests blocks event loop; use httpx.AsyncClient with async with
Django ORM in async views Bare Model.objects.get() blocks; use aget() (Django 4.1+) or sync_to_async
allow_origins=["*"] Enumerate specific origins — * disables credential support, security risk
Single model for request + response + DB Three separate models: CreateUserRequest, UserResponse, UserDB

Decision Table: Sync vs Async

Scenario Use Why
CPU-bound processing Sync + thread pool async doesn't help CPU work
Multiple external API calls Async + httpx.AsyncClient Concurrent I/O without threads
Simple CRUD with sync ORM Sync handlers Async adds complexity with no benefit
WebSocket connections Async (required) Inherently long-lived

Layer Separation

text
HTTP Layer (routes) → validated typed request models
Domain Layer (logic) → typed domain objects
Data Layer (repo/ORM)

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

Jamie-BitFlight/claude_skills

ccc

This skill should be used when code search is needed (whether explicitly requested or as part of completing a task), when indexing the codebase after changes, or when the user asks about ccc, cocoindex-code, or the codebase index. Trigger phrases include 'search the codebase', 'find code related to', 'update the index', 'ccc', 'cocoindex-code'.

33 4
Explore
Jamie-BitFlight/claude_skills

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

33 4
Explore
Jamie-BitFlight/claude_skills

delegate

Quick delegation template for sub-agent prompts. Use when assigning work to a sub-agent, before invoking the Agent tool, or when preparing prompts for specialized agents. Provides the WHERE-WHAT-WHY framework. For comprehensive delegation guidance, activate the agent-orchestration how-to-delegate skill.

33 4
Explore
Jamie-BitFlight/claude_skills

swarm-spawning

Spawn agents and teammates in Claude Code swarms. Use when choosing between subagents vs teammates, selecting agent types (Explore, Plan, general-purpose, plugin agents), configuring spawn backends (in-process, tmux, iterm2), or setting environment variables for spawned agents.

33 4
Explore
Jamie-BitFlight/claude_skills

knowledge-explorer

Manage the research/ knowledge base (KB) of tool and library research entries. Use when browsing KB topics, adding new research entries, updating existing entries with dated revisions, fetching GitHub repo metadata into a draft KB entry, or migrating old-format entries to skill-spec frontmatter. Triggers on tasks like "what do we have on X", "add this to the KB", "update the KB entry for Y", "fetch github info for owner/repo", or "migrate old entries".

33 4
Explore
Jamie-BitFlight/claude_skills

design-anti-patterns

Enforce anti-AI UI design rules based on the Uncodixfy methodology. Use when generating HTML, CSS, React, Vue, Svelte, or any frontend UI code. Prevents "Codex UI" — the generic AI aesthetic of soft gradients, floating panels, oversized rounded corners, glassmorphism, hero sections in dashboards, and decorative copy. Applies constraints from Linear/Raycast/Stripe/GitHub design philosophy: functional, honest, human-designed interfaces. Triggers on: UI generation, dashboard building, frontend component creation, CSS styling, landing page design, or any task producing visual interface code.

33 4
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results