Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable testing recipe with executable code, explicit validation feedback loops, and a useful anti-patterns checklist. The main weakness is progressive disclosure: everything lives inline in one file with no reference files to offload advanced material.
Suggestions
Move the advanced plugin-contract and context-required resolver test sections into a reference file (e.g. references/ADVANCED.md) and link to it from SKILL.md so the body stays a concise overview.
Extract the full Apollo Server / GraphQL Yoga integration examples into references/INTEGRATION.md, replacing the inline stub blocks with a clearly signaled 'See INTEGRATION.md' link.
Add a one-level-deep reference (e.g. references/EXAMPLES.md) for the per-domain snapshot and plugin-combination guidance, keeping SKILL.md as a navigable entry point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-forward, assuming Claude's competence — e.g. "graphql() from graphql-js executes against the schema directly. No server. No HTTP. No middleware." It avoids explaining concepts Claude already knows (no "what is GraphQL" preamble) and every section earns its tokens. Not score 2 because there is no padded or unnecessary explanation to tighten. | 3 / 3 |
Actionability | Provides fully executable, copy-paste-ready TypeScript (SchemaBuilder setup, graphql() unit test, printSchema snapshot, Apollo/Yoga wiring, relay plugin, context-value tests) plus concrete commands (npm install --save-dev, npm test -- --updateSnapshot, CI yaml). Matches the score-3 anchor and exceeds the pseudocode/incomplete score-2 anchor. | 3 / 3 |
Workflow Clarity | A clear topical progression (Install → Build schema → Unit-test resolver → Snapshot → Integration → Running → CI) with explicit validation feedback loops: the snapshot "fails and reviewers see the diff" and CI "--ci flag prevents --updateSnapshot and fails on mismatch", plus an anti-patterns table acting as a checklist. Not score 2 because validation checkpoints and error-recovery guidance are present rather than missing. | 3 / 3 |
Progressive Disclosure | Well-organized into clear sections with a signaled References list, but the entire skill is a single inline file with no one-level-deep reference files (references/scripts/assets do not exist) and advanced material (plugin-contract and context-required tests) that could be split is inline. This fits the score-2 anchor (some structure, content that should be separate is inline) rather than the score-3 anchor requiring well-signaled separate reference files. | 2 / 3 |
Total | 11 / 12 Passed |