CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sce-validate

Validate one completed SCE plan and record final validation evidence

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tightly written orchestration document: unambiguous control flow, explicit branching and stop conditions, and exemplary progressive disclosure that keeps all phase detail in real, one-level-deep reference files. Its only weakness is slight redundancy in the read-before-running instructions and a couple of meta-explanatory sentences.

DimensionReasoningScore

Conciseness

The body is lean and directive with zero concept-teaching — every line is an instruction or a boundary. Minor trimmable redundancy keeps it off 5: "Read the reference before taking any action for step 1, not after" duplicates the Rules bullet "Read each phase's reference before running that phase", and sentences like "That property is load-bearing, so reach it through the reference rather than acting from this summary" are meta-commentary. Not 3 because there is no unnecessary explanation of things Claude already knows and the writing is tight throughout.

4 / 5

Actionability

As an instruction-only skill, its guidance is fully executable: exact reference paths ("Read `references/validation.md`, then run the Validation phase"), an explicit branch on the report's `Status:` with defined outcomes for `blocked`, `failed`, and `validated`, exact stop points, preserved retry command ("Preserve the retry `/validate {plan-path}` instruction"), and explicit empty-`$ARGUMENTS` handling ("report that a plan name or path is required, state the expected argument, and stop"). The common cases are all covered; per the scoring notes, absence of code in an instruction-only skill is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

The sequence is explicit and checkpointed: Input handling (required argument, resolve exactly one plan) → step 1 validate with branch-on-status → step 2 render the Completion layout → stop. Validation is the workflow's core and is surfaced as an explicit gate, and there is a feedback loop on `failed` (the handoff ends with `/validate {plan-path}` for repair-then-retry). The skill is explicitly non-destructive ("never repairs it", "Do not create a Git commit"), so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Scored against the actual bundle: SKILL.md is a concise control-flow overview, and all three referenced files exist and are one level deep — `references/validation.md` (the phase), `references/validation-report.md` (the plan-file report format, directly surfaced from SKILL.md), and `references/output.md` (the terminal layout). References are well-signaled via the step→reference table and point-of-need callouts, and no phase detail is inlined ("Do not duplicate the internal instructions of embedded phases"). This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

19

/

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, concrete 'what' scoped to a specific niche (validating one completed SCE plan), but it omits any 'when to use' trigger guidance and leans on internal jargon (SCE) with few natural trigger terms. It is functional but below the standard of the good examples, which pair a concrete what with an explicit Use-when clause.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to validate, verify, or run final checks on a completed SCE plan, or mentions finishing or signing off on a plan."

Broaden natural trigger terms with synonyms users would actually say — "verify", "check", "final validation", "acceptance criteria" — instead of relying solely on "validate" and the internal term "SCE".

Enumerate the concrete actions the skill performs — run full validation and acceptance-criterion checks, write the Validation Report into the plan, and return a validated/failed/blocked result — to lift specificity and distinctiveness.

DimensionReasoningScore

Specificity

"Validate one completed SCE plan and record final validation evidence" names the domain (SCE plans) and exactly two concrete actions (validate, record evidence), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. Not 4 because it does not list several specific actions covering the skill's actual scope (running acceptance checks, writing the Validation Report, returning validated/failed/blocked outcomes); not 2 because the actions are more concrete than 'Processes PDF files'.

3 / 5

Completeness

The 'what' is clear (validate a completed SCE plan and record final validation evidence) but there is no 'Use when...' clause or any implied trigger for when Claude should invoke it, so completeness is capped at 3 per the judging guideline ('Has a clear what but when is missing or only weakly implied'). Not 2 because the 'what' is concrete, not vague; not 4 because 'when' is entirely absent rather than under-specified.

3 / 5

Trigger Term Quality

Natural terms present: "validate", "validation", "plan", "evidence" — a user would plausibly say "validate the plan". But "SCE" is internal jargon users would not say, and common synonyms like "verify", "check", or "confirm" are absent, matching 'Some relevant keywords but missing common variations or synonyms'. Not 4 because keyword coverage is thin; not 2 because the terms go beyond generic phrases like 'Works with files'.

3 / 5

Distinctiveness Conflict Risk

"one completed SCE plan" carves a distinct niche with low overlap risk against unrelated skills, and 'completed' plus 'final validation evidence' distinguish it from implementation skills in the same family — 'Mostly distinct; minor overlap risk with closely related skills'. Not 5 because without any trigger phrasing, a generic request to 'validate' something could still pull in this or sibling SCE 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-validate/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.