Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable reference catalog with executable code, clear per-mode flows, and strong verification/recovery tables. The only weakness is mild verbosity in the introductory definition and transition prose that assumes less than Claude's competence.
Suggestions
Trim the opening Apollo doc-quote definition of 'what a persisted query is' and the 'Two motivations, often conflated' framing — Claude already knows this; lead with the strategy-specific content.
Tighten the transitional prose in Mode 3 ('Best of both: dev gets the iteration speed of auto-register; prod gets the allowlist') to a single clause so the mode table/flow carries the meaning.
Consider moving the per-framework support table and Limitations into a short companion reference file if the catalog grows, keeping SKILL.md as the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, purposeful reference material (tables, code, numbered flows), but the opening doc-quote definition of what a persisted query is and framing prose like 'Two motivations, often conflated' and 'Best of both: dev gets the iteration speed...' could be tightened. Not score 3 because some explanatory framing explains concepts Claude already knows; not score 1 because the bulk is lean and reference-style rather than padded. | 2 / 3 |
Actionability | Provides fully executable examples: ApolloServer persistedQueries config, the createPersistedQueryLink TypeScript snippet, and `npx graphql-codegen` commands, plus concrete per-mode request flows. Not score 2 because the core guidance is copy-paste ready rather than pseudocode. | 3 / 3 |
Workflow Clarity | Each mode has a clearly numbered request flow (e.g. Mode 1 steps 1-5, Mode 2 steps 1-5), and the 'Testable behaviours' table plus the 'Anti-patterns' table provide explicit verification and error-recovery checkpoints ('These tests prove the chosen mode is actually in effect'). Not score 2 because validation/verification is explicit, not merely implied. | 3 / 3 |
Progressive Disclosure | Well-organized single-file structure with clearly labeled sections (Overview, When to use, the three modes, Implementation patterns, Per-framework support, Testable behaviours, Anti-patterns, Limitations, References) and clearly signaled one-level external links; no nested/deep references. Not score 2 because navigation is clean and content is appropriately sectioned for a self-contained reference with no bundle files. | 3 / 3 |
Total | 11 / 12 Passed |