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-architected progressive-disclosure index that is lean, clearly navigated, and one level deep into real reference files. Its main gap is actionability — the body relies on references for concrete code, leaving only the Global Rules as inline actionable guidance.
Suggestions
Add a few short executable snippets directly in SKILL.md (e.g., a minimal defineType schema or a basic GROQ query) so common tasks are actionable without forcing a reference load.
Illustrate each Global Rule with a one-line concrete example (e.g., a reference field definition or a singleton Studio Structure entry) to make the in-body guidance copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean overview/index that assumes Claude's competence — it never explains what GROQ, Portable Text, or Sanity are — and each section (When to Apply, Global Rules, Quick Reference, How to Use) earns its place without concept padding. | 3 / 3 |
Actionability | The Global Rules give concrete, actionable directives ('Let Sanity generate _id values', 'Model relationships with reference fields'), but the body is predominantly navigation pointing to reference files with no inline executable code or copy-paste examples, so guidance is concrete but incomplete. | 2 / 3 |
Workflow Clarity | The 'How to Use' section gives a clear, unambiguous selection workflow — start with the single matching guide, then read additional references only when the task crosses concerns — and no destructive/batch workflow lives in the body to require validation checkpoints. | 3 / 3 |
Progressive Disclosure | A textbook one-level-deep structure: a Quick Reference split into Integration Guides and Topic Guides plus a How-to-Use section pointing to 24 real reference files (groq.md, schema.md, nextjs.md verified present), with easy navigation and no nested references. | 3 / 3 |
Total | 11 / 12 Passed |