Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with concrete commands, a JSON schema, executable bash, and well-sequenced workflows including duplicate and limit validation. Its main weakness is redundancy: triggers and prohibitions are restated across several sections, inflating the token budget without adding operational value.
Suggestions
Consolidate the auto-invoke triggers, 'When to Use', 'When Not to Use', and 'Anti-Patterns' sections — they restate the same five trigger categories and the same prohibitions multiple times; merge into a single triggers list and a single anti-patterns list.
Trim the Usage Examples section to one or two representative cases, since the response format is already specified verbatim in the per-command sections.
Remove restated constraints (e.g. the 5-per-type/20-total limit appears in both the Pin procedure and a dedicated Limits section) and keep a single authoritative location.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and actionable, but the Auto-Invoke Rules, When to Use, When Not to Use, Anti-Patterns, and Usage Examples sections substantially restate the same triggers and prohibitions already covered, adding length without new operational information. | 2 / 3 |
Actionability | Each command has a numbered procedure, a concrete JSON schema, an executable slug-derivation bash block, and copy-paste-ready example invocations with exact response strings. | 3 / 3 |
Workflow Clarity | Pin/Show/Remove/Clear workflows are explicitly sequenced with validation checkpoints (duplicate check before write, not-found handling, limit enforcement with oldest-drop), satisfying the feedback-loop requirement for batched file writes. | 3 / 3 |
Progressive Disclosure | For a self-contained skill with no bundle files, content is organized into clearly labeled sections (State File, Commands, Philosophy, Key Behaviors) with the two external references cleanly isolated in a References section. | 3 / 3 |
Total | 11 / 12 Passed |