CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-help

This skill should be used when the user says "arness code help", "where am I", "what's next", "show pipeline", "pipeline status", "what step am I on", "arness code status", "arn-code-help", "show workflow", or wants to see their current position in the Arness workflow pipeline and get guidance on the next step.

46

Quality

48%

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-code/skills/arn-code-help/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

62%

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 distinctiveness due to its extensive list of natural phrases and its tie to the specific 'Arness workflow pipeline.' However, it is weak on specificity — it fails to describe concrete actions or outputs the skill performs beyond vaguely showing position and giving guidance. The description reads more like a trigger-matching rule than a capability description.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Displays the current stage in the Arness workflow pipeline, lists completed and remaining steps, and provides actionable guidance for the next step.'

Restructure to lead with a clear 'what it does' statement before listing trigger phrases, e.g., 'Tracks progress through the Arness code workflow pipeline and provides step-by-step guidance. Use when...'

DimensionReasoningScore

Specificity

The description mentions 'see their current position in the Arness workflow pipeline and get guidance on the next step' but does not list concrete actions beyond showing position and giving guidance. It's vague about what the skill actually does — no specific capabilities like 'displays pipeline stages', 'checks completion status', or 'generates next-step instructions' are mentioned.

1 / 3

Completeness

The 'when' is very well covered with explicit trigger phrases and conditions. However, the 'what' is weak — it only vaguely says 'see their current position in the Arness workflow pipeline and get guidance on the next step' without detailing what concrete actions or outputs the skill provides.

2 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say: 'where am I', 'what's next', 'show pipeline', 'pipeline status', 'what step am I on', 'arness code help', etc. These are realistic, varied, and cover multiple ways a user might invoke this skill.

3 / 3

Distinctiveness Conflict Risk

The skill is clearly tied to the 'Arness workflow pipeline' which is a specific, named system. The trigger terms like 'arness code help' and 'arn-code-help' are highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

9

/

12

Passed

Implementation

35%

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

This skill provides a thorough specification for a read-only pipeline status detection tool with clear safety constraints and multi-plugin awareness. However, it is significantly over-verbose — repeating command suggestions across multiple sections, over-explaining FAQ answers Claude could handle with minimal prompting, and inlining error handling that could be a compact table or external reference. The actionability suffers from deferring all rendering to an external file without showing any example output.

Suggestions

Reduce verbosity by consolidating repeated command suggestions into a single lookup table (stage → suggested commands) rather than repeating them in Steps 1, 2, 3, and Error Handling.

Add a concrete example of the expected ASCII pipeline diagram output so the rendering step is actionable without requiring the external pipeline-map.md reference.

Move the FAQ section (Step 4 common questions) to a separate reference file and keep only a brief pointer in the main skill body.

Compress the error handling section into a compact table format (condition → stage → suggestion) to eliminate redundant prose.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~150+ lines with extensive detail that could be significantly compressed. It over-explains detection logic, error handling edge cases, and FAQ answers that Claude could infer from a compact rule set. Many sections repeat similar suggestions (e.g., '/arn-code-feature-spec' or '/arn-code-bug-spec' appears in multiple places).

1 / 3

Actionability

The detection rules are fairly specific with concrete file paths and patterns to check (e.g., SWIFT_REPORT.json, PROGRESS_TRACKER.json), but there are no executable code examples. The rendering step defers entirely to an external pipeline-map.md reference file without showing what the output should look like, making the actual output format unclear.

2 / 3

Workflow Clarity

The steps are clearly numbered and sequenced (Steps 0-4), and the detection hierarchy is well-ordered (most advanced to least advanced). However, there are no explicit validation checkpoints — the skill doesn't verify that extracted configuration fields are valid before proceeding, and the dependency on an external pipeline-map.md for rendering rules means the actual rendering workflow is opaque.

2 / 3

Progressive Disclosure

The skill references an external pipeline-map.md file for detection rules and rendering templates, which is good progressive disclosure in principle. However, no bundle files were provided, so we can't verify the reference exists or is well-structured. The FAQ section in Step 4 is quite long and could be split into a separate reference file, and the inline error handling section adds bulk that could be externalized.

2 / 3

Total

7

/

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.