CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-uikit

Use when bridging UIKit and SwiftUI, modernizing UIKit apps (scene lifecycle, resizability), debugging Auto Layout, Combine, TextKit, PencilKit, or UIKit animations.

Quality

71%

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

Quality

Content

63%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 with concrete symptom-to-reference routing, explicit conflict-resolution rules, and a useful anti-rationalization table. Its two real defects are redundancy (the same routing table is presented four ways) and that none of the referenced bundle files ship with the skill, leaving the progressive-disclosure pointers dangling.

Suggestions

Collapse the four parallel routing representations (Quick Reference table, dot digraph, numbered Decision Tree, Example Invocations) into the table plus one numbered decision list; the dot graph and Example Invocations add no routing information the table doesn't already carry.

Ship or fix the referenced bundle files — 'skills/uikit-bridging.md', 'skills/adaptive-layout.md', and the other ~13 'skills/*.md' targets plus 'axiom-audit-resize' do not exist relative to SKILL.md, so every pointer is currently dangling.

Correct the self-duplicate pointer in Example Invocations ('axiom-audit-resize (or axiom-audit-resize)') and make external cross-skill references like '/skill axiom-swiftui' and 'axiom-performance' consistently formatted.

DimensionReasoningScore

Conciseness

The body contains no concept explanations and every line routes somewhere, but the same symptom-to-file mapping is repeated four times across the Quick Reference table, the dot digraph, the numbered Decision Tree, and Example Invocations. That is noticeable redundancy that could be cut roughly in half, matching 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the lean anchor 5.

3 / 5

Actionability

As an instruction-only router, the guidance is concrete and directly executable: exact symptom strings and API names map to exact file paths, and Conflict Resolution gives explicit precedence rules ('Try uikit FIRST', 'Only use performance if...'). It falls short of fully executable because pointers like 'skills/uikit-bridging.md' and 'axiom-audit-resize' do not resolve anywhere in this bundle, and line 149 reads 'axiom-audit-resize (or axiom-audit-resize)', a literal self-duplicate.

4 / 5

Workflow Clarity

The routing workflow is clearly sequenced: a prioritized numbered decision tree (0/0b/0c, 1, 2, 2b...) with an explicit catch-all for pure-SwiftUI questions, plus conflict-resolution ordering rules. No validation checkpoints apply (no destructive or batch operations), so this sits at anchor 4 — clear sequence, minor gaps such as three parallel routing representations that a reader must reconcile.

4 / 5

Progressive Disclosure

The design is textbook router structure — a symptom table, a decision tree, and well-signaled one-level-deep references — but the actual bundle contains no files at all: none of the ~15 referenced 'skills/*.md' paths (nor an 'axiom-audit-resize' target) exist alongside SKILL.md, so the disclosure chain cannot be followed or verified from the skill directory.

3 / 5

Total

14

/

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 tight, trigger-focused description with excellent natural domain keywords and a clear UIKit niche. Its main weakness is that it never states what the skill actually provides, relying entirely on the 'Use when' clause to imply its capabilities.

Suggestions

Add a leading 'what' clause, e.g., 'Provides reference guides and debugging recipes for bridging UIKit and SwiftUI, ... Use when ...', so the description answers both what and when.

Include the API-level synonyms users actually type when they need this skill: 'UIViewRepresentable', 'UIViewControllerRepresentable', 'UIHostingController', 'Unable to simultaneously satisfy constraints'.

DimensionReasoningScore

Specificity

The description enumerates several concrete task areas — 'bridging UIKit and SwiftUI', 'modernizing UIKit apps (scene lifecycle, resizability)', 'debugging Auto Layout, Combine, TextKit, PencilKit, or UIKit animations' — which are specific and domain-grounded, matching the 'lists several specific actions; minor gaps in coverage' anchor. It falls short of 5 because it names task areas rather than stating concrete capabilities of the skill itself.

4 / 5

Completeness

The 'when' is explicit and strong ('Use when bridging... debugging...') but the 'what' is never stated — the description is entirely a trigger clause with the skill's actual capability (reference guides and debugging recipes) only implied by the topic enumeration. This sits between anchor 2 ('only when present without what') and anchor 4 (both present), landing on 3.

3 / 5

Trigger Term Quality

'UIKit', 'SwiftUI', 'Auto Layout', 'Combine', 'TextKit', 'PencilKit', 'scene lifecycle', 'resizability', 'animations' are the natural terms iOS developers would say, giving good keyword coverage. Not 5 because a few common user phrases are missing (e.g., 'UIViewRepresentable', 'UIHostingController', 'Unable to simultaneously satisfy constraints').

4 / 5

Distinctiveness Conflict Risk

The UIKit-vs-SwiftUI niche is clear and the scope is well-bounded ('bridging', 'UIKit apps', 'UIKit animations'), but 'Combine' and 'PencilKit' standing alone could pull in pure concurrency or drawing questions that belong to sibling skills — the body itself needs a Conflict Resolution section for exactly these overlaps, confirming minor overlap risk with closely related skills (anchor 4).

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