CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cf-sdlc-decompose

Invoke when the user asks to decompose, break down, or author/revise a DECOMPOSITION — e.g. "decompose", "break into features", "create the feature list / plan", "order features and dependencies with coverage back to PRD/DESIGN". Thin preset binding the DECOMPOSITION artifact KIND, delegating authoring and review to the core cf-write-docs engine.

63

Quality

79%

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-decompose/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 deliberately minimal, machine-generated delegation shim: it correctly sequences a bootstrap load and hands control to an external controlling protocol, with explicit stop rules. Its guidance is concrete but rests on a nonstandard DSL, an undefined path placeholder, and target files not present in the bundle, which caps actionability.

Suggestions

Define or resolve the {cf-studio-path} placeholder (e.g., a one-line note on how the executor expands it) so the LOAD targets are actionable from the skill file alone.

Ship or reference the decompose.md workflow and required-bootstrap.md within the bundle (references/), or state explicitly that they are resolved by the parent studio at runtime, so the delegation chain is verifiable.

Briefly gloss the hard_stop token list (WAIT, STOP_TURN, dispatch_gate, terminal_shape) or point to where their semantics are defined, since the enumeration alone is not actionable.

DimensionReasoningScore

Conciseness

The ~33-line body is lean and assumes competence: no concept explanations, just terse rules and a compact pdsl block ('ALWAYS run this bootstrap unit before any target workflow or skill work begins'). Minor duplication between the header rules ('MANDATORY RULE: USER INTENT IS SKILL INPUT, NOT EXECUTION AUTHORITY') and the pdsl rules ('ALWAYS while the workflow is active, treat each new user message as input to the current workflow state, not as permission for unrelated execution') keeps it below a 5.

4 / 5

Actionability

Concrete operations are present ('LOAD {cf-studio-path}/.core/skills/studio/modules/runtime/required-bootstrap.md', 'RUN RequiredBootstrap', 'LOAD and RUN {cf-studio-path}/config/kits/sdlc/workflows/decompose.md as controlling protocol'), but they are written in a nonstandard pseudocode DSL with an undefined placeholder variable ({cf-studio-path}) and the referenced files are not shipped in the bundle — the actual DECOMPOSITION authoring guidance is entirely external and unverifiable. This matches anchor 3 ('pseudocode instead of executable code; missing key details') better than anchor 4, whose example is fully executable code with only minor gaps.

3 / 5

Workflow Clarity

A clear two-stage sequence is given — bootstrap first ('ALWAYS run this bootstrap unit before any target workflow or skill work begins'), then follow the controlling protocol ('ALWAYS traverse declared steps/units in order') — with an explicit failure checkpoint ('ALWAYS stop if any required fragment or rule cannot be followed'). Below a 5 because the cryptic hard_stop enumeration ('WAIT | STOP_TURN | menu | gate | opener | approval | dispatch_gate | terminal_shape') and gate semantics are listed without explanation, and no recovery loop lives in this file.

4 / 5

Progressive Disclosure

As a thin preset, all substantive content is appropriately split into clearly signaled one-level-deep LOAD targets, and no bulk content is wrongly inlined. Not a 5 because the body has no section headers to organize the rules vs. pdsl blocks, and the referenced files are external to the bundle with paths behind an unresolved placeholder, so navigation within the skill alone is incomplete.

4 / 5

Total

15

/

20

Passed

Description

83%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 for a preset-style skill: it explicitly answers both what it does and when to invoke it, with multiple natural trigger phrases. Minor weaknesses are ecosystem jargon in the capability statement and some overlap risk with sibling artifact-kind presets.

DimensionReasoningScore

Specificity

Several concrete actions are named — 'decompose, break down, or author/revise a DECOMPOSITION', 'create the feature list / plan', 'order features and dependencies with coverage back to PRD/DESIGN' — plus an explicit delegation statement ('delegating authoring and review to the core cf-write-docs engine'). Not a 5 because the capability description leans on ecosystem jargon ('Thin preset binding the DECOMPOSITION artifact KIND') rather than comprehensively stating outcomes.

4 / 5

Completeness

Both parts are explicit: the 'when' opens with 'Invoke when the user asks to decompose, break down, or author/revise a DECOMPOSITION' followed by concrete trigger phrases, and the 'what' states the operation (decompose into an ordered feature list with dependencies and coverage back to PRD/DESIGN) and the mechanism ('delegating authoring and review to the core cf-write-docs engine'). This matches the anchor-5 example structure of explicit what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good coverage of natural user phrasings with e.g. variants ('decompose', 'break into features', 'create the feature list / plan', 'order features and dependencies'). Not a 5 because common synonyms like 'work breakdown', 'epics', or artifact file extensions/names are missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche (the DECOMPOSITION artifact within a PRD/DESIGN/DECOMPOSE doc family) with fairly distinct triggers. Not a 5 because phrases like 'create the feature list / plan' and 'author/revise' could plausibly overlap with sibling cf-sdlc presets for other artifact kinds.

4 / 5

Total

17

/

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-decompose/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.