Content
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a table of contents pointing to rule files that are not provided in the bundle. It contains no actionable code, commands, or concrete guidance—Claude would gain almost nothing from reading it without the referenced files. The organizational structure is reasonable but the body content fails to deliver any executable or instructive value on its own.
Suggestions
Add at least 2-3 concrete, executable examples inline (e.g., a basic stack configuration block, a `terramate run` command, a `generate_hcl` snippet) so the skill provides immediate value even without the referenced rule files.
Include a quick-start workflow with explicit steps and commands (e.g., 'Create a stack: `terramate create stacks/my-stack` → Configure: add stack block → Run: `terramate run terraform init`') with validation checkpoints.
Remove or condense the 'When to Apply' section and priority table, which add little actionable value—replace with a brief one-liner scope statement and jump straight to concrete guidance.
Ensure bundle files (the referenced rule files and AGENTS.md) are actually included so the progressive disclosure structure is functional rather than pointing to missing content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is moderately efficient but includes unnecessary framing (e.g., 'Comprehensive guide for Terramate CLI, Cloud, and Catalyst, maintained by Terramate') and the 'When to Apply' section largely restates what the table of contents already conveys. The priority table and quick reference lists are useful but could be tighter. | 2 / 3 |
Actionability | The skill provides no concrete code, commands, or executable examples. It is entirely a table of contents and organizational overview, describing what rules exist rather than instructing Claude how to do anything. There are zero copy-paste-ready snippets or specific commands. | 1 / 3 |
Workflow Clarity | There are no multi-step workflows, no sequenced processes, and no validation checkpoints. The content is purely an index/catalog of rule files with no guidance on how to execute any task. | 1 / 3 |
Progressive Disclosure | The skill clearly references external rule files and an AGENTS.md compiled document, which is good structure. However, no bundle files were provided, so we cannot verify these references exist. The SKILL.md itself is almost entirely an index with very little substantive content at the top level, making it an empty shell rather than a useful overview with actionable quick-start content. | 2 / 3 |
Total | 6 / 12 Passed |