This skill should be used when the user says "assess infrastructure", "infra assess", "arn infra assess", "infrastructure assessment", "analyze infrastructure needs", "what infrastructure do I need", "infrastructure audit", "app infrastructure assessment", "full infra assessment", "infrastructure review", "assess my app", "un-defer infrastructure", "infra backlog", or wants a comprehensive analysis of their application's infrastructure needs, including processing deferred infrastructure backlogs, to produce a prioritized infrastructure backlog published as issues.
80
76%
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-assess/SKILL.mdQuality
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 an extensive list of user phrases and clearly stating both what the skill does and when to use it. Its main weakness is that the capability description could be more specific about the concrete actions performed (e.g., what types of infrastructure are analyzed, what analysis methods are used). Overall, it is a strong description that would enable reliable skill selection.
Suggestions
Add more specific concrete actions to the capability portion, e.g., 'Analyzes compute, storage, networking, and database requirements' or 'Evaluates scaling needs and security configurations' to improve specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions some actions like 'comprehensive analysis of application's infrastructure needs', 'processing deferred infrastructure backlogs', and 'produce a prioritized infrastructure backlog published as issues', but these are somewhat vague and not fully concrete — it doesn't detail specific steps or methods used. | 2 / 3 |
Completeness | The description explicitly answers both 'what' (comprehensive analysis of infrastructure needs, processing deferred infrastructure backlogs, producing prioritized backlog as issues) and 'when' (with a detailed list of trigger phrases and contextual conditions). | 3 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would say, such as 'assess infrastructure', 'infra assess', 'infrastructure audit', 'assess my app', 'un-defer infrastructure', 'infra backlog', covering many common variations and phrasings. | 3 / 3 |
Distinctiveness Conflict Risk | The skill is clearly focused on infrastructure assessment and backlog prioritization with very specific trigger terms. It occupies a distinct niche that is unlikely to conflict with other skills like general code review or deployment skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
62%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 orchestration skill for a complex multi-step infrastructure assessment workflow. Its strengths are excellent workflow clarity with clear sequencing, conditional logic, and comprehensive error handling with fallbacks. Its weaknesses are moderate verbosity (especially in Step 8's next-steps section), heavy reliance on external reference files that aren't provided in the bundle, and some content that could be tightened without losing clarity.
Suggestions
Trim the Step 8 'Recommended next steps' section significantly — the detailed descriptions of other skills (/arn-infra-discover, /arn-infra-triage, etc.) are verbose and could be reduced to a simple ordered list of skill names with one-line descriptions.
Consider providing the referenced bundle files (agent-invocation-guide.md, assessment-questionnaire.md, backlog-item-template.md) or inlining the most critical details so the skill is more self-contained and actionable without requiring multiple file reads.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long but most content is necessary for the complex multi-step workflow. However, there's some verbosity in the summary/next-steps section (Step 8) which essentially advertises other skills, and the two-use-case explanation at the top could be tighter. The error handling section is thorough but could be more concise. | 2 / 3 |
Actionability | The skill provides concrete CLI commands for GitHub issue creation and specific file paths to read, but many steps delegate to external reference files (agent-invocation-guide.md, assessment-questionnaire.md, backlog-item-template.md) that are not provided in the bundle. The actual executable details are largely deferred to those references, making this more of a coordination document than a fully actionable guide. | 2 / 3 |
Workflow Clarity | The workflow is clearly sequenced with numbered steps (0-8), explicit conditional branching (deferred vs. fresh, monorepo vs. separate repo vs. infra-only), validation checkpoints, and comprehensive error handling with fallback strategies. The error handling section covers edge cases including re-run safety and graceful degradation. | 3 / 3 |
Progressive Disclosure | The skill references multiple external files (ensure-config.md, experience-derivation.md, agent-invocation-guide.md, assessment-questionnaire.md, backlog-item-template.md) which is good progressive disclosure structure, but none of these bundle files are provided for evaluation. The references are one-level deep and clearly signaled, but the main document itself is quite long and some content (like the full Step 8 next-steps text) could potentially be extracted. | 2 / 3 |
Total | 9 / 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.