Content
28%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/knowledge resume rather than a working skill: it enumerates technologies Claude already knows in ~140 lines while providing no concrete commands, procedures, or validation steps. Its only external reference is a dangling path to a nonexistent file, leaving a monolithic catalog that adds little actionable value.
Suggestions
Replace the capability catalog with executable procedures, e.g. a layered troubleshooting runbook with actual commands (`ping`, `dig +trace`, `openssl s_client -connect`, `traceroute/mtr`, `ss -tulpn`) and a concrete design checklist.
Move the technology lists into a references/ file (e.g. references/capabilities.md) and fix the broken `resources/implementation-playbook.md` path — no such file or directory exists in the bundle.
Add explicit validation checkpoints to the workflow (e.g. 'verify connectivity after each change with X, roll back if Y') instead of the generic 'Test thoroughly' step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 90% of the body is a catalog of technologies Claude already knows — 13 capability sections enumerating 'AWS networking: VPC, subnets, route tables, NAT gateways...', 'Diagnostic tools: tcpdump, Wireshark, ss, netstat...' plus a 'Knowledge Base' restating 'Cloud networking services across AWS, Azure, and GCP'. This is noticeably-to-severely padded with zero new information. Not a 1 because it does not prose-explain concepts the way the anchor example does; not a 3 because there is no meaningful content that could not be trimmed or that Claude does not already know. | 2 / 5 |
Actionability | The instructions are abstract ('Clarify goals, constraints, and required inputs', 'Apply relevant best practices and validate outcomes') with no commands, code, or procedures anywhere; the 'Response Approach' steps are generic ('Design network architecture with appropriate redundancy and security'). There are a few high-level hints like 'Tests connectivity systematically at each network layer (physical, data link, network, transport, application)', which is why this lands at 'Minimal concrete guidance; high-level hints but missing the specific steps to execute' rather than the 'entirely vague' anchor 1. | 2 / 5 |
Workflow Clarity | A rough sequence exists ('Response Approach' lists 9 numbered steps: analyze, design, implement, configure, monitor, optimize, document, plan DR, test), but the steps are poorly defined and validation is essentially absent — 'Test thoroughly from multiple vantage points' is the only, purely implicit, checkpoint. This matches 'Rough sequence present but many gaps; steps poorly defined; validation absent'. Not a 3 because even the sequence itself is generic and no explicit checkpoints exist. | 2 / 5 |
Progressive Disclosure | The body has clear section headers (## Capabilities, ## Behavioral Traits, etc.) and one reference pointer, but the 100+ lines of capability catalog are exactly the content that belongs in separate reference files, and the sole reference — 'open `resources/implementation-playbook.md`' — points to a file that does not exist in the bundle (no references/, scripts/, or assets/ directories are present). This matches 'Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline'. Not a 2 because headers do provide navigable structure; not a 4 because the single reference is broken and the bulk of the content is inlined. | 3 / 5 |
Total | 9 / 20 Passed |