Name: arn-infra-review-change
Rating: 68.8 (1 reviews)
Author: AppsVortex

arn-infra-review-change

This skill should be used when the user says "review infra change", "infrastructure review", "review infrastructure", "infra quality review", "arn infra review", "check infra change", "review infrastructure change", "infra change review", "quality check infrastructure", "arn-infra-review-change", "post-deployment review", or wants to perform a comprehensive post-execution quality review of completed infrastructure changes, producing a structured review report with a PASS/WARN/NEEDS_FIXES verdict.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%Weight 40%Scale 1-3

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

A well-structured, highly actionable orchestration skill with clear sequencing and validation checkpoints. It loses points on conciseness and progressive disclosure, where a large inline context template and presentation variants inflate the body and could be moved into reference files.

Suggestions

Extract the Step 2 structured-context template and the three experience-level presentation templates into reference files under ./references/, linking to them from the body to reduce inline length and improve progressive disclosure.

Tighten Step 4 by summarizing the expert/intermediate/beginner variants into a short rule plus one concise example rather than three full template blocks.

Consider a short 'Inputs/outputs' overview near the top so the prerequisite extraction and report-writing steps read as a compact summary rather than inline prose.

Dimension	Reasoning	Score
Conciseness	The body avoids explaining concepts Claude already knows and is mostly actionable, but the large inline structured-context block in Step 2 and the three full experience-level presentation templates in Step 4 add length that could be tightened or factored out.	2 / 3
Actionability	Concrete, executable guidance throughout: specific Glob patterns, exact file paths, a named agent ('arn-infra-change-reviewer'), and explicit tool calls (Task, AskUserQuestion), giving copy-ready orchestration instructions appropriate for an instruction-only skill.	3 / 3
Workflow Clarity	A clear five-step sequence with explicit validation checkpoints (review-scope summary, 'Proceed with review?' gate, incomplete-phase warnings), feedback loops (agent-retry, re-run after fixes), and conditional verdict handling.	3 / 3
Progressive Disclosure	No bundle files exist and the body is a monolithic ~215-line document; its only references point to other plugin skills' files rather than clearly-signaled one-level-deep detailed materials for this skill, and large blocks (the structured-context template, presentation templates) are inline that could be split.	2 / 3
	Total	10 / 12 Passed

Description

90%Weight 40%Scale 1-3

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 strong, with explicit use-when triggers, broad natural keywords, and a clearly distinct niche. The only soft spot is specificity, which states one composite action rather than enumerating multiple concrete operations.

Dimension	Reasoning	Score
Specificity	Names the domain and a concrete action ('perform a comprehensive post-execution quality review of completed infrastructure changes, producing a structured review report with a PASS/WARN/NEEDS_FIXES verdict') but describes essentially one action rather than a list of multiple distinct concrete actions, so it stops short of the top anchor.	2 / 3
Completeness	Explicitly answers 'when' ('This skill should be used when the user says...') and 'what' (post-execution quality review producing a structured report with a verdict), satisfying the top anchor with explicit triggers.	3 / 3
Trigger Term Quality	Broad coverage of natural phrases a user would say ('review infra change', 'infrastructure review', 'review infrastructure', 'post-deployment review', 'check infra change'), matching the top anchor for natural trigger terms.	3 / 3
Distinctiveness Conflict Risk	A clear niche (post-execution infra change review) with arness-specific triggers ('arn-infra-review-change', 'arn infra review') makes it unlikely to fire for the wrong skill.	3 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: AppsVortex/arness
Path: plugins/arn-infra/skills/arn-infra-review-change/SKILL.md
Commit: 7f87870

Reviewed: 14 days ago

Table of Contents

Discovery Implementation Validation

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.