Content
92%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 is an exemplary operational skill: fully executable commands at every step, an explicit lint/validate gate with feedback loops before any apply, and clean offloading of HCL details and caveats to genuine one-level reference files. The only visible improvement is trimming repeated source citations and the brief security editorializing in Step 1.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and command-dominated - it assumes competence and adds only Atlas-specific knowledge (dev-url scratch-DB semantics, atlas.sum tamper guard, analyzer codes). Minor trimmable spots keep it below the lean anchor: the 'Per [at-start][at-start]' citation is repeated four times, and the install-script security aside ('runs unreviewed remote code') slightly over-explains a practice Claude already knows. | 4 / 5 |
Actionability | Every step ships copy-paste-ready commands with full flags and env vars - brew/docker install, 'atlas schema apply --url ... --to file://schema.sql --dev-url ...', migrate diff/validate/lint/apply with --dry-run, the atlas.hcl lint config, and a complete CI YAML snippet. The worked example traces a realistic NOT NULL column addition end-to-end, covering the common cases the rubric's top anchor asks for. | 5 / 5 |
Workflow Clarity | Nine clearly sequenced steps with an explicit gate ('Lint and validate (Step 5) are the gate: nothing reaches migrate apply (Step 6) until they pass'), a fix-and-re-lint feedback loop ('Re-run atlas migrate diff/migrate hash after editing an unapplied file, then repeat step 2 until it exits 0'), and dry-run verification before the real apply. For database operations this is exactly the validate -> fix -> retry pattern the rubric requires for a top score. | 5 / 5 |
Progressive Disclosure | The core workflow lives in SKILL.md while HCL details and the anti-patterns/limitations catalogue are split into two real, well-signaled reference files linked inline ('see [references/hcl-schema.md]', 'catalogued in [references/atlas-caveats.md]'), each one level deep with no nested-reference chains. Section headers, a step-indexed structure, and a closing references map make navigation easy, matching the clear-overview-with-well-signaled-references anchor. | 5 / 5 |
Total | 19 / 20 Passed |