Content
92%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.
An exceptionally actionable setup skill: copy-paste commands and complete provider code for every supported framework, a numbered detection workflow with explicit error-recovery branches, and a verification checklist closing the loop. Bundled protocol guides and API references are all real, one level deep, and clearly signaled from a concise overview. The only improvement space is minor token tightening (a thrice-stated NextJS import-path warning and partly redundant detection pattern lists).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative — tabular detection logic ("yarn.lock → use yarn add", dependency checks), library-specific facts Claude would not know ("React's DataProvider has a backup <Suspense>, so a Suspense boundary above it never catches"), and no basic-concept explanations. Not 5 because of minor trims available: the NextJS import path ("@data-client/react/nextjs") is stated three times (inline note, checklist, Common Issues), and some detection pattern lists ("query {, mutation {, subscription {") restate what Claude already knows; not 3 because padding is minor relative to the skill's justified complexity. | 4 / 5 |
Actionability | Guidance is fully executable throughout: per-package-manager install commands ("npm install @data-client/react && npm install -D @data-client/test"), the skills-linking command ("npx --no data-client-skills"), a verbatim AGENTS.md snippet, and complete copy-paste provider code for all five framework variants. Specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | A clear sequence runs from numbered detection steps (1-5) through skill/package installation, provider setup, and protocol-specific guides, ending in an explicit "Verification Checklist" with per-phase checkboxes. Feedback loops for error recovery are present ("If it reports Kept .agents/skills/data-client-setup... Remove it... and run the command again"; "If the command isn't found... install the skills with the skills CLI"; the TanStack "Check the migration" list), matching the top anchor. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview: protocol detail is delegated to real bundled one-level-deep guides (references/data-client-rest-setup.md, data-client-graphql-setup.md, data-client-endpoint-setup.md, tanstack-query-migration.md — all verified to exist), API docs live in an annotated References list with one-line descriptions, and the Vue convention ("read <name>.vue.md instead of <name>.md when it exists") matches actual .vue.md files on disk. Content split and navigation match the top anchor; not 4 because no organization gaps were found. | 5 / 5 |
Total | 19 / 20 Passed |