CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cf-sdlc-doc-feature

Invoke when the user asks to author, write, revise, generate, or spec a FEATURE — e.g. "generate FEATURE", "spec the feature", "define flows / algorithms / states / definition of done (CDSL)", "write test scenarios for a feature". Thin preset binding the FEATURE artifact KIND, delegating authoring and review to the core cf-write-docs engine.

62

Quality

78%

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

Quality

Content

63%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 lean, coherently ordered bootstrap preset: it sequences load-bootstrap → run protocol → follow steps in order with explicit stop conditions and no wasted tokens. Its weaknesses are executability — the "{cf-studio-path}" placeholder is never resolved and all substantive guidance is delegated to files that are not part of the bundle — and a single generic stop rule standing in for any validation or error-recovery checkpoint.

Suggestions

Define or resolve {cf-studio-path} explicitly (e.g., state how to locate it — a fixed root, an environment variable, or a path relative to the skill bundle) so the two LOAD instructions are executable as written.

Replace the bare "ALWAYS stop if any required fragment or rule cannot be followed" with a concrete fallback for the likely failure case: what to do when required-bootstrap.md or doc-feature.md is missing or unreadable (e.g., report the missing path to the user and halt).

De-duplicate the intent-is-input rule, which appears both as "MANDATORY RULE: USER INTENT IS SKILL INPUT, NOT EXECUTION AUTHORITY" and again in GeneratedFollowProtocol's RULES — keeping one authoritative statement would tighten the body further.

DimensionReasoningScore

Conciseness

The ~30-line body is lean, explains no concepts Claude already knows, and every block carries instructions. Not 5 because the intent-is-input rule is stated twice ("MANDATORY RULE: USER INTENT IS SKILL INPUT, NOT EXECUTION AUTHORITY" and again as "treat each new user message as input to the current workflow state, not as permission for unrelated execution") and the top rule block partially duplicates the pdsl RULES; not 3 because there is no padding or over-explanation beyond that minor duplication.

4 / 5

Actionability

Concrete targets exist (LOAD the two named files, RUN RequiredBootstrap, follow doc-feature.md as controlling protocol), but "{cf-studio-path}" is never resolved or defined anywhere in the skill or bundle, the pdsl block is a declarative spec rather than executable commands, and the actual feature-authoring work is delegated wholesale with no stated fallback. Fits the 3 anchor (some concrete guidance but incomplete, missing key details); not 4 because the unresolved path placeholder is a real execution gap rather than a minor one.

3 / 5

Workflow Clarity

The sequence is explicit and ordered: run the bootstrap unit before any work, then load doc-feature.md as controlling protocol, then "traverse declared steps/units in order", "evaluate conditional gates", with "ALWAYS stop if any required fragment or rule cannot be followed" as a guard. Not 5 because there is no error-recovery guidance beyond the generic stop rule (e.g., what to do when the target protocol file is missing); not 3 because the ordering and gate rules are explicit and coherent.

4 / 5

Progressive Disclosure

The body appropriately delegates detail to two named files, but both references live outside the bundle at an unresolved placeholder path, and the bundle itself contains no references/, scripts/, or assets/ directories to back them — scored against the actual (empty) bundle structure, the references are present but neither clearly signaled as navigable material nor resolvable. Not 2 because the short body is well organized into units and does not inline content that belongs elsewhere; not 4 because the references cannot be followed from what is written.

3 / 5

Total

14

/

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: it explicitly states both what the skill does and when to invoke it, with concrete quoted trigger phrases and good verb-synonym coverage. Its main weakness is reliance on internal kit jargon (artifact KIND, thin preset, cf-write-docs engine, CDSL) that a user outside the CF/SDLC studio would not naturally say.

DimensionReasoningScore

Specificity

Lists several concrete actions — "author, write, revise, generate, or spec a FEATURE", "define flows / algorithms / states / definition of done (CDSL)", "write test scenarios for a feature" — each backed by quoted example utterances. It is not 5 because the action list is bookended by internal jargon ("Thin preset binding the FEATURE artifact KIND", "delegating ... to the core cf-write-docs engine") that names machinery rather than user-visible capabilities; not 3 because it goes well beyond naming a domain plus 1–2 actions.

4 / 5

Completeness

Explicitly answers both questions: "when" via "Invoke when the user asks to author, write, revise, generate, or spec a FEATURE" with concrete quoted trigger phrases, and "what" via "Thin preset binding the FEATURE artifact KIND, delegating authoring and review to the core cf-write-docs engine". Not 4 because the 'when' clause is not merely present — it is highly explicit with example utterances, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good natural-language coverage via quoted example triggers ("generate FEATURE", "spec the feature", "write test scenarios for a feature") plus verb synonyms (author/write/revise/generate/spec). Not 5 because common variations a user might actually say ("feature spec", "write requirements", "acceptance criteria") are absent and "definition of done (CDSL)" is kit jargon rather than a natural user phrase; not 3 because multiple natural phrasings and synonyms are explicitly present.

4 / 5

Distinctiveness Conflict Risk

Anchored to the FEATURE artifact kind with kit-specific markers (FEATURE, CDSL, definition of done, test scenarios), making it mostly distinct from generic document skills. Not 5 because the broad verbs (author/write/generate) could overlap with sibling artifact presets in the same kit; not 3 because the FEATURE/CDSL vocabulary narrows the trigger space considerably.

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-doc-feature/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.