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
48%
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-code/skills/arn-code-help/SKILL.mdQuality
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...'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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 | |
b9084b6
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.