Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable meta-skill with clear sequenced workflow and embedded tool calls. Its main weaknesses are redundancy across trigger sections and a monolithic layout that underuses progressive disclosure.
Suggestions
Consolidate the overlapping trigger lists in 'When to Extract', 'Automatic Triggers', and 'Self-Reflection Prompts' into one section to remove repetition and tighten the body.
Move the full skill-structure template (Step 4) and the worked n8n example into a reference file (e.g. references/template.md), keeping SKILL.md as an overview with a one-level-deep link.
Trim the 'Core Principle' and intro paragraph, which restate the description, to reduce tokens that don't earn their place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, but trigger guidance is repeated across the description, 'When to Extract', 'Automatic Triggers', and 'Self-Reflection Prompts', and the 'Core Principle' reiterates the intro, so it could be tightened. | 2 / 3 |
Actionability | Provides concrete, executable tool calls (search_thoughts, capture_thought), decision tables mapping outcomes to actions, a fill-in skill template, and a full worked example — copy-paste ready guidance. | 3 / 3 |
Workflow Clarity | The Extraction Process is sequenced as Steps 1–7 with explicit validation checkpoints (search-before-create gates, a final quality-gate checklist) and error-recovery decision tables. | 3 / 3 |
Progressive Disclosure | Well-sectioned but a single monolithic file with no reference offloading; the large skill template and worked example are inline and could be split into reference files for a body of this length. | 2 / 3 |
Total | 10 / 12 Passed |