Patterns for Atlas database schema management covering HCL/SQL schema definitions, versioned and declarative migrations, linting analyzers, testing, and project configuration. Use when working with atlas.hcl, .hcl schema files, Atlas CLI commands, or database migrations.
93
Quality
89%
Does it follow best practices?
Impact
97%
1.10xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms with file extensions and tool names, explicitly states both what the skill does and when to use it, and is highly distinctive to the Atlas ecosystem. The description uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'HCL/SQL schema definitions, versioned and declarative migrations, linting analyzers, testing, and project configuration.' These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('schema management covering HCL/SQL schema definitions, versioned and declarative migrations, linting analyzers, testing, and project configuration') AND when ('Use when working with atlas.hcl, .hcl schema files, Atlas CLI commands, or database migrations'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'atlas.hcl', '.hcl schema files', 'Atlas CLI commands', 'database migrations', 'HCL', 'SQL'. Good coverage of file extensions and tool-specific terms. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with Atlas-specific triggers like 'atlas.hcl', 'Atlas CLI commands', and '.hcl schema files'. Unlikely to conflict with generic database or migration skills due to tool-specific terminology. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality, comprehensive Atlas skill that excels in conciseness and actionability with excellent executable examples throughout. The main weaknesses are the lack of explicit validation checkpoints in multi-step workflows and the monolithic structure that could benefit from progressive disclosure via external file references for advanced topics.
Suggestions
Add explicit validation steps to workflows, e.g., after 'atlas migrate diff', verify the generated migration before applying: 'Review migrations/*.sql, then run atlas migrate validate --env local'
Split advanced topics (ORM Integration, CI/CD Integration, Schema Testing) into separate referenced files to improve progressive disclosure and reduce the main file size
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, presenting information without explaining concepts Claude already knows. Every section provides actionable content without padding or unnecessary context about what databases or migrations are. | 3 / 3 |
Actionability | Provides fully executable code examples throughout - complete HCL schemas, SQL statements, bash commands, and YAML configurations that are copy-paste ready. No pseudocode; all examples are concrete and specific. | 3 / 3 |
Workflow Clarity | While commands are clearly documented, the two workflows (declarative vs versioned) lack explicit validation checkpoints. The baseline adoption section mentions steps but doesn't include verification that the baseline was correctly applied before proceeding. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but it's a monolithic document (~250 lines) that could benefit from splitting advanced topics (ORM integration, CI/CD, testing) into separate referenced files. No external file references are provided. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
5342bca
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.