Content
96%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.
An exemplary instruction skill: it supplies only project-specific knowledge (deploy sequencing, lint rules, repo commands), wraps destructive operations in explicit expand/contract discipline, and provides a fully executable workflow with validation at every checkpoint. The only structural note is that the playbook and annotation catalog live entirely inline in a single file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries project-specific information — the blue/green deploy window, lint rule names, and repo-specific commands — with no padding or explanation of concepts Claude already knows. The per-operation playbook is delivered as a dense table rather than prose, so every token earns its place. | 5 / 5 |
Actionability | The body gives copy-paste-ready commands (`cd packages/db && bunx drizzle-kit generate`, `bun run check:migrations`, `bun run db:migrate`, the `grep -rn "contract-pending" ...` check) plus exact SQL patterns (`CREATE INDEX CONCURRENTLY`, `NOT VALID`, batched idempotent backfills) and literal annotation/marker formats. It fully instructs rather than describes. | 5 / 5 |
Workflow Clarity | The workflow is a clear 6-step sequence with explicit validation checkpoints: the lint gate with per-tier error handling, schema-mock regeneration, re-running drizzle-kit generate to detect drift, and local migration verification. Feedback loops (fix, re-run, split the PR) are present for the destructive and batch operations the skill governs, satisfying the destructive-op validation requirement. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and clearly signaled (The window, Expand/contract, playbook, Tracking the contract, Judgment, Workflow, Hard rule) with all referenced paths being real repo files. However, the ~92-line body keeps the full per-operation playbook and annotation catalog inline with no bundle files for splitting, exceeding the under-50-line simple-skill exception. | 4 / 5 |
Total | 19 / 20 Passed |