CtrlK
BlogDocsLog inGet started
Tessl Logo

atlas-best-practices

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

1.10x

Quality

89%

Does it follow best practices?

Impact

97%

1.10x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
NeverSight/skills_feed
Reviewed

Table of Contents

Is this your skill?

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.