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.
An unusually well-executed orchestration skill: every step is concrete and executable against named MCP tools, every risky path (spend, partial runs, renamed projects) has an explicit validation or fallback rule, and nothing pads the token budget. The two structural deductions are minor — a few passages could be tightened, and the report-format and tool-inventory material could be split into one-level-deep reference files.
Suggestions
Move the detailed report-format specification ("What to return" section order, table columns, evidence block) into a reference file and keep a short summary inline, letting the body serve as a true overview.
Consider moving the per-tool inventory ("OpenSEO MCP tools" section) into a reference file, keeping only the tools needed per workflow step inline.
Tighten the longest inline passages — the "No tracker" bullet and the project-renaming procedure in Project context step 3 — by compressing the procedural detail into short imperative clauses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational throughout — exact tool calls, parameters (`limit: 50`, `nextCursor`, `runNowCostUsd` as `maxCostUsd`), counts, and per-state branch conditions — with no explanations of concepts Claude already knows. A few passages could still be trimmed (the long "No tracker" bullet, the project-renaming procedure in Project context step 3), which keeps it below the lean anchor 5. | 4 / 5 |
Actionability | Fully actionable for an instruction-only skill: exact MCP tool names and parameters, specific counts (10-15 prompts, five or six pages to read, five to eight candidates), the specific crawlers to check in `robots.txt`, a fully specified report structure down to table columns, and even a chat lead-sentence template with a worked example. Nothing is left as vague direction. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with an explicit decision branch for every tracker state (completed run, in progress, no runs, no active prompts, no tracker) and validation checkpoints throughout: cost approval before any spend, `pollAfterSeconds` polling, "If it returns an error, such as no paid plan, continue without it and say so", "Read it before claiming so", and "A failed or partial run still supplies whatever answers it completed; report its coverage". The Guardrails section adds an error-avoidance checklist. | 5 / 5 |
Progressive Disclosure | Sections are well organized with clear headers and a coherent overview-to-workflow-to-output flow, but everything is inline in a single ~105-line file with no references. The detailed report-format spec ("What to return") and the tool inventory could plausibly live in one-level-deep reference files; since the skill exceeds 50 lines, the simple-skill exception to score 5 does not apply. | 4 / 5 |
Total | 18 / 20 Passed |