CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-md-management

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

67

Quality

84%

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

75%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, highly actionable skill body with a clear 5-phase workflow, concrete scoring rubric, templates, and worked examples. The main costs are token efficiency — the criteria table and trigger lists are repeated across sections — and a dangling unlinked bundle file (templates.md), plus a missing verification step after updates are applied.

Suggestions

State the 6-criteria scoring table once (Phase 2) and have the report template and Example 1 reference it instead of duplicating it, cutting three copies to one.

Trim the 'When to Use' section and the overlapping 'Best Practices'/'Constraints and Warnings' lists — both restate the frontmatter triggers and the approval rule already enforced in Phases 4–5.

Add an explicit link to references/templates.md (e.g., in Phase 3 or the from-scratch example, where templates are actually needed) so all three bundle files are discoverable from the body.

DimensionReasoningScore

Conciseness

The body is mostly efficient but has notable redundancy: the 6-criteria scoring table appears three times (Phase 2, the report template, and Example 1), 'When to Use' repeats the frontmatter triggers almost verbatim, and 'Best Practices' overlaps 'Constraints and Warnings' (e.g., 'Report before editing' vs 'Never modify without approval'). This fits the 'mostly efficient but could be tightened' anchor, above score 2 because there is no padding that explains concepts Claude already knows.

3 / 5

Actionability

Guidance is fully executable: a copy-paste `find` command, a weighted scoring rubric with point allocations and grade bands, a complete report template, a diff format, and three worked examples (assessment, creation from scratch, update proposal) covering the common cases. This matches the score-5 anchor.

5 / 5

Workflow Clarity

The 5-phase workflow is clearly sequenced with key checkpoints ('CRITICAL: Always output the quality report BEFORE making any updates' and user confirmation before Phase 5). It falls short of 5 because there is no post-apply verification or error-recovery loop after edits, and short of the destructive/batch cap of 3 because the edits are approval-gated and diffed rather than blind batch writes.

4 / 5

Progressive Disclosure

Structure is good: detailed criteria and update guidelines are properly offloaded to one-level-deep, real files (references/quality-criteria.md and references/update-guidelines.md, both verified to exist). The gap is that references/templates.md exists in the bundle but is never linked by path — it is only alluded to as 'templates' in Best Practices — leaving it undiscoverable from the body.

4 / 5

Total

16

/

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 explicitly answers both what the skill does and when to use it, with a comprehensive set of concrete actions and natural trigger phrases. The only weaknesses are a few missing trigger synonyms/extensions and a slightly broad 'documentation review' trigger that could overlap with documentation-editing skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full lifecycle — 'scans memory files, evaluates quality against standardized criteria, outputs detailed quality reports with scores and recommendations, then makes targeted updates with user approval' — matching the comprehensive-coverage anchor. It sits above the score-4 anchor ('several specific actions; minor gaps') because scanning, evaluating, reporting, and updating are all explicitly covered.

5 / 5

Completeness

Both 'what' (auditing, quality assessment, targeted improvements with the scan/evaluate/report/update detail) and 'when' (explicit 'Use when user asks to check, audit, update, improve, fix, maintain, or validate...' with concrete trigger phrases) are clearly and explicitly stated, matching the score-5 anchor.

5 / 5

Trigger Term Quality

Trigger coverage is good: 'check, audit, update, improve, fix, maintain, or validate project memory files' plus quoted phrases like 'project memory optimization' and 'CLAUDE.md quality check'. It falls short of the score-5 anchor because a few natural terms and file-extension variants are missing (e.g., 'review CLAUDE.md', '.claude.local.md', 'create CLAUDE.md').

4 / 5

Distinctiveness Conflict Risk

The CLAUDE.md/project-memory niche is mostly distinct, but the broad trigger 'documentation review' and generic verbs like 'update/improve/fix' create minor overlap risk with general documentation-editing skills, placing it at the 'mostly distinct; minor overlap risk' anchor rather than 5.

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

giuseppe-trisciuoglio/developer-kit

Path

plugins/developer-kit-core/skills/memory-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.