CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cf-sdlc-reverse-engineer

Invoke when the user intent is reconstructing SDLC artifacts (PRD/ADR/DESIGN/DECOMPOSITION/FEATURE) from existing code using code markers (@cpt-*) and the reverse-engineering methodology, without converting from another spec format.

54

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/cf-sdlc-reverse-engineer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a lean, directive-style bootstrap that defers all substantive work to an external controlling protocol. It is token-efficient but lacks actionable detail: the path placeholder is unresolved, no validation checkpoints are defined, and the referenced files are not part of this skill's bundle.

Suggestions

Explain how {cf-studio-path} is resolved (or inline the bootstrap content) so the LOAD instructions are executable without guessing the studio root.

Add explicit validation checkpoints for protocol traversal, e.g. verify each required fragment loaded successfully before proceeding, instead of a single terminal stop rule.

Either ship the referenced files (required-bootstrap.md, reverse-engineer.md) in the skill bundle under references/ with relative paths, or add section headers (## Bootstrap, ## Protocol rules) so the body is navigable on its own.

DimensionReasoningScore

Conciseness

The body is terse and directive-only with no padding or explanation of known concepts ('MANDATORY RULE: USER INTENT IS SKILL INPUT, NOT EXECUTION AUTHORITY', the pdsl LOAD/RUN units). Minor over-explanation remains (the 'ask_tool_description' line defining AskUserQuestion, and the prerequisite rule stated both in prose and in RULES), so it fits anchor 4 rather than 5.

4 / 5

Actionability

Concrete file paths are supplied ('LOAD {cf-studio-path}/.core/skills/studio/modules/runtime/required-bootstrap.md', 'RUN RequiredBootstrap'), but the {cf-studio-path} placeholder is never resolved and the actual work is deferred to files absent from this bundle; the pdsl block reads as structured pseudocode. This matches anchor 3 ('some concrete guidance but incomplete; missing key details').

3 / 5

Workflow Clarity

A rough sequence exists (bootstrap load -> run bootstrap -> load controlling protocol -> traverse steps, evaluate gates) and there is an explicit stop condition ('ALWAYS stop if any required fragment or rule cannot be followed'), but there are no validation checkpoints or feedback loops and the real step list lives in an external file. This is anchor 3 ('sequence present but checkpoints missing or implicit'), not 4.

3 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist alongside SKILL.md; the two referenced paths point into an external {cf-studio-path} tree that cannot be verified, and the body has no section headers. References are clearly signaled via LOAD statements (above anchor 2), but organization and verifiability gaps place it at anchor 3.

3 / 5

Total

13

/

20

Passed

Description

66%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 has a clearly defined, distinctive niche with an explicit when-clause and a useful negative boundary. Its weaknesses are jargon-heavy trigger language (@cpt-*, SDLC) and describing a single action rather than a set of concrete capabilities, which limit specificity and natural keyword coverage.

Suggestions

Rewrite the trigger clause around phrases a user would actually say, e.g. 'Use when the user asks to recover or reverse-engineer a PRD, ADR, design doc, or feature spec from existing code' rather than 'Invoke when the user intent is reconstructing SDLC artifacts'.

List the concrete actions the skill performs (e.g. scans code for @cpt-* markers, maps markers to artifact types, drafts each artifact from the code) instead of one umbrella action plus an enumeration of output formats.

Move internal jargon like 'code markers (@cpt-*)' and 'reverse-engineering methodology' into the body, keeping the description in user-facing vocabulary with synonyms (recover spec, extract design, document architecture).

DimensionReasoningScore

Specificity

The description names the domain ('reconstructing SDLC artifacts (PRD/ADR/DESIGN/DECOMPOSITION/FEATURE) from existing code') and one main concrete action, but enumerates outputs rather than several distinct actions. It matches anchor 3 ('names domain and 1-2 concrete actions'), not 4, which requires a list of several specific actions.

3 / 5

Completeness

Both 'what' (reconstructing SDLC artifacts from existing code) and 'when' ('Invoke when the user intent is...') are explicitly present, plus a boundary clause. Not 5 because the trigger is phrased in meta/jargon terms ('user intent is', '@cpt-*') rather than concrete phrases a user would naturally say.

4 / 5

Trigger Term Quality

Some relevant keywords exist ('PRD', 'ADR', 'reverse-engineering', 'existing code'), but the phrasing leans on internal jargon ('code markers (@cpt-*)', 'SDLC artifacts', 'DECOMPOSITION') and misses natural variations users would say ('recover the spec', 'document the design'). Anchor 4 requires good natural-term coverage, which this lacks.

3 / 5

Distinctiveness Conflict Risk

'reconstructing SDLC artifacts ... from existing code ... without converting from another spec format' carves out a clear niche with distinct triggers and an explicit disambiguation against a sibling spec-conversion skill, matching anchor 5 (clear niche, minimal conflict risk).

5 / 5

Total

15

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

constructorfabric/gears-frontx

Path

.claude/skills/cf-sdlc-reverse-engineer/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.