CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-audit-swiftui-layout

Use when the user mentions SwiftUI layout review, adaptive layout issues, GeometryReader problems, or multi-device layout checking.

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

This is a strong, highly executable audit skill: concrete grep patterns with verification steps, a clear five-phase workflow with validation checkpoints, and a copy-paste output template. The main weakness is structure — everything lives in one long SKILL.md with no bundle files, where the 12-pattern detection catalog and cross-reference tables are natural candidates for a one-level-deep references file.

Suggestions

Move the 12 detection patterns into a references/patterns.md (or split by severity) and keep a one-line index of pattern names in SKILL.md, so the main file stays a navigable overview.

Consider moving the Phase 3 completeness table and Phase 4 compound-severity matrix into the same reference file — they are lookup material the auditor consults after scanning, not upfront instructions.

DimensionReasoningScore

Conciseness

The body is dense and assumes SwiftUI competence — pattern entries like "GeometryReader has no intrinsic size, so a stack gives it the space left after fixed-size siblings" convey non-obvious facts in one line. It stays at anchor 4 rather than 5 because the five invocation examples, the 'why it matters' column in Phase 3, and some repeated iOS-26/27 resizing rationale across sections could be trimmed without losing guidance.

4 / 5

Actionability

Every detection pattern ships an exact grep regex (e.g. `\.frame\(width:\s*\d{3,}`, with explicit caveats about what the regex over-matches and how to Read-verify), fixes include copy-paste code (`.containerRelativeFrame(.horizontal) { w, _ in w * 0.5 }`), and the output format is a complete fill-in markdown template with per-issue fields.

5 / 5

Workflow Clarity

Five phases are clearly sequenced with an explicit checkpoint ("Present this map in the output before proceeding") and validation throughout: "use Read to verify the surrounding context before reporting", a dedicated False Positives section, and output limits for large findings. The operation is read-only auditing, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The body is well-sectioned but entirely monolithic — no references/, scripts/, or assets/ bundle files exist, and all 12 detection patterns, the Phase 3/4 tables, and scoring rubric are inlined in one 300+ line file. The only pointers ("axiom-swiftui skills/toolbars.md, skills/iphone-duo.md") target an external skill not in this bundle. This matches anchor 3 ('content that should be separate is inline') — structure is good, but the per-pattern detail could be split into a references file so the main file stays an overview.

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 is a trigger-only sentence: it answers 'when' well with natural, specific trigger phrases, but completely omits 'what' — no capability or action is ever stated. It is distinguishable from sibling skills thanks to the GeometryReader and adaptive-layout triggers, but the missing capability statement makes it under-specified for a user deciding what the skill actually does.

Suggestions

Lead with a third-person capability statement, e.g. 'Audits SwiftUI code for layout anti-patterns — GeometryReader misuse, deprecated screen APIs, hardcoded breakpoints, identity-losing conditional stacks — and scores layout adaptivity across device sizes.' before the 'Use when' clause.

Add natural trigger synonyms users actually say: 'iPad', 'Split View', 'rotation/landscape', 'responsive layout', 'layout breaks on ...'.

State the outcome (a severity-ranked findings report with a Layout Health Score) so the 'what' is concrete rather than implied.

DimensionReasoningScore

Specificity

The description names the domain ("SwiftUI layout review", "adaptive layout issues") but contains no capability statements at all — there is not a single action verb describing what the skill does. It fits anchor 2 ('names the domain but actions are minimal or generic') rather than 1, since the language is domain-specific rather than purely abstract, but cannot score higher because zero actions are listed.

2 / 5

Completeness

This is a pure trigger clause: "Use when the user mentions..." — the 'when' is explicit but the 'what' is entirely absent, matching anchor 2 ('only when is present without what', e.g. "Use when working with documents"). It cannot score 3 because anchor 3 requires a clear 'what' even with a weak 'when'.

2 / 5

Trigger Term Quality

"SwiftUI layout review", "adaptive layout issues", "GeometryReader problems", and "multi-device layout checking" are phrases users would naturally say. It falls short of anchor 5 because common synonyms are missing — users say "iPad", "Split View", "rotation", or "responsive" when describing these problems, and none appear.

4 / 5

Distinctiveness Conflict Risk

"GeometryReader problems" and "adaptive layout issues" are distinct triggers establishing a clear niche. It stays at anchor 4 rather than 5 because "SwiftUI layout review" could catch general SwiftUI code-review requests, and the body itself acknowledges overlap with sibling auditors (resize-auditor, swiftui-performance-analyzer).

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