CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

compound-refresh

Use when docs/solutions/ learnings may be stale — after refactors, migrations, or dependency upgrades, when a retrieved learning feels outdated or contradicts a recently solved problem, when pattern docs no longer reflect current code, or when reviewing docs/solutions/ for accuracy.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/compound-refresh/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 actionable and well-sequenced maintenance workflow with genuine validation gates, undermined by heavy cross-section duplication that inflates the token cost and by a monolithic structure that inlines material better kept in reference files. The policy content itself is domain-specific and never condescends to known concepts.

Suggestions

Consolidate the autonomous-mode rules into the single 'Autonomous mode rules' section and reference it elsewhere with one phrase instead of restating the full rules in the mode table, Core Rules, Phase 3, Phase 5, and the output section.

Cut or drastically trim the Common Mistakes table rows that repeat earlier rules verbatim (Update-vs-Replace boundary, problem-domain check, memory-only drift), keeping only genuinely novel failure modes.

Split the output format spec, subagent prompt templates, and Phase 5 commit policy into references/ files (e.g., references/report-format.md, references/subagent-prompts.md, references/commit-policy.md) and signal them from the main body to shrink SKILL.md to an overview.

DimensionReasoningScore

Conciseness

The body systematically restates the same policies: autonomous-mode rules ('skip questions, mark ambiguous as stale, always report') appear in ~8 places (mode table, rules section, Core Rule 4, Phase 1, Subagent Strategy, Phase 3, Phase 5, output section); memory-drift-is-supplementary in 5 places; problem-domain-vs-implementation three times inside 'Before archiving' alone; Replace-evidence sufficiency in 4 sections; and the Common Mistakes table restates earlier rules verbatim. This is noticeably verbose with several padded sections — roughly 150 lines could be cut without information loss — rather than 'mostly efficient with some tightening' (anchor 3), and it never explains concepts Claude already knows, keeping it above anchor 1's severity.

2 / 5

Actionability

For an instruction-only skill the guidance is fully executable: copy-paste ready templates (report format, question format, no-candidates message, subagent prompt block), exact frontmatter keys ('status: stale', 'stale_reason', 'stale_date: YYYY-MM-DD', 'superseded_by', 'archived_date'), exact paths ('docs/solutions/_archived/'), ordered scope-matching strategies, numeric routing thresholds, and concrete branch-naming examples. This matches anchor 5's 'copy-paste ready, specific examples cover the common cases'.

5 / 5

Workflow Clarity

Phases 0–5 are clearly sequenced with explicit validation gates for a destructive/batch operation: evidence-sufficiency assessment before any Replace, auto-archive criteria requiring both implementation AND problem domain to be gone, write-failure fallback to 'recommended' status, conservative stale-marking when uncertain, and git-context detection before commit. Error-recovery feedback loops and a mistakes checklist are both present, matching anchor 5 and satisfying the destructive/batch validation cap.

5 / 5

Progressive Disclosure

The single 550-line file has substantial internal structure (clear ## sections, tables, templates), so it is above anchor 2's 'minimal structure', but content that clearly belongs in separate reference files — the full report format spec, the subagent prompt templates, and the Phase 5 commit policy — is inlined with no bundle files at all. Anchor 3's 'content that should be separate is inline' fits; anchor 4 would require an appropriate split.

3 / 5

Total

15

/

20

Passed

Description

73%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 trigger-focused description with excellent, explicit 'when' guidance and a distinct niche, but a weak 'what' — it relies on one review action and never names the maintenance actions (update/replace/archive, pattern refresh, commit) the skill performs. The voice is correctly imperative/third-person with no fluff or buzzwords.

Suggestions

State the concrete actions the skill performs, e.g., 'Reviews docs/solutions/ learnings against the current codebase, then updates, replaces, or archives stale docs and refreshes dependent pattern docs' — this would lift both specificity and completeness.

Name the primary deliverable (a summary report separating applied from recommended actions) so users know what outcome to expect.

Add one or two natural synonyms such as 'knowledge base' or 'out of date' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ('docs/solutions/ learnings') and one concrete action ('reviewing docs/solutions/ for accuracy'), but never states what the skill actually does — update, replace, archive, refresh pattern docs, commit — leaving action coverage non-comprehensive. It sits between anchor 2 (domain with minimal action) and anchor 4 (several specific actions), and the single explicit review action keeps it at 3 rather than 2.

3 / 5

Completeness

The 'when' is explicit and rich ('Use when...' with four concrete trigger scenarios), and a 'what' is present ('reviewing docs/solutions/ for accuracy'), so both halves exist. The 'what' side is thin — no mention of the maintenance actions or the summary report deliverable — matching anchor 4's pattern of both present with one side needing more specificity rather than anchor 3's missing 'when'.

4 / 5

Trigger Term Quality

Triggers like 'after refactors, migrations, or dependency upgrades', 'a retrieved learning feels outdated', 'contradicts a recently solved problem', and 'pattern docs no longer reflect current code' are natural phrases a maintainer would say. A few natural variations are missing (e.g., 'knowledge base', 'out of date', 'documentation drift'), so it falls short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Triggers reference ecosystem-specific artifacts ('docs/solutions/', 'learnings', 'pattern docs') and stake out a clear maintenance niche (stale learnings after refactors) clearly distinct from the companion capture skill. Conflict risk with generic skills is minimal, matching anchor 5.

5 / 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

skill_md_line_count

SKILL.md is long (550 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

lucianghinda/superpowers-ruby

Path

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