Content
71%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive, highly actionable tRPC skill with excellent executable code examples covering the full stack from server setup to client components. Its main weaknesses are verbosity — the overview, 'when to use,' and core concepts sections explain things Claude already knows — and the monolithic structure that would benefit from splitting detailed examples and advanced topics into separate files. The workflow is well-sequenced but lacks explicit verification checkpoints.
Suggestions
Remove or drastically shorten the 'Overview,' 'When to Use This Skill,' and 'Core Concepts' sections — Claude already knows what tRPC is, what routers/procedures are, and when to use type-safe APIs.
Split the content into multiple files: keep SKILL.md as a concise overview with the setup steps, and move detailed examples (subscriptions, SSR caller, mutation patterns) into an EXAMPLES.md or PATTERNS.md file.
Add a brief verification step after Step 6 (e.g., 'Test: `curl http://localhost:3000/api/trpc/post.list?input={}` should return a valid response') to improve workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~350+ lines) and includes some unnecessary explanation (e.g., 'Overview' section explaining what tRPC is, 'When to Use This Skill' section with 5 bullets, 'Core Concepts' section explaining routers/procedures/context/middleware). Claude already knows what tRPC is and how it works. The code examples are valuable but the surrounding prose could be significantly tightened. | 3 / 5 |
Actionability | Excellent actionability — every step includes complete, executable TypeScript code with proper imports, type annotations, and realistic patterns (cursor-based pagination, cache invalidation, auth middleware, server-side callers). The examples cover all major use cases: queries, mutations, subscriptions, SSR, and client setup. | 5 / 5 |
Workflow Clarity | The 7-step workflow is clearly sequenced and logically ordered from installation through client setup. However, there are no explicit validation checkpoints (e.g., 'verify the server starts,' 'test the endpoint before proceeding'). Since this isn't a destructive/batch operation, the missing validation doesn't cap the score at 3, but adding verification steps would improve it. | 4 / 5 |
Progressive Disclosure | The content is entirely self-contained in a single file with no bundle files. At ~350+ lines with detailed code examples for routers, context, middleware, subscriptions, client setup, and multiple component examples, this would benefit from splitting into separate files (e.g., SUBSCRIPTIONS.md, EXAMPLES.md, MIDDLEWARE.md). The 'Related Skills' and 'Additional Resources' sections provide external references but the core content is monolithic. | 3 / 5 |
Total | 15 / 20 Passed |