Content
77%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.
Operationally excellent content: concrete API guidance, exemplary consent/verification workflow with feedback loops, and disciplined, non-padded prose. The main weaknesses are structural — the five CMS adapters are inlined wholesale in SKILL.md instead of being split into reference files, and the referenced orchestration-details.md is absent from the bundle — plus one minor URL-interpolation inconsistency.
Suggestions
Move the five CMS adapter sections into per-adapter reference files (e.g. references/adapters/wordpress.md) and keep only the adapter-overview table plus one-line links in SKILL.md.
Resolve the dangling reference: either ship references/orchestration-details.md in the bundle or remove/repath the instruction to read it, since no references/ directory exists.
Fix the WordPress list-tags example to pass the search term as an encoded parameter consistent with the skill's own no-string-interpolation rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — it never explains concepts Claude already knows (what tags are, what REST is) and includes genuinely non-obvious details like Ghost JWT signing and Shopify access scopes. A few tokens could be trimmed: the standalone "Manage tags and categories across CMS platforms.", the stop-word list ("articles, prepositions, conjunctions, pronouns"), and repeated "checked 2026-10-12" citations — so it sits at the 4 anchor rather than 5. | 4 / 5 |
Actionability | Highly executable: exact endpoints, request bodies, pagination rules ("follow `X-WP-TotalPages` header", "loop while `pageInfo.hasNextPage` is true"), numeric thresholds, and status-code error handling. Falls short of fully copy-paste-ready because the WordPress list-tags example interpolates `{keyword}` into the URL query, contradicting the skill's own hard limit "never by string interpolation into a query or URL" — a minor inconsistency in otherwise concrete guidance. | 4 / 5 |
Workflow Clarity | The 6-step consent gate has explicit validation checkpoints and feedback loops throughout: dry-run plan, approval by host and counts, "Execute only the approved items, one post first... verify it by re-reading, then continue", "Stop on the first unexpected response", and a rollback record. Batch-write validation is thoroughly present, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The file is well-sectioned (Commands table, per-workflow, per-adapter) but ~150 lines of CMS adapter API reference are inlined in SKILL.md rather than split into per-adapter reference files, and the one reference named — "Read the main reference `orchestration-details.md`" — does not exist in the bundle (no references/ directory exists), leaving it unresolvable. Good internal structure keeps this above 2, but the inlined bulk and dangling reference keep it below 4. | 3 / 5 |
Total | 16 / 20 Passed |