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

77%

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 ./axiom-codex/skills/axiom-apple-docs/SKILL.md
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.

The body is a well-executed router skill: concrete paths, exact filenames, an unambiguous resolution chain, and explicit fallback and error-reporting behavior. Its only weaknesses are mild redundancy between the decision tree and the catalog tables, and an external reference that is not part of the bundle.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no padding explaining what Xcode or Swift is, and the tables carry real lookup data. Minor trimmable redundancy remains: the Routing Decision Tree largely re-states mappings already given in the guide-file tables, keeping it just below the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is fully executable: a copy-paste Read invocation with the complete path, exact filenames for 20 guides and ~46 diagnostics, an ls command for unlisted diagnostics, and a concrete xcode-select -p / AXIOM_XCODE_PATH resolution chain. The common cases (specific diagnostic, framework feature) are covered with ready-to-run commands.

5 / 5

Workflow Clarity

As a single-task router skill the action is unambiguous: an explicit resolution precedence (session context → AXIOM_XCODE_PATH → xcode-select -p → default install), an ordered fallback list when the docs directory is absent, and explicit recovery steps ("If a diagnostic you need isn't listed above, list the diagnostics directory first") plus "Do not silently fail — tell the user".

5 / 5

Progressive Disclosure

Good structure with well-organized sections and a clearly signaled one-level-deep reference in the Research Methodology section. It falls short of the top anchor because that reference (skills/apple-docs-research.md) is not part of this bundle, and the ~100-line file catalog is inlined in SKILL.md rather than split out — minor organization gaps, not the could-be-better-organized mid anchor.

4 / 5

Total

18

/

20

Passed

Description

57%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 use-when trigger, but it is thin: it never states the skill's concrete capability and uses second-person voice ("you need"), costing it specificity. Trigger coverage is narrow, missing common phrasings like "compiler error" or "Apple docs".

Suggestions

State the capability concretely in third person, e.g., "Reads Apple's for-LLM documentation bundled inside Xcode and explains Swift compiler diagnostics from the compiler's own docs. Use when..." — this fixes both the missing 'what' and the second-person voice.

Broaden trigger terms to include natural variations users actually say: "compiler error", "warning", "Apple docs", "API reference", and named frameworks (SwiftUI, SwiftData, StoreKit).

Consider signaling the two distinct use cases (framework guides vs. compiler diagnostics) as separate trigger phrases so each is independently discoverable.

DimensionReasoningScore

Specificity

The description names its domains ("Apple's own documentation", "Swift compiler diagnostic") and one action ("explained"), matching the anchor that names a domain with minimal actions — it never states what the skill actually does (read Xcode-bundled for-LLM docs). The second-person phrasing "Use when you need" incurs the rubric's 1-point voice penalty, lowering the anchor-3 base to 2.

2 / 5

Completeness

The "when" is explicit ("Use when you need Apple's own documentation or a Swift compiler diagnostic explained"), and a "what" is faintly present via "explained rather than recalled", but the actual capability (reading Apple's bundled Xcode documentation files) is only implied, so it does not reach the fully-explicit-both anchor.

4 / 5

Trigger Term Quality

"Apple's own documentation" and "Swift compiler diagnostic" are terms users would naturally say, but common variations like "compiler error", "warning", "Apple docs", or "API reference" are missing, which matches the some-keywords-missing-synonyms anchor rather than the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

The niche is clear — Apple's own docs and Swift compiler diagnostics — with distinct triggers and only minor overlap risk against closely related skills (e.g., generic web-doc lookup or the sibling apple-docs-research skill referenced in the body), matching the mostly-distinct anchor.

4 / 5

Total

13

/

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

axiom-codex/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.