Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a strong, highly actionable instruction skill — complete entry templates, executable grep commands, and well-sequenced promotion/extraction workflows with approval gates and verification steps. Its weaknesses are token efficiency (~500 lines with redundant priority/area tables and overlapping best-practices sections) and an orphaned references/examples.md that is never linked from the main file.
Suggestions
Trim the Priority Guidelines and Area Tags tables (their values are already enumerated inline in the entry templates) and cut or merge the Best Practices and Multi-Agent Support sections, which largely restate Detection Triggers.
Link references/examples.md from SKILL.md (e.g., a '## Examples' pointer) so its 383 lines of example entries are discoverable, or fold its essential examples into the entry templates and drop the file.
Add brief failure-path guidance to the Promotion and Extraction workflows (e.g., what to do when the fresh-session verification fails or when eligibility checks reject a candidate), completing the feedback loops for workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and specific (no concept-explanation fluff), but at ~500 lines it includes unnecessary material: the Priority Guidelines and Area Tags tables restate the enum values already inline in the entry templates ("low | medium | high | critical", "frontend | backend | infra | tests | docs | config"), and the Best Practices and Multi-Agent Support sections restate guidance covered by Detection Triggers. Not 4: the redundancy is more than minor trimmable instances; not 2: most sections are actionable and free of padded explanation. | 3 / 5 |
Actionability | Fully executable throughout: complete copy-paste markdown templates for all three entry types, exact ID format with examples ("LRN-20250115-001"), runnable bash ("grep -h \"Status\**: pending\" .learnings/*.md | wc -l", "./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run"), and a concrete promotion diff example. Matches the fully-executable anchor covering common cases. | 5 / 5 |
Workflow Clarity | Multi-step workflows are clearly sequenced with checkpoints: promotion step 3 "Show the proposed diff for human approval before writing instructions", extraction step 5 "Verify: Read skill in fresh session to ensure it's self-contained", and a Skill Quality Gates checklist. Not 5: no error-recovery feedback loops (e.g., what to do when the fresh-session verification or a promotion eligibility check fails), and Periodic Review actions are an unordered bullet list; not 3: validation checkpoints are explicit rather than missing. | 4 / 5 |
Progressive Disclosure | Good bundle structure with clearly signaled, purpose-scoped one-level-deep references: "For installation commands, see references/installation.md... Read these only when installing or configuring the skill", plus hooks-setup.md, amp-setup.md, context-maintenance.md, assets/SKILL-TEMPLATE.md, and scripts/extract-skill.sh — all real files. Not 5: references/examples.md (383 lines) is orphaned — never linked from SKILL.md, so undiscoverable — and inline enum tables plus Gitignore Options could live in a reference to slim the overview; not 3: the split between overview and detail is deliberate and mostly well-placed. | 4 / 5 |
Total | 16 / 20 Passed |