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.

64

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 explaining both what it does and when to use it. The main weakness is that the specificity of capabilities could be stronger—it mentions rendering an ASCII diagram and detecting modes but doesn't detail what guidance or actions are available beyond showing status. The extensive trigger phrase list, while thorough, makes the description somewhat verbose.

Suggestions

Add more specific capability details beyond status display, such as what guidance is provided (e.g., 'recommends next infrastructure step, links to relevant documentation, suggests commands to run').

Consider condensing the trigger phrase list into a more concise format while retaining key variations, to improve readability without losing coverage.

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 doesn't comprehensively list what concrete actions the skill performs beyond showing status.

2 / 3

Completeness

The description clearly answers both 'what' (detects Quick vs Full Pipeline mode, renders ASCII diagram with active stage marked, provides guidance on next step) and 'when' (explicit list of trigger phrases plus a general 'wants to see their current position' clause).

3 / 3

Trigger Term Quality

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

3 / 3

Distinctiveness Conflict Risk

The skill is highly specific to the 'Arness Infra workflow' with very distinct trigger terms like 'arn infra help' and 'arn-infra-help'. It's unlikely to conflict with other skills due to the unique domain and specific trigger phrases.

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 status/help skill with clear workflow sequencing, good safety constraints, and thoughtful experience-level adaptation. Its main weaknesses are the lack of concrete executable examples (glob patterns, grep commands) for artifact detection and moderate verbosity in the FAQ and error handling sections. The progressive disclosure design is sound but unverifiable without bundle files.

Suggestions

Add concrete glob/grep patterns showing exactly how to detect pipeline artifacts (e.g., `Glob pattern: .arness/infra-specs/INFRA_*.md` or `Grep for 'status: reviewed'`), rather than deferring all detection logic to the external pipeline-map.md.

Trim the Step 5 FAQ section — most of these answers describe concepts Claude can infer from the workflow context, or could be moved to a separate reference file for progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but includes some verbosity that could be tightened — e.g., the FAQ section in Step 5 explains concepts Claude could infer, and the error handling section repeats information already covered in prerequisites and workflow steps. 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 lacks concrete executable examples — there are no actual glob patterns, grep commands, or code snippets showing how to detect artifacts. The detection logic references pipeline-map.md for rules but doesn't show what those rules look like inline, making it dependent on an external file that wasn't provided in the bundle.

2 / 3

Workflow Clarity

The workflow is clearly sequenced (Steps 0-5) with explicit detection ordering (most advanced to least advanced, first match wins), clear branching logic for Quick vs Full Pipeline modes, experience-level adaptation, and well-defined error handling with specific recovery actions. The read-only constraint and validation of prerequisites before proceeding are good safety checkpoints.

3 / 3

Progressive Disclosure

The skill references pipeline-map.md and experience-derivation.md as external references, which is good progressive disclosure design. However, no bundle files were provided, making it impossible to verify these references exist or are well-structured. The SKILL.md itself is fairly long (~180 lines) and some content like the FAQ section and detailed error handling could potentially be split into reference files.

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.