This skill should be used when the user says "define infrastructure", "generate IaC", "infra define", "arn infra define", "generate terraform", "generate opentofu", "generate pulumi", "generate cdk", "generate bicep", "create kubernetes manifests", "provision cloud resources", "create IaC", "infrastructure as code", or wants to generate infrastructure-as-code in their chosen IaC tool for configured cloud provider(s). It produces provider-specific infrastructure code, validates it through a multi-level validation ladder, and writes an infrastructure architecture spec.
74
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-define/SKILL.mdQuality
Discovery
89%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 strong skill description with excellent trigger term coverage and clear 'when to use' guidance. Its main weakness is that the 'what it does' portion could be more specific about the concrete actions performed beyond the general 'produces provider-specific infrastructure code'. The extensive list of trigger phrases ensures reliable skill selection.
Suggestions
Add more specific concrete actions beyond 'produces provider-specific infrastructure code' — e.g., 'generates resource definitions, configures networking, sets up IAM policies, defines storage and compute resources'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions producing 'provider-specific infrastructure code', validating through a 'multi-level validation ladder', and writing an 'infrastructure architecture spec', but these actions are somewhat abstract. It names the domain and some actions but doesn't list concrete specific operations like 'create VPC configurations, define IAM roles, set up load balancers'. | 2 / 3 |
Completeness | The description clearly answers both 'what' (produces provider-specific infrastructure code, validates it, writes architecture spec) and 'when' (explicitly lists trigger phrases and conditions like 'when the user says...' or 'wants to generate infrastructure-as-code'). The 'when' guidance is very explicit. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'define infrastructure', 'generate IaC', 'generate terraform', 'generate opentofu', 'generate pulumi', 'generate cdk', 'generate bicep', 'create kubernetes manifests', 'provision cloud resources', 'infrastructure as code'. These are terms users would naturally say when requesting this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to infrastructure-as-code generation with distinct triggers mentioning specific tools (Terraform, OpenTofu, Pulumi, CDK, Bicep, Kubernetes). This creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill has excellent workflow clarity with a well-structured 9-step process, explicit validation checkpoints, and comprehensive error handling. However, it is excessively verbose — the content could be reduced by 40-50% without losing actionable information. The skill describes processes rather than providing executable code, and the main file is monolithic despite referencing external files that could absorb much of the inline detail.
Suggestions
Reduce verbosity by removing explanatory framing (e.g., 'This is the central skill...', 'This step is skipped if...') and condensing the agent invocation templates into a compact format or moving them to a reference file.
Move the extensive error handling catalog to a separate reference file (e.g., `error-handling.md`) and keep only the 2-3 most critical error cases inline.
Replace the descriptive agent invocation blocks with a concise template format or reference file, since the full payload structure doesn't need to be inline in the main workflow.
Add actual executable code examples for at least one IaC tool (e.g., a minimal OpenTofu module) to make the skill more actionable rather than purely procedural.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines with significant redundancy. It explains workflow orchestration details, agent invocation formats, and configuration reading steps that Claude can infer. Many sections repeat information (e.g., provider lists, tool names) and include unnecessary framing like 'This is the central skill in the Arness Infra pipeline.' The error handling section alone is massive and could be condensed significantly. | 1 / 3 |
Actionability | The skill provides structured steps and specific tool commands (e.g., `tofu validate`, `cdk synth`, `checkov`), but most guidance is procedural description rather than executable code. The agent invocation blocks are template-like but not truly executable — they use placeholder syntax. No actual code snippets for generating IaC are provided; it relies on external reference files and specialist agents. | 2 / 3 |
Workflow Clarity | The 9-step workflow is clearly sequenced with explicit validation checkpoints (the validation ladder in Step 6), feedback loops for error recovery (auto-fix and re-validate), conditional branching (triage brief exists vs. not, beginner vs. expert paths), and approval gates before writing files. The error handling section covers numerous failure modes with specific recovery actions. | 3 / 3 |
Progressive Disclosure | The skill references multiple external files (paas-config-patterns.md, opentofu-patterns.md, validation-ladder.md, infra-architecture-template.md, experience-derivation.md, etc.) which is good progressive disclosure design. However, no bundle files were provided to verify these exist, and the SKILL.md itself is monolithic — much of the inline content (e.g., the full agent invocation templates, the complete error handling catalog) could be split into reference files to keep the main skill leaner. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
1fe948f
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.