CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ce-compound-refresh

Refresh the repo's captured learnings against the current codebase. Use when auditing stale, overlapping, superseded, or drifted learnings; avoid general refactor, debugging, or code review unless the learnings store is explicit.

Quality

92%

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

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 well-crafted orchestration skill body: it is a lean, dense rule set that sequences a multi-step audit pipeline unambiguously, states load-bearing invariants and error-recovery paths inline, and delegates all per-step detail to clearly signaled, existing reference files. No padding, no concept explanations, and every bundle file is reachable from the documented navigation.

DimensionReasoningScore

Conciseness

The body explains no concepts Claude already knows and carries no filler; every sentence is a rule, invariant, or pointer (e.g., 'A failed write is recorded as **recommended**, and the run continues'). It is an 84-line orchestration overview that assumes the reader's competence and defers all detail to references, matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Concrete, executable guidance throughout: 'Read `docs_root` from `<repo-root>/.compound-engineering/config.yaml`' with '<repo-root>` = `git rev-parse --show-toplevel`', a copy-paste two-option confirmation prompt, an explicit outcome enum (Keep/Update/Consolidate/Replace/Delete), and a verbatim subagent clause to carry into every spawn. For an instruction-only skill this is copy-paste-ready, fully specified guidance with no gaps.

5 / 5

Workflow Clarity

A clearly sequenced pipeline (Mode → Worth lens → Artifact Root → Scope → Investigate → Classify → Execute → Vocabulary Capture → Report → Commit → Discoverability Check) with explicit ordering constraints ('Read `references/classify.md` before assigning any of them') and explicit validation/error-recovery checkpoints: the auto-delete rule and its pre-checks, the failed-write→recommended fallback, docs_root validation that hard-stops naming the bad value, and 'Skip if nothing changed'. The destructive/batch cap does not apply because validation gates are stated inline and bundled validators are wired into the write flows.

5 / 5

Progressive Disclosure

The body is a pure overview that delegates every section's detail to a well-signaled reference ('**Read `references/modes.md` now.**'), and all ten referenced files exist in references/. Verified against the actual bundle: scripts/validate-frontmatter.py and scripts/validate-doc-claims.py are reachable via references/per-action-flows.md, and assets/resolution-template.md plus references/schema.yaml and references/yaml-schema.md are reachable the same way. Navigation is one level deep with clearly marked pointers, and content is appropriately split.

5 / 5

Total

20

/

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 'Use when…' trigger clause, natural audit vocabulary, and an unusually good negative boundary that prevents conflicts with general refactor/debug/code-review skills. Its main weakness is capability coverage: it advertises the umbrella 'refresh/audit' action but none of the concrete maintenance outcomes the skill actually performs.

Suggestions

Name one or two concrete maintenance outcomes in the description (e.g., 'classify each learning as keep/update/consolidate/replace/delete and apply the evidence-supported fixes, reporting the rest as recommended') to raise specificity beyond the umbrella 'refresh' verb.

Add the natural intent words the body already recognizes — 'clean up', 'prune', 'outdated' — so a user asking to cull the learnings store triggers this skill without needing the word 'audit' or 'stale'.

DimensionReasoningScore

Specificity

The description names the domain ('the repo's captured learnings') and roughly two concrete actions — 'Refresh the repo's captured learnings against the current codebase' and 'auditing stale, overlapping, superseded, or drifted learnings'. It stays at 3 rather than 4 because the skill's actual maintenance actions (classify into keep/update/consolidate/replace/delete, apply fixes, report, commit) are absent, which is more than a minor coverage gap.

3 / 5

Completeness

It explicitly answers both questions: the 'what' ('Refresh the repo's captured learnings against the current codebase') and the 'when' with concrete triggers ('Use when auditing stale, overlapping, superseded, or drifted learnings'), plus a negative boundary ('avoid general refactor, debugging, or code review unless the learnings store is explicit') that sharpens the trigger further.

5 / 5

Trigger Term Quality

Natural trigger terms are present and specific: 'auditing', 'stale', 'overlapping', 'superseded', 'drifted', 'learnings', 'refresh'. Not a 5 because common user phrasings the body itself recognizes as intent ('cleaned up', 'culled', 'pruned', 'trimmed', 'outdated') are missing from the description, leaving a few natural synonyms uncovered.

4 / 5

Distinctiveness Conflict Risk

A clear niche (the learnings store under solutions/) with distinct triggers and an explicit disambiguation clause — 'avoid general refactor, debugging, or code review unless the learnings store is explicit' — that actively prevents firing for adjacent but wrong 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

EveryInc/compound-engineering-plugin

Path

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