CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-execute-change

This skill should be used when the user says "execute infra change", "run infra plan", "apply infrastructure change", "execute change", "arn infra execute", "deploy infra plan", "execute infrastructure plan", "run infrastructure change", "apply infra plan", "infra execute", "arn-infra-execute-change", or wants to orchestrate the phased execution of a structured infrastructure change plan, invoking agents for IaC generation, security gates, cost gates, deployment, verification, and review.

84

Quality

81%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

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 strong skill description that clearly defines its purpose, provides extensive trigger phrases for reliable skill selection, and specifies concrete actions. The description effectively distinguishes itself from other potential infrastructure-related skills by focusing specifically on the execution/orchestration phase of infrastructure change plans. Minor improvement could be made by using a cleaner structure separating the 'what' from the 'when', but overall it is highly functional.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: orchestrating phased execution, invoking agents for IaC generation, security gates, cost gates, deployment, verification, and review. These are concrete, specific capabilities.

3 / 3

Completeness

The description explicitly answers both 'what' (orchestrate phased execution of infrastructure change plans, invoking agents for IaC generation, security gates, cost gates, deployment, verification, and review) and 'when' (with explicit trigger phrases and the 'Use when' equivalent at the start).

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say, covering many variations like 'execute infra change', 'run infra plan', 'apply infrastructure change', 'deploy infra plan', etc. Good coverage of natural language variations.

3 / 3

Distinctiveness Conflict Risk

The description carves out a very specific niche around infrastructure change plan execution with distinct trigger terms like 'arn-infra-execute-change' and specific domain concepts (IaC generation, security gates, cost gates). Unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured orchestration skill with excellent workflow clarity, comprehensive error handling, and clear validation checkpoints throughout the multi-phase execution pipeline. Its main weaknesses are verbosity (the inline agent prompt templates and presentation templates add significant length) and partial actionability since core execution logic is delegated to external references that weren't provided for verification. The progressive disclosure structure is sound in design but the main file could benefit from moving the prompt templates to reference files.

Suggestions

Move the agent invocation prompt templates (Steps 2.2-2.7) to a reference file like `references/agent-prompts.md` to reduce the main skill's length and improve conciseness.

Trim the presentation templates (execution summary, promotion gate, completion summary) to structural outlines rather than full formatted examples — Claude can format these appropriately from brief specifications.

DimensionReasoningScore

Conciseness

The skill is quite long (~250 lines) with significant verbosity in the agent invocation templates (showing full prompt structures with delimiters). Some sections like the execution summary templates and error handling are thorough but could be more compact. However, it avoids explaining basic concepts Claude already knows and most content is operationally relevant.

2 / 3

Actionability

The skill provides structured workflows with specific steps, agent invocation templates, and gate evaluation criteria. However, it relies heavily on external references (dispatch-loop.md, gate-policies.md, deploy-procedures.md) for the actual executable details, and the agent invocation blocks are prompt templates rather than executable code. The glob pattern and file paths are concrete, but much of the core logic is delegated elsewhere.

2 / 3

Workflow Clarity

The workflow is exceptionally well-sequenced with a clear 7-step dispatch loop per phase, explicit validation checkpoints (security gate, cost gate, verification, review gate), rollback checkpoints before changes, user confirmation requirements before deployments and environment promotions, and comprehensive error handling with recovery options. Feedback loops are present throughout (fix-and-retry for security gate, rollback for deployment failures, resume from interruption).

3 / 3

Progressive Disclosure

The skill references several external files (dispatch-loop.md, gate-policies.md, deploy-procedures.md, experience-derivation.md, report template) which is good progressive disclosure design. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself is quite long with inline agent prompt templates that could potentially be externalized. The references are clearly signaled with Read directives, which is positive.

2 / 3

Total

9

/

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.