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

70%

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-cursor/skills/axiom-apple-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable router: exact paths, copy-paste commands, a deterministic resolution procedure with fallbacks, and a clear decision tree. Its weaknesses are token bulk — a near-complete diagnostics catalog duplicating `ls`-discoverable data plus filename repetition between tables and the decision tree — and a sole external reference (skills/apple-docs-research.md) that is not resolvable within the bundle.

Suggestions

Trim the diagnostics tables to the most common entries and lean on the existing `ls` fallback, or move the full catalog to a bundled references/diagnostics-index.md so SKILL.md stays an overview.

De-duplicate the routing decision tree, which repeats guide filenames already listed in the tables — keep one authoritative listing.

Fix the dangling skills/apple-docs-research.md references: either include the file in the bundle or state where it lives relative to this skill.

DimensionReasoningScore

Conciseness

Prose is lean and assumes Claude's competence, but the body carries substantial trimmable bulk: ~50 diagnostics table rows that the skill itself admits are incomplete ("ships more files than are listed here") and discoverable via the included `ls` command, plus a routing decision tree that repeats guide filenames already tabulated above. That is more than anchor 4's 'minor instances', fitting anchor 3's 'could be tightened'.

3 / 5

Actionability

Guidance is fully executable: exact base directories, a copy-paste example ("Read /Applications/Xcode.app/.../SwiftUI-Implementing-Liquid-Glass-Design.md"), a concrete `ls` command, explicit filename-to-topic tables, and a deterministic path-resolution procedure (session context → AXIOM_XCODE_PATH → `xcode-select -p` → default). Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The path-resolution sequence is clearly ordered with explicit conditional checkpoints ("If it prints /Library/Developer/CommandLineTools, no Xcode is selected") and an error-recovery fallback chain ending in "Do not silently fail — tell the user", matching anchor 4. It falls short of anchor 5 only because there is no explicit check that a specific guide/diagnostic file exists before reading it — the ls fallback appears only in the diagnostics section's tail and the tree's 'Other' branch.

4 / 5

Progressive Disclosure

The bundle contains no references/, scripts/, or assets/, and the body's only cross-references point to "skills/apple-docs-research.md", which does not exist in the bundle — a dangling reference. Meanwhile ~50 rows of diagnostics catalog are inlined in SKILL.md where the rubric expects an overview pointing to a separate index file, fitting anchor 3 ('content that should be separate is inline; references present but not clearly signaled') rather than anchor 4's 'most content appropriately placed'.

3 / 5

Total

15

/

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.

A concise, explicit trigger with a distinctive niche, but it describes almost no concrete capability — one generic verb ("explained") over a named domain — and leans on the technical term "diagnostic" where users would say "error" or "warning". Both the what and when are present, just compressed into a single clause.

Suggestions

State at least one concrete action, e.g. "Reads Apple's for-LLM documentation guides bundled in Xcode and explains Swift compiler diagnostics from their official docs" instead of the single generic verb "explained".

Add natural synonyms users would actually say: "Swift compiler error or warning", "Apple docs", "Xcode documentation".

Keep the distinctive "rather than recalled" framing but pair it with a short standalone what-clause so the capability reads as explicit rather than implied.

DimensionReasoningScore

Specificity

The description names its domain ("Apple's own documentation or a Swift compiler diagnostic") but offers only one generic action verb — "explained" — matching the anchor 'Names the domain but actions are minimal or generic' (cf. "Processes PDF files"). The qualifier "rather than recalled" sharpens intent without adding a concrete capability, so it does not reach anchor 3's '1-2 concrete actions'.

2 / 5

Completeness

The explicit "Use when..." clause satisfies the trigger requirement, and the 'what' — needing Apple's documentation or a diagnostic "explained rather than recalled" — is stated within the same sentence, so both are present. It is not anchor 5 because the 'what' is not stated as a standalone capability with concrete trigger phrases, and not anchor 3 because the 'when' is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

"Apple's own documentation" and "Swift compiler diagnostic" are relevant keywords, but common natural phrasings are missing: users say "compiler error" or "warning" far more than "diagnostic", and "Xcode docs", "Apple docs", or "API reference" are absent. This fits anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

"Apple's own documentation" and "Swift compiler diagnostic explained rather than recalled" carve a clear niche with distinct triggers, and the "rather than recalled" qualifier separates it from generic Apple/Swift Q&A skills. Minor overlap risk remains with sibling skills like the referenced apple-docs-research skill, keeping it below anchor 5's minimal conflict risk.

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