Content
92%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 highly actionable, well-structured skill body with excellent progressive disclosure and workflow checkpoints. The only weakness is moderate redundancy between the frontmatter and the body's trigger/principle sections.
Suggestions
Remove the duplicated explicit trigger-phrase list from the 'Invocation Triggers' section or replace it with a one-line pointer to the frontmatter, keeping only the implicit-signal bullets that add new information.
Consolidate 'Operating Principles' and 'Anti-Patterns To Reject' — several entries (dropping trivial items, corporate-ifying voice, acting without approval) state the same idea twice; keep one authoritative list.
Tighten the 'Grill-Me Mid-Organization Clarifier' section: the stop-condition and anti-pattern restate the 'max one question' rule already implied, which could be cut to a single sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and mostly earns its tokens, but the trigger phrases are duplicated between the frontmatter and the 'Invocation Triggers' section, and 'Operating Principles' overlaps with 'Anti-Patterns To Reject'. | 4 / 5 |
Actionability | Copy-paste-ready format templates for each section, a concrete right-pattern/anti-pattern table with explicit 'Output:' file paths, and named scripts with CLI invocations fully cover the common cases. | 5 / 5 |
Workflow Clarity | Sequenced Sections 1–4 with an explicit Approval Gate checkpoint, a stop-condition (max one clarifier), and an Error Handling feedback table; the operation is non-destructive so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Clear overview in SKILL.md with well-signaled one-level-deep references; all three references/*.md and three scripts/*.py are real files, listed in a dedicated References section and signaled inline. | 5 / 5 |
Total | 19 / 20 Passed |