Content
78%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 well-structured, highly actionable skill body with copy-paste-ready commands for every mode, concrete cost/time expectations, and a clear workflow with exit codes. The main issues are minor duplication between the two use-case sections and a broken bundle structure where the referenced scripts/research.py and requirements.txt are missing.
Suggestions
Ship the referenced scripts (scripts/research.py and requirements.txt) in the bundle, or inline the essential behavior, since every usage command depends on files that are absent.
Merge the overlapping "When to Use This Skill" and "Best Use Cases" sections into one list to remove duplication.
Add brief error-recovery guidance for exit code 1 (e.g., check GEMINI_API_KEY, retry on timeout) to close the workflow validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanations of known concepts, with useful concrete tables ("Time | 2-10 minutes per task", "$2-5 per task", token usage). It loses a point because "When to Use This Skill" and "Best Use Cases" largely duplicate the same use-case lists (market analysis, competitive landscaping, due diligence appear in both), which could be merged. | 4 / 5 |
Actionability | Every usage mode is given as a copy-paste-ready command (e.g., `python3 scripts/research.py --query "Research the history of Kubernetes"`, `--status <interaction_id>`, `--wait`, `--continue`, `--list`), plus concrete setup steps, output formats, and exit codes. The examples cover the common cases completely. | 5 / 5 |
Workflow Clarity | The Workflow section gives a clear 5-step sequence with monitoring checkpoints ("Monitor with --stream or poll with --status") and exit codes signal error outcomes. It falls short of 5 because there is no error-recovery guidance for exit code 1 (e.g., what to check or whether to retry), and no validation of the returned report. | 4 / 5 |
Progressive Disclosure | The SKILL.md itself is well organized into clear sections, but its references ("python3 scripts/research.py", "pip install -r requirements.txt") point to files that are not present in the bundle — no scripts/ directory exists — so the one-level-deep reference structure is broken and the skill cannot actually be executed as bundled. This is more than a minor organization gap, placing it below 4. | 3 / 5 |
Total | 16 / 20 Passed |