Reviews mature LESSONS-LEARNED.md entries, rewrites them as permanent rules in skill/instruction files, and archives graduated lessons. Use when graduating lessons into skills, promoting validated lessons, updating skills from past learnings, archiving mature lessons, codifying repeated patterns, or cleaning up a crowded LESSONS-LEARNED.md.
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It clearly specifies concrete actions (review, rewrite, archive), provides an explicit 'Use when...' clause with diverse trigger terms, and occupies a distinct niche that is unlikely to conflict with other skills. The third-person voice is used correctly throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'reviews mature LESSONS-LEARNED.md entries', 'rewrites them as permanent rules in skill/instruction files', and 'archives graduated lessons'. These are clear, actionable operations. | 3 / 3 |
Completeness | Clearly answers both 'what' (reviews, rewrites, archives lessons-learned entries into skill files) and 'when' with an explicit 'Use when...' clause listing six specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'graduating lessons into skills', 'promoting validated lessons', 'updating skills from past learnings', 'archiving mature lessons', 'codifying repeated patterns', 'cleaning up a crowded LESSONS-LEARNED.md'. Good coverage of variations. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focused specifically on the LESSONS-LEARNED.md to skill file graduation workflow. The specific file references (LESSONS-LEARNED.md, skill/instruction files) and domain-specific terminology (graduating, archiving, codifying) make it unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently communicates a multi-step process with clear thresholds, concrete templates, explicit validation checkpoints, and appropriate progressive disclosure. The anti-patterns section adds valuable guardrails, and the quality gates checklist ensures merge operations are verified. The content is concise while remaining comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section serves a purpose — criteria table, numbered workflow, merge protocol, quality gates, and anti-patterns. No unnecessary explanations of concepts Claude already knows. The table format for run criteria is particularly token-efficient. | 3 / 3 |
Actionability | Provides concrete templates (the draft edit format, the archive markdown format, the attribution comment syntax), specific thresholds (3+ citations, 60 days, 50 entries), explicit strategies, and a checklist. The guidance is specific enough to execute without ambiguity. | 3 / 3 |
Workflow Clarity | The 6-step numbered workflow is clearly sequenced, with steps 3-6 expanded in the Merge Protocol section. Validation is explicit via the Quality Gates checklist, including a smoke verification step. The anti-patterns section provides guardrails against common failure modes, and the 'never delete' constraint is clearly stated. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with the workflow, then expands key steps in the Merge Protocol section. The worked example is appropriately delegated to REFERENCE.md with a clear one-level-deep reference. Content is well-organized across sections without being monolithic. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
18c6f2c
Table of Contents
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.