CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-ensure-config

This skill should be used when the user says "ensure config", "check arness config", "arn-code-ensure-config", "verify arness setup", or wants to verify that Arness Code configuration is present for the current project. This skill is primarily consumed as a reference by entry-point skills (arn-planning, arn-implementing, arn-shipping, arn-reviewing-pr, arn-assessing, arn-code-feature-spec, arn-code-bug-spec, arn-code-swift, arn-code-standard) which read the `references/step-0-fast-path.md` reference as Step 0 before proceeding with their workflow.

Quality

81%

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

82%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.

This is a well-designed dispatcher skill: a minimal, token-efficient body that routes two distinct invocation modes (entry-point Step 0 via the cache fast path, and direct invocation via full validation) to the correct reference file. The only weaknesses are inherited from the bundle rather than the body — second-level reference chaining and two reference files that the body never points to.

DimensionReasoningScore

Conciseness

The ~11-line body contains only routing information ("Entry points should NOT read this SKILL.md directly", "This indirection is what saves ~95% of ensure-config token cost") with zero concept re-explanation or padding; every token earns its place by pointing the reader to the right file for their invocation mode.

5 / 5

Actionability

The body gives concrete, executable pointers — exact paths like "${CLAUDE_PLUGIN_ROOT}/skills/arn-code-ensure-config/references/step-0-fast-path.md" and explicit conditional directives (cache hit → skip full validation; direct invocation → "runs the full validation flow"). It falls short of anchor 5 because no commands or exit-code handling appear in the body itself; the executor must open the referenced file before acting.

4 / 5

Workflow Clarity

The conditional sequence is clear: entry points read the fast path, the cache-check gates full validation ("only falls through to the full validation when needed"), and the layer ordering is stated ("Layers 1–3, then Layer 4 cache write"). The actual validation checkpoints (exit 0 vs non-zero with reason surfaced) live in step-0-fast-path.md rather than the body — a minor gap versus anchor 5, but well above anchor 3's missing-checkpoint profile.

4 / 5

Progressive Disclosure

The body is a lean overview with well-signaled, one-level-deep pointers to real bundle files (step-0-fast-path.md for entry points, ensure-config.md for direct invocation), and the ~500-line validation flow is appropriately kept out of SKILL.md. Minor gaps against the actual bundle: ensure-config.md itself chains into other skills' references (template-setup.md, agent-models presets, template-versioning.md — a second hop), and references/preferences-schema.md and specialist-pre-check.md are not reachable from the body's navigation.

4 / 5

Total

17

/

20

Passed

Description

73%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.

The description excels at routing: it has explicit, natural trigger phrases, a clear niche, and honest metadata about how entry-point skills consume it. Its main weakness is that it names only one concrete capability — what the full validation actually does (profile check, ## Arness section, labels, cache) is never surfaced.

Suggestions

Enumerate the concrete capabilities in the description — e.g. "Checks the user profile, creates or repairs the ## Arness section in CLAUDE.md, installs missing GitHub labels, and writes a validation cache" — to raise specificity from a single high-level action.

Consider trimming the parenthetical list of nine entry-point skill names to a shorter form (e.g. "all arn-* entry-point skills") so the saved length can fund the capability enumeration without growing the description.

DimensionReasoningScore

Specificity

The only concrete capability stated is "verify that Arness Code configuration is present for the current project"; the remainder is trigger phrasing and consumption metadata ("primarily consumed as a reference by entry-point skills"), not capabilities. This matches anchor 3 (names domain and 1-2 concrete actions) rather than anchor 4, which would require listing several specific actions such as profile checking, ## Arness section creation, or platform label setup.

3 / 5

Completeness

Both halves are present: the what ("verify that Arness Code configuration is present for the current project") and an explicit when ("should be used when the user says…") with concrete trigger phrases, placing it above anchor 3's weakly-implied-when. It falls short of anchor 5 because the what is a single high-level action — thinner than the multi-action concrete example — rather than because the when is imprecise.

4 / 5

Trigger Term Quality

Five explicit natural trigger phrases are provided: "ensure config", "check arness config", "arn-code-ensure-config", "verify arness setup", and "wants to verify that Arness Code configuration is present". Coverage is good but a few natural variants (e.g. "set up arness", "arness config") are absent, so it sits at anchor 4 rather than the comprehensive synonym-level coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Namespaced triggers ("arn-code-ensure-config", "check arness config", "verify arness setup") plus the explicitly enumerated consumer skills carve out a clear niche with distinct triggers and minimal conflict risk with any generic skill, matching anchor 5.

5 / 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-ensure-config/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.