Content
88%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-engineered operational skill: every command maps to exact MCP tools with defaults and outputs, and paid/batch API usage is wrapped in an explicit pre-call cost-validation loop with post-call logging. The remaining slack is duplication between the quick-reference table and the per-command sections, and the large inlined command catalog that could be partially offloaded to reference files.
Suggestions
Trim the Quick Reference table (or the per-command sections) to remove duplication — e.g., keep the table as a compact index of command → purpose → primary MCP tool, and let the detailed sections carry parameters and outputs.
Move the per-command parameter/output details for less-common commands (e.g., whois, tech, subdomains, top-searches) into a references/ file alongside tool-catalog.md, keeping SKILL.md focused on the quick reference, cost guardrail, and high-traffic workflows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a terse command catalog — MCP tool names, default parameters, and expected outputs per command — with essentially no explanation of concepts Claude already knows. Minor trim candidates exist: the 24-row Quick Reference table duplicates the per-command sections that follow, and the serp-images caveat is stated three times (though the repetition reads as a deliberate anti-hallucination guard). This matches anchor 4 (efficient, minor instances that could be trimmed) rather than anchor 5. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact MCP tool names per command, default parameters (location_code=2840, language_code=en, depth=100), copy-paste commands (`./extensions/dataforseo/install.sh`, the cost check/log invocations with explicit status handling), and concrete expected outputs. Matches the copy-paste-ready anchor (5); no pseudocode or vague direction is present. | 5 / 5 |
Workflow Clarity | The cost guardrail forms an explicit validation loop for expensive/batch operations: "Before every DataForSEO MCP call, run cost estimation" with three outcome branches (approved/needs_approval/blocked) and "After each API call completes, log the cost". Add to that a numbered 4-step ai-mentions workflow, a pre-use availability check, and an Error Handling section with recovery guidance — clear sequences with explicit validation steps and feedback loops, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Two clearly signaled, one-level-deep references that were verified to exist and match their claimed content (references/cost-tiers.md for the pricing table, references/tool-catalog.md for utility tools), plus a quick-reference table for navigation. Not 5: the ~400-line per-command catalog is fully inlined in SKILL.md when much of it could be split into references (as the utility tool catalog already is), leaving only the quick table and key workflows inline — good structure with minor organization gaps, matching anchor 4. | 4 / 5 |
Total | 18 / 20 Passed |