CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-init

Optional customization and upgrade tool. This skill should be used when the user says "initialize arness code", "arness code init", "arn-code-init", "init arness code", "setup arness code", "arness code setup", "set up arness code", "start arness code", "upgrade arness code", "update arness code", "configure arness code for this project", "add arness code to this project", "reconfigure arness code", "review arness config", "customize arness config", "arness settings", or wants to customize Arness configuration, review current settings, or upgrade after a plugin update. Handles both existing codebases (analyzes patterns) and greenfield projects (recommends patterns based on technology choices). Also handles upgrades after plugin updates.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 dense, highly actionable init workflow with concrete commands, exact prompts and file formats, schema validation checkpoints, verification checklists, and thorough error handling across both fresh-init and upgrade paths. Its main weakness is redundancy — the shared-field preservation and upgrade logic is restated across Steps 3, 9, and U7, inflating token cost without adding information.

Suggestions

Consolidate the shared-field preservation rules (repeated nearly verbatim in Step 3, Step 9, and Step U7) into a single section or a references/preserve-fields.md file and cite it from each location.

Move the full Upgrade Flow (Steps U1–U9) into a references/upgrade-flow.md file, keeping a short entry-point summary in the main body; most of the ~630-line body is only relevant to one of the two paths a given run takes.

Trim or remove the "Re-running Arness Init" section, which restates Step 1's Review/Upgrade/Reconfigure/Keep options and backward-compatibility notes already covered elsewhere.

DimensionReasoningScore

Conciseness

The ~630-line body is procedural throughout with no concept-padding, but it restates the same logic repeatedly: the shared-field preservation rules appear in Step 3 ("skip detection and preserve the existing values"), Step 9 ("Preserve all fields not managed by this skill — this includes greenfield fields … and infra fields …"), and again in Step U7, and the "Re-running Arness Init" section restates Step 1's options. Mostly efficient but could be meaningfully tightened — better than anchor 2's padded explanations, short of anchor 4's minor trims.

3 / 5

Actionability

Fully executable guidance throughout: concrete commands (`git rev-parse --is-inside-work-tree`, `gh label create`, `bkt auth status`, `mkdir -p <chosen-path>`, `bash …/plugin-version.sh`), the exact `## Arness` config block format, exact `.claude/settings.json` JSON to write, verbatim AskUserQuestion prompts, and a U4 table of prompts with defaults. Failure branches (auth not available, agent fails, linting.md missing) are covered, matching anchor 5.

5 / 5

Workflow Clarity

Clear sequence (Steps 1→10 with Flow A/B branches and the U1–U9 upgrade flow), explicit validation checkpoints ("Before writing each file, validate the content against the schema"; Step 10 verification checklist), and feedback loops ("If it seems incomplete … re-invoke with more specific guidance"; dedicated Error Handling section with per-mode recovery). Matches anchor 5's explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep ("> Read …/references/platform-labels.md for label details", pattern-schema.md, template-setup.md, greenfield-questions.md, bkt-setup.md, jira-mcp-setup.md, agent-models-presets/<choice>.md) and all cited bundle files exist. Not a 5 because the main body inlines substantial content that belongs in separate files (the entire U1–U9 upgrade flow and twice-repeated field-preservation lists), and several references point into sibling skills' files outside this bundle (arn-code-ensure-config references).

4 / 5

Total

17

/

20

Passed

Description

86%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 nails the 'when' with an exhaustive list of natural trigger phrases and is highly distinctive thanks to the "arness" term throughout. The 'what' is present but high-level — it never states that configuration is persisted to CLAUDE.md or enumerates what actually gets set up, keeping specificity and completeness just short of full marks.

DimensionReasoningScore

Specificity

Lists several concrete actions — "analyzes patterns", "recommends patterns based on technology choices", "review current settings", "upgrade after a plugin update" — but never states what the tool produces (persisting configuration to CLAUDE.md, creating directories/templates), leaving minor gaps in coverage. It exceeds anchor 3 (only 1-2 actions) but falls short of anchor 5's comprehensive coverage.

4 / 5

Completeness

Both parts are explicit: the 'what' ("Optional customization and upgrade tool. … Handles both existing codebases (analyzes patterns) and greenfield projects") and the 'when' ("This skill should be used when the user says…"). Not a 5 because the 'what' stays high-level — it never mentions that configuration is written to CLAUDE.md or what concretely gets set up.

4 / 5

Trigger Term Quality

Exhaustive natural trigger variations and synonyms: "initialize arness code", "arness code init", "setup arness code", "set up arness code", "reconfigure arness code", "arness settings". Matches anchor 5's comprehensive coverage including synonyms; anchor 4 ("a few natural terms missing") is too weak a fit despite the verbosity.

5 / 5

Distinctiveness Conflict Risk

Every trigger phrase contains the distinct product term "arness" ("configure arness code for this project", "review arness config", "customize arness config"), giving it a clear niche with minimal conflict risk against unrelated skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (650 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-init/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.