CtrlK
BlogDocsLog inGet started
Tessl Logo

axiom-audit-ux-flow

Use when the user mentions UX flow issues, dead-end views, dismiss traps, missing empty states, broken user journeys, or wants a UX audit of their iOS app.

59

Quality

67%

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-audit-ux-flow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-sequenced, verification-driven auditor prompt with concrete detection patterns and clear phases, but it is monolithic (no reference files) and its fix guidance stays abstract, which caps actionability and progressive disclosure at 2.

Suggestions

Move the 11 detection categories (or the output-format template) into a references file and keep SKILL.md as a concise overview pointing to it, improving progressive disclosure.

Upgrade the per-category "Fix" entries from one-line guidance to a short executable SwiftUI/UIKit snippet so the skill is copy-paste actionable, not just diagnostic.

Trim the duplicated rating/output tables (Phase 5 health score vs. Enhanced Rating Table) to reduce token cost without losing the audit structure.

DimensionReasoningScore

Conciseness

The body is dense and mostly load-bearing (concrete grep patterns, defect categories, severity tables) without explaining known concepts, but the full output-format template and dual rating tables add length that could be trimmed without losing clarity.

2 / 3

Actionability

Detection guidance is concrete — exact grep strings like "NavigationStack", ".fullScreenCover" and explicit search steps — but the per-category "Fix" lines are one-line abstract guidance ("Add dismiss button or cancel action") rather than executable code.

2 / 3

Workflow Clarity

A clear five-phase sequence (map → detect → reason → cross-reference → score) with explicit verification checkpoints ("use Read to verify the surrounding context before reporting", "Require evidence from the Phase 1 map — don't speculate") and a false-positive list as a feedback guard.

3 / 3

Progressive Disclosure

There are no bundle files and the entire skill — all 11 detection categories, four phase tables, and the output template — lives inline in one ~250-line SKILL.md; sections are well-organized but content that could be split into a reference file is monolithic.

2 / 3

Total

9

/

12

Passed

Description

72%

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-rich description with strong natural keywords and a clear niche, but it is almost entirely a "Use when…" clause; the concrete capability is implied rather than explicitly stated, capping completeness and specificity at 2.

Suggestions

Lead with an explicit third-person capability statement before the trigger clause, e.g. "Detects user-journey defects (dead-ends, dismiss traps, missing states) in iOS apps."

Keep the strong "Use when…" triggers but pair them with the named actions the skill performs (detect, verify, score, report) so "what" and "when" are both explicit.

DimensionReasoningScore

Specificity

The description names the domain ("UX audit of their iOS app") and specific defect types ("dead-end views, dismiss traps, missing empty states"), but it never states a concrete capability verb; the action is only implied via the trigger "wants a UX audit" rather than an explicit "Detects/audits…" statement.

2 / 3

Completeness

The "when" is explicit ("Use when the user mentions…"), but the "what does this do" is only implied through the trigger clause rather than stated as a distinct capability, so it does not clearly answer both.

2 / 3

Trigger Term Quality

It lists natural terms a user would say — "UX flow issues", "broken user journeys", "UX audit" — alongside specific defect phrasings, giving good coverage of likely user phrasings.

3 / 3

Distinctiveness Conflict Risk

It carves a clear niche — iOS user-journey/UX-flow auditing — with distinctive triggers ("dismiss traps", "dead-end views") that are unlikely to fire for unrelated skills.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
CharlesWiltgen/Axiom
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.