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.
72
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.
The description is heavily weighted toward trigger terms, listing many natural phrases users might say, which is a strength. However, it fails to clearly articulate what the skill actually does in concrete terms — the 'what' is vague and abstract. The description would benefit significantly from listing specific actions and outputs rather than relying on abstract phrases like 'guided conversation' and 'well-formed specification.'
Suggestions
Add specific concrete actions the skill performs, e.g., 'Gathers requirements through structured questions, identifies affected AWS resources, generates a formatted infrastructure change specification document with resource ARNs, change descriptions, and rollback plans.'
Briefly describe the output format or deliverable so Claude and users know what to expect, e.g., 'Produces a structured YAML/markdown change spec including resource identifiers, change type, dependencies, and approval requirements.'
Trim the trigger phrase list to the most distinctive terms and move the remaining detail into the skill body, keeping the description concise and focused.
| 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 very well covered with explicit trigger phrases. However, the 'what' is weak — it vaguely mentions developing a specification through guided conversation and upgrading IaC artifacts, but doesn't clearly explain what the skill actually does (e.g., what outputs it produces, what steps it follows, what format the spec takes). | 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 a user might naturally use. | 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-related skills. The mention of 'structured change pipeline' adds some distinctiveness 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, highly actionable skill with excellent workflow clarity and comprehensive error handling. The multi-step process is clearly sequenced with appropriate branching, validation checkpoints, and convergence criteria. The main weaknesses are moderate verbosity (particularly in the experience-level-adapted prompts and agent invocation blocks) and the inability to verify referenced bundle files, though the progressive disclosure structure is sound in principle.
Suggestions
Consider moving the experience-level-adapted prompt examples (beginner/intermediate/expert) to a reference file to reduce the main skill's token footprint.
Tighten the agent invocation templates — Claude can construct these from briefer instructions rather than full template blocks with placeholder comments.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some verbosity that could be tightened. The beginner-level prompt examples and the detailed agent invocation templates add bulk, though most content is justified by the complexity of the workflow. Some sections like the pipeline position line and the two entry paths explanation could be more concise. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance throughout: specific file paths to check, exact agent invocation templates with structured text blocks, precise file naming conventions (kebab-case derivation example), exact directory creation commands, and clear output format expectations. The step-by-step workflow leaves little ambiguity about what Claude should do at each stage. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced with explicit steps (1 through 6), branching paths (2a vs 2b) are well-defined with clear detection criteria, the iterative exploration phase (Step 5) includes a convergence check, and the error handling section covers failure modes with specific recovery actions. The spec writing step includes validation via user confirmation of the name and a readiness check before finalizing. | 3 / 3 |
Progressive Disclosure | The skill references external files (infra-change-spec-template.md, blast-radius-guide.md, experience-derivation.md) which is good progressive disclosure, but no bundle files were provided to verify these exist. The main SKILL.md itself is quite long (~200+ lines) and some content like the detailed beginner/intermediate/expert prompt variations could potentially be moved to a reference file. The references are one-level deep and clearly signaled, which is positive. | 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.