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.
A lean, well-structured behavioral skill: concrete rules, an exact announcement format, a rationalization table, and clean one-level platform references that all resolve to real files. The main gaps are mild redundancy in the red-flags table, no actual mechanism for discovering skills despite the description claiming one, and one orphaned bundle file (gemini-tools.md) not surfaced in the body.
Suggestions
Trim the 12-row Red Flags table to the 4-5 genuinely distinct rationalization patterns — entries like 'This is just a simple question', 'This doesn\'t count as a task', and 'I\'ll just do this one thing first' restate the same excuse and dilute the table's impact.
Add the missing skill-discovery step the description promises: a line on how to enumerate or look up available skills (e.g., where the skill list lives or how to search it) so the 'find' half of 'find and use skills' is actionable.
Add references/gemini-tools.md to the Platform Adaptation list (or remove the file) so the body's reference list matches the actual bundle contents.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tight and purposeful — 'Invoke relevant or requested skills BEFORE any response or action' and the priority mapping ('"Let\'s build X" → superpowers:brainstorming first') carry real weight per token. It falls short of 5 because the 12-row Red Flags table contains near-duplicate entries (e.g. 'This is just a simple question' / 'This doesn\'t count as a task' / 'I\'ll just do this one thing first') and the EXTREMELY-IMPORTANT block repeats its mandate three ways ('This is not negotiable. You cannot rationalize your way out of this.'), which could be trimmed without loss. | 4 / 5 |
Actionability | The guidance is concrete and executable for an instruction-only skill: an exact announcement format ('Using [skill] to [purpose]'), a concrete todo rule ('If it has a checklist, create a todo per item'), specific priority examples, and verifiable platform file paths. It misses a 5 because despite the description promising it 'establishes how to find and use skills', the body never says how to discover which skills exist (no command, list, or lookup step) — a real gap for the skill's core claim. | 4 / 5 |
Workflow Clarity | The single decision workflow is clearly sequenced (check for skills → invoke before responding → announce → follow with todos), with an explicit recovery path ('If it turns out wrong for the situation, you don\'t have to use it') and an explicit precedence rule in the User Instructions section. No validation checkpoints are needed since this is neither destructive nor batch, so the score-3 cap does not apply; the only gap keeping it from 5 is that the Skill Priority examples cover just two cases without stating how to resolve other multi-skill conflicts. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned (~60 lines) with clearly signaled, one-level-deep references: 'If your harness appears here, read its reference file' followed by six named files, all of which exist in references/ and contain no nested references. It falls short of 5 because references/gemini-tools.md is present in the bundle but never referenced from the body — an orphaned file indicating drift between the body and the actual bundle. | 4 / 5 |
Total | 16 / 20 Passed |