Content
96%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.
An exemplary skill body: dense, fully executable commands, explicit decision tables, and validation/feedback loops at every risky step. The only weakness is that its single external reference, LESSON-CATEGORIES.md, is missing from the bundle.
Suggestions
Ship LESSON-CATEGORIES.md alongside SKILL.md (e.g. in references/) so the "The categories, and when each applies" link resolves within the skill bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: "Lessons are the team's memory. A lesson is a file in .opencastle/lessons/, committed with the change you made" and "Nobody sorts memories afterwards" convey only project-specific facts Claude could not know. Tables carry dense decision information ("Still true? | Run"), and no section explains concepts Claude already knows. Anti-drift check: no "minor instances of over-explanation" that would justify a 4. | 5 / 5 |
Actionability | Every workflow ships a copy-paste-ready command: the full "npx opencastle lesson --title ... --problem ... --why ... --cite src/lib/payments.ts:42" example, "rg -i \"CRON_SECRET\" .opencastle/lessons/ || true", "npx opencastle lesson verify <id> --cite <new/path.ts>", "npx opencastle lesson archive <id> --into <file>", and "npx opencastle sync". The main record-lesson case is a complete filled example; templates use appropriate placeholders. Matches the fully-executable top anchor. | 5 / 5 |
Workflow Clarity | Sequences are explicit with validation and feedback loops: the CLI "prints the new id, and refuses a lesson holding a credential or citing a file that does not exist" (error recovery on record); the "When cited code has changed" section is a doctor-triggered verify/move/archive feedback loop; "Resolve two lessons that contradict each other before you merge either" is a checkpoint before merging; and "doctor warns when the index passes about 2,000 tokens" gates graduation. No destructive or batch operation lacks validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | Structure is good: well-headed sections with the bulk of detail appropriately in the body, and exactly one clearly signaled one-level reference ("The categories, and when each applies: [LESSON-CATEGORIES.md](LESSON-CATEGORIES.md)"). Not a 5 because the referenced LESSON-CATEGORIES.md is not present in the skill's bundle (no references/ directory exists), so the link cannot be verified as a real navigation target — a minor organization gap per the 4 anchor. | 4 / 5 |
Total | 19 / 20 Passed |