CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

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

A highly actionable, well-sequenced skill body with concrete artifact checks, exact output strings, and comprehensive error handling. Its weaknesses are redundancy (constraints repeated three times and detection rules/hint strings duplicated from the reference file) and a few internal inconsistencies between the inline workflow and the pipeline-map.md reference.

Suggestions

Deduplicate: remove the inline per-project/global detection lists and cross-plugin hint strings from SKILL.md and rely on the pipeline-map.md reference (which the skill already loads in Steps 2 and 3), stating the read-only constraint once in the Constraints section.

Resolve the missing-##-ness contradiction: Step 1 and Error Handling say to show the core pipeline diagram unmarked when ## Arness is absent, while pipeline-map.md's Core Annotation Instructions say to skip the diagram entirely — pick one behavior.

Fix sequencing: Step 0 currently depends on "the ## Arness section (loaded in Step 1)"; either move multi-plugin awareness after Step 1 or note that the config load happens first.

DimensionReasoningScore

Conciseness

The body is mostly efficient, instruction-first writing, but includes clear redundancy: the read-only constraint is stated three times ("strictly read-only -- it never modifies files", "MUST NOT use Write or Edit", and the Constraints section), and Steps 2/3 restate detection rules and cross-plugin hint strings (e.g., "Spark exploration: active — run `/arn-spark-help` for details.") verbatim from pipeline-map.md even while instructing the reader to load that file. This is anchor 3 ("could be tightened") rather than anchor 4 ("minor instances"), because the duplication spans multiple sections.

3 / 5

Actionability

The guidance is fully executable for an instruction-only skill: exact artifact paths and JSON fields ("PROGRESS_TRACKER.json with overallStatus = \"completed\"", "reports/IMPLEMENTATION_REPORT_*.json", "TASKS.md with parseable task entries", "INTRODUCTION.md"), exact glob patterns (SWIFT_*, PLAN_PREVIEW_*.md, FEATURE_*.md), exact output strings, and per-error-case commands. This matches anchor 5's copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

Steps 0-4 are clearly sequenced with a thorough six-case Error Handling section functioning as recovery paths, matching anchor 4's clear sequence with most checkpoints present. It is not anchor 5 because of internal inconsistencies: SKILL.md Step 1 says render the core diagram with all stages unmarked when ## Arness is missing, while pipeline-map.md's annotation instructions say to skip the diagram; Step 0 references the ## Arness section "loaded in Step 1" (a forward dependency); and the inline per-project detection list omits ship/simplify-done stages present in the reference's authoritative table.

4 / 5

Progressive Disclosure

The body points to a real, verified, one-level-deep reference (${CLAUDE_PLUGIN_ROOT}/skills/arn-code-help/references/pipeline-map.md, cited in Steps 2, 3, and 4) with clear signaling, matching anchor 4's good structure. It falls short of anchor 5's "content appropriately split" because the detection rules, next-step suggestion strings, and cross-plugin hints are duplicated inline in SKILL.md instead of living solely in the reference.

4 / 5

Total

16

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit, comprehensive trigger guidance and a clear statement of what the skill delivers. Its main weaknesses are a thin what-clause (no mention of the diagram rendering or next-command suggestion) and generic phrases ("where am I", "what's next") that risk conflicting with sibling Spark/Infra help skills.

Suggestions

State the skill's concrete actions in the description, e.g., 'Renders an ASCII pipeline diagram with the active stage marked and suggests the next command to run (read-only)', to lift specificity beyond two generic outcome phrases.

Scope the generic triggers to reduce sibling-skill conflicts, e.g., '"where am I" in the code pipeline' or drop "what's next" in favor of pipeline-specific phrasing, since arn-spark-help and arn-infra-help likely claim the same generic phrases.

DimensionReasoningScore

Specificity

The description names the domain ("Arness workflow pipeline") and 1-2 outcome-level actions ("see their current position", "get guidance on the next step"), which matches anchor 3. It does not list several concrete actions (ASCII diagram rendering, next-command suggestion, cross-plugin hints), so it falls short of anchor 4; it is well above anchor 2's minimal/generic action level.

3 / 5

Completeness

Both questions are explicitly answered: "This skill should be used when the user says ... or wants to see their current position in the Arness workflow pipeline and get guidance on the next step" provides an explicit use-when clause with concrete trigger phrases plus a clear what-clause. This matches anchor 5; anchor 4's deficit ('when' could be more explicit) does not apply since the when-guidance is maximally explicit.

5 / 5

Trigger Term Quality

Comprehensive natural trigger coverage with synonyms and command-name variants: "arness code help", "arn-code-help", "arness code status", "show pipeline", "pipeline status", "show workflow", "what step am I on" — phrases a user would naturally say. This matches anchor 5's comprehensive synonym coverage; only marginal variants like "workflow status" are absent, so it is not the anchor-4 case of clearly missing natural terms.

5 / 5

Distinctiveness Conflict Risk

Arness-specific terms ("arness code help", "arness code status", "pipeline status") are distinctive, but the generic phrases "where am I" and "what's next" would equally trigger sibling skills such as arn-spark-help and arn-infra-help, which plausibly describe themselves the same way. This is anchor 3 ("somewhat specific but could still overlap with similar skills") rather than anchor 4, whose minor-overlap framing understates the near-identical generic triggers across the plugin family.

3 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-help/SKILL.md

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.