Content
71%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-sequenced, largely executable instruction set with good safety gates (spend approval, credential hygiene, untrusted-content warnings) and clean error-handling fallbacks. Its main structural weakness is progressive disclosure: the body leans on a main reference and a sibling-skill layout that are absent from this bundle, leaving both the orchestration pointer and the API-mode wrapper dangling.
Suggestions
Bundle the referenced orchestration-details.md (or any files the body depends on, e.g. the DataForSEO CLI wrapper in scripts/) so the 'main reference' and sibling-root pointers resolve, or remove those pointer lines from the body.
Move the API-mode endpoint payloads, recommendation deep-dives (MERGE/DIFFERENTIATE/CANONICAL/NOINDEX), and severity formulas into a one-level-deep references/ file linked from a short overview section, keeping SKILL.md as the navigable summary.
Flesh out Local Mode Steps 4-5 with the same specificity as Steps 1-3 (what signals map to which severity level and how recommendations are chosen) — the local heuristic exists but is not connected to the Step 4 flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational throughout — glob patterns, env var names, a deterministic extraction method, and endpoint payloads — and does not explain concepts Claude already knows (no SEO 101 padding). Minor trimmable content keeps it below the top anchor: inline time-sensitive dates ('checked 2026-10-12', twice) sit outside any 'old patterns'/'deprecated' section, and the opening paragraph on ${CLAUDE_SKILL_DIR} resolution is denser than needed. It is clearly above anchor 3, where noticeable unnecessary explanation would be present. | 4 / 5 |
Actionability | Mostly executable guidance: copy-paste-ready endpoint JSON bodies with required parameters, a severity formula with defined variables, skip patterns, credential env vars, and per-error fallback behavior. It is not fully self-contained: API mode 'requires ... a dedicated local CLI wrapper' that is not bundled and has no implementation or invocation instructions (only the SKIPPED fallback), and the local-mode keyword extraction relies on judgment where a precise procedure or script would exist. That places it between anchors 4 and 5, closer to 4. | 4 / 5 |
Workflow Clarity | Both modes have numbered, clearly sequenced steps, and there is a real pre-flight checkpoint — the spend-approval gate ('count the URLs ... Proceed only after the user approves that count, never exceed it') plus retry-once-then-fallback error handling. Minor gaps keep it below 5: Step 4 ('assess severity and generate a recommendation') and Step 5 are underspecified, and API-mode step 1 leaves URL collection vague ('from the user (or sitemap)'). The skill is read-only reporting, so the destructive/batch validation cap does not apply. | 4 / 5 |
Progressive Disclosure | The bundle contains no references/, scripts/, or assets/ directories at all, yet the body's opening directs the reader to 'Read the main reference `orchestration-details.md`' — a dangling reference to a file that does not exist, with the only other paths (${CLAUDE_SKILL_DIR}/../blog/references, etc.) pointing outside the skill. The single-file body also inlines detail (full API endpoint payloads, five recommendation deep-dives) that a well-structured bundle would split into one-level-deep reference files. It has real section structure, so it sits at anchor 3 rather than 2, but the broken/missing reference and monolithic placement of API detail prevent a higher score. | 3 / 5 |
Total | 15 / 20 Passed |