CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

64

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/ce-explain/SKILL.md

The canonical home for this skill is ce-explain in EveryInc/compound-engineering-plugin

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured orchestration-style skill: phased workflow, concrete run-directory procedure, explicit failure and fallback paths, and exemplary progressive disclosure into real, well-signposted reference files. Its weakest spots are mild redundancy around artifact-root resolution and a handful of abstract directives whose operational meaning is left implicit.

Suggestions

Tighten the Artifact Root section by merging the prose paragraph with the ce-docs-root block, which currently state overlapping rules twice.

Make the Phase 3 claim-verification step operational — name the action (e.g., re-open the cited file/line and quote the supporting passage before delivery) instead of the abstract 'check every factual claim against its source'.

Replace abstract directives like 'Preserve material constraints and uncertainty' with a concrete rule (e.g., 'state the uncertainty inline beside the claim it qualifies').

DimensionReasoningScore

Conciseness

The body is dense, assumes competence, and teaches no concepts Claude already knows; nearly every sentence is a rule or decision. Anchor 4 (efficient, minor trimmable instances) fits because of mild redundancy: the ce-docs-root block restates the preceding Artifact Root paragraph, and the bash block repeats 'umask 077; mkdir -p' checks across lines. Not 5 since those repetitions and some doubled root-resolution prose could be tightened.

4 / 5

Actionability

One fully executable, copy-paste-ready bash block for scratch/run-dir setup, plus concrete artifacts and paths ('$RUN_DIR/explainer.html', 'references/agents/work-recap-scout.md', explicit file names to write). Per the instruction-only note, absent code is not penalized, but a few directives remain abstract ('Preserve material constraints and uncertainty', 'Keep attribution accurate'), matching anchor 4's minor gaps rather than anchor 5's fully covered common cases.

4 / 5

Workflow Clarity

Four explicitly sequenced phases with named edge-case and failure handling: 'Empty window: report the absence of activity and finish', dispatch-failure fallback routing, symlink/ownership validation of the scratch root, and pre-delivery claim checking. Anchor 4 fits because a few checkpoints (e.g., what 'check every factual claim against its source' operationally involves) are named but not specified, and some validation detail lives in references rather than inline.

4 / 5

Progressive Disclosure

The body is a genuine overview: all seven referenced files (orchestration.md, intake.md, explainer-html.md, explainer-markdown.md, check-in.md, destinations.md, agents/work-recap-scout.md) exist, are real one-level-deep content, and each read is signposted with its timing ('Read references/intake.md now', 'before grounding', 'at compose time'). This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

17

/

20

Passed

Description

75%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 cleanly answers what the skill does and when to use it, with a rare explicit routing hint to a sibling skill (ce-pov). Its main gaps are a generic single trigger condition and missing natural synonyms like 'recap' or 'walk me through' that users commonly say.

Suggestions

Expand the 'Use when' clause with concrete trigger phrases, e.g., 'Use when the user asks how or why something works this way, why a change was made, or what happened over a period of work.'

Add natural synonyms such as 'recap', 'walkthrough', or 'history of a change' to broaden trigger term coverage.

Briefly distinguish from adjacent siblings (e.g., 'A factual explanation of current behavior stays here; use ce-debug for diagnosing failures') to reduce conflict risk within the skill family.

DimensionReasoningScore

Specificity

Names two concrete capabilities — 'Explain how and why something has its current shape, or what happened over a window of work, grounded in evidence' — matching the anchor listing several specific actions with minor coverage gaps. Not 5 because the action set is smaller and less enumerable than the comprehensive anchor; not 3 because it covers two distinct modes plus evidence grounding rather than only 1-2 generic actions.

4 / 5

Completeness

Both what ('Explain how and why something has its current shape, or what happened over a window of work, grounded in evidence') and when ('Use when the user asks for an explanation') are explicit. Anchor 4 fits because the when clause is a single fairly generic condition, whereas anchor 5 requires multiple concrete trigger phrases like 'PDFs, forms, or document extraction'.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'Explain', 'explanation', 'how and why', 'what happened over a window of work'. A few natural variations users would say are missing (e.g., 'recap', 'walk me through', 'why did X', 'history'), which matches the good-coverage-with-gaps anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Explicit de-confliction ('Use ce-pov for a judgment or recommendation') establishes a clear niche and routing, matching the mostly-distinct anchor 4. Not 5 because 'asks for an explanation' is a broad trigger with residual overlap risk against sibling skills (e.g., ce-debug, ce-ideate) whose boundaries are only drawn in the body, not the description.

4 / 5

Total

16

/

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
crdant/compound-engineering-plugin
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.