CtrlK
BlogDocsLog inGet started
Tessl Logo

claude-md-improver

Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".

92

1.39x
Quality

91%

Does it follow best practices?

Impact

92%

1.39x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%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, actionable skill body with a clear five-phase workflow, concrete output formats, and sensible use of reference files. The main gaps are minor: inline duplication of content held in references (especially the orphaned update-guidelines.md) and the absence of a post-update verification step.

DimensionReasoningScore

Conciseness

The body is dense and table-driven (file-types table, assessment checklist, report template), but has minor trimmable padding: the 'What Makes a Great CLAUDE.md' section and 'Recommended sections' list duplicate content already in references/templates.md, and 'User Tips to Share' could be tightened. Not a 3 because there is no explanation of concepts Claude already knows, and not a 5 because of the cross-file duplication.

4 / 5

Actionability

Guidance is copy-paste ready: an executable 'find' command, a complete quality-report output template with per-criterion point allocations, and a concrete diff format example. For an instruction-only skill this fully covers the common cases, matching the score-5 anchor.

5 / 5

Workflow Clarity

Five clearly sequenced phases with an emphatic checkpoint ('ALWAYS output the quality report BEFORE making any updates') and a user-approval gate before the destructive write phase, plus an assessment checklist. Not a 5 because there is no post-edit verification step (e.g., re-checking the updated file or re-running the assessment) to close the loop on the batch-update operation.

4 / 5

Progressive Disclosure

The body points clearly to references/quality-criteria.md and references/templates.md (both real files, one level deep), and detailed rubrics/templates are appropriately offloaded. Not a 5 because references/update-guidelines.md exists in the bundle but is never referenced — Phase 4 instead inlines its own 'Update Guidelines' that overlap that file's content — leaving an orphaned bundle file and duplicated guidance.

4 / 5

Total

17

/

20

Passed

Description

92%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 explicit what/when structure, concrete trigger verbs, and third-person action statements. The only weakness is modest synonym coverage beyond the core 'CLAUDE.md' terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions in third person voice: 'Audit and improve CLAUDE.md files', 'Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates' — comprehensive coverage of the skill's behavior. It does not fit the score-4 anchor because there are no meaningful gaps in the action coverage for this domain.

5 / 5

Completeness

Explicitly answers both what ('Audit and improve CLAUDE.md files... outputs quality report, then makes targeted updates') and when ('Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Also use when the user mentions...') with concrete trigger phrases — a direct match to the score-5 anchor.

5 / 5

Trigger Term Quality

Good keyword coverage with natural user phrasing: 'check, audit, update, improve, or fix CLAUDE.md files', plus 'CLAUDE.md maintenance' and 'project memory optimization'. Not a 5 because a few natural synonyms users might say are missing (e.g., 'project instructions', 'project context', '.claude.local.md', or file-extension-style variants).

4 / 5

Distinctiveness Conflict Risk

Clear niche: every trigger names CLAUDE.md explicitly, so it is unlikely to fire for unrelated documentation or memory skills. It is not a 4 because the trigger set is tightly scoped to a specific artifact rather than having overlap with 'closely related skills'.

5 / 5

Total

19

/

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
anthropics/claude-plugins-official
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.