Content
35%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 a persona/capability catalog rather than operational guidance: it enumerates topic areas Claude already knows, provides no executable commands or code, and its only progressive-disclosure pointer references a nonexistent file. It needs concrete, example-driven instructions and its reference material moved into real bundle files.
Suggestions
Add executable examples and commands — e.g. EXPLAIN ANALYZE output interpretation, a pg_stat_statements query to find top offenders, a concrete index-creation example, and a fix-retry validation loop ('re-run EXPLAIN after adding the index; verify the plan uses it').
Move the Capabilities/Behavioral Traits/Knowledge Base catalogs into a reference file and keep SKILL.md as a concise operational overview with clearly signaled, verified links.
Fix the broken reference: 'resources/implementation-playbook.md' does not exist in the bundle — either create the file or correct the path to match the actual bundle structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 130 lines of 'Capabilities', 'Behavioral Traits', and 'Knowledge Base' sections enumerate topics Claude already knows (B-tree indexes, write-through caching, read replicas, ORM eager loading) with no added operational knowledge — heavily padded. Not score 1 because it lists rather than prose-explains concepts, but it is noticeably verbose with several padded sections that earn no tokens. | 2 / 5 |
Actionability | No code, commands, or executable steps anywhere: instructions are pure abstraction ('Apply relevant best practices and validate outcomes') and the 'Response Approach' steps ('Analyze current performance using appropriate profiling tools') give no specifics. Concrete tool names (EXPLAIN ANALYZE, pg_stat_statements, pgbench, DataLoader) appear only as knowledge-area bullets, providing minimal concrete hints without any steps to execute — between anchors 1 ('only describes rather than instructs') and 2, leaning low. | 2 / 5 |
Workflow Clarity | The 'Response Approach' section lists a coherent 9-step sequence (analyze → identify bottlenecks → design → implement → monitor → validate) and validation is mentioned ('Validate improvements through comprehensive benchmarking and testing'), but there are no explicit checkpoints, commands, or fix-retry feedback loops for what are database operations — matching 'Steps listed but validation gaps; checkpoints missing or implicit'. | 3 / 5 |
Progressive Disclosure | Section headers are well organized, but the bulk of the file (~130 lines of capability catalog) is inlined in SKILL.md where it belongs in reference files, matching 'content that should be separate is inline'. The single reference — 'open resources/implementation-playbook.md' — points to a file that does not exist in the bundle (no references/, scripts/, assets/, or resources/ directories are present), which blocks a score of 4; the genuine section structure keeps it above anchor 2's header-less monolith. | 3 / 5 |
Total | 10 / 20 Passed |