CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-triage

This skill should be used when the user says "triage infra request", "infra triage", "arn infra triage", "process infra issue", "handle infra request", "infrastructure request", "triage infrastructure", "analyze infra issue", "infra request analysis", "process infrastructure request", or wants to process an incoming infrastructure request issue created by Arness Core or manually, analyze its infrastructure implications, and produce a structured implications brief.

68

Quality

83%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

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 an extensive list of invocation phrases and clearly stating both what the skill does and when to use it. Its main weakness is that the actual capabilities described (analyze implications, produce implications brief) are somewhat abstract and could benefit from more concrete action descriptions. The heavy reliance on listing trigger phrases makes it functional but somewhat verbose.

Suggestions

Add more specific concrete actions beyond 'analyze infrastructure implications' — e.g., 'identifies affected services, estimates resource requirements, flags security concerns, and categorizes request priority'.

Trim the trigger phrase list to the most distinct variations and instead add detail about what the 'structured implications brief' contains or what specific analysis steps are performed.

DimensionReasoningScore

Specificity

The description mentions processing infrastructure request issues, analyzing infrastructure implications, and producing a structured implications brief, but these actions are somewhat vague — 'analyze infrastructure implications' and 'produce a structured implications brief' lack concrete detail about what specific operations are performed.

2 / 3

Completeness

The description explicitly answers both 'what' (process incoming infrastructure request issues, analyze infrastructure implications, produce a structured implications brief) and 'when' (with a comprehensive list of trigger phrases and contextual conditions like 'when the user says...' or 'wants to process an incoming infrastructure request issue').

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say, covering many variations like 'triage infra request', 'infra triage', 'process infra issue', 'infrastructure request', 'analyze infra issue', etc. This provides excellent coverage of how users might naturally invoke this skill.

3 / 3

Distinctiveness Conflict Risk

The skill has a very clear niche — infrastructure request triage with specific mention of 'Arness Core', 'implications brief', and domain-specific trigger terms. This is unlikely to conflict with other skills due to its specialized focus.

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 for a complex multi-step infrastructure triage workflow. Its strengths are the clear step sequencing, concrete commands and templates, comprehensive error handling with fallbacks, and good use of external references for templates. Its main weakness is moderate verbosity — the skill could be tightened in places, and some inline content (like the full agent context block and topology behaviors) could be extracted to reference files for better progressive disclosure.

Suggestions

Consider extracting the agent invocation context template and topology-aware behavior details into a reference file to reduce the main skill's length and improve progressive disclosure.

Tighten the introductory paragraph and prerequisite section — the explanation of what infrastructure request issues are and the detailed experience level derivation chain could be more concise.

DimensionReasoningScore

Conciseness

The skill is fairly long but most content is necessary given the complexity of the multi-step workflow with multiple topology types, trackers, and experience levels. However, some sections could be tightened — e.g., the free-form parsing explanation, the topology-aware behavior descriptions, and the experience level derivation chain are somewhat verbose. The introductory paragraph explaining what infrastructure request issues are is mildly redundant given the context.

2 / 3

Actionability

The skill provides concrete, executable commands (gh issue view, gh issue edit), specific file paths to read, exact structured prompts to pass to the agent, and clear decision trees for each scenario. The agent invocation includes a complete context template with placeholders. Every step has specific actions rather than vague directions.

3 / 3

Workflow Clarity

The 6-step workflow is clearly sequenced with explicit prerequisites, conditional branching for different trackers/topologies, label management as a validation checkpoint, and a comprehensive error handling section with fallback behaviors for each failure mode. The decision points (AskUserQuestion) create clear gates, and re-running safety is explicitly addressed.

3 / 3

Progressive Disclosure

The skill references external files (infra-request-template.md, implications-brief-template.md, experience-derivation.md, ensure-config.md) which is good progressive disclosure design, but no bundle files were provided to verify these exist. The main SKILL.md itself is quite long (~180 lines of substantive content) and some sections like the full agent context template and the detailed topology-aware behavior could potentially be extracted to reference files. The references are clearly signaled with paths though.

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
Reviewed

Table of Contents

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.