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 an excellent skill description that clearly articulates specific actions (review, rewrite, archive), targets a well-defined niche (lessons-learned graduation), and provides comprehensive trigger guidance with six natural use-case variations. It uses proper third-person voice throughout and would be easily distinguishable from other skills in a large collection.
| 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 patterns) make it very 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 criteria, concrete templates, validation checkpoints, and anti-patterns. The progressive disclosure is excellent, keeping the main file focused while pointing to a reference for the worked example. The quality gates checklist and anti-patterns section provide strong guardrails for safe execution.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section serves a purpose — criteria table, numbered workflow, merge protocol details, quality gates, and anti-patterns. No unnecessary explanations of concepts Claude already knows. | 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), and explicit strategies. The guidance is specific enough to execute directly. | 3 / 3 |
Workflow Clarity | Clear 6-step numbered workflow with detailed sub-steps for steps 3-6. Includes explicit validation checkpoints via the Quality Gates checklist, and anti-patterns serve as guardrails. The 'never delete' constraint and conflict resolution requirement show good error prevention. | 3 / 3 |
Progressive Disclosure | Well-structured with a clear overview (run criteria, workflow) followed by detailed protocol sections. References a worked example in REFERENCE.md — one level deep, clearly signaled. Content is appropriately split between overview and detail. | 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.
f5c8508
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.