Content
27%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 establishes useful scope boundaries, behavioral traits, and distinctions from sibling skills, but drowns them in a long catalog of technologies and concepts Claude already knows, with no executable guidance, templates, or decision frameworks. It is a monolithic role profile rather than a lean, actionable skill document.
Suggestions
Cut the ~150-line Capabilities taxonomy and the Purpose/Core Philosophy/Knowledge Base sections, keeping only the decision frameworks and behavioral rules that are not common knowledge; move any needed catalog to a references/ file.
Replace the high-level step labels with concrete, executable guidance: a technology-selection decision table, a schema-design checklist, or a sample migration plan template with phases and rollback triggers.
Add explicit validation checkpoints to the workflow (e.g., 'validate migration plan in staging, verify data counts, only then recommend cutover') so the Safety section's intent becomes workflow steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Heavily padded: ~150 of 257 lines are a Capabilities taxonomy enumerating technologies and concepts Claude already knows (B-tree/GIN/BRIN indexes, ACID, isolation levels, CAP theorem, product name lists), plus redundant 'Purpose', 'Core Philosophy', and 'Knowledge Base' sections that restate the description or list known concepts. The genuinely skill-specific signal (scope boundaries, behavioral traits, key distinctions) is a small fraction of the token budget. | 1 / 5 |
Actionability | Guidance stays at the high level: 'Choose the database model and architecture pattern', 'Design schemas, indexes, and lifecycle policies' name concerns but give no concrete method, decision framework, command, or worked example to execute them. Not 3 because the Response Approach and Output Examples sections describe categories of output rather than any specific actionable content, and not 1 because the 4-step Instructions and Safety constraints do give minimal concrete direction. | 2 / 5 |
Workflow Clarity | A sequence is present ('Instructions' 4 steps, 'Response Approach' 10 steps) and the Safety section includes validation ideas ('Validate migration plans in staging before production'), but checkpoints remain implicit — there is no validate/fix/retry loop anywhere in the workflow itself. Per the feedback-loops note for database operations, missing explicit validation loops cap this at 3. | 3 / 5 |
Progressive Disclosure | The body has clear section headers and a 'Use/Do not use' split, so navigation is possible, but everything lives inline in one monolithic 257-line file with zero bundle references — the capability catalogs and example interactions clearly belong in separate reference files. This matches 'some structure but content that should be separate is inline'; not 2 because the sectioning is real, not minimal. | 3 / 5 |
Total | 9 / 20 Passed |