CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-apple-docs

Use when you need Apple's own documentation or a Swift compiler diagnostic explained rather than recalled.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude-plugin/plugins/axiom/skills/axiom-apple-docs/SKILL.md

The canonical home for this skill is axiom-apple-docs in CharlesWiltgen/Axiom

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 router skill: fully executable paths and commands, a clear decision flow with explicit fallbacks and failure reporting, and lean lookup tables that assume Claude's competence. The only real gaps are the redundant decision tree (duplicating the tables) and a referenced file (skills/apple-docs-research.md) that is missing from the bundle.

DimensionReasoningScore

Conciseness

The body is dense lookup content — literal base directories, topic-to-filename tables, and terse instructions like '20 files. Read with the path pattern {guides base}/{filename}' — with no padding or explanations of concepts Claude already knows. It is not a 5 because the Routing Decision Tree largely duplicates the topic-to-filename mapping already provided by the categorized tables, and full directory paths are repeated where a shorter pattern would do.

4 / 5

Actionability

Guidance is fully executable: exact base directories, a copy-paste example Read invocation, a concrete ls fallback for unlisted diagnostics, and a prioritized path-resolution cascade (session context, AXIOM_XCODE_PATH, xcode-select -p, default /Applications/Xcode.app) covering the common cases. This matches the copy-paste-ready anchor with common cases covered.

5 / 5

Workflow Clarity

The routing decision tree and the ordered path-resolution fallbacks form a clear, unambiguous sequence with explicit error-recovery branches: 'If it prints /Library/Developer/CommandLineTools, no Xcode is selected; try /Applications/Xcode.app', 'If a diagnostic you need isn't listed above, list the diagnostics directory first', and 'Do not silently fail — tell the user... which fallback you used'. The skill is read-only, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

Sections are well organized with clearly signaled one-level-deep references ('see skills/apple-docs-research.md' for research beyond the bundled guides), and the routing index appropriately lives in SKILL.md so no extra file load is needed to route. It is not a 5 because the referenced skills/apple-docs-research.md is not present in the bundle (no references/, scripts/, assets/, or skills/ directories exist), leaving a dangling reference; it is above 3 because the structure and in-file navigation are otherwise clean.

4 / 5

Total

18

/

20

Passed

Description

62%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 a clear, distinctive niche and an explicit trigger clause, but it undersells the skill's concrete capability and omits many natural trigger keywords. Stating the what explicitly (reading Apple's bundled for-LLM docs) and adding common terms like Xcode, WWDC, or API reference would lift it substantially.

Suggestions

State the 'what' explicitly as a concrete action, e.g., 'Reads Apple's for-LLM documentation bundled in Xcode to give authoritative API details and Swift compiler diagnostic explanations. Use when you need Apple's own documentation or a Swift compiler diagnostic explained rather than recalled.'

Add natural trigger keywords users would say: 'Xcode docs', 'WWDC session content', 'Apple API reference', 'Swift error/warning', 'Apple framework' — these currently appear only in the body, not the description.

Disambiguate from sibling Axiom framework skills in the description itself (e.g., 'for authoritative Apple API details' vs. opinionated Axiom guidance), since the description is the only text used for skill routing.

DimensionReasoningScore

Specificity

The description names two concrete domains ("Apple's own documentation", "Swift compiler diagnostic") with one concrete action ("explained rather than recalled"), which matches the anchor for naming a domain and 1-2 concrete actions without comprehensive coverage. It falls short of 4 because it does not list several distinct actions, and above 2 because the action is specific rather than generic.

3 / 5

Completeness

An explicit 'Use when you need...' trigger answers 'when', and 'explained rather than recalled' implies the what (explaining from Apple's authoritative source), but the what is embedded rather than stated as a concrete capability (e.g., 'Reads Apple's for-LLM documentation bundled in Xcode'). This sits between the clear-but-implicit-what anchor and the fully-explicit-both anchor, matching 4.

4 / 5

Trigger Term Quality

"Apple's own documentation" and "Swift compiler diagnostic" are natural phrases users would say, but common variations and synonyms are missing (e.g., Xcode, WWDC, API reference, Apple framework, Swift error/warning). This matches the 'some relevant keywords but missing common variations or synonyms' anchor rather than the good-coverage anchor at 4.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and the 'Apple's own' / 'rather than recalled' framing distinguishes it from memory-based answers, but sibling Axiom skills (axiom-swiftui, axiom-concurrency, etc.) also target Apple-framework questions, creating minor overlap risk. Mostly distinct with minor overlap matches 4 rather than the minimal-conflict anchor at 5.

4 / 5

Total

14

/

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

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

CharlesWiltgen/Axiom

Path

.claude-plugin/plugins/axiom/skills/axiom-apple-docs/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.