CtrlK
BlogDocsLog inGet started
Tessl Logo

axiom-audit-swiftui-nav

Use when the user mentions SwiftUI navigation issues, deep linking problems, state restoration bugs, or navigation architecture review.

64

Quality

75%

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

Quality

Content

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

This is a strong, well-engineered audit skill: a clear five-phase workflow with mandatory tool use, explicit grep→Read verification, severity escalation rules, and a health-score rubric. The only real lever is token efficiency — some inline catalogs could be trimmed or externalized.

DimensionReasoningScore

Conciseness

The body is dense and actionable — concrete grep patterns and fix snippets with no padding about what SwiftUI/NavigationStack is — but the ~250 lines have minor redundancy between Phase 2's 10 anti-patterns and Phase 3's completeness questions, keeping it just below the lean level-5 anchor.

4 / 5

Actionability

It gives concrete, runnable Grep patterns (e.g. '.navigationDestination(for:', 'NavigationStack {') and copy-pasteable fix snippets (e.g. '@State private var path = NavigationPath()'); it is not a 5 because several fixes are one-liners without full surrounding context for the common cases.

4 / 5

Workflow Clarity

A clearly sequenced five-phase workflow (Map → Detect → Reason → Cross-Reference → Score) with an explicit validation checkpoint ('For every grep match, use Read to verify the surrounding context before reporting'), a required Phase 1 output map, a Phase 5 scoring rubric, output limits, and a false-positives checklist — matching the level-5 anchor's explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

The body is well-structured into labeled phases/sections with no nested or buried references, and no bundle files exist to misorganize; it is not a 5 because everything is inlined in one ~250-line file with no one-level-deep references deferring the detailed pattern catalog or output templates.

4 / 5

Total

17

/

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.

The description has excellent, natural trigger guidance and a clear niche, but it is 'when'-heavy and weak on the explicit 'what' — it never states the concrete action the skill performs. Adding an explicit capability verb would raise both specificity and completeness.

Suggestions

Lead with an explicit 'what' clause before the triggers, e.g. 'Detects and reports SwiftUI navigation anti-patterns and architecture gaps.'

Add a few technical synonyms users say (NavigationStack, NavigationPath, programmatic navigation, push/pop) to broaden trigger-term coverage.

State the boundary in the description itself (e.g. 'For performance issues, use swiftui-performance-analyzer') to reduce overlap risk with sibling skills.

DimensionReasoningScore

Specificity

The description names the domain ('SwiftUI navigation') and the phrase 'navigation architecture review' implies an action, but it never states a concrete verb for what the skill does (e.g., 'detects', 'audits', 'reports'), matching the anchor that lists the domain with only minimal/generic actions rather than the level-4 anchor's several specific actions.

3 / 5

Completeness

It has an explicit, strong 'when' clause ('Use when the user mentions...') and a present-but-terse 'what' ('navigation architecture review'); the 'what' is not stated as explicitly as the level-5 anchor ('Detects and reports...'), so it sits above the midpoint but not at the top.

4 / 5

Trigger Term Quality

Natural user-facing phrases ('SwiftUI navigation issues', 'deep linking problems', 'state restoration bugs', 'navigation architecture review') give good keyword coverage; it stops short of level 5 because synonyms like 'NavigationStack/NavigationPath' or 'push/pop' that users also say are absent.

4 / 5

Distinctiveness Conflict Risk

SwiftUI navigation is a clear niche with distinct triggers and low conflict risk; it is not a 5 because the description itself does not disambiguate from the sibling swiftui-performance-analyzer (that boundary is only stated in the body), leaving minor overlap risk with related SwiftUI/UX-flow skills.

4 / 5

Total

15

/

20

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.