Content
75%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.
A well-structured router skill: terse lookup tables, concrete API corrections, an executable computer-use example, and disciplined delegation to sub-skills and package skills. The main weaknesses are the duplicated decision tree, inline persistence/computer-use detail that could live one level deeper, and a couple of reference rows lacking concrete entry paths.
Suggestions
Merge the Quick Decision Tree into the Sub-Skills table (or drop it) — the two sections duplicate the same routing information across ~25 lines.
Give @tanstack/ai-code-mode an explicit entry path like node_modules/@tanstack/ai-code-mode/skills/... the way the persistence and ai-skills sections do.
Move the store-contract type list and the full computer-use implementation example into the referenced sub-skill/package skills, keeping only the routing rows and the critical warnings inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense — routing tables, terse bullets, executable code, and library-specific facts with no padding or explanations of concepts Claude already knows. It matches anchor 4 rather than 5 because the Quick Decision Tree largely duplicates the Sub-Skills table and the persistence section inlines contract-level types ("RunStatus, RunRecord, RunStore, defineRunStore, InMemoryRunStore") that could be pushed one level down. | 4 / 5 |
Actionability | Guidance is concrete and mostly executable: copy-paste bash install commands, a complete executable computer-use TypeScript example with exact imports, precise API corrections with code ("useChat({ tools: clientTools(myTool.client(...)) })"), and exact sub-skill paths. It misses anchor 5 only through small gaps, e.g. the @tanstack/ai-code-mode section says just "See the ai-code-mode skill in that package" with no entry path, unlike the other two companion packages. | 4 / 5 |
Workflow Clarity | Routing decisions are unambiguous via two lookup structures plus a fallback ("Debugging mistakes? → Check Common Mistakes in the relevant sub-skill"), and companion-package setup is sequenced (pnpm add → "npx @tanstack/intent@latest install" → explicit entry path). It is anchor 4 rather than 5 because setup flows lack explicit validation checkpoints (e.g., confirming the skills actually wired in after the intent install). | 4 / 5 |
Progressive Disclosure | References are consistently one level deep and well signaled — a "Need to... | Read..." table of sub-skill SKILL.md paths, explicit node_modules entry points for companion packages, and four linked computer-use docs pages. It matches anchor 4 rather than 5 because no actual bundle files ship alongside this SKILL.md (the referenced sub-skill paths resolve outside it), and the ~50-line inline computer-use example plus persistence contract detail could be split one level deeper. | 4 / 5 |
Total | 16 / 20 Passed |