Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and well-structured with a clear sequenced workflow, validation loops, and clean one-level-deep reference navigation. Its main weakness is conciseness — several passages explain background concepts (SSR/CSR/hydration, LLM-crawler stances) that Claude already knows.
Suggestions
Trim the Audit Notes rendering explanation to the actionable rule (compare raw vs rendered DOM) and drop the SSR/SSG/CSR primer Claude already knows.
Condense the Data Sources prose into a compact command + reference list instead of paragraph explanations of each connector.
Move the LLM-crawler stance rationale into the referenced playbook and keep only the decision-gate prompt in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational and dense with concrete commands, but explanatory asides restate concepts Claude already knows (e.g., "AI crawlers don't execute JS; critical content and JSON-LD must be in the initial HTML. SSR/SSG ships it server-side; pure CSR hides it until hydration") and the Data Sources section is padded with prose. | 2 / 3 |
Actionability | Copy-paste-ready commands (e.g., `python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/robots.py" <url> --check-ai-bots`), exact CWV thresholds (LCP <2.5s, INP <200ms, CLS <0.1), and curl/indexpush recipes give fully executable guidance. | 3 / 3 |
Workflow Clarity | A clear 9-step audit sequence pairs with explicit Decision Gates (stop-and-ask vs continue-silently), a ledger-diff validation feedback loop (psi.py | ledger.py record/diff), and "Done when" criteria with P0/P1/P2 severity. | 3 / 3 |
Progressive Disclosure | The SKILL.md is an overview pointing one level deep to 8 real reference files (verified present), each clearly signaled and enumerated in a Reference Materials section, with content appropriately split into templates, examples, and playbooks. | 3 / 3 |
Total | 11 / 12 Passed |