PY

Provides architectural decision trees and best practices for Python backend framework selection.

Install

mkdir -p .claude/skills/python-pro-pikakit && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13829" && unzip -o skill.zip -d .claude/skills/python-pro-pikakit && rm skill.zip

Installs to .claude/skills/python-pro-pikakit

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Python development with FastAPI, Django, or Flask. Async patterns, type hints, project structure. Use when building Python backends, scripts, or choosing Python frameworks. NOT for Node.js projects (use nodejs-pro) or general AI agents (use google-adk-python).
260 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Intermediate

Key capabilities

  • →Select the appropriate Python framework based on project scope and scale.
  • →Classify workloads as I/O-bound or CPU-bound to decide between async and sync.
  • →Define architecture layering with routes, services, and repositories.
  • →Enforce type hints on all public APIs.
  • →Utilize Pydantic for input/output validation.
  • →Provide recommendations for background tasks using Celery.

How it works

The skill uses a decision tree and classification rules to recommend Python frameworks and architectural patterns based on project requirements. It provides guidelines for type hinting and project structure.

Inputs & outputs

You give it
Project requirements including scope, scale, and async needs
You get back
A recommendation for a Python framework, async/sync approach, and architectural layering

When to use python-pro

  • →Choosing a Python framework
  • →Structuring a Python backend
  • →Planning async architectures

About this skill

Python Backend Engineering

Build typed, observable Python systems with explicit ownership of blocking work and lifecycle state.

Workflow

  1. Confirm the supported Python version, packaging tool, deployment target, and concurrency model.
  2. Choose a framework from product requirements rather than popularity.
  3. Isolate transport, domain, persistence, and integration boundaries.
  4. Validate external data at entry points and type public interfaces.
  5. Keep blocking work outside the event loop; add deadlines and cancellation to I/O.
  6. Define structured errors, logging, metrics, startup, shutdown, and rollback behavior.
  7. Test behavior at unit, integration, and contract boundaries.

Routing

ConcernRead
Framework decisionframework-selection.md
Package boundariesproject-structure.md
Async and cancellationasync-patterns.md
FastAPIfastapi-patterns.md
Djangodjango-patterns.md
Type contractstype-hints.md
Teststesting-patterns.md
Cross-cutting gateengineering-spec.md

Release Gate

Require locked dependencies, type checking, deterministic tests, migration review, timeouts for external I/O, graceful shutdown, and redacted diagnostics. Fail when a required check cannot run.

When not to use it

  • →When working on Node.js projects.
  • →When the task is general AI agent development.
  • →When the task involves API design, testing strategy, or database schema.

Limitations

  • →The skill focuses on Python development with FastAPI, Django, or Flask.
  • →The skill produces recommendations and does not write code.
  • →The skill does not cover API design, testing strategy, or database schema.

How it compares

This skill provides deterministic recommendations for Python framework selection and architecture based on specific criteria, unlike general programming advice.

Compared to similar skills

python-pro side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
python-pro (this skill)04moNo flagsIntermediate
python-configuration54moReviewBeginner
python-development-python-scaffold15moReviewBeginner
backend-architect105moNo flagsAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

python-configuration

wshobson

Python configuration management via environment variables and typed settings. Use when externalizing config, setting up pydantic-settings, managing secrets, or implementing environment-specific behavior.

542

python-development-python-scaffold

sickn33

You are a Python project architecture expert specializing in scaffolding production-ready Python applications. Generate complete project structures with modern tooling (uv, FastAPI, Django), type hint

14

backend-architect

sickn33

Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.

1014

design

matteocervelli

Design component architecture, REST API contracts, and data models (Pydantic schemas) before implementation. Use when planning how to build a feature, defining endpoints, or modeling data. Trigger on "design the architecture", "design the API", "data model", "how should I structure this feature".

00

fastapi-templates

wshobson

Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.

5201,086

fastapi-pro

sickn33

Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use PROACTIVELY for FastAPI development, async optimization, or API architecture.

79181

Search skills

Search the agent skills registry