CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-infra-help

This skill should be used when the user says "infra help", "arn infra help", "where am I in the pipeline", "what's next for infra", "infra status", "pipeline status", "infra pipeline", "arn-infra-help", "show infra pipeline", "what step am I on for infra", "infra workflow", "infrastructure status", "show infrastructure pipeline", or wants to see their current position in the Arness Infra workflow and get guidance on the next step. This skill detects whether the user is in Quick (interactive) mode or Full Pipeline mode and renders an ASCII diagram with the active stage marked.

80

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-infra/skills/arn-infra-help/SKILL.md
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.

This description excels at trigger term coverage and completeness, providing an exhaustive list of phrases that would invoke the skill and clearly stating both what it does and when to use it. Its main weakness is that the specificity of capabilities could be slightly more detailed regarding what guidance or actions are available beyond showing the pipeline diagram. The description is functional and effective for skill selection despite being somewhat verbose.

Suggestions

Add more specific capability details beyond 'renders an ASCII diagram' — e.g., what guidance is provided for the next step, what actions can be taken from the status view.

DimensionReasoningScore

Specificity

The description names the domain (Arness Infra workflow/pipeline) and some actions (detects mode, renders ASCII diagram, marks active stage, provides guidance on next step), but it doesn't comprehensively list what concrete actions the skill performs beyond showing status.

2 / 3

Completeness

The description clearly answers both 'what does this do' (detects Quick vs Full Pipeline mode, renders ASCII diagram with active stage, provides next-step guidance) AND 'when should Claude use it' (explicit list of trigger phrases plus a general 'when the user wants to see their current position in the Arness Infra workflow').

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would actually say, including variations like 'infra help', 'pipeline status', 'what step am I on', 'infrastructure status', 'infra workflow', and the shorthand 'arn-infra-help'. This provides excellent coverage of how users would naturally invoke this skill.

3 / 3

Distinctiveness Conflict Risk

The skill is highly distinctive with its focus on the specific 'Arness Infra' workflow/pipeline, unique trigger phrases like 'arn infra help' and 'arn-infra-help', and the specific behavior of rendering ASCII pipeline diagrams. It is unlikely to conflict with other 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 read-only diagnostic skill with clear workflow sequencing, good error handling, and appropriate safety constraints. Its main weaknesses are reliance on external reference files that aren't provided in the bundle (making actionability hard to fully assess), and some verbosity in the follow-up questions and repeated constraint statements. The experience-level adaptation and dual-mode detection logic are thoughtfully designed.

Suggestions

Include the pipeline-map.md reference file in the bundle, or inline the critical detection rules and ASCII templates so the skill is self-contained enough to execute without missing references.

Move the follow-up Q&A section to a reference file — Claude can handle ad-hoc questions about pipeline stages without a pre-written FAQ, and this would save ~20 lines of token budget.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but includes some verbosity that could be tightened — e.g., the follow-up questions section with full Q&A pairs explains things Claude could infer, and the error handling section repeats information already covered in the workflow. The cross-plugin awareness logic is detailed but necessarily so given the complexity.

2 / 3

Actionability

The skill provides clear procedural steps and specific file paths to check, but relies heavily on an external reference file (pipeline-map.md) for the actual detection rules, ASCII templates, and next-step tables — none of which are provided in the bundle. Without those, Claude cannot fully execute the skill. The detection logic is described at a high level ('apply the Full Pipeline Stage Detection Rules from pipeline-map.md') rather than giving concrete, executable instructions inline.

2 / 3

Workflow Clarity

The workflow is clearly sequenced with numbered steps (0-5), explicit branching logic for different modes and states, and thorough error handling. The detection order (most advanced to least advanced, first match wins) is well-specified. Validation isn't needed since this is a read-only diagnostic skill, and the fallback/error cases are comprehensive.

3 / 3

Progressive Disclosure

The skill references external files like pipeline-map.md, experience-derivation.md, and user-profile.yaml, which is good progressive disclosure in principle. However, no bundle files were provided, so we cannot verify these references exist or are well-structured. The main SKILL.md itself is fairly long (~180 lines of substantive content) and some sections like the follow-up Q&A could potentially be moved to a reference file.

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.

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.