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.
The body is highly actionable and workflow-oriented, with executable commands, typed examples, and an explicit validation-gated checklist — outstanding on actionability and workflow clarity. Its main weaknesses are length (a few sections could be trimmed) and the absence of progressive disclosure: the entire specification is inlined in SKILL.md with no reference files.
Suggestions
Split reference-grade material into bundle files — e.g., move the shared options-type table and the testing-harness guide into references/options.md and references/testing.md, leaving SKILL.md as a concise overview with clearly signaled one-level-deep links.
Trim the full `--help` sample output block to only the 'Examples:' portion it illustrates, and reduce the naming-conventions section to a one-line pointer to the phoenix-typescript skill it already cites.
Add a short 'Quick start' section at the top (the 3-4 most common commands) so the most frequent use case is reachable without scanning the full specification.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific requirements (RFC 2119 rules, tables, exact file paths) and avoids explaining concepts Claude already knows, but the full `--help` sample output and the naming-conventions section (which duplicates the referenced phoenix-typescript skill) could be trimmed — matching 'efficient; minor instances of over-explanation', not the fully lean top anchor. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact commands ('px project create --name my-project --format raw --no-input', 'pnpm test'), a complete TypeScript interface example with TSDoc requirements, specific test-harness APIs, and an 18-step checklist — fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | The 'Checklist for Adding a New Resource Command' is explicitly sequenced with validation gates and feedback loops — 'Run `pnpm test` — fix any failures before proceeding', 'Run `pnpm build` — fix any type errors before proceeding', and a manual `--format raw` verification step — matching the top anchor with explicit validation rather than merely implied checkpoints. | 5 / 5 |
Progressive Disclosure | No bundle files exist and all ~320 lines live in SKILL.md, including reference-grade material (the shared options-type table, the full testing-harness guide, naming conventions) that clearly belongs in separate files; section headers are well organized, placing this above 'minimal structure' but below 'good structure' since nothing is split out and the body far exceeds overview size. | 3 / 5 |
Total | 17 / 20 Passed |