CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-standard

This skill should be used when the user says "arn-code-standard", "standard change", "medium change", "standard feature", "standard fix", or wants a mid-ceremony implementation for a change that needs lightweight architectural context (spec-lite) and task-tracked execution but not the full feature-spec/plan pipeline. Bridges the gap between arn-code-swift and the full thorough pipeline. Includes spec-lite generation, structured plan, in-session execution, review-lite, and a unified change record.

Quality

84%

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-validated workflow document: concrete prompts, exact paths, explicit test-and-review feedback loops. Its weaknesses are token efficiency (verbatim duplication of the preference-lookup and follow-up patterns) and a step-numbering collision between Step 2's sub-steps and the later top-level Steps 2b/2c, which creates navigation ambiguity.

Suggestions

Deduplicate the preference-lookup and gate/follow-up logic: state the two-tier lookup chain and the "remember this?" pattern once (or delegate to the already-referenced preferences-schema.md) and have Steps 2b and 5b reference that single definition, cutting ~30 lines.

Fix the step-numbering collision: rename the top-level "Step 2b: Arness-Sketch Offer" and "Step 2c: Load Sketch Manifest" (e.g., to Steps 2.5/2.6 or 2e/2f) so "continue to Step 2b" in Step 2d is unambiguous, and correct the internal cross-reference in Step 2d ("continue to Step 2b" currently sits after a section that itself describes 2b).

Move the exhaustive UI/security term lists (Step 2a) and the full report/change-record field enumerations (Steps 5 and 7) into a reference file in references/, keeping only the decision logic and a short field summary in the body.

DimensionReasoningScore

Conciseness

The body is densely procedural and avoids explaining concepts Claude already knows, but it is noticeably padded by repetition: the two-tier preference lookup chain is duplicated verbatim in Step 2b and Step 5b, the "remember this?" follow-up pattern appears twice in full, and the self-heal test-retry rule is stated three times. This is more than the "minor instances that could be trimmed" of the level-4 anchor, but not the pervasive padding of level 2.

3 / 5

Actionability

Guidance is copy-paste ready: exact AskUserQuestion texts with option lists, exact artifact paths ("<plans-dir>/STANDARD_<name>/STANDARD_REPORT.json"), enumerated JSON report/change-record fields, structured agent prompt blocks, a concrete mkdir command, and a worked example table for the Sketch Source column. The common cases are covered; the only soft spot (undefined "key terms" in the manifest fuzzy-match) is acceptable flexibility.

5 / 5

Workflow Clarity

The 8-step sequence has explicit validation checkpoints and feedback loops (run targeted tests per task, self-heal up to 3 attempts with escalation, "Only proceed to the next step when ALL tests pass", review verdict loop through NEEDS FIXES). It falls short of level 5 because step identifiers collide: "2b" and "2c" name both Step 2's sub-steps (Parallel agent dispatch / False-negative follow-up) and the top-level "Step 2b: Arness-Sketch Offer" / "Step 2c: Load Sketch Manifest" sections, so a transition like "continue to Step 2b" is ambiguous.

4 / 5

Progressive Disclosure

The plan template is correctly split into the real, well-signaled references/standard-plan-template.md (referenced exactly where needed in Step 3), and external procedures are pointed to via clear one-level-deep references. It misses level 5 because substantial detail that belongs in reference files is inlined (the exhaustive UI/security term lists, the full report and change-record field specifications, and the preference-lookup logic duplicated instead of delegated to the referenced preferences-schema.md), and several referenced files live outside this skill's bundle.

4 / 5

Total

16

/

20

Passed

Description

88%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 that explicitly states both what the skill does and when to use it, with concrete trigger phrases and clear positioning between its sibling tiers. The main residual weakness is moderate keyword coverage — a few natural variations of the tier trigger terms are missing — and inherent overlap risk within the tier family.

DimensionReasoningScore

Specificity

The description lists five concrete pipeline capabilities — "spec-lite generation, structured plan, in-session execution, review-lite, and a unified change record" — comprehensively covering what the skill does. It matches the comprehensive-coverage anchor rather than the level-4 anchor, which allows minor gaps in coverage; no pipeline stage is missing.

5 / 5

Completeness

Explicitly answers both questions: what it does ("Includes spec-lite generation, structured plan, in-session execution, review-lite, and a unified change record") and when to use it ("This skill should be used when the user says ... or wants a mid-ceremony implementation for a change that needs lightweight architectural context (spec-lite) and task-tracked execution but not the full feature-spec/plan pipeline") with concrete trigger phrases. This matches the level-5 anchor exactly; the missing-'Use when' cap does not apply.

5 / 5

Trigger Term Quality

Provides five natural trigger phrases ("arn-code-standard", "standard change", "medium change", "standard feature", "standard fix") giving good keyword coverage. It falls short of the level-5 comprehensive-coverage anchor because common variations users might say, such as "medium feature", "standard implementation", or "mid-sized change", are absent.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche ("Bridges the gap between arn-code-swift and the full thorough pipeline") with tier-specific trigger phrases, but the tiered vocabulary ("standard"/"medium" change) intentionally overlaps sibling tier skills routed by the same scope router, so minor overlap risk with closely related skills remains — the level-4 anchor, not the minimal-conflict level-5 anchor.

4 / 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 (551 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-standard/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.