CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sce-validate

Validate one completed SCE plan and record final validation evidence

Quality

72%

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

77%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 well-structured orchestration document: it sequences a two-step workflow with explicit validation-status branching, stop conditions, and a retry feedback loop, and it cleanly separates control flow from phase detail in existing one-level-deep references. Its main weakness is redundancy — the Rules section restates the Workflow's branch handling, and a few meta-explanatory sentences could be cut without losing guidance.

Suggestions

De-duplicate the Rules section against the Workflow section: rules like 'On `failed`, print the handoff Markdown as returned and stop' and 'Do not run final validation when implementation tasks remain' already appear as step-1 branch outcomes and could be removed or reduced to one-line pointers.

Trim meta-commentary such as 'That property is load-bearing, so reach it through the reference rather than acting from this summary' and the explanation of which document holds what in 'Phase references' — the reference table already conveys the structure.

Shorten the paragraph explaining that every emitted `{plan-path}` is runnable to a single sentence, e.g. 'Emit only paths carried by the Validation phase report so every command is directly runnable.'

DimensionReasoningScore

Conciseness

Phrases like 'On `failed`, print the handoff Markdown as returned and stop. Preserve the retry `/validate {plan-path}` instruction' and 'Do not run final validation when implementation tasks remain' in the Rules section largely restate the Workflow section's branch handling, and meta-commentary such as 'That property is load-bearing, so reach it through the reference rather than acting from this summary' could be trimmed. The body is otherwise efficient, matching 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the verbosity of a 2.

3 / 5

Actionability

Guidance is concrete and directive: 'Read `references/validation.md`, then run the **Validation phase**', an explicit input contract for `$ARGUMENTS` with defined empty-argument behavior, a concrete branch table ('`blocked` -> Return the blocked Markdown report unchanged. Stop.'), and a named layout to render ('Render the **Completion** layout from `references/output.md`'). It falls short of 5 because the actual executable detail is delegated to reference files rather than given inline, leaving minor gaps.

4 / 5

Workflow Clarity

A strictly ordered two-step workflow with explicit validation checkpoints: step 1 branches on the report's 'Status:' with defined outcomes (blocked/failed/validated), explicit 'Stop.' markers, and a preserved feedback loop for error recovery ('Preserve the retry `/validate {plan-path}` instruction'). The sequence, gates, and stop conditions are all explicit, matching the top anchor.

5 / 5

Progressive Disclosure

SKILL.md is a lean control-flow overview (~95 lines) that holds only dispatch logic, while all phase detail lives in three one-level-deep reference files that all exist (`references/validation.md`, `references/validation-report.md`, `references/output.md`), each signposted with read timing ('Read the reference before taking any action for step 1, not after'; 'Step 1 points to it at the moment it is needed'). This matches 'clear overview with well-signaled one-level-deep references; content appropriately split'.

5 / 5

Total

17

/

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 is concise, in third person, and clearly states what the skill does within its niche, but it omits any 'when to use' trigger guidance and uses only a narrow set of keywords. Adding an explicit 'Use when...' clause with natural trigger phrases would address its main gaps.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to validate, check, or sign off on a completed SCE plan, or to record final validation evidence for a plan.'

Broaden natural keyword coverage with synonyms users might say, such as 'verify the plan', 'final check', 'plan sign-off', or the '/validate' command form.

Enumerate the concrete capabilities a bit more fully (e.g., what the validation measures and what evidence is recorded) to lift specificity beyond two high-level actions.

DimensionReasoningScore

Specificity

The description names the domain ('SCE plan') and two concrete actions ('Validate one completed SCE plan', 'record final validation evidence'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because two actions do not constitute 'several specific actions', and the actions themselves are stated at a high level.

3 / 5

Completeness

The 'what' is clear (validate a completed SCE plan, record final validation evidence) but there is no 'when' — no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

Relevant keywords are present ('Validate', 'SCE plan', 'validation evidence'), and a user would plausibly say 'validate this plan'. However, common variations and synonyms are missing (e.g., 'check', 'verify', 'final review', 'plan validation'), matching 'Some relevant keywords but missing common variations or synonyms' rather than the good coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

'SCE plan validation' carves out a clear niche within the SCE workflow system, so it is 'mostly distinct; minor overlap risk' with closely related SCE skills (e.g., other SCE validation or completion skills). It falls short of 5 because the description provides no distinct trigger phrases, leaving some risk of overlap with generic validation requests.

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

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