Content
82%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 strongly actionable, project-specific instruction set: exact tool invocation parameters, a priority-ordered type-detection procedure with signal words, and a concrete decomposition pattern. Its main weaknesses are minor redundancy (types table vs. detection rules, one historical note) and absent error-recovery guidance for the MCP call.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly all content is project-specific (MCP tool, learning types, signal words) with no explanation of concepts Claude already knows, but the Learning Types table partially duplicates the Auto-Type Detection section and "This replaces the old bash command approach" is historical padding that could be trimmed. Not anchor 3 — there is no whole unnecessary section, only minor tightening opportunities. | 4 / 5 |
Actionability | Fully executable guidance: the exact MCP tool path (mcp__opc-memory__store_learning) with a complete parameter block including defaults, typed invocation examples, per-type signal-word lists for detection, and a concrete decomposition format with example phrasings. Matches the copy-paste-ready, common-cases-covered anchor. | 5 / 5 |
Workflow Clarity | The sequence (parse args, detect type first-match top-to-bottom, decompose vague learnings, call the MCP tool, get confirmation with ID) is clear, with the priority-ordered detection rules acting as an explicit decision procedure. Not anchor 5 because there is no error-recovery guidance if the MCP call fails or returns an error, only an implicit confirmation checkpoint. | 4 / 5 |
Progressive Disclosure | A single flat file with clear section headers, no nested references, and no bundle files; all content is needed on every invocation. Not anchor 5 because the ~40-line auto-type detection catalog could live in a separate reference file to keep SKILL.md lean, and the types table plus detection rules form a minor organization duplication. | 4 / 5 |
Total | 17 / 20 Passed |