CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-swift

Use when the question is about Swift or its toolchain rather than a framework — modern idioms, noncopyable types, drag and drop, debug deep links, tvOS targets.

Quality

61%

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

Fix and improve this skill with Tessl

tessl review fix ./axiom-cursor/skills/axiom-swift/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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.

This is a well-designed router skill with a clear decision structure and genuinely useful conflict-resolution and anti-rationalization sections, but it suffers from two real defects: the routing map is repeated in four redundant formats (roughly doubling token cost), and none of the referenced files ship with the bundle, making every pointer dangling. Trimming duplication and including the referenced files would move this from adequate to strong.

Suggestions

Eliminate redundant routing presentations — keep the Quick Reference table and Conflict Resolution, and delete the dot-graph Decision Tree (duplicated by the numbered list) and the 12-entry Example Invocations section, cutting roughly 40% of tokens.

Ship the referenced files in the bundle (references/ directory or correct relative paths) so pointers like `skills/swift-modern.md` resolve, or inline the most critical quick-reference content as fallback.

Add a few copy-paste-ready snippets for the highest-frequency asks (e.g., one modern-idiom before/after pair, one Transferable conformance) so the skill is actionable even before opening a reference file.

DimensionReasoningScore

Conciseness

The same symptom→file routing map is restated four times: the Quick Reference table, the dot-format Decision Tree, the numbered Decision Tree list ("Outdated Swift patterns... -> `skills/swift-modern.md`"), and 12 Example Invocations that duplicate the table almost entry-for-entry; the Critical Patterns section then re-summarizes the referenced files. This is noticeably padded — roughly half the body is duplication — matching anchor 2. Not 1 because no section explains basic concepts Claude already knows and each unit is dense; not 3 because the dot graph and Example Invocations are wholesale duplications, not merely 'could be tightened'.

2 / 5

Actionability

Directives are concrete and specific ("See `skills/swift-modern.md`", "`swift-simplifier` agent — `/axiom-audit` swift-simplify"), but every referenced path is absent from the bundle — no references/ or skills/ files ship with SKILL.md — so the primary instruction cannot be executed as packaged, and there is no inline fallback content. Not 2 because the guidance gives exact paths and commands rather than high-level hints; not 4 because dangling targets are a genuine execution gap.

3 / 5

Workflow Clarity

The routing sequence is unambiguous and the Conflict Resolution section explicitly disambiguates overlapping triggers ("Use concurrency, NOT swift", "Use swift for ownership... Use performance if the question is COW"). Not 5 because there are no verification or feedback steps; not 3 because the sequence is clear and this routing-only skill involves no destructive or batch operations that would demand validation checkpoints.

4 / 5

Progressive Disclosure

References are one level deep, clearly and consistently signaled, and the body stays an overview — structurally this is good design. However, none of the five referenced files (`skills/swift-modern.md`, `skills/ownership-conventions.md`, `skills/transferable-ref.md`, `skills/deep-link-debugging.md`, `skills/tvos.md`) exist in the bundle, so the navigation cannot actually be followed. Not 4/5 because the bundle structure breaks every pointer; not 2 because the organization is strong and references are prominently signaled, not buried or inlined.

3 / 5

Total

12

/

20

Passed

Description

56%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 well-targeted trigger description with strong natural keywords and an explicit disambiguation clause, but it is all 'when' and no 'what' — the skill's actual capability is never stated, and no action verbs appear. Adding a capability clause (e.g., what it does with those topics) and a few more synonyms would lift it substantially.

Suggestions

Add an explicit 'what' clause naming the skill's action, e.g., 'Reviews and corrects Swift code for outdated patterns, ownership errors, and platform pitfalls — modern idioms, noncopyable types, drag and drop, debug deep links, tvOS targets.'

Include common synonyms users would say: 'Transferable', 'ownership (~Copyable/borrowing/consuming)', 'ShareLink', and 'Swift 6' alongside the existing topic list.

Mention what happens on invocation (routes to topic-specific reference files) so the description communicates capability, not just trigger conditions.

DimensionReasoningScore

Specificity

The description names the domain ("Swift or its toolchain") and lists concrete topic nouns ("modern idioms, noncopyable types, drag and drop, debug deep links, tvOS targets"), but states no action the skill performs — there is not a single verb describing what it does. This matches anchor 2 ('names the domain but actions are minimal or generic'); not 3 because that anchor requires '1-2 concrete actions', which are absent, and not 1 because the enumerated topics are concrete rather than pure abstraction.

2 / 5

Completeness

The 'when' is explicit and detailed ("Use when the question is about Swift or its toolchain rather than a framework" plus five enumerated triggers), but the 'what' is entirely unstated — the skill's capability or action never appears. Not 4/5 because 'what' is missing, and not 2 because the when-clause is far richer than the vague 'Use when working with documents' anchor example, with the trigger list partially conveying scope.

3 / 5

Trigger Term Quality

Includes natural phrases users would actually say: "Swift", "drag and drop", "tvOS", "debug deep links", "modern idioms". Not 5 because common synonyms are missing (e.g., Transferable, ownership, ShareLink, Swift 6, SwiftUI interop); not 3 because keyword coverage is good and varied, well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

"rather than a framework" explicitly carves out SwiftUI-style questions, giving a clear language-level Swift niche with distinct triggers. Not 5 because "Swift or its toolchain" is broad and overlaps with sibling skills (concurrency, performance, SwiftUI per the body's own conflict section); not 3 because the framework exclusion actively disambiguates the most likely collision.

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

CharlesWiltgen/Axiom

Path

axiom-cursor/skills/axiom-swift/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.