django-safe-migration

Django AI Skills

Portable Django expertise for Claude Code, Codex, Cursor, OpenCode, and tools that implement the Agent Skills specification.

The repository has one canonical authoring tree under skills/. Host manifests and package-local projections are generated from plugins/catalog.json, so the same behavior is delivered without maintaining separate copies by hand.

Included capabilities

ID	Capability
django-expert	Django backend, ORM, DRF, security, testing, and performance guidance
django-celery-expert	Reliable Celery task design, retries, scheduling, and operations
cdrf-expert	DRF class selection, lifecycle tracing, MRO, and safe override guidance
django-safe-migration	PostgreSQL-aware, zero-downtime Django migration guidance
django-reviewer	Report-first Django and Python review for recent or user-selected changes

See installation and lifecycle instructions for each host and the compatibility matrix for the validation level of every adapter.

Repository layout

skills/                         canonical Agent Skills
plugins/catalog.json            canonical metadata and host declarations
plugins/<id>/                   self-contained generated plugin packages
.claude-plugin/                 Claude marketplace
.agents/plugins/                Codex marketplace
.cursor-plugin/                 Cursor marketplace
.opencode/plugins/              OpenCode skills-path adapter
scripts/                        generation, validation, and isolated smoke checks

Package manifests and package-local skills are generated outputs. Contributors should read AGENTS.md before changing the catalog or skill content.

Local validation

python scripts/generate_adapters.py --check
python scripts/validate_plugins.py
python -m unittest discover -s tests -p 'test_*.py'

The smoke runner accepts claude, codex, cursor, opencode, and agent-skills targets and always installs into a temporary location:

python scripts/smoke_plugins.py --target cursor

These skills can complement the django-ai-boost MCP server; neither project requires the other.

License

MIT © Vinta Software