Python Developer Agent Skill Suite

Composable skills for senior-level Python development — one responsibility per skill, explicit handoff contracts, deterministic tooling.

GitHub Example walkthrough Install guide

Get started in 60 seconds

mkdir -p .agents/skills
cp -r python-*/ .agents/skills/

`.agents/skills/` is the vendor-neutral location shared by opencode, Codex CLI, Trae, and most SKILL.md-based agents. Per-host paths for Claude Code and Kilo Code are in the INSTALL.md.

Then just ask your agent

• “Find circular imports in this repo”
• “Review this PR for architectural risks”
• “Plan how to add billing without coupling it to FastAPI handlers”
• “Design the invoice-generation worker”

Each request routes to the smallest specialist skill chain and hands off through explicit contracts.

The 12 skills

Skill	Responsibility
python-agent-orchestrator	Routes work across the suite, defines handoff contracts
python-senior-architect	Architecture analysis, design, ADRs, migration strategy
python-coder	Bounded implementation from a plan or clear request
python-reviewer	Code and PR review for correctness and regressions
python-testing	Test strategy, fixtures, regression and contract coverage
python-security	Auth, secrets, injection, SSRF, dependencies, isolation
python-performance	Profiling, database and async bottlenecks, caching
python-production	Deployment, observability, rollback, incidents
python-dependency-analyzer	Import graphs, cycles, layer violations, dependency health
python-architecture-scanner	Enforces layer contracts and forbidden-import CI gates
python-data-architect	Persistence, data models, migrations, warehouses, pipelines
python-async-architect	Event loops, workers, queues, backpressure, messaging

Why this suite

• One responsibility per skill — no mega-prompt that is architect, implementer, reviewer, and security auditor at once.
• Progressive disclosure — lean SKILL.md entry points, depth in references/, output contracts in templates/.
• Evidence over opinion — claims must be grounded in repository findings; the eval judge fails fabricated evidence.
• Deterministic, dependency-free tooling — import graphs, layer-rule gates, and async-blocking scans are stdlib-only Python that runs in CI.
• Machine-checked consistency — the suite validator verifies skill lists, versions, links, and concern ownership on every change.

Supported hosts

Host	Install
opencode	.agents/skills/, .opencode/skills/, or ~/.config/opencode/skills/
Claude Code	.claude/skills/ or plugin marketplace (/plugin marketplace add bzdvdn/python-developer-ai-skill)
Codex CLI	.codex/skills/ or codex plugin marketplace add bzdvdn/python-developer-ai-skill
Kilo Code	.kilo/skills/
Trae	.trae/skills/