CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dmr-upgrade

Upgrade a project to a newer django-modern-rest (dmr) release. Use when bumping the django-modern-rest version, when a dependency update breaks imports from `dmr`, or when asked to migrate to a new dmr release. Applies the official migration prompt of every release in between, in order.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

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

An excellent instruction-style skill body: concrete commands, a well-sequenced workflow with strong validation and feedback loops, and clean one-level-deep disclosure of the per-release prompts. Its only flaw is mild repetition of the apply-every-release-in-order imperative.

DimensionReasoningScore

Conciseness

The body is lean, assumes competence, and includes zero explanation of concepts Claude already knows, but the "apply every release, never skip one" imperative is stated roughly four times ("apply all of it", "Never skip a release", "oldest first", "Apply one release at a time"). Fits anchor 4 (minor instances that could be trimmed) rather than 5's "every token earns its place".

4 / 5

Actionability

Fully executable guidance throughout: exact commands ("uv pip show django-modern-rest", "python manage.py dmr_export_schema <schema-path>"), specific lock/requirements file names, a version-range-to-file table, and a versioned llms.txt URL pattern. Copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

Clear sequence (find versions → bump dependency → apply each prompt oldest-first → verify → report) with explicit validation checkpoints (type checker, tests, "diff the output against the previous schema: only intended changes should appear", symbol search with the completion criterion "none is left") and a stop-and-ask escape hatch. The batch migration even gets a feedback loop, matching the anchor for clear sequence with explicit validation and error recovery.

5 / 5

Progressive Disclosure

The SKILL.md is a concise overview and the heavy per-release migration prompts are split into one-file-per-release in references/, clearly signaled by a linked table; all three referenced files exist and match the links. Pre-0.13 guidance points to external release notes rather than nesting files, so references are exactly one level deep with easy navigation.

5 / 5

Total

19

/

20

Passed

Description

95%Weight 40%Scale 1-5

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

A strong description: concrete actions, explicit third-person trigger phrasing with good synonym coverage, and a tightly scoped niche. The only minor gap is that it doesn't hint at the verification/reporting half of the workflow, but everything stated is accurate and unpadded.

DimensionReasoningScore

Specificity

"Upgrade a project to a newer django-modern-rest (dmr) release" and "Applies the official migration prompt of every release in between, in order" name several concrete actions. Not 5 because coverage has minor gaps (e.g., the verification steps central to the skill go unmentioned); not 3 because it goes well beyond naming the domain with 1-2 generic actions.

4 / 5

Completeness

Explicitly answers both questions: what ("Upgrade a project to a newer django-modern-rest (dmr) release... Applies the official migration prompt of every release in between, in order") and when ("Use when bumping... or when asked to migrate...") with three concrete trigger phrases, in third-person voice. Matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

"bumping the django-modern-rest version", "dependency update breaks imports from `dmr`", and "migrate to a new dmr release" give comprehensive natural trigger phrasings with synonyms (upgrade/bump/migrate) plus both the full package name and its abbreviation. No natural term a user would say is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

A clear niche scoped to a single named package's version upgrades with distinct triggers (bump/migrate/broken imports of `dmr`); virtually no overlap risk with any other skill. Clearly matches the anchor for a distinct niche with minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

wemake-services/django-modern-rest

Path

dmr/.agents/skills/dmr-upgrade/SKILL.md

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.