CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dia-migration

Convenience wrapper for existing DIA users upgrading between DIA versions (e.g. v1 -> v2 -> v3). Runs the migration scripts under `tools/migration/` in sequence: detect state, strip status duplicates, rename IDs (FEATURE-NNNN -> FEAT-EE-FF, EPIC-NNN -> EPIC-NN), flatten analysis/, regenerate BACKLOG.md, update skill-name references, run `/consistency-check` mode A. Idempotent. Use this skill when the user already has DIA artefacts and wants to upgrade to current conventions without the full reverse-engineering walk. Triggers: "migrate to DIA v2", "migrate v1", "upgrade DIA", "convert backlog", "restructure backlog", "FEATURE to FEAT". For BROWNFIELD projects (no `_devprocess/` yet, only code), use `/reverse-engineering` instead -- it absorbs the same migration mechanics for any pre-existing partial artefacts and additionally walks the code to fill the gaps.

Quality

84%

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

71%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.

A highly actionable, well-sequenced migration procedure with strong safety rails (confirmations, backups, rollback, idempotency). Its weaknesses are redundancy (duplicated tool tables and repeated explanations), internal inconsistencies (duplicate step numbering, contradictory branch names), and a monolithic structure with no progressive disclosure into reference files.

Suggestions

Merge the duplicated script tables ('Shared tooling' and 'Tools') into a single table, and state the legacy mini-BA move once (in Phase 4) instead of four times across Phases 0, 1, 3, and 4.

Split the Phase 3 rename mapping table and the Phase 8 parallel-branch procedure into references/ files (e.g. references/rename-mappings.md), keeping SKILL.md as a lean overview that points one level deep.

Fix the workflow defects: renumber the two consecutive '10' steps in 'Workflow when invoked', reconcile the branch naming ('chore/dia-migration-<YYYY-MM-DD>' vs 'feature/dia-migration'), and correct 'seven phases' to match the actual phase count.

DimensionReasoningScore

Conciseness

Mostly efficient domain-specific content, but there is real redundancy: the tools/migration script table appears verbatim in both 'Shared tooling' and 'Tools', the legacy mini-BA move (EPIC-{nn}-ba.md -> analysis/BA-EPIC-{nn}-{slug}.md) is explained four times (Phase 0, Phase 1, Phase 3 table, Phase 4), the brownfield -> /reverse-engineering redirect appears three times, and trigger phrases are repeated across the description, 'When to invoke', and 'Keywords'. Anchor 3 ('mostly efficient but could be tightened') fits; not 2 because nearly all content is load-bearing rather than padded filler.

3 / 5

Actionability

Fully executable guidance throughout: exact script invocations ('python3 tools/renumber-for-merge.py --target chore/dia-migration-<date> --list-conflicts'), copy-paste git commands ('git for-each-ref --format=...'), exact commit message format ('chore(dia-migration): phase N -- {short summary}'), concrete rename mapping tables, and a runnable rollback command ('mv _devprocess/context/BACKLOG.md.preMigration _devprocess/context/BACKLOG.md'). Matches the anchor for copy-paste ready commands covering common cases.

5 / 5

Workflow Clarity

The phase sequence (0 through 7 plus 5b and 8) is clearly ordered with per-phase user confirmations, per-phase commits, a failure/rollback section, and a final consistency check as validation, so destructive/batch operations do have checkpoints and the cap-at-3 rule does not apply. Held at 4 rather than 5 due to concrete defects: the 'Workflow when invoked' list numbers two consecutive items '10', the intro says 'seven phases' while the workflow actually spans phases 0-8, and the branch convention contradicts itself ('chore/dia-migration-<YYYY-MM-DD>' in the pre-phase vs 'feature/dia-migration' in Safety contract rule 1).

4 / 5

Progressive Disclosure

The skill is a 540-line monolithic SKILL.md with no references/ directory at all; content that clearly belongs in separate files (the Phase 3 rename mapping table, the Phase-by-phase detail, the Phase 8 branch-alignment procedure) is inlined. Section headers are clear and well-organized, matching anchor 3 ('some structure... content that should be separate is inline'), but a leaner overview pointing one level deep into reference files would match anchor 5.

3 / 5

Total

15

/

20

Passed

Description

92%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.

An exemplary description: concrete action list, explicit 'Use when' clause, an explicit trigger phrase list, and clear boundary guidance steering brownfield cases to the sibling skill. The only gap is a few missing natural trigger variants (v3, V-Model terminology).

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with concrete details: 'detect state, strip status duplicates, rename IDs (FEATURE-NNNN -> FEAT-EE-FF, EPIC-NNN -> EPIC-NN), flatten analysis/, regenerate BACKLOG.md, update skill-name references, run /consistency-check mode A'. This matches anchor 5 (comprehensive coverage of specific concrete actions); score 4 would require minor gaps in coverage, and there are none.

5 / 5

Completeness

Both questions are explicitly answered: what ('Runs the migration scripts under tools/migration/ in sequence: ...') and when ('Use this skill when the user already has DIA artefacts and wants to upgrade to current conventions'), plus concrete trigger phrases. This matches anchor 5 exactly.

5 / 5

Trigger Term Quality

An explicit 'Triggers:' list provides natural phrases users would actually say ('migrate to DIA v2', 'upgrade DIA', 'convert backlog', 'restructure backlog', 'FEATURE to FEAT'). Falls just below anchor 5 because a few natural variants are missing: 'migrate to DIA v3' (despite v3 being named in the first sentence), 'V-Model migration', and 'update/upgrade conventions'.

4 / 5

Distinctiveness Conflict Risk

A clear niche (DIA version migration) with distinct triggers and an explicit negative boundary that prevents mis-invocation: 'For BROWNFIELD projects (no _devprocess/ yet, only code), use /reverse-engineering instead'. Minimal conflict risk, matching anchor 5.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (561 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

salemaziel/digital-innovation-agents

Path

skills/dia-migration/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.