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.
58
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-swift/SKILL.mdQuality
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 is a strong skill description with excellent trigger term coverage and clear completeness, explicitly defining both what the skill does and when to use it. Its main weakness is that the specific capabilities could be more concretely enumerated beyond the high-level mentions of 'architectural assessment, targeted testing, and pattern compliance review.' The extensive trigger term list is a notable strength for skill selection accuracy.
Suggestions
Add more concrete action verbs describing what the skill actually does, e.g., 'Modifies existing code files, adds new functions or classes, updates imports and configurations' rather than the abstract 'lightweight, pattern-aware implementation'.
| Dimension | Reasoning | Score |
|---|---|---|
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 specific actions like 'modify files, add functions, update configs'. | 2 / 3 |
Completeness | The description explicitly answers both 'what' (lightweight, pattern-aware implementation for small features, 1-8 files, with architectural assessment, targeted testing, and pattern compliance review) and 'when' (extensive explicit trigger list plus contextual guidance about when to use it vs the full pipeline). | 3 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger terms users would say: 'swift', 'quick change', 'small change', 'just do this', 'quick feature', 'swift fix', 'implement this quickly', 'simple change', etc. These are highly natural phrases a user would actually type. | 3 / 3 |
Distinctiveness Conflict Risk | The description clearly carves out a distinct niche: it's specifically for quick/small implementations that bridge between raw Claude Code and a full Arness pipeline. The explicit trigger terms and scope limitation (1-8 files) make it clearly distinguishable from both general coding skills and full-pipeline 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 and well-structured workflow skill with excellent sequencing, validation checkpoints, and error handling. However, it suffers severely from verbosity — the Simple and Moderate paths duplicate large blocks of identical logic (sketch promotion, simplification preferences, change records, review) that should be extracted into shared references. The skill would benefit enormously from a ~60% reduction in length by factoring out repeated sections and trusting Claude to apply shared patterns across paths.
Suggestions
Extract duplicated logic (sketch-aware promotion, simplification preference check, CHANGE_RECORD generation) into shared reference files and reference them from both paths, reducing the main skill by ~40-60%.
Consolidate the Simple and Moderate paths into a single flow with a table or brief callout noting the differences (task tracking for moderate, pattern refresh for moderate) rather than repeating the entire workflow twice.
Remove the detailed preference-check flow (read tier 1, read tier 2, branch on value, gate, follow-up) and extract it into a single reusable reference like 'preference-gate-pattern.md' since the same pattern appears for both sketch-preview and simplification preferences.
Add at least one concrete executable example (e.g., a sample SWIFT_REPORT.json snippet or a sample plan output) rather than only describing field names abstractly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~500+ lines. There is massive duplication between the Simple Path (4A) and Moderate Path (4B) — the sketch-aware promotion logic, simplification preference check, CHANGE_RECORD generation, and review steps are repeated nearly verbatim. The preference check flows (sketch-preview, simplification) are each spelled out in full multiple times. Claude could follow these patterns from a single description with path-specific deltas. | 1 / 3 |
Actionability | The skill provides detailed procedural steps with specific file paths, JSON field names, and decision trees, which is good. However, it relies heavily on external references (complexity-criteria.md, swift-plan-template.md, swift-review-checklist.md, preferences-schema.md, pattern-refresh.md) that are not provided in the bundle, and contains no executable code examples — only mkdir commands and JSON field listings. The guidance is specific but not copy-paste executable. | 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, escalate after failures), and clear error handling for each failure mode. The complexity routing criteria are well-defined with explicit thresholds. | 3 / 3 |
Progressive Disclosure | The skill references multiple external files (complexity-criteria.md, swift-plan-template.md, swift-review-checklist.md, preferences-schema.md, pattern-refresh.md, step-0-fast-path.md, specialist-pre-check.md) which is good progressive disclosure in principle. However, the main SKILL.md itself is a monolithic wall of text with enormous inline detail that should be factored out — the sketch promotion logic, preference check flows, and CHANGE_RECORD generation are repeated in full rather than referenced from a shared location. The bundle files were not provided, making it impossible to verify reference accuracy. | 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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
b9084b6
Table of Contents
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.