CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sce-decision

Record one already-qualified decision as an immutable ADR, reusing an equivalent active ADR when present

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 ./.opencode/skills/sce-decision/SKILL.md

The canonical home for this skill is sce-decision in crocoder-dev/shared-context-engineering

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 content is a well-structured, protocol-style instruction skill: an explicit six-step workflow with a real verification checkpoint, precise schemas for paths, statuses, and results, and clean delegation of the ADR format to a single real reference file. Its weaknesses are modest redundancy across sections and the lack of a concrete example of the returned result payload.

Suggestions

Deduplicate repeated rules: the allowed statuses and the one-ADR/never-modify constraints each appear in both the workflow steps and the Boundaries section — stating each once would trim tokens without losing clarity.

Add a short example of the returned result object (e.g., a sample `written` payload with the exact field names) to make step 6 copy-paste ready and lift actionability.

Consolidate the qualification-handoff rules, which currently restate the do-not-reassess-the-threshold rule three times in slightly different forms.

DimensionReasoningScore

Conciseness

The body is dense and imperative with no explanation of concepts Claude already knows, but there is noticeable repetition: the allowed statuses appear in both step 1 and step 2, the "Boundaries" section restates rules from steps 1–2 ("Write more than one ADR per request", "Modify ... existing ADRs"), and the no-requalification rule is stated three times across "Qualification handoff". This fits anchor 4 ("efficient; minor instances ... that could be trimmed") rather than 5, where every token would earn its place.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: exact path format `context/decisions/YYYY-MM-DD-<decision-slug>.md`, the exact allowed status set, exact result field names, and a real reference template. It falls short of anchor 5 only because there is no worked example of a returned result object (e.g., a sample `written` payload) or a filled-in ADR instance, leaving a minor gap between enumerated fields and copy-paste-ready output.

4 / 5

Workflow Clarity

Six numbered steps are clearly sequenced, step 5 ("Verify the record") is an explicit validation checklist covering filename, status, sections, references, and no modification of existing ADRs, and error paths (blocked / not_qualified / skipped) provide feedback loops for recovery. This matches anchor 5's "explicit validation steps; feedback loops ... checklists" rather than anchor 4, which requires only "most" checkpoints with minor gaps.

5 / 5

Progressive Disclosure

The body is well-sectioned and delegates the ADR schema to a single, clearly signaled, one-level-deep reference ("Read `references/adr-template.md` before writing. It is the sole authority for the persisted ADR schema"), which exists in the bundle and contains no further nested references. This matches anchor 5: clear overview, appropriately split content, easy navigation.

5 / 5

Total

18

/

20

Passed

Description

53%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 states a clear, specific capability but omits any explicit when-to-use trigger guidance, which caps completeness and leaves trigger coverage thin. Adding a "Use when..." clause and spelling out "architecture decision record" with natural synonyms would lift most dimensions.

Suggestions

Add an explicit trigger clause, e.g. "Use when a decision has been qualified by task context synchronization and needs to be recorded as an ADR" — the missing 'Use when' guidance currently caps completeness at 3.

Spell out "architecture decision record (ADR)" and include natural synonyms such as "decision log", "record a decision", or "supersede a decision" to improve trigger-term coverage.

Briefly enumerate the outcome behaviors (create a new ADR, reuse an equivalent active one, return not_qualified/skipped/blocked) to move specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

The description names the domain (ADR records) and two concrete actions — "Record one already-qualified decision as an immutable ADR" and "reusing an equivalent active ADR when present" — but stops there. It does not reach anchor 4's "several specific actions" (e.g., no mention of path resolution, verification, or result reporting), and it is clearly above anchor 2 because the actions are concrete rather than generic.

3 / 5

Completeness

The "what" is clear — record one qualified decision as an immutable ADR, reusing an equivalent active ADR — but there is no "Use when..." clause or equivalent explicit trigger guidance; "when present" is a conditional on reuse, not activation guidance. Per the rubric guideline, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords like "decision" and "ADR" are present, but the description never spells out "architecture decision record" or related natural phrases a user would say ("record a decision", "decision log", "supersede"). It matches anchor 3 ("some relevant keywords but missing common variations or synonyms") rather than 4, since coverage is thin beyond the two core terms.

3 / 5

Distinctiveness Conflict Risk

The niche is distinct — immutable ADR recording with reuse of equivalent active ADRs — so overlap risk is minor, fitting anchor 4. It falls short of anchor 5 because "clear niche with distinct triggers" is undermined by the absence of explicit trigger phrases and by generic terms ("decision", "record") that could overlap with other decision- or documentation-recording skills.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

crocoder-dev/shared-context-engineering

Path

.opencode/skills/sce-decision/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.