CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-change-plan

This skill should be used when the user says "plan infra change", "arn-infra-change-plan", "infra change plan", "plan this infrastructure change", "create infra plan", "arn infra plan", "plan the infra spec", "infrastructure implementation plan", "infra plan from spec", "generate infra plan", "plan infrastructure", or wants to generate a phased implementation plan from an infrastructure change specification, structured by provisioning order, blast radius, rollback checkpoints, and environment promotion gates.

86

Quality

83%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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.

The description excels at trigger term coverage and completeness, providing extensive explicit trigger phrases and clearly answering both what and when. Its main weakness is that the 'what' portion could be more specific about the concrete actions performed beyond plan generation. The heavy front-loading of trigger phrases makes it slightly verbose but functional for skill selection.

Suggestions

Add more specific concrete actions beyond plan generation, such as 'analyzes dependency graphs', 'identifies rollback points', or 'sequences resource provisioning' to improve specificity.

DimensionReasoningScore

Specificity

The description mentions generating 'a phased implementation plan from an infrastructure change specification' and lists structuring elements (provisioning order, blast radius, rollback checkpoints, environment promotion gates), which names the domain and some actions but doesn't list multiple distinct concrete actions beyond plan generation.

2 / 3

Completeness

The description explicitly answers both 'what' (generate a phased implementation plan structured by provisioning order, blast radius, rollback checkpoints, and environment promotion gates) and 'when' (lists explicit trigger phrases and the condition 'wants to generate a phased implementation plan from an infrastructure change specification').

3 / 3

Trigger Term Quality

The description includes extensive natural trigger phrases like 'plan infra change', 'create infra plan', 'infrastructure implementation plan', 'plan infrastructure', covering many variations a user might naturally say. The coverage of natural terms is thorough.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to infrastructure change planning with distinct concepts like blast radius, rollback checkpoints, provisioning order, and environment promotion gates. This creates a clear niche unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

77%

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, highly actionable skill with clear multi-step workflow sequencing, explicit feedback loops, and thorough error handling. Its main weakness is length — the inline agent prompt templates and detailed experience-level presentation formats make it verbose, and some of this content could be extracted into reference files. The lack of bundle files makes it impossible to verify referenced paths, slightly weakening progressive disclosure.

Suggestions

Extract the agent prompt templates (Step 3 and Step 4b) into reference files to reduce the main SKILL.md length and improve progressive disclosure.

Move the experience-level presentation formats (Expert/Intermediate/Beginner) into a reference file, keeping only a brief note in the main workflow to adapt by experience level.

DimensionReasoningScore

Conciseness

The skill is fairly long but most content is necessary for the multi-step workflow. However, there's some verbosity in the agent prompt templates (which could be more concise), the experience-level presentation section is quite detailed, and the error handling section enumerates many scenarios that Claude could handle implicitly. The pipeline position line and some explanatory text could be tightened.

2 / 3

Actionability

The skill provides highly concrete, executable guidance: exact file paths, specific agent invocation prompts with full template text, precise filename derivation rules, exact user-facing messages, and clear decision trees for each scenario. The Task tool invocations include copy-paste-ready prompt templates.

3 / 3

Workflow Clarity

The workflow is clearly sequenced across 5 steps with explicit validation checkpoints: checking for existing PLAN_PREVIEW before regenerating, a feedback loop (Step 4 -> 4b -> back to 4) with clear approval/rejection paths, and comprehensive error handling with recovery options for each failure mode. The feedback loop is well-structured with explicit retry logic.

3 / 3

Progressive Disclosure

The skill references external files (blast-radius-guide.md, experience-derivation.md, user-profile.yaml) appropriately, but no bundle files are provided to verify these references. The SKILL.md itself is monolithic at ~180 lines with the full agent prompt templates inline rather than in reference files. The experience-level presentation formats and error handling could be split into separate reference documents.

2 / 3

Total

10

/

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.