py-dev-kit

Modern Python development plugin for Claude Code and Factory Droid.

The repository ships as a single plugin tree that both agents can install. Skills are the one shared source of truth (skills/); each agent reads its own manifest and subagent directory and shares commands/ and the pre-commit hook.

py-dev-kit/
├── .claude-plugin/        # Claude Code manifest + marketplace
├── .factory-plugin/       # Factory Droid manifest + marketplace
├── agents/                # Claude Code subagents
├── droids/                # Factory Droid subagents
├── commands/              # shared slash commands
├── hooks/                 # shared pre-commit script + hooks.json (both agents)
├── skills/                # shared skills (single source)
└── templates/             # project scaffolding for both agents

Installation

Claude Code

/plugin marketplace add asynq-io/py-dev-kit
/plugin install py-dev-kit@asynq-io

Factory Droid

droid plugin marketplace add asynq-io/py-dev-kit
droid plugin install py-dev-kit@asynq-io --scope user

Then initialize your project with /py-dev-kit:setup.

Commands

• /py-dev-kit:setup — initialize the project with CLAUDE.md, AGENTS.md, and the matching settings files from templates/ (safe to run on existing projects: merges, never overwrites)
• /py-dev-kit:implement <feature description> — full feature workflow: plan (waits for approval), implement, review, test, fix until green
• /py-dev-kit:review — full code review of current changes via the code-reviewer subagent, with parallel fix subagents and a final verification run

Skills

• code-style — PEP8, precise typing, self-documenting code
• pytest — function-only tests, anyio, fixtures, parametrization, branch coverage
• anyio — AnyIO reference: structured concurrency, cancellation, streams, testing
• alembic — autogenerated migrations only, never hand-written
• api-design — REST guidelines (Zalando-based): URLs, payloads, pagination, compatibility
• fastapi-best-practices — FastAPI routers, Pydantic v2, dependencies, httpx tests

Subagents

• code-reviewer — read-only diff review enforcing the skills plus API/compat bars
• test-writer — delegated pytest-writing task following the pytest skill

Hooks

• PostToolUse — runs pre-commit after every file edit (shared hooks/pre-commit.sh)

Other tools (outside of plugin)

Test and verify on your own

• Python LSP
• rtk
• serena
• codebase-memory-mcp
• context7
• context-mode