CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cf-sdlc-doc-adr

Invoke when the user asks to author, write, revise, generate, or record an ADR or architecture decision — e.g. "generate ADR", "record a decision", "document why we chose X", "capture context / options / decision / consequences". Thin preset binding the ADR artifact KIND, delegating authoring and review to the core cf-write-docs engine.

60

Quality

75%

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-adr/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 machine-generated delegation stub: a lean, rule-dense control script that loads a bootstrap and hands control to an external workflow file. It is efficient in length but scores mid-range on actionability and workflow clarity because everything task-relevant lives behind pseudocode, a placeholder path, and files absent from the bundle, leaving Claude with no concrete or verifiable steps inside SKILL.md itself.

Suggestions

Resolve the {cf-studio-path} placeholder (or explain how it is resolved at runtime) and confirm the two LOAD targets exist relative to the skill, so the delegation steps are actionable rather than pseudocode with an unknown base path.

Include a minimal fallback outline of the ADR workflow in the body (context / options / decision / consequences sections) so the skill still guides ADR authoring if the external doc-adr.md protocol is unavailable.

Add a validation checkpoint (e.g. verify the generated ADR against the expected artifact KIND before finishing, or check the required fragments loaded successfully) to turn the stop-on-failure guardrail into a concrete validate-and-recover loop.

DimensionReasoningScore

Conciseness

The body is terse with no concept over-explanation and no padding — every line is a directive. Minor trimmable redundancy remains (e.g. 'ask_tool_description' re-explaining what AskUserQuestion is, and the GeneratedFollowProtocol rules restating control behavior), keeping it just below the lean-and-efficient anchor.

4 / 5

Actionability

The pdsl block names concrete LOAD paths and traversal rules, but it is explicitly pseudocode ('```pdsl') built around an unresolved placeholder variable ('{cf-studio-path}'), and all actual task guidance (how to author the ADR) lives in external files not present in the bundle. Concrete-but-incomplete matches the 3 anchor rather than the executable 4 anchor.

3 / 5

Workflow Clarity

The bootstrap sequence is ordered (load required-bootstrap.md, run it, load the controlling protocol) and rules like 'ALWAYS stop if any required fragment or rule cannot be followed' provide a stop guardrail, but there are no validation checkpoints or feedback loops, and the real task steps are entirely opaque behind the external doc-adr.md protocol. Steps-present-but-checkpoints-missing fits the 3 anchor.

3 / 5

Progressive Disclosure

The two delegation targets are clearly signaled and only one level deep, but they live outside the skill bundle behind an unexpanded placeholder path ({cf-studio-path}/...), the bundle contains no reference material of its own (no references/, scripts/, or assets/), and the body has no navigable section organization — a control-flow script rather than an overview. This sits between the 3 and 4 anchors: references are signaled but not resolvable or organized.

3 / 5

Total

13

/

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 states concrete actions, an explicit delegation mechanism, and well-chosen quoted trigger phrases that cover both what and when. The main weaknesses are a few missing natural trigger variants and a 'what' sentence written in internal framework jargon ('artifact KIND', 'cf-write-docs engine') that is opaque to outside readers.

DimensionReasoningScore

Specificity

Lists several specific action verbs ('author, write, revise, generate, or record an ADR') and explicitly states the mechanism ('Thin preset binding the ADR artifact KIND, delegating authoring and review to the core cf-write-docs engine'). Not comprehensive — the verbs are largely synonyms and the mechanism sentence is framework jargon — so it falls between the 3 and 5 anchors.

4 / 5

Completeness

Explicitly answers both 'what' (a thin preset that delegates ADR authoring and review to the cf-write-docs engine) and 'when' ("Invoke when the user asks to author, write, revise, generate, or record an ADR") with concrete quoted trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Quoted natural trigger phrases ('generate ADR', 'record a decision', 'document why we chose X', 'capture context / options / decision / consequences') are exactly what users would say. A few natural variants are missing (e.g. 'create an ADR', 'decision log', fully spelled-out 'architecture decision record'), keeping it just below the comprehensive-coverage anchor.

4 / 5

Distinctiveness Conflict Risk

The ADR/architecture-decision niche is clear and distinct, but broad phrases like 'record a decision' or 'document why we chose X' could plausibly trigger closely related documentation or decision-log skills — minor overlap risk rather than minimal.

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