CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

71

Quality

88%

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

77%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced workflow with strong validation feedback loops and concrete commands. Its main weaknesses are repetition that inflates token cost and a bundle where four of six files are never referenced from the body, leaving them undiscoverable.

Suggestions

Factor the verbatim blocking-question-tool paragraph (repeated in the CONCEPTS.md bootstrap, Interaction Principles, Question Style, and Discoverability sections) into a single shared reference or define-it-once callout, and have later sections link back to it.

Reference the orphaned bundle files where relevant — point Phase 4's validation step at `scripts/validate-frontmatter.py` and `scripts/validate-doc-claims.py`, the vocabulary section at `references/schema.yaml` / `references/yaml-schema.md`, and the Replace flow at `assets/resolution-template.md` — so the full bundle is discoverable from the body.

Move the long Phase 4.5 Vocabulary Capture procedure and the Discoverability Check into a reference file, keeping SKILL.md as a concise overview that signals where the detail lives.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence (never explains what learnings, git, or frontmatter are) and stays opinionated, but at ~694 lines it is padded by repetition — the multi-platform blocking-question-tool paragraph is restated verbatim in four sections and the headless stale-marking rules are re-derived repeatedly. This matches anchor-2 'mostly efficient but includes some unnecessary explanation or could be tightened.' It is not 3 because the verbatim repeats and re-stated rules are tokens that do not earn their place, and not 1 because it never lectures on concepts Claude already knows.

2 / 3

Actionability

Provides concrete, executable guidance throughout — `git rev-parse --show-toplevel`, `git log --diff-filter=D -- <root>/solutions/`, `git branch --show-current`, exact frontmatter fields (`status: stale`, `stale_reason`, `stale_date`), and a copy-paste report template — matching anchor-3 'fully executable code/commands; specific examples; copy-paste ready.' It is not 2 because the instructions are concrete commands and exact schemas, not pseudocode or vague direction.

3 / 3

Workflow Clarity

Phases 0–5 are clearly sequenced with explicit validation checkpoints and feedback loops: auto-delete triple-condition checks, headless write-failure → record as recommended and continue, 'validate frontmatter and cited claims' before deleting, and 'only proceed when validation passes' patterns — matching anchor-3 'clear sequence with explicit validation steps; feedback loops for error recovery.' It is not 2 because checkpoints are explicit and present for the destructive/batch operations, not implicit or missing.

3 / 3

Progressive Disclosure

The body signals two real one-level-deep references ("Read `references/per-action-flows.md`" and "Read `references/concepts-vocabulary.md`"), but four provided bundle files — `references/schema.yaml`, `references/yaml-schema.md`, `scripts/validate-doc-claims.py`, `scripts/validate-frontmatter.py`, and `assets/resolution-template.md` — are never referenced anywhere in the body, leaving them undiscoverable; and large blocks like the Phase 4.5 vocabulary procedure and the Discoverability Check are inlined rather than split out. This matches anchor-2 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline.' It is not 3 because half the bundle is orphaned and the overview is monolithic, and not 1 because the two signaled references are real and only one level deep.

2 / 3

Total

10

/

12

Passed

Description

100%Weight 40%Scale 1-3

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 tight, third-person description that answers both what it does and when to use it, with an explicit boundary against adjacent refactor/debug/review skills. Trigger terms are natural and the maintenance vocabulary is well covered.

DimensionReasoningScore

Specificity

Quotes the concrete refresh action and an enumerated audit taxonomy — "Refresh the repo's captured learnings against the current codebase" and "auditing stale, overlapping, superseded, or drifted learnings" — listing multiple specific concrete actions rather than vague language. It sits at the anchor-3 bar rather than 2 because it goes beyond naming the domain to enumerating the distinct maintenance cases; it is not below 3 because no anchor-2 'some actions, not comprehensive' gap is evident.

3 / 3

Completeness

Explicitly answers both 'what' ("Refresh the repo's captured learnings against the current codebase") and 'when' ("Use when auditing stale, overlapping, superseded, or drifted learnings"), matching the anchor-3 'clearly answers both what AND when with explicit triggers.' It is not 2 because the 'Use when...' clause is present and explicit, not merely implied.

3 / 3

Trigger Term Quality

Includes natural maintenance vocabulary a user would actually say — "Use when auditing stale, overlapping, superseded, or drifted learnings" — covering 'stale', 'overlapping', 'superseded', and 'drifted'. This matches the anchor-3 'good coverage of natural terms users would say'; it is not 2 because the trigger set is broad, not a single generic keyword, and the negative-trigger clause ('avoid general refactor, debugging, or code review') adds user-voiced disambiguation.

3 / 3

Distinctiveness Conflict Risk

The carve-out "avoid general refactor, debugging, or code review unless the learnings store is explicit" explicitly separates it from adjacent skills, and the 'captured learnings' / 'solutions' niche is distinct, matching anchor-3 'clear niche with distinct triggers; unlikely to conflict.' It is not 2 because the negative boundary actively suppresses overlap with the named adjacent skills.

3 / 3

Total

12

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (694 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
EveryInc/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.