CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reverse-engineering

Brownfield entry point for the V-Model workflow. Reverse-engineers an existing codebase into the standard V-Model artifacts: plan-context.md, ADRs, arc42 snapshot, FEATURE inventory, backlog seed, and an evidence-based BA draft. Walks the V backwards from Coding up to Business Analysis, filling every step only with what can be proven from the code or the existing documentation. Every claim is sourced (path:line or doc section); nothing is invented. Use this skill when the user mentions "existing project", "legacy codebase", "reverse engineer", "import existing code", "brownfield", "we already have code", "onboard existing project", or when the user wants to enter the V-Model workflow but artifacts do not exist yet.

Quality

87%

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, evidence-obsessed workflow skill: every phase names its output files, formats, and verification gates. Its weaknesses are structural — an 840-line monolith with inlined templates that belong in reference files, a duplicated/out-of-order Phase 6, repeated backlog rules, and time-stamped/mixed-language headings that add tokens and confusion.

Suggestions

Merge the Phase 6 stub (line 626) into the real Handoff Ritual section and renumber so phases read in execution order (Phase 7 currently precedes the Phase 6 content); drop the '(added 2026-04-20)' changelog date from the heading.

Move the artifact templates (Epic frontmatter, FEATURE spec skeleton, Codebase-Verifikation block, SC table format, BACKLOG row schema) into one-level-deep reference files under references/ and keep SKILL.md as the phase walkthrough that links to them.

State the backlog Status/Phase/last-change rules once — currently they appear in both the 'MANDATORY: Backlog as single source of truth' section and Phase 5 — and normalize the mixed German/English headings (e.g. 'Graph-Konsistenz-Check', 'Kriterium (observable)', 'Refinement-Bedarf') to one language.

DimensionReasoningScore

Conciseness

Mostly efficient project-specific rules with little explanation of concepts Claude already knows, but there is real tightening to do: Phase 6 appears twice (a "Handoff Ritual (moved, see below)" stub at line 626 and the real content at line 728), backlog status/phase rules are stated in the MANDATORY section and again in Phase 5, and time-stamped detail like "Phase 7: Codebase-Verification Gate (added 2026-04-20)" plus mixed German/English headings ("Graph-Konsistenz-Check", "Verifikations-Befund", "Kriterium (observable)") add tokens without adding instruction. Anti-drift check: anchor 2 would require 'several unnecessary explanations or padded sections' — the content is dense rather than padded — so 3 is the best fit.

3 / 5

Actionability

Guidance is fully concrete and executable: exact artifact paths ("_devprocess/requirements/handoff/plan-context.md", "ADR-{XXX}-{slug}.md"), copy-paste frontmatter blocks for each artifact, shell commands ("mkdir -p {ROOT}/{analysis,...}"; "git for-each-ref --format='%(refname:short)' refs/heads/"; "python3 tools/renumber-for-merge.py --target <re-branch> --source-ref \"$B\" --list-conflicts"), a canonical commit message, and a filled-in example SC table showing exactly what to write. Anti-drift check: anchor 4 ('minor gaps') would apply if key formats were left abstract, but every phase has its output format fully specified.

5 / 5

Workflow Clarity

The V-walk is explicitly sequenced (Phase -1 through 9) with validation checkpoints and feedback loops: "Verify before filing... drop the finding if the target is already satisfied", Phase 7's codebase-verification gate, Phase 8's consistency check, and "Fix any failed gate before running the Handoff Ritual". However the phase numbering is incoherent in places — Phase 6 is declared out of order (stub between 5 and 7, real content after Phase 9) and Phase 7 carries a changelog date in its heading — which keeps it below a 5. Anti-drift check: anchor 3 requires missing or implicit checkpoints, but validation here is explicit and layered; the defect is sequencing, matching anchor 4's 'minor gaps'.

4 / 5

Progressive Disclosure

The file has clear section structure and signals external material by path ("skills/project-conventions/SKILL.md#canonical-specs", "skills/requirements-engineering/templates/BACKLOG-TEMPLATE.md", "tools/migration/*.py"), but no bundle files exist and everything else is inlined in a ~840-line monolith: full Epic/FEATURE frontmatter templates, the SC table format, the Codebase-Verifikation block, and the backlog row schema are exactly the material that belongs in one-level-deep reference files. Anti-drift check: anchor 2 ('minimal structure') is too harsh given the consistent headers and signaled references; anchor 4 requires 'most content appropriately placed', which the inlined templates contradict.

3 / 5

Total

15

/

20

Passed

Description

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

The description is a model example: it states what the skill produces (six named artifacts), how it works (backward V-walk, evidence-only sourcing), and exactly when to invoke it, with a rich set of natural trigger phrases and a fallback condition. It is written in third person and dense without padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete artifacts — "plan-context.md, ADRs, arc42 snapshot, FEATURE inventory, backlog seed, and an evidence-based BA draft" — plus concrete actions ("Reverse-engineers an existing codebase", "Walks the V backwards from Coding up to Business Analysis") and a sourcing convention ("Every claim is sourced (path:line or doc section)"). Coverage of what the skill produces is comprehensive and nothing is padded fluff. Anti-drift check: anchor 4 ("several specific actions; minor gaps") is too weak — no gaps in the artifact list are visible; anchor 5 fits best.

5 / 5

Completeness

It explicitly answers both questions: 'what' ("Reverse-engineers an existing codebase into the standard V-Model artifacts... Walks the V backwards...") and 'when' ("Use this skill when the user mentions 'existing project', ... or when the user wants to enter the V-Model workflow but artifacts do not exist yet"). This mirrors the rubric's 5-anchor example structure of a clear what followed by an explicit Use-when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The 'Use this skill when the user mentions' clause enumerates natural phrases users would actually say: "existing project", "legacy codebase", "reverse engineer", "import existing code", "brownfield", "we already have code", "onboard existing project" — covering synonyms and paraphrases, plus a fallback condition ("wants to enter the V-Model workflow but artifacts do not exist yet"). Anti-drift check: anchor 4 ("a few natural terms missing") undersells the synonym coverage; anchor 5 is the best fit.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and narrow: "Brownfield entry point for the V-Model workflow" that runs when "artifacts do not exist yet", which distinguishes it from the downstream skills it names (/business-analysis, /requirements-engineering) and from greenfield entry points. Triggers like "brownfield" and "we already have code" are unlikely to fire for the wrong skill. Anti-drift check: anchor 4 would apply if triggers could plausibly collide with closely related workflow skills, but the brownfield/no-artifacts precondition disambiguates them.

5 / 5

Total

20

/

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 (838 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/reverse-engineering/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.