CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-standard

This skill should be used when the user says "standard", "standard mode", "standard implementation", "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.

73

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-standard/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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

This description excels at trigger term coverage and completeness, with a very explicit 'when to use' clause and clear positioning relative to adjacent skills. Its main weakness is that the 'what it does' portion is somewhat compressed at the end, listing actions without much detail on what each entails. The description is functional and effective for skill selection but could benefit from slightly more specificity on the concrete actions performed.

Suggestions

Expand the capabilities section at the end to briefly describe what each action involves (e.g., 'spec-lite generation: creates a lightweight architectural context document summarizing scope and approach').

DimensionReasoningScore

Specificity

The description names several concrete actions like 'spec-lite generation, structured plan, in-session execution, review-lite, and a unified change record,' but these are listed briefly at the end rather than being comprehensively described. The bulk of the description focuses on trigger terms rather than detailing what each action entails.

2 / 3

Completeness

The description explicitly answers both 'what' (spec-lite generation, structured plan, in-session execution, review-lite, unified change record, bridging swift and full pipeline) and 'when' (extensive list of trigger phrases and contextual conditions like 'mid-ceremony implementation' and 'needs lightweight architectural context'). The 'when' is front-loaded and very explicit.

3 / 3

Trigger Term Quality

The description provides extensive natural trigger terms including 'standard', 'standard mode', 'standard implementation', 'arn-code-standard', 'standard change', 'medium change', 'standard feature', 'standard fix', and conceptual triggers like 'mid-ceremony implementation' and 'lightweight architectural context'. These cover many natural variations a user might say.

3 / 3

Distinctiveness Conflict Risk

The description clearly positions itself between 'arn-code-swift' and the 'full thorough pipeline,' explicitly naming adjacent skills and defining its niche as the mid-ceremony tier. The specific trigger terms like 'arn-code-standard' and 'standard mode' are highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

47%

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

This is a comprehensive orchestration skill with excellent workflow clarity and thorough error handling, but it suffers significantly from verbosity. The sketch-related conditional logic, preference lookup chains, and manifest status handling consume a disproportionate amount of tokens relative to their importance in the core workflow. The skill would benefit greatly from extracting conditional paths into reference files and trusting Claude to handle routine operations (YAML reading, boolean checks, file existence checks) without exhaustive step-by-step instructions.

Suggestions

Extract the sketch-related logic (Steps 2b, 2c, and Step 4's sketch-aware promotion) into a separate reference file like `sketch-integration.md` to reduce the main skill's token footprint by ~40%.

Compress the preference lookup pattern (used identically in Steps 2b and 5b) into a single reusable reference or a brief inline pattern description rather than repeating the full two-tier lookup chain twice.

Remove explanatory prose that Claude can infer — e.g., 'This is automatic and non-blocking. If the refresh fails, proceed to change record generation without blocking' can be reduced to 'Auto, non-blocking.'

Add a complete example of the STANDARD_REPORT.json output structure rather than listing field names with descriptions — a concrete JSON example would be more actionable and potentially more concise.

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~400+ lines with extensive detail on preference lookups, sketch manifest handling, conditional branching, and multi-tier fallback logic. Much of this could be compressed significantly — Claude doesn't need step-by-step instructions for reading YAML files, checking boolean flags, or writing preference values. The sketch-related sections alone (Steps 2b, 2c, 4's sketch promotion) consume enormous token budget for what are conditional side-paths.

1 / 3

Actionability

The skill provides detailed procedural steps and specific file paths, JSON field names, and table formats, which is good. However, it lacks executable code examples — the only code block is a simple mkdir command. The JSON schemas are shown as fragments rather than complete templates, and many steps reference external files (templates, checklists, other skills) without showing their content, making it impossible to execute without those dependencies.

2 / 3

Workflow Clarity

The workflow is exceptionally well-sequenced with numbered steps, clear branching logic, explicit validation checkpoints (spec-lite approval, plan approval, test verification, review verdict), and feedback loops (self-heal up to 3 attempts, re-review after fixes). The error handling section covers edge cases comprehensively with specific recovery actions.

3 / 3

Progressive Disclosure

The skill references multiple external files (ensure-config.md, specialist-pre-check.md, preferences-schema.md, standard-plan-template.md, swift-review-checklist.md, pattern-refresh.md, report templates) which is good progressive disclosure in principle. However, no bundle files were provided to verify these exist, and the main SKILL.md itself is monolithic — the sketch-related conditional logic (Steps 2b, 2c, Step 4 sketch promotion) could easily be extracted to a separate reference file to reduce the main document's size.

2 / 3

Total

8

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
AppsVortex/arness
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.