Content
17%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body reads as an encyclopedic capability catalog rather than actionable skill instructions: it re-states database knowledge Claude already has, offers no executable code or commands, and packs all reference material into one file. Workflow sequencing exists but lacks validation feedback loops for risky database operations.
Suggestions
Strip conceptual enumerations Claude already knows (index types, ACID, isolation levels, ORM lists) and replace them with a concise decision workflow plus 1-2 executable templates (e.g., a Mermaid ERD skeleton, a zero-downtime migration checklist with validation steps).
Move the long technology/category catalogs into a references file (e.g., references/tech-selection.md) and keep SKILL.md as a lean overview that links out one level deep.
Add explicit validation checkpoints to the migration/schema-change workflow (validate in staging → rollback triggers → only proceed on success) to lift workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~255-line body is a dense catalog of capabilities, technology lists, and conceptual enumerations Claude already knows (e.g., B-tree/Hash/GiST indexes, ACID properties, isolation levels) — heavy padding with no executable artifacts that earn their tokens. | 1 / 3 |
Actionability | Almost entirely descriptive lists with no executable code, commands, or copy-paste-ready guidance; even migration/schema sections enumerate concepts rather than instruct, leaving Claude without concrete actions. | 1 / 3 |
Workflow Clarity | The 'Instructions' and 'Response Approach' sections give a numbered sequence, but destructive/batch database operations (migrations, schema changes) lack explicit validate→fix→retry checkpoints, capping the score per the rubric. | 2 / 3 |
Progressive Disclosure | Content is organized into clearly labeled sections, but everything lives inline in one monolithic file with no bundle files or one-level-deep references to split the heavy reference material, so navigation/discovery is limited. | 2 / 3 |
Total | 6 / 12 Passed |