Content
67%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 well-structured, highly actionable behavioral skill with a clear decision workflow diagram and properly offloaded platform references. Its main cost is repetition — the core invocation rule is restated three times — plus a dangling unreferenced bundle file and inconsistent heading hierarchy.
Suggestions
State the 1%-chance rule once (in 'The Rule' section) and trim the redundant restatement in the EXTREMELY-IMPORTANT block and the dot graph node labels, keeping only the flow structure.
Reference references/gemini-tools.md in the Platform Adaptation section alongside copilot-tools.md and codex-tools.md so no bundle file is orphaned, and normalize heading levels (the h1 'Using Skills' appears mid-document under h2 sections).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core 1%-chance rule is stated three times ('If you think there is even a 1% chance... you ABSOLUTELY MUST invoke the skill', 'Even a 1% chance a skill might apply means that you should invoke the skill to check', and again in the dot graph), so the document could be tightened. It stays above anchor 2 because most sections (Red Flags table, Instruction Priority, Skill Priority) each carry distinct behavioral value rather than padding. | 3 / 5 |
Actionability | Guidance is concrete and executable for a behavioral skill: 'Use the `Skill` tool', 'Never use the Read tool on skill files', the announce template "'Using [skill] to [purpose]'", 'Create TodoWrite todo per item', and platform-specific tool names (skill, activate_skill). It falls short of anchor 5 only through minor gaps like the vague 'Check your platform's documentation for how skills are loaded' and the absence of a worked example. | 4 / 5 |
Workflow Clarity | The dot graph sequences the full workflow with decision branches ('Might any skill apply?', 'Already brainstormed?') and a recovery path ('If an invoked skill turns out to be wrong for the situation, you don't need to use it'). Not a destructive or batch operation, so no validation cap applies; it misses anchor 5 because error recovery is a single sentence rather than an explicit validate-fix-retry loop. | 4 / 5 |
Progressive Disclosure | Platform tool mappings are appropriately offloaded to real one-level-deep references ('see references/copilot-tools.md... references/codex-tools.md'), and both referenced files exist in the bundle. Minor gaps keep it below anchor 5: references/gemini-tools.md is present in the bundle but never referenced in the body, and heading levels jump from '## Platform Adaptation' to '# Using Skills'. | 4 / 5 |
Total | 15 / 20 Passed |