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

77%

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

Quality

Content

75%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/index skill: every symptom routes to a concrete file, agent, or command, with clear escalation and conflict-resolution procedures. Its weaknesses are presentational redundancy (the routing table is duplicated as a dot decision tree) and reference targets that are not resolvable within the skill's own bundle directory.

Suggestions

Drop one of the two routing mechanisms — the 'dot' Decision Tree duplicates ~20 rows of the Quick Reference table — or move the generated tree into a referenced file, keeping a single canonical index in SKILL.md.

Trim the Anti-Rationalization table's detailed technical caveats (e.g. the Xcode 27 '@State' row's private/deployment-target conditions and TN311 breaks) to one-line pointers into skills/architecture.md, keeping only the myth and the reference.

Make the `skills/*.md` reference targets resolvable from the skill's own bundle (e.g. place them under references/ or state the plugin-root-relative resolution rule once at the top) so the index can be verified and navigated standalone.

DimensionReasoningScore

Conciseness

The body is a dense router that mostly avoids explaining known concepts, but it could be tightened: the 'dot' Decision Tree duplicates roughly 20 rows of the Quick Reference table in a second format, and Anti-Rationalization rows embed detailed technical caveats (e.g. the Xcode 27 '@State is lazy' row's private/deployment-target gating and TN3211 references) that belong in the referenced files. This fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4's 'minor instances'.

3 / 5

Actionability

As an instruction/router skill, every entry gives a concrete, executable destination: named files ('See `skills/nav.md`'), named agents ('Launch `swiftui-nav-auditor` agent'), or copy-paste commands ('/axiom:audit swiftui-performance', '/skill axiom-accessibility'). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Routing is unambiguous via the symptom-to-reference table, with explicit escalation paths ('View update still broken after debugging → `skills/debugging-diag.md`') and an ordered conflict-resolution procedure with a check-before-escalate condition ('Only use axiom-performance if domain fixes don't help'). Minor gaps — not every table row has an escalation path and no guidance for multiple co-occurring symptoms — keep it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-sectioned index (Quick Reference, Non-SwiftUI Routes, Conflict Resolution, Decision Tree, Automated Scanning, Anti-Rationalization) with clearly signaled one-level references ('See `skills/layout.md`') and explicit out-of-scope routing to sibling suites. However, the `skills/*.md` targets do not exist within this skill's bundle (no references/ or skills/ directory alongside SKILL.md), so the split cannot be verified against actual files — anchor 4 ('good structure, minor organization gaps') rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Description

70%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 trigger-focused description with an excellent explicit 'Use when' clause and a clearly distinct SwiftUI niche, but it never states what the skill provides, leaving the capability side implicit. Keyword coverage is good yet omits high-frequency natural terms like 'previews' despite previews being a major covered topic.

Suggestions

Prepend a short 'what' statement before the trigger clause, e.g. 'SwiftUI reference and troubleshooting router covering views, navigation, layout, previews, and iOS 26 APIs. Use when...' so the description answers both what and when.

Add missing natural trigger keywords, especially 'previews' / '#Preview' / 'Xcode previews' (a major covered topic), and consider 'sheets', 'toolbars', and 'state management' as additional user phrasings.

Keep the specific version-anchored terms (iOS 26, iPhone Duo) but pair them with version-neutral synonyms ('latest iOS', 'foldable iPhone') so the description still triggers once those versions age.

DimensionReasoningScore

Specificity

The description enumerates comprehensive, concrete scope ("views, navigation, layout, animations, gestures, debugging, iOS 26 features, iPhone Duo, view-level performance, feature architecture") but the action verbs ("building, fixing, or improving") are generic. It lists several specific coverage areas with minor gaps, matching anchor 4 rather than anchor 5's fully concrete action list, and well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'when' is maximally explicit ("Use when building, fixing, or improving ANY SwiftUI UI") but the 'what' is only weakly implied: nothing states what the skill actually provides (reference material, troubleshooting, routing). This matches anchor 3 (capability implied rather than stated) — not anchor 4, which requires both 'what' and 'when' present, and not anchor 2, since the enumerated scope does convey substantial capability information.

3 / 5

Trigger Term Quality

Strong natural keyword coverage ("SwiftUI", "navigation", "animations", "gestures", "debugging", "layout") that users would actually say. However, "previews" — a major body topic with two dedicated reference files (skills/previews.md, skills/previews-ref.md) and a natural user trigger — is missing, so it falls short of anchor 5's comprehensive coverage including synonyms.

4 / 5

Distinctiveness Conflict Risk

"SwiftUI" is a clear, distinct niche, and "view-level performance" explicitly scopes the performance overlap away from a general profiling skill. Conflict risk with sibling suites (UIKit, design) is minimal because their trigger terms are absent; this matches anchor 5's clear niche with distinct triggers.

5 / 5

Total

16

/

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