CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-explain

Explain how and why something has its current shape, or what happened over a window of work, grounded in evidence. Use when the user asks for an explanation. Use ce-pov for a judgment or recommendation.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

An exceptionally disciplined orchestration skill: lean phrasing, an executable run-directory script, a phased workflow with explicit validation gates and enumerated fallbacks, and clean one-level-deep reference routing verified against the actual bundle. Its only cost is density — several rules packed per paragraph — a fair trade for the token efficiency it achieves.

DimensionReasoningScore

Conciseness

The body contains no concept explanations or filler; every sentence is an operating rule ('Do not infer the output from the caller's identity alone', 'A function call does not establish guarantees about its uninspected implementation'), and the one long block is an executable script rather than exposition. Not the 4 anchor, since there is no trimmable over-explanation anywhere.

5 / 5

Actionability

Guidance is concrete and executable: a copy-paste bash block that creates and validates $RUN_DIR, exact read triggers ('Read `references/intake.md` now'), a named dispatch protocol ('dispatch a generic subagent directly at the extraction tier, seeded with `references/agents/work-recap-scout.md`'), and enumerated common cases (empty range, empty window, no subagent primitive, dispatch failure, confirmation unavailable).

5 / 5

Workflow Clarity

Four named phases run in sequence with explicit validation checkpoints and feedback loops: 'Before delivery, check every factual claim against its source' with removal of unsupported claims, fail-fast `exit 1` checks on the scratch root, docs_root validation that stops with a named error, and a consent gate on publishing ('If confirmation cannot be obtained, do not publish'). Error-recovery paths are explicitly enumerated rather than implied, so it is not the 4 anchor.

5 / 5

Progressive Disclosure

The body is a lean orchestration overview that splits detail into eight real reference files, each signaled with when to read it ('before grounding, the first blocking question, or subagent dispatch'; 'now'; 'at compose time'; 'before acting'). All referenced paths exist under references/ (including the directly-referenced agents/ scouts), and grepping the reference files shows no second-level indirection chains — matching the clear-overview, one-level-deep anchor.

5 / 5

Total

20

/

20

Passed

Description

70%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 concise, third-person, well-targeted description that states both what and when and cleanly separates explanation from judgment. Its weaknesses are the generic single trigger clause and a capability list narrower than the skill's actual scope.

Suggestions

Enumerate the main deliverable forms in the what-clause, e.g. 'Explain how and why something has its current shape, recap what happened over a window of work, or produce a teaching artifact, grounded in source evidence', to raise specificity.

Replace the generic trigger 'Use when the user asks for an explanation' with concrete phrases users would naturally say, such as 'Use when asked to explain why something works a certain way, recap what happened over a time window, or teach a concept from the repo.'

Add natural synonyms such as 'recap' or 'walkthrough' to the trigger clause to broaden keyword coverage.

DimensionReasoningScore

Specificity

'Explain how and why something has its current shape, or what happened over a window of work, grounded in evidence' names the domain plus two concrete capability branches, but omits the fuller action list the body actually covers (teaching artifacts, recap mode, destination handling). It matches the 1-2-concrete-actions anchor rather than 'lists several specific actions' (4).

3 / 5

Completeness

Both parts are explicit: the what is 'Explain how and why something has its current shape, or what happened over a window of work, grounded in evidence' and the when is 'Use when the user asks for an explanation.' The when-clause is a single generic trigger without the concrete trigger phrases of the 5 anchor, matching 'when could be more explicit or specific' (4).

4 / 5

Trigger Term Quality

Natural keywords are present — 'Explain', 'how and why', 'what happened', 'explanation', 'judgment or recommendation' — giving good coverage, but common variations a user would actually say ('recap', 'walk me through', 'why does X behave this way', 'teach') are missing, so it falls short of comprehensive synonym coverage (5).

4 / 5

Distinctiveness Conflict Risk

'Use ce-pov for a judgment or recommendation' explicitly carves out the nearest neighbor, and the evidence-grounded work-window scope gives a distinct niche. However, 'Use when the user asks for an explanation' is broad enough to overlap other explanation-shaped skills, so it is 'mostly distinct; minor overlap risk' rather than minimal conflict (5).

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

EveryInc/compound-engineering-plugin

Path

skills/ce-explain/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.