CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-md-management

Provides comprehensive CLAUDE.md file management capabilities including auditing, quality assessment, and targeted improvements. Use when user asks to check, audit, update, improve, fix, maintain, or validate CLAUDE.md files. Also triggers for "project memory optimization", "CLAUDE.md quality check", "documentation review", or when CLAUDE.md needs to be created from scratch. This skill scans all CLAUDE.md files, evaluates quality against standardized criteria, outputs detailed quality reports with scores and recommendations, then makes targeted updates with user approval.

66

Quality

83%

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 giuseppe-trisciuoglio/developer-kit

SKILL.md
Quality
Evals
Security

Quality

Content

71%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.

The content is highly actionable with a well-sequenced, approval-gated 5-phase workflow and copy-paste-ready templates throughout. It is held back by redundancy (duplicated description, repeated approval rules, a very long inline Examples section) and a progressive-disclosure gap where one of three bundle files is undiscoverable from SKILL.md.

Suggestions

Move the three full example reports (Phase 3 output, creation, update) into a references file such as references/examples.md and link it, keeping only one condensed example inline — this trims ~120 lines and addresses both conciseness and progressive disclosure.

Add an explicit link to references/templates.md (e.g., in Phase 4 or Best Practices: 'Use [references/templates.md](references/templates.md) for section layouts') so every bundle file is navigable from SKILL.md.

Cut the duplicated opening paragraph (which restates the frontmatter description verbatim) and merge the overlapping approval rules from Best Practices and Constraints into one 'Safety rules' section; also add a post-edit verification step (re-read the file or re-run the assessment to confirm the score improved) to complete the workflow's feedback loop.

DimensionReasoningScore

Conciseness

The body opens by repeating the frontmatter description nearly verbatim ('Provides comprehensive CLAUDE.md file management capabilities including auditing...'), restates the approval-before-editing rule three times (Phase 4, Best Practice #2, Constraint #1), and spends ~120 lines on three full example reports. This is 'mostly efficient but includes some unnecessary explanation or could be tightened' (anchor 3) rather than anchor 4, where only minor trimming would be needed.

3 / 5

Actionability

Guidance is fully executable: a copy-paste-ready discovery command ('find . -name "CLAUDE.md" ... | head -50'), exact criterion weights, a complete fill-in-the-blank report template, a diff format spec, and three worked examples covering assessment, creation, and update. It matches anchor 5 ('fully executable; copy-paste ready... specific examples cover the common cases') and exceeds anchor 4 because no key execution detail is left to inference.

5 / 5

Workflow Clarity

The 5-phase workflow is clearly sequenced with explicit checkpoints: 'CRITICAL: Always output the quality report BEFORE making any updates', user confirmation in Phase 4, and approval gating Phase 5. It fits anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') rather than anchor 5 because there is no post-edit feedback loop (e.g., re-reading the file or re-scoring to confirm the fix landed), and no recovery path if an edit misfires.

4 / 5

Progressive Disclosure

Two bundle files are clearly signaled with links ([references/quality-criteria.md], [references/update-guidelines.md]), but references/templates.md exists in the bundle and is never linked — only vaguely gestured at as 'templates' in Best Practices — and ~120 lines of example output that belongs in a separate examples file are inlined. This matches anchor 3 ('could be better organized... content that should be separate is inline') better than anchor 4, where organization gaps would be minor.

3 / 5

Total

15

/

20

Passed

Description

88%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 that clearly states capabilities, an explicit 'Use when' trigger clause, and a concrete action lifecycle in third person. Its only weaknesses are minor: a couple of missing natural trigger synonyms and two broad trigger phrases with mild overlap risk against generic documentation skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'scans all CLAUDE.md files, evaluates quality against standardized criteria, outputs detailed quality reports with scores and recommendations, then makes targeted updates with user approval' — covering the full capability set comprehensively in third-person voice. It clearly exceeds anchor 4 ('lists several specific actions; minor gaps') because the audit-assess-report-update lifecycle is fully enumerated with no coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: what ('auditing, quality assessment, and targeted improvements... outputs detailed quality reports with scores and recommendations') and when ('Use when user asks to check, audit, update, improve, fix, maintain, or validate CLAUDE.md files. Also triggers for...'), matching the anchor-5 exemplar structure with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural term coverage: 'check, audit, update, improve, fix, maintain, or validate CLAUDE.md' plus quoted phrases like 'project memory optimization', 'CLAUDE.md quality check', 'documentation review'. It falls short of anchor 5 because a few natural user phrasings (e.g., 'project context', 'onboarding docs', 'init') are missing, and 'documentation review' is broader than the niche.

4 / 5

Distinctiveness Conflict Risk

The CLAUDE.md file type is a clear, distinct niche with dedicated triggers, but 'documentation review' and 'project memory optimization' are broad phrases that could overlap with general documentation or memory-management skills. It fits anchor 4 ('mostly distinct; minor overlap risk with closely related skills') better than anchor 5, which demands minimal conflict risk across all triggers.

4 / 5

Total

18

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/developer-kit

Path

plugins/developer-kit-core/skills/claude-md-management/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.