CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-accessibility

Use when fixing or auditing ANY accessibility issue — VoiceOver, Dynamic Type, color contrast, touch targets, WCAG compliance, App Store accessibility review.

Quality

76%

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

Quality

Content

67%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 skill that cleanly maps symptoms to reference files and auditor skills with distinct lookup modalities. Its weaknesses are four-fold repetition of the same routing map (table, dot graph, list, examples), an agent-vs-skill routing contradiction between the inline Codex note and the decision tree, and referenced files that are absent from the bundle.

Suggestions

Collapse the redundancy: the dot-graph decision tree and the numbered list restate the Quick Reference table; keep one routing representation and trim Example Invocations to cases that demonstrate a different route.

Resolve the routing contradiction between the inline note ('no Claude Code agent required') and the decision tree/step 7 pointing to the 'accessibility-auditor' agent, so automated-scan requests have a single directive.

Ship the referenced files (skills/accessibility-diag.md, skills/ux-flow-audit.md, skills/watchos-a11y.md) in the skill's bundle or correct their paths, since none currently exist relative to SKILL.md.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows, but the same routing decision is encoded four times: the Quick Reference table, the dot-graph decision tree, the numbered Decision Tree list, and Example Invocations all repeat 'VoiceOver/Dynamic Type/contrast → skills/accessibility-diag.md'. Mostly efficient signal with substantial tightening opportunity (the dot graph and many example invocations add no new routing), matching anchor 3 rather than 2 since there is no padded prose or over-explanation.

3 / 5

Actionability

As an instruction/router skill the guidance is concrete and specific: unambiguous directives ('See skills/accessibility-diag.md', 'axiom-audit-accessibility') and named APIs ('Image(decorative:)', 'accessibilityInputLabels()', 'accessibilityDifferentiateWithoutColor'). Not 5 because no complete executable code or commands are given — the Critical Patterns bullets name APIs without usage examples.

4 / 5

Workflow Clarity

The classification workflow (symptom → reference file / auditor) is a clear, unambiguous single-action process, well suited to a router skill. Not 5 because there is a routing incoherence: the inline Codex note says 'no Claude Code agent required' yet the decision tree and item 7 route to an 'accessibility-auditor' agent, leaving two conflicting directives for the same intent.

4 / 5

Progressive Disclosure

The body is a proper overview with well-signaled, one-level-deep references ('skills/accessibility-diag.md', 'skills/ux-flow-audit.md', 'skills/watchos-a11y.md') and organized sections, matching anchor 4's good structure. Not 5 because none of the referenced files exist in the skill's bundle (no references/, scripts/, or assets/ directories are present), so the signaled navigation cannot be followed — a structural gap beyond 'minor organization issues' implied by anchor 4 but far better organized than anchor 3.

4 / 5

Total

15

/

20

Passed

Description

75%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 strong, trigger-focused description with explicit 'Use when' guidance and a well-chosen enumeration of concrete accessibility topics. Its main weakness is that the 'what' is reduced to two generic verbs (fixing/auditing), leaving the skill's actual mechanics implicit, and some natural synonyms are absent.

Suggestions

Add a brief third-person 'what' clause before the trigger (e.g., 'Routes accessibility diagnosis and auditing to reference guides and auditor skills'), since the current what is only implied by 'fixing or auditing'.

Add natural synonyms users say that are currently missing, such as 'screen reader', 'a11y', 'Section 508', and 'reduce motion', to widen trigger coverage.

DimensionReasoningScore

Specificity

Names the domain and enumerates six concrete sub-areas ('VoiceOver, Dynamic Type, color contrast, touch targets, WCAG compliance, App Store accessibility review'), but the actions themselves are limited to two generic verbs ('fixing or auditing'). Fits anchor 4 (several specific items, minor gaps) rather than 3 (only 1-2 concrete actions) because the enumerated issue types are specific, and not 5 because coverage omits areas the body handles (watchOS, UX dead ends).

4 / 5

Completeness

The 'when' is explicit and specific ('Use when fixing or auditing ANY accessibility issue — VoiceOver...'), and a 'what' is present but terse — 'fixing or auditing' implies the action without stating what the skill concretely does (routing to diagnostic references or audit agents). Both present with one weakly explicit, matching anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Includes natural developer phrases users would actually say ('VoiceOver', 'Dynamic Type', 'color contrast', 'touch targets', 'WCAG compliance'), matching anchor 4's good keyword coverage. Not 5 because common synonyms are missing ('screen reader', 'a11y', 'Section 508', 'reduce motion', 'keyboard navigation').

4 / 5

Distinctiveness Conflict Risk

A clear accessibility niche with distinct triggers (VoiceOver, Dynamic Type, touch targets), mostly distinct from sibling skills. Not 5 because 'ANY accessibility issue' plus 'WCAG compliance' and 'color contrast' could overlap with web-accessibility or design/theming skills; more specific than anchor 3's 'could still overlap with similar skills'.

4 / 5

Total

16

/

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