Content
75%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.
A well-engineered, dense reference with executable commands, explicit verification after creation, gated destructive operations, and a clean one-level-deep bundle structure. Weaknesses are modest: an unsourced `<USERNAME>` placeholder, dated migration notes outside a deprecated section, a duplicated troubleshooting flow, one orphaned bundle file, and a missing confirmation step on reset-branch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean — dense tables, executable commands, and smart deferral of full flag documentation to `-h` discovery. Deducted for dated time-sensitive info in prominent blockquotes ("March 2026", "June 2026") outside a deprecated section and the schema-permission recovery flow being duplicated between the What's Next section and the Troubleshooting table. | 4 / 5 |
Actionability | Fully specified CLI commands with JSON payloads, a JSON-path table for extracting connection values, SQL grants, and a copy-paste scriptable version. Not 5 because `user=<USERNAME>` is never sourced — no step or JSON path indicates where the username comes from, breaking the flagship psql flow's executability. | 4 / 5 |
Workflow Clarity | Create → verify → extract-connection-values is checkpointed, and the deploy-first app workflow has an explicit sequence plus a full error-recovery loop (permission denied → export options A/B) with destructive delete gated on explicit user permission. Not 5 because destructive `reset-branch` ("Local changes are lost") lacks a confirmation checkpoint unlike delete, and update/reset workflows have no verify step. | 4 / 5 |
Progressive Disclosure | Good structure: an overview body with a clearly labeled reference-docs list of six one-level-deep files, all verified to exist, each with a topic description. Not 5 because `references/medallion-from-cdc.md` exists in the bundle but is never linked from SKILL.md (hurting discoverability), and the What's Next section mixes workflows with reference pointers. | 4 / 5 |
Total | 16 / 20 Passed |