CtrlK
BlogDocsLog inGet started
Tessl Logo

ce-compound

Document a solved problem as a durable repo learning. Use when verified work produced non-obvious reasoning absent from its final code, tests, or existing docs; avoid routine fixes whose artifacts already explain the lesson.

71

Quality

87%

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

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

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.

A well-engineered orchestration skill: the body carries only routing, eligibility, and write-boundary decisions while every procedural detail lives in clearly signaled, per-step references, all of which are present in the bundle. The only quality nit is mild redundancy in the mode-detection and non-interactive-contract prose.

DimensionReasoningScore

Conciseness

The body is dense, decision-oriented prose with no padding and no explanation of concepts Claude already knows — every sentence encodes a rule, boundary, or routing decision. It sits at 4 rather than 5 because a few clauses are over-enumerated for the top level, e.g. the Mode Detection token combinatorics ('multiple `depth:` tokens, or a `depth:` token without non-interactive intent') and the non-interactive contract being restated across Mode Detection, Choosing the path, and Full Mode step 2, which could be tightened or pushed into a reference.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact invocation forms ('/ce-compound mode:non-interactive depth:lightweight [context]'), exact paths ('<repo-root>/.compound-engineering/config.yaml', 'git rev-parse --show-toplevel'), named required reads per step ('Read `references/modes.md` before step 1'), and exact terminal signals to emit ('Documentation complete', 'Documentation skipped'). Not a 4 because there are no meaningful gaps in the executable guidance.

5 / 5

Workflow Clarity

The Full Mode section gives a numbered 1-6 sequence where 'Each reference is a required read at the step that names it', with an explicit parallelism instruction ('start it *after* launching the parallel block') and an explicit continuation rule ('When it returns... go straight to assembly without pausing'). Validation gates are explicit: the counterfactual precondition ('If the counterfactual fails, write nothing and report why'), frontmatter/claims validation, and the refresh check. Error-recovery and no-op paths are defined, matching the 5 anchor.

5 / 5

Progressive Disclosure

The body is a true overview that routes to one-level-deep, well-signaled references, all of which exist in the bundle (research.md, modes.md, session-history.md, assembly.md, refresh-and-discoverability.md, enhancement.md, report.md, lightweight.md), each flagged as a required read at its specific step. Scripts and the agents/ subdirectory stay out of the main flow until the relevant reference or step needs them. Not below 5: navigation is easy and nothing that belongs in a reference is inlined.

5 / 5

Total

19

/

20

Passed

Description

82%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 strong description with an explicit and unusually precise 'Use when' clause plus a negative boundary that prevents over-triggering on routine fixes. The main gap is that it states only one capability, so a reader learns when to fire it more fully than what it will actually do.

DimensionReasoningScore

Specificity

The description names the domain ('durable repo learning') and one concrete action ('Document a solved problem'), but does not list several specific actions — the rest of the text is trigger conditions rather than capabilities. It fits the anchor 'Names domain and 1-2 concrete actions, but not comprehensive': above a 2 because the single action is concrete, below a 4 because there is no inventory of what the skill actually does (write/update docs, validate frontmatter, capture vocabulary).

3 / 5

Completeness

It explicitly answers both parts: what — 'Document a solved problem as a durable repo learning'; when — 'Use when verified work produced non-obvious reasoning absent from its final code, tests, or existing docs', plus a negative boundary ('avoid routine fixes whose artifacts already explain the lesson'). The 'when' clause uses concrete trigger phrases rather than vague implication, matching the 5 anchor; a 4 would have a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

Phrases like 'solved problem', 'verified work', 'non-obvious reasoning', 'final code, tests, or existing docs', and 'routine fixes' are natural things a user or agent would say when needing this skill. Below 5 because common synonyms a user might actually say — 'lesson', 'postmortem', 'write-up', 'capture what we learned' — are missing, while 'durable repo learning' leans toward internal jargon.

4 / 5

Distinctiveness Conflict Risk

A clear niche (durable repo learnings) with distinct triggers — the eligibility condition 'non-obvious reasoning absent from its final code, tests, or existing docs' sharply separates it from generic documentation or note-taking skills. Minimal conflict risk, matching the 5 anchor; a 4 would leave noticeable overlap with closely related skills.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

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.