CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-implementing

This skill should be used when the user says "implementing", "arness implementing", "start implementing", "execute the plan", "build it", "implement this", "run the tasks", "execute", "start building", "implement the feature", "implement the fix", "quick change", "swift", "swift mode", "quick implementation", "standard", "standard mode", "standard implementation", "start execution", "build the feature", "arn-implementing", or wants to execute an implementation plan, run a quick implementation, a standard-tier implementation, or manage the build-simplify-review cycle. Chains to arn-shipping at completion.

Quality

89%

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

88%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 well-engineered orchestrator skill: fully actionable routing instructions, a clearly gated workflow with validation checkpoints and error-recovery loops, and no concept over-explanation. The main improvement areas are trimming the duplicated preference-lookup/write-back machinery across G3/G4 and moving the CHANGE_RECORD population spec out of the body.

Suggestions

Factor the two-tier preference lookup chain and the "remember this?" write-back logic, repeated nearly verbatim in G3 (pipeline.simplification) and G4 (pipeline.implementation-review), into one shared subsection or a reference file, parameterized by the preference key and the always/skip values.

Move the CHANGE_RECORD.json field-by-field population spec (Step 7) into a reference file next to the template (e.g., a change-record-guide.md), keeping only the thorough-tier detection conditions and the write path inline.

DimensionReasoningScore

Conciseness

The body is lean and imperative — it never explains concepts Claude already knows, and uses terse tables (state detection), exact option lists, and exact skill invocations. The main tightening opportunity is the near-verbatim duplication of the two-tier preference lookup chain and the "remember this?" write-back logic across G3 and G4 (~50 lines), plus the inline CHANGE_RECORD field-by-field spec; this is more than trivial but not pervasive padding, placing it at anchor 4 ('efficient; minor instances... that could be trimmed') rather than anchor 3 ('mostly efficient but includes some unnecessary explanation').

4 / 5

Actionability

Guidance is fully executable throughout: exact artifact paths ("SIMPLIFICATION_REPORT.json in <plans-dir>/<project>/reports/"), exact questions and option text for AskUserQuestion, exact invocations ("Skill: arn-code:arn-code-swift"), precise branch conditions ("If 3 or more phases OR 15 or more files touched"), and concrete file-write instructions for the preferences YAML. This matches anchor 5 ('fully executable... specific examples cover the common cases'); anchor 4 would require minor gaps in the concrete details, and none are evident.

5 / 5

Workflow Clarity

The sequence is explicit and gated (Step 0 → 0.5 routing → state detection → G0/G2/G3/G4/G5 with swift and standard bypass paths), state detection is a validation checkpoint with first-match-wins ordering and resume points, and there are feedback loops (NEEDS FIXES → fixes handled internally → re-present gate; sub-skill failure → retry/skip/abort; start-fresh does not delete artifacts). This matches anchor 5; anchor 4's 'minor validation gaps' does not apply given the explicit checkpoints and error-recovery paths.

5 / 5

Progressive Disclosure

Structure is good and navigable (Workflow with numbered steps, dedicated Swift Path, Standard Path, Sketch, Error Handling sections), and external references are clearly signaled with full paths ("${CLAUDE_PLUGIN_ROOT}/skills/arn-code-ensure-config/references/step-0-fast-path.md", preferences-schema.md). However, no bundle reference files exist for this skill, and content that could reasonably live in a reference file is inlined (the ~25-line CHANGE_RECORD.json field population spec and the duplicated preference machinery), which fits anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than anchor 5 (well-signaled one-level-deep references, content appropriately split).

4 / 5

Total

18

/

20

Passed

Description

87%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 trigger-rich description that clearly and exhaustively answers both 'what' and 'when' with concrete, natural trigger phrases. Its main weakness is conflict risk: several single-word generic triggers ("execute", "standard", "swift", "build it") are likely to collide with sibling skills in the same plugin family.

Suggestions

Drop or context-qualify the standalone generic triggers ("execute", "standard", "swift", "build it", "start building") that sibling skills like arn-code-execute-plan, arn-code-swift, and arn-code-standard would also match; keep multi-word, Arness-scoped phrases like "execute the plan" and "run the tasks".

Lead with one direct third-person capability sentence (e.g., "Orchestrates execution of implementation plans: routing input, detecting state, running the swift/standard/thorough paths, and managing the simplify-review cycle") before the trigger list, so the 'what' is stated up front rather than embedded in want-clauses.

DimensionReasoningScore

Specificity

The description names several concrete capabilities — "execute an implementation plan", "run a quick implementation, a standard-tier implementation", "manage the build-simplify-review cycle", "Chains to arn-shipping at completion" — which are specific, though they are meta-level orchestration actions with minor gaps (state detection, resume, and gate handling are not mentioned). This matches anchor 4 ('several specific actions; minor gaps') better than anchor 3, since more than 1-2 concrete actions are listed, and better than anchor 5, since coverage of what the sequencer actually does is not comprehensive.

4 / 5

Completeness

Both questions are answered explicitly: 'when' via a concrete, quoted trigger-phrase list plus want-clauses ("or wants to execute an implementation plan, run a quick implementation, a standard-tier implementation, or manage the build-simplify-review cycle"), and 'what' via those same capability statements plus "Chains to arn-shipping at completion". This matches anchor 5 (both what and when with concrete trigger phrases); anchor 4's defining weakness ('when' could be more explicit) does not apply here.

5 / 5

Trigger Term Quality

Trigger coverage is exhaustive and natural, including synonyms and mode variants: "implementing", "arness implementing", "start implementing", "execute the plan", "build it", "implement this", "run the tasks", "start building", "quick change", "swift", "swift mode", "quick implementation", "standard", "standard mode", "standard implementation", "start execution", "build the feature", "arn-implementing". This comprehensively covers natural terms and their variations, matching anchor 5; anchor 4 would require notable natural terms to be missing, which is not the case.

5 / 5

Distinctiveness Conflict Risk

Distinct markers exist ("arness implementing", "arn-implementing", "execute the plan", "build-simplify-review cycle"), but standalone generic triggers like "execute", "standard", "build it", "start building", and "swift" overlap heavily with sibling skills in the same chain (arn-code-execute-plan, arn-code-swift, arn-code-standard, arn-planning). This is 'somewhat specific but could still overlap with similar skills' (anchor 3); it is not anchor 4 because the overlap is with closely related sibling execution skills via multiple generic single-word triggers, and not anchor 2 because the Arness-scoped phrases do carve out a clear niche.

3 / 5

Total

17

/

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-implementing/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.