CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-audit-swiftui-architecture

Use when the user mentions SwiftUI architecture review, separation of concerns, testability issues, or "logic in view" problems.

Quality

73%

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

Quality

Content

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

An exceptionally actionable, well-sequenced auditor prompt with expert-level domain specifics and strong verification loops throughout. Its weaknesses are redundancy (duplicated scope and related-auditor content) and a fully monolithic structure with no progressive disclosure despite being long enough to benefit from splitting into reference files.

Suggestions

Move the detailed anti-pattern catalog, cross-reference tables, and output-format template into one-level-deep reference files (e.g. references/anti-patterns.md, references/output-format.md) and keep SKILL.md as the phased overview.

Consolidate the duplicated Scope (opening paragraph vs trailing '## Scope' section) and merge '## Related' with the Phase 4 cross-auditor notes to remove redundancy.

Trim the four invocation examples to one or two — they all demonstrate the same launch behavior.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, high-value specifics (e.g. the Xcode 27 @State deferred-initial-value behavior, '@Bindable on a struct does not compile', the withAnimation/await compile-error note) and avoids explaining basics. Not 5 because of clear redundancy: Scope is stated twice (opening paragraph and trailing section), the Related section repeats the cross-auditor notes from Phase 4, and four invocation examples say the same thing.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: literal grep patterns per category, an explicit read-to-verify requirement for every match, concrete fix targets with alternatives ('@Binding var item', '@Bindable var model'), a false-positive exclusion list, and a complete output template. Every detection category names its search, issue, and specific fix.

5 / 5

Workflow Clarity

Five phases are explicitly sequenced with checkpoints: 'use Read to verify the surrounding context before reporting' forms a grep→verify feedback loop, 'Present this map in the output before proceeding' gates Phase 2 on Phase 1 output, and Phase 3 requires evidence from the map ('don't speculate without reading the code'). Output limits handle the high-volume case.

5 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but it is a ~240-line monolith with no bundle files — the anti-pattern catalog detail, the Phase 3/4 cross-reference tables, the health-score template, and the invocation examples are all inlined content that could live in one-level-deep reference files. This matches 'some structure but... content that should be separate is inline'; not 4 because no references exist at all to offload the bulk.

3 / 5

Total

17

/

20

Passed

Description

47%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 works well as a trigger clause with several natural, specific phrases, but it completely omits the 'what' — the skill's concrete capabilities are never stated. Adding a capability sentence before the trigger clause would lift both completeness and specificity substantially.

Suggestions

Add a 'what' clause naming concrete actions, e.g. 'Detects logic-in-view, async boundary violations, @State misuse, and testability gaps in SwiftUI code, and produces an architecture health score. Use when...'.

Include additional natural trigger terms users would say, such as 'MVVM', 'view models', 'state management', or '@State misuse'.

State the boundary against sibling skills inline (e.g. 'for performance issues use swiftui-performance-analyzer') to reduce overlap risk with generic review skills.

DimensionReasoningScore

Specificity

The description names the domain ("SwiftUI architecture review, separation of concerns, testability issues") but lists no concrete actions — it says when to trigger, never what the skill actually does. This matches the anchor 'Names the domain but actions are minimal or generic'; it is below 3 because no 1-2 concrete actions are stated at all.

2 / 5

Completeness

The description is entirely a 'Use when...' trigger clause — 'only when is present without what' — with no statement of what the skill does (detects anti-patterns, produces an architecture health score, etc.). It is not 1 because the 'when' itself is concrete and multi-trigger, and not 3 because a clear 'what' is entirely absent rather than weakly implied.

2 / 5

Trigger Term Quality

Natural phrases users would say are present ("SwiftUI architecture review", "separation of concerns", "testability issues", the quoted "logic in view"), giving good keyword coverage. Not 5 because common variations users actually use are missing — e.g. "MVVM", "view models", "state management", "@State".

4 / 5

Distinctiveness Conflict Risk

The SwiftUI-architecture niche is clear and the quoted "logic in view" phrase is a distinctive trigger, so conflict risk is low. Not 5 because generic phrases like "architecture review" and "testability issues" overlap with general code-review and refactoring skills, and the description does not state the boundary against performance or navigation audits.

4 / 5

Total

12

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

CharlesWiltgen/Axiom

Path

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