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.
The body is a lean, well-structured routing skill with concrete install and cost commands, an explicit pre-flight MCP check with failure handling, and clear cross-skill delegation rules. Weaknesses are minor: pinned version/date maintenance details sit in the main flow, and no example MCP tool invocations or API-error handling steps are provided. All four dimensions land at 4–5 with no actionable gaps worth flagging.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — a routing table, terse conventions, and guardrails with no padding. Minor trimmable tokens remain: the "Package check (2026-07-10)" date line and repeated pinned version "@ahrefs/mcp@0.0.11" are time-sensitive details that penalize conciseness per the guidelines, keeping it below 5. | 4 / 5 |
Actionability | Concrete executable guidance throughout: "extensions/ahrefs/install.sh" / "install.ps1", the API token URL, a routing table mapping exact commands to actions, and the copy-pasteable cost command "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py. It stops short of 5 because no example MCP tool invocation or parameter details are shown for the four data lookups. | 4 / 5 |
Workflow Clarity | A pre-flight check ("verify the MCP is connected... If tools are not available, tell the user the extension is not installed") provides explicit error recovery, and the cost-guardrail batch workflow has pre-batch validation (estimate, surface, log). Not 5 because checkpoints for API errors, rate limits, or empty results are missing. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed: the ~50-line body is organized into clear single-purpose sections (Prerequisites, Routing, Output conventions, Cross-skill delegation, Cost guardrails, Security) with no nested references. Per the simple-skill guidance, this earns the top score with well-organized sections alone. | 5 / 5 |
Total | 17 / 20 Passed |