CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-swiftui

Use when building, fixing, or improving ANY SwiftUI UI — views, navigation, layout, animations, gestures, debugging, iOS 26 features, iPhone Duo, view-level performance, feature architecture.

Quality

72%

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-codex/skills/axiom-swiftui/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured router body that assumes Claude's competence, routes every symptom to a concrete one-level-deep reference, and anticipates skip-behavior with a thoughtful Anti-Rationalization table. Its main costs are the fully duplicated routing in the dot Decision Tree and unverifiable `skills/` reference paths. Fix procedures and validation loops correctly live in the referenced files.

Suggestions

Delete the dot Decision Tree (or the Quick Reference table) — both encode the same symptom→reference mapping, and one format covers the routing need at roughly half the tokens.

Trim long parenthetical rows (navigationSubtitle placements, the Liquid Glass and TextKit scan descriptions) by moving that detail into the referenced files they point to.

Ship the `skills/*.md` files inside the bundle (or under `references/`) so the one-level-deep references resolve, and confirm cross-suite targets (axiom-uikit, axiom-design, axiom-macos, axiom-swift) are installed dependencies.

DimensionReasoningScore

Conciseness

Mostly efficient — no over-explanation of concepts Claude already knows, and pointers are dense — but the ~28-line dot 'Decision Tree' repeats the same symptom→reference mapping already given in the 32-row 'Quick Reference' table, and verbose rows (the iOS 26 'navigationSubtitle' entry, the long Liquid Glass/TextKit scan parentheticals) could be tightened. It is not 4 because the duplication is an entire redundant section rather than minor trim instances.

3 / 5

Actionability

Routing guidance is concrete and executable: every symptom maps to an exact path ("See `skills/debugging.md`"), with concrete fallback logic ("if `command -v <tool>` finds nothing ... use `<plugin-root>/tools/<tool>`") and a sequenced escalation rule ("Try axiom-swiftui FIRST ... Only use axiom-performance if domain fixes don't help"). Not 5 because the actual fix procedures live in the referenced files rather than here, and placeholder resolution ("two levels above this skill's Base directory") needs interpretation.

4 / 5

Workflow Clarity

The diagnosis workflow is clearly sequenced — symptom lookup → reference, conflict-resolution ordering (1. try domain fixes, 2. escalate), and escalation checkpoints like "View update still broken after debugging → `skills/debugging-diag.md`". Not 5 because explicit post-fix validation steps are deferred to the referenced files; not 3 because sequencing and error-recovery escalation are both present.

4 / 5

Progressive Disclosure

Exemplary router structure: the 'Quick Reference' table and 'Non-SwiftUI UI Routes' section point one level deep to clearly signaled `skills/*.md` targets organized by symptom. Not 5 because no bundle files are provided to verify the `skills/*.md` targets and cross-suite references (axiom-uikit, axiom-design, axiom-macos, axiom-swift) actually exist — the nonstandard `skills/` path is unverifiable in the provided bundle, leaving minor navigation risk.

4 / 5

Total

15

/

20

Passed

Description

66%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 strong trigger-oriented description with explicit 'Use when' guidance and a specific, well-enumerated SwiftUI scope. Its main weakness is the missing explicit 'what' capability statement — the description tells Claude when to load the skill but not what it contains or does. A few natural trigger synonyms (Swift files, state, previews) are also absent.

Suggestions

Add an explicit capability statement before the trigger clause, e.g. 'Provides SwiftUI debugging, navigation, layout, and architecture guidance with symptom-to-reference routing.' so both 'what' and 'when' are answered.

Include natural trigger variations users actually say: 'Swift files', 'SwiftUI views not updating', 'state', 'previews', 'sheets/popovers'.

DimensionReasoningScore

Specificity

"building, fixing, or improving ANY SwiftUI UI" pairs generic verbs with a concrete enumerated scope ("views, navigation, layout, animations, gestures, debugging, iOS 26 features, iPhone Duo, view-level performance, feature architecture"). Several specific areas are named with only minor gaps, but the verbs themselves are broad synonyms rather than distinct concrete actions, which keeps it below the comprehensive anchor 5.

4 / 5

Completeness

The 'when' is explicit and strong ("Use when building, fixing, or improving ANY SwiftUI UI"), but there is no explicit 'what' statement — the skill's capability is only implied by the topic enumeration, not stated as an action the skill performs. It is not 4 because that anchor requires both 'what' and 'when' present, and not 2 because the enumerated scope conveys far more than a bare 'Use when working with documents'.

3 / 5

Trigger Term Quality

Natural terms users would say are well covered ("SwiftUI", "navigation", "layout", "animations", "debugging", "gestures", "architecture"), and niche-but-real triggers like "iPhone Duo" and "iOS 26 features" are present. Common variations such as "Swift files", "state", "previews", or "sheets/popovers" are missing, so coverage stops short of the comprehensive-with-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

"SwiftUI UI" plus distinctive markers ("iPhone Duo", "iOS 26 features") carves a clear niche with distinct triggers. However "view-level performance" and "feature architecture" sit close to sibling performance/architecture skills — the body even needs a dedicated Conflict Resolution section — which is exactly anchor 4's 'minor overlap risk with closely related skills', not the minimal-conflict anchor 5.

4 / 5

Total

15

/

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

axiom-codex/skills/axiom-swiftui/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.