CtrlK
BlogDocsLog inGet started
Tessl Logo

django-migrations

Django migration patterns and safety workflow for PostHog. Use when creating, adjusting, or reviewing Django/Postgres migrations, including non-blocking index/constraint changes, multi-phase schema changes, data backfills, migration conflict rebasing, and product model moves that require SeparateDatabaseAndState. Also use for any deletion or removal of a model, table, column, product, or app — including deleting migration files or retiring a feature — even when no migration is written.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an actionable, well-sequenced PostHog migration safety guide that assumes Claude's competence and concentrates on non-obvious project-specific hazards (hot tables, cross-language NOT NULL, CI policies), with concrete commands, named helpers, and explicit validation feedback loops. It is dense but not padded with general knowledge.

DimensionReasoningScore

Conciseness

Assumes Claude's competence — no generic 'what is a migration' preamble — and every section covers non-obvious PostHog-specific hazards (hot-table locks, cross-language NOT NULL, CI guards) that Claude does not already know, so each token earns its place; not level 2 because it is not padded with general knowledge, though a few narrative asides could be trimmed.

3 / 3

Actionability

Gives copy-paste-ready commands and named helpers — 'DEBUG=1 ./manage.py makemigrations', 'python manage.py rebase_migration <app>', 'SafeAddIndexConcurrently', 'AddForeignKeyNotValid' — and complete executable code for db_default= and RunSQL, matching the level-3 fully-executable anchor.

3 / 3

Workflow Clarity

An explicit Classify → Generate → Apply safety rules → Validate workflow with validation checkpoints ('./manage.py sqlmigrate', run tests, confirm linear sequence), a sequenced retire-model procedure with deploy-cycle waits, and verify/feedback loops ('sqlmigrate', 'makemigrations --dry-run') for destructive DB operations, matching the level-3 anchor.

3 / 3

Progressive Disclosure

Opens with 'Read these files first' pointing to four well-signaled one-level-deep doc paths, then keeps the overview inline with content appropriately split; references are clearly navigable rather than monolithic or nested, matching the level-3 anchor.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, well-triggered, complete, and distinctive — naming concrete migration operations and deletion/retirement cases with explicit 'Use when' guidance and a clear boundary against the sibling ClickHouse skill. It uses third person throughout and avoids fluff.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'creating, adjusting, or reviewing Django/Postgres migrations, including non-blocking index/constraint changes, multi-phase schema changes, data backfills, migration conflict rebasing, and product model moves' — plus deletions; matches the level-3 anchor of multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both 'what' ('Django migration patterns and safety workflow for PostHog') and 'when' via an explicit 'Use when...' clause plus 'Also use for any deletion or removal...', matching the level-3 anchor for both what AND when.

3 / 3

Trigger Term Quality

Natural user-facing terms abound — 'Django/Postgres migrations', 'deletion or removal of a model, table, column, product, or app', 'deleting migration files', 'retiring a feature'; good coverage of phrasings users would say, matching the level-3 anchor.

3 / 3

Distinctiveness Conflict Risk

Clear narrow niche (PostHog Django/Postgres migrations) with distinct triggers and an explicit hand-off ('If the task is a ClickHouse migration, use clickhouse-migrations instead'), making conflict unlikely; matches the level-3 anchor.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
PostHog/posthog
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.