CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-define

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

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-define/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
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.