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

70%

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 ./.claude-plugin/plugins/axiom/skills/axiom-swift/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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 well-designed router body: unambiguous routing with explicit conflict resolution and no padding with known concepts. Its critical flaw is that every referenced skills/*.md file is missing from the bundle, so the skill cannot deliver its referenced content; secondary flaws are a duplicated decision tree and repeated routing tables.

Suggestions

Ship the referenced files (`skills/swift-modern.md`, `skills/ownership-conventions.md`, `skills/transferable-ref.md`, `skills/deep-link-debugging.md`, `skills/tvos.md`, `skills/swift-simplifier.md`) inside the bundle so the routing targets resolve.

Drop either the dot-graph decision tree or the numbered list — they duplicate each other line for line — to cut tokens without losing lookup ability.

Consolidate the Quick Reference table and Example Invocations into one routing section; the same five mappings appear in both.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and is mostly pointers, but the same routing information is restated four times (Quick Reference table, dot graph, numbered decision tree, Example Invocations), and the dot graph exactly duplicates the numbered list. Mostly efficient, but noticeably could be tightened.

3 / 5

Actionability

Routing guidance is concrete and executable — exact file pointers per situation ("Read: `skills/transferable-ref.md`"), a concrete agent command ("`/axiom:audit swift-simplify`"), and 12 worked user-to-reference examples. Minor gaps: the agent fallback path ('search Axiom's skills for `skills/<agent>.md`') is a search instruction rather than an exact path.

4 / 5

Workflow Clarity

This is a single-purpose router skill and the single action — route to the correct reference file — is unambiguous, supported by three lookup mechanisms (table, decision tree, examples) plus explicit conflict-resolution rules for edge cases. The simple-skill exception applies; no destructive or batch operations require validation checkpoints.

5 / 5

Progressive Disclosure

References are clearly signaled and one level deep by design, but none of the six referenced files (`skills/swift-modern.md`, `skills/ownership-conventions.md`, `skills/transferable-ref.md`, `skills/deep-link-debugging.md`, `skills/tvos.md`, `skills/swift-simplifier.md`) exist in the bundle — no references/, scripts/, or assets/ directories are present. Navigation fails at the first hop as bundled, matching anchor 2 rather than 3 (the problem is existence, not signaling).

2 / 5

Total

14

/

20

Passed

Description

61%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 concise, well-bounded trigger description with natural keywords and an explicit boundary against framework skills. Its main weakness is the missing 'what' — it never states what the skill does with these topics, leaving the capability side implied.

Suggestions

Add a brief action clause stating what the skill does, e.g., 'Reviews and corrects Swift language usage... Use when the question is about Swift or its toolchain rather than a framework'.

Include a few more natural synonyms in the trigger list, such as 'ownership', 'borrowing/consuming', and 'Transferable', which users ask about by those names.

DimensionReasoningScore

Specificity

The description names the domain ("Swift or its toolchain") and lists concrete topic areas ("modern idioms, noncopyable types, drag and drop, debug deep links, tvOS targets"), but contains no action verbs describing what the skill actually does, so coverage of capabilities is incomplete rather than comprehensive.

3 / 5

Completeness

The 'when' is explicit and well-bounded ("Use when the question is about Swift or its toolchain rather than a framework"), but the 'what' is only weakly implied by the trailing topic list — no action statement tells what the skill does. This sits above anchor 2 (the topic list does convey scope) but below anchor 4 (no clear 'what').

3 / 5

Trigger Term Quality

Natural user-facing terms like "Swift", "toolchain", "noncopyable types", "drag and drop", "debug deep links", and "tvOS" give good keyword coverage, though common synonyms users would say (e.g., "ownership", "borrowing", "Transferable") are absent.

4 / 5

Distinctiveness Conflict Risk

The explicit boundary "rather than a framework" cleanly separates this from framework/SwiftUI skills, and the niche triggers are distinct. Minor overlap risk remains for drag-and-drop and deep-links topics that users might route to a swiftui or integration skill.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

CharlesWiltgen/Axiom

Path

.claude-plugin/plugins/axiom/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.