CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-swift

This skill should be used when the user says "swift", "arness code swift", "quick change", "small change", "just do this", "quick feature", "quick implementation", "swift fix", "implement this quickly", "add this quickly", "simple change", "just implement this", "arn-code-swift", "swift mode", "quick task", or wants a lightweight, pattern-aware implementation for a small feature or enhancement (1-8 files) without going through the full Arness pipeline. Bridges the gap between raw Claude Code and the full feature-spec/plan pipeline. Includes architectural assessment, targeted testing, and pattern compliance review.

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-swift/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 an extensive list of natural phrases that would activate the skill and a clear explanation of both what it does and when to use it. Its main weakness is that the actual capabilities could be more concretely specified - the actions beyond 'lightweight implementation' are somewhat abstract. The description is functional and effective for skill selection despite being somewhat front-loaded with trigger terms at the expense of capability detail.

Suggestions

Add more concrete action verbs describing what the skill actually does, e.g., 'Implements small features, applies bug fixes, adds enhancements across 1-8 files with pattern-aware code generation'.

DimensionReasoningScore

Specificity

The description mentions some actions like 'architectural assessment, targeted testing, and pattern compliance review' and describes the scope (1-8 files, small feature/enhancement), but the core capability ('lightweight, pattern-aware implementation') is somewhat vague and doesn't list concrete actions like 'modify files, add functions, update configs'.

2 / 3

Completeness

Clearly answers both 'what' (lightweight pattern-aware implementation for small features, 1-8 files, with architectural assessment, targeted testing, and pattern compliance review) and 'when' (explicit trigger phrases and use-case description at the start). The entire description essentially opens with a 'Use when...' clause.

3 / 3

Trigger Term Quality

Excellent coverage of trigger terms - includes extensive natural language variations users would say: 'swift', 'quick change', 'small change', 'just do this', 'quick feature', 'swift fix', 'simple change', 'just implement this', 'quick task', plus the formal skill names like 'arn-code-swift' and 'swift mode'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive - explicitly positions itself as a bridge between 'raw Claude Code' and 'the full feature-spec/plan pipeline', with a clear scope (1-8 files, small changes). The numerous specific trigger phrases like 'swift', 'arn-code-swift', 'swift mode' create a clear niche that is 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 skill has excellent workflow clarity with well-defined branching, validation checkpoints, and error recovery, but suffers severely from verbosity — large blocks of logic are duplicated verbatim across the simple and moderate paths, and procedural details that Claude could infer are spelled out exhaustively. The content would benefit enormously from extracting repeated patterns (preference checks, sketch promotion logic) into shared reference files, which would also improve progressive disclosure.

Suggestions

Extract the duplicated preference-check pattern (used for sketch-preview and simplification across both paths) into a shared reference file like `references/preference-gate.md` and reference it by name, reducing ~150 lines of duplication to ~10 lines of references.

Extract the sketch-aware promotion logic (duplicated between Step 4A section 3 and Step 4B section 4) into `references/sketch-promotion.md` — the logic is identical and takes up ~60 lines each time.

Reduce Step 2c (Load Sketch Manifest) from ~60 lines to ~15 by trusting Claude to handle status field branching from a concise table rather than spelling out every permutation with full prose.

Add executable code examples for key operations (e.g., the SWIFT_REPORT.json population, the sketch manifest status update) rather than describing them in prose — currently the skill has almost no runnable code despite being an implementation skill.

DimensionReasoningScore

Conciseness

Extremely verbose at ~500+ lines. Massive amounts of repetition — the simplification preference check is copy-pasted verbatim between Step 4A and 4B, sketch-aware promotion logic is duplicated across both paths, and the sketch manifest loading (Step 2c) is exhaustively detailed with every status permutation spelled out. Claude could infer most of this from a concise specification. The preference read/write pattern alone is repeated 3+ times with identical instructions.

1 / 3

Actionability

The skill provides detailed procedural steps and specific file paths/commands, but almost no executable code — just a single `mkdir -p` command. The JSON schema for promotedComponents is shown but most guidance is procedural prose rather than copy-paste-ready commands or code. References to external templates and checklists are frequent but the actual content is not provided in the bundle.

2 / 3

Workflow Clarity

The workflow is exceptionally well-sequenced with clear branching logic (simple/moderate/complex paths), explicit validation checkpoints (test self-healing with 3-attempt limit, review verdicts with PASS/WARNINGS/NEEDS FIXES), feedback loops (fix and re-validate tests, re-run review after fixes), and clear error recovery procedures. The pipeline position diagram and step numbering make the sequence unambiguous.

3 / 3

Progressive Disclosure

The skill references multiple external files (complexity-criteria.md, swift-plan-template.md, swift-review-checklist.md, pattern-refresh.md, preferences-schema.md, ensure-config.md, specialist-pre-check.md) which is good progressive disclosure in principle. However, no bundle files were provided to verify these exist, and the SKILL.md itself is a monolithic wall of text that inlines enormous amounts of detail (sketch promotion logic, preference handling) that could have been extracted to reference files. The main file tries to be both overview and complete specification.

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 (617 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.