Content
92%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An actionable, well-sequenced operational skill with concrete commands, validation checkpoints, and clear feedback loops for its destructive operations. Its weakness is purely structural: everything lives in one large file with no progressive disclosure into referenced materials.
Suggestions
Split the TOOL LADDER & ALTERNATIVES and COMMON PITFALLS sections into separate reference files (e.g. tools.md, pitfalls.md) referenced one level deep from SKILL.md, so the main body stays a lean overview.
Verify the `tools/*.sh` / `tools/*.py` paths referenced in DEEP DIVE and HARD GUARDS actually exist as bundled scripts, or replace the `-h` invocations with the concrete usage inline.
Move version/time-sensitive specifics (e.g. 'Python 3.9', '2025' rule names) into a clearly labeled section so they don't age the core guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with almost no padding of concepts Claude already knows — every section (pipeline, guards, pitfalls, checklist, tool ladder) contributes field-specific operational knowledge that earns its tokens. | 3 / 3 |
Actionability | Provides copy-paste-ready concrete guidance throughout — exact flags (--delay 1800 --jitter 60, --max-count 1000000, --fail-regex "Invalid|incorrect|wrong"), code blocks, mode/filter tables, and specific commands like 'python ooxml/scripts/validate.py'-style invocations. | 3 / 3 |
Workflow Clarity | The 4-stage pipeline is clearly sequenced with a diagram, and the OPERATIONAL CHECKLIST gives explicit before/during/after checkpoints with feedback loops (--dry-run pre-flight, stop-on-hit, abort-on-WAF-detection, notify-program-on-lockout) appropriate for the destructive live-auth operations involved. | 3 / 3 |
Progressive Disclosure | The skill is a single monolithic ~385-line file with no bundle/reference files at all (references/, scripts/, assets/ are absent); the large TOOL LADDER, COMMON PITFALLS, and DEEP DIVE sections would benefit from being split into one-level-deep referenced files rather than kept inline. | 2 / 3 |
Total | 11 / 12 Passed |