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
83%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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.