This skill should be used when the user says "infra change spec", "infrastructure change", "specify infrastructure change", "change spec", "arn infra spec", "describe infra change", "what infrastructure needs to change", "infra spec", "spec this infra change", "write infra spec", "infrastructure change specification", "create infra change spec", "upgrade to pipeline", "convert to pipeline", or wants to iteratively develop an infrastructure change idea into a well-formed specification through guided conversation, or wants to upgrade existing interactive IaC artifacts into the structured change pipeline.
57
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-change-spec/SKILL.mdQuality
Discovery
54%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 description is heavily weighted toward trigger terms at the expense of explaining what the skill actually does. While it excels at listing many natural phrases a user might say, it fails to describe the concrete actions or outputs the skill produces. The description reads more like a keyword list than a functional description of a skill's capabilities.
Suggestions
Add concrete action descriptions before the trigger list, e.g., 'Guides users through defining infrastructure changes by gathering requirements, identifying affected resources, and producing a structured change specification document.'
Explain what the output looks like — what is a 'well-formed specification' and what does the 'structured change pipeline' entail? Specific deliverables help Claude understand the skill's purpose.
Restructure to lead with 'what it does' followed by a concise 'Use when...' clause rather than front-loading an exhaustive trigger phrase list.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lacks concrete actions. It mentions 'iteratively develop an infrastructure change idea into a well-formed specification through guided conversation' and 'upgrade existing interactive IaC artifacts into the structured change pipeline,' but these are vague and abstract rather than listing specific concrete actions the skill performs. | 1 / 3 |
Completeness | The 'when' is thoroughly covered with explicit trigger phrases and use cases. However, the 'what' is weak — it doesn't clearly explain what the skill actually does beyond vague references to 'guided conversation' and 'well-formed specification.' The description is essentially all trigger terms with minimal explanation of capabilities. | 2 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would say, such as 'infra change spec', 'infrastructure change', 'change spec', 'write infra spec', 'upgrade to pipeline', 'convert to pipeline', covering many variations and synonyms. | 3 / 3 |
Distinctiveness Conflict Risk | The extensive trigger phrase list helps distinguish it, but terms like 'infrastructure change' and 'change spec' are somewhat generic and could overlap with other infrastructure or IaC-related skills. The mention of 'structured change pipeline' adds some specificity but isn't well-defined enough to fully prevent conflicts. | 2 / 3 |
Total | 8 / 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-crafted conversational workflow skill with strong actionability and workflow clarity. It provides concrete guidance for every decision point, clear branching logic, iterative refinement loops, and comprehensive error handling. The main weaknesses are moderate verbosity (some sections could be tightened) and the length of the inline content, though the structure and references are generally well-organized.
Suggestions
Consider moving the full agent invocation payload templates to a reference file to reduce the main skill's token footprint while keeping the dispatch logic inline.
Tighten the experience-level question examples in Step 2b — Claude can adapt tone from a brief description like 'Beginner: walk through each area with examples' rather than listing full dialogue lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some verbosity, particularly in the experience-level prompts (full example dialogue lines), the agent invocation templates, and the detailed prerequisite extraction steps. Some sections like the pipeline position diagram and the upgrade detection signals could be tightened. However, it mostly avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific file paths to read, exact agent invocation payloads with template text, specific file naming conventions (INFRA_CHANGE_<name>.md), exact mkdir commands, specific questions to ask per experience level, and clear decision criteria for each step. The agent dispatch includes complete context blocks ready to use. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced across 6 steps with explicit branching (Step 2a vs 2b), an iterative exploration loop with convergence criteria (Step 5), and a finalization step with user confirmation. Validation checkpoints are present: confirming understanding after idea capture, checking readiness before writing, confirming spec name, and handling existing spec conflicts. Error handling covers agent failures, missing config, and ambiguous scope with clear recovery paths. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (infra-change-spec-template.md, blast-radius-guide.md, experience-derivation.md, ensure-config.md) with clear paths, and defers detailed content to those references. However, no bundle files were provided to verify these references exist, and the skill itself is quite long (~200+ lines) with some content that could potentially be split out (e.g., the full agent invocation templates, the experience-level question sets). The inline content is well-organized with clear headers but borders on monolithic. | 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 | |
b9084b6
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.