Content
45%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 lays out a clear, well-sequenced multi-phase workflow but is badly overlong and redundant, with marketing claims and placeholder-driven implementation undercutting actionability. Progressive disclosure is essentially absent given the single monolithic file.
Suggestions
Collapse the three repeated analysis-category sections (When to Use, Analysis Types, Examples) into one, and remove unverifiable marketing claims like per-example 'Quality: 97/100' and the 'Quality Guarantees ✓' list.
Split detailed material into references/ files (e.g. analysis-types.md, quality-rubric.md, examples.md) and have SKILL.md point to them one level deep, instead of inlining everything.
Replace the placeholder Claude orchestration in scripts/analyze.sh (the 'In actual implementation, this would use the Task tool' block) with a real, executable invocation, or clearly document that the script is a scaffold to be driven by Claude Code.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~730 lines with heavy redundancy: analysis categories appear three times (When to Use, Analysis Types, Examples), marketing-style 'Quality Guarantees ✓' bullets and fabricated per-example quality scores (97/100, 98/100) pad the content, and phases are restated repeatedly. | 2 / 5 |
Actionability | Install/test commands for Gemini and Codex CLIs and the analyze.sh invocation are concrete and executable, but the central orchestration is explicitly a placeholder ('In actual implementation, this would use the Task tool') and the bundled script simulates Claude research rather than implementing it. | 3 / 5 |
Workflow Clarity | The 5/6-phase pipeline is clearly sequenced with per-phase outputs, durations, and an explicit verification-then-iterate loop, which provides good checkpoints; minor gaps come from the placeholder-driven implementation not matching the documented flow. | 4 / 5 |
Progressive Disclosure | The skill is a monolithic ~730-line SKILL.md with no references/ files; material that belongs in separate references (full analysis-type specs, the quality rubric, worked examples) is all inlined, and the only external pointer is to the bundled scripts/analyze.sh. | 2 / 5 |
Total | 11 / 20 Passed |