Content
92%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 high-quality instruction-only skill body: everything is empirical Semrush-specific knowledge Claude could not infer, delivered as executable call syntax, real response/error examples, and clearly sequenced workflows with cost-control and retry checkpoints. Detail is appropriately split into two real one-level-deep reference files. The only reservation is length — a ~290-line always-loaded body with a few passages that could be trimmed or delegated to the references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with measured, non-inferable facts (per-call unit costs, parameter-name tables, error JSON shapes) and never explains concepts Claude already knows — no definition of SEO, backlinks, or MCP. However, at ~290 lines it is a long always-loaded body, and a few passages could be tightened or pushed to references (e.g., the follow-on analysis of the cost table, "That command is one agent's syntax. Substitute whatever your agent uses..."). This sits noticeably above the 'mostly efficient but some unnecessary explanation' level 3 but short of 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable: exact call syntax (`get_report_schema(report="domain_rank")`, `execute_report(report=..., params={target: "example.com", database: "us"})`), a real response envelope to parse, per-report parameter names with types, exact date format (`2026-08-15` works; `20260815` fails), batch forms (`phrase_these` takes `"a;b;c"`), and concrete error JSON with recovery semantics. An agent can act on this verbatim without guessing. | 5 / 5 |
Workflow Clarity | The core multi-step process is explicitly sequenced with numbered steps (three-step call protocol, project-first flow for site_audit/position_tracking) plus skip conditions. Checkpoints and feedback loops are present throughout: budget agreement before the first execute_report, accumulating `metadata.usage.api_units` and stopping at the limit, `retryable`/`hint`-driven retry for validation failures, checking a project's `tools` array before proceeding, and pre-empting the unhelpful 'campaign not found' error. Unit-spending calls are treated as the risky operation and are explicitly guarded. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview: the full 86-report catalogue and confirmed parameters live in references/reports.md, and OAuth/HTTP/error details in references/protocol.md — both real files, linked inline at point of need and again in a dedicated References section with per-file descriptions. References are exactly one level deep (no further links inside them), matching the score-5 anchor for well-signaled, one-level-deep structure. | 5 / 5 |
Total | 19 / 20 Passed |