Content
85%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.
Excellent project-specific content: executable commands, validated multi-step workflows, and a disciplined refusal to restate what the codebase already shows. The single structural weakness is that it is a long monolithic file with no progressive disclosure — detailed reference material (IR schemas, modality API docs) sits inline in SKILL.md instead of being split into bundle files.
Suggestions
Move the domain-map IR reference material (classes/bindings JSON examples, arg routing, projections, cache) into a references/domain-map-ir.md file and keep only a compact summary plus a one-line pointer in SKILL.md.
Extract the consumer-facing API documentation (singleton vs direct instantiation, AI SDK adapter, /tools subpath) into references/modalities.md, leaving the architecture overview and workflows in SKILL.md.
Trim the ASCII pipeline diagram to a three-line stage list ('capture-tools.ts -> domain-map.json -> generate-sdk.ts') to reclaim tokens without losing information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token is project-specific knowledge Claude cannot know (pipeline stages, domain-map IR, side-effect membrane rules, env vars, .js import convention), and it explicitly refuses to enumerate methods ('It does not enumerate every method'). The ASCII pipeline diagram and a few JSON examples could be tightened, which keeps it at the 'minor instances of over-explanation' anchor rather than the lean 5. | 4 / 5 |
Actionability | Fully executable throughout: exact commands ('bun scripts/capture-tools.ts', 'npx vitest run test/unit/sdk.test.ts', 'bun scripts/e2e-test.ts', 'npx tsc'), copy-paste TypeScript/JSON examples for every pattern, and numbered procedures (Supporting a New Tool, Adding a New Side-Effect Method) that cover the common cases. This matches the anchor-5 example. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints and feedback loops: 'Run validate-generated.ts to confirm consistency', Stage 3 validation rules for side-effect declarations, and the Red-Green-Yellow pattern that mandates failing tests first, then passing tests, then refactor with 'validate-generated.ts to verify pipeline integrity'. This matches the anchor-5 validate-fix-retry shape. | 5 / 5 |
Progressive Disclosure | The body is ~345 lines with no references/, scripts/, or assets/ files in the bundle — everything is inlined under decent section headers. Content that plausibly belongs in separate reference files (the domain-map IR schema with multi-part JSON examples, the AI SDK adapter / tools-subpath usage docs, the side-effect extension pattern) is inline, matching the 'some structure but could be better organized; content that should be separate is inline' anchor rather than the well-split anchor at 4. The under-50-line simple-skill exception does not apply, and headers alone do not constitute progressive disclosure at this length. | 3 / 5 |
Total | 17 / 20 Passed |