axiom-apple-docs

Use when ANY question involves Apple framework APIs, Swift compiler errors, or Xcode-bundled documentation. Covers Liquid Glass, Swift 6.2 concurrency, Foundation Models, SwiftData, StoreKit, 32 Swift compiler diagnostics.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

96%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 tight, highly actionable router skill: exact paths, executable examples, and a clear decision tree with a fallback. The main gap is that the bulk filename/diagnostic catalog is inlined rather than split into reference files, and one referenced file is not part of the bundle.

Suggestions

Move the guide-file and diagnostic-filename tables into a separate references/ index file (e.g. references/guide-index.md and references/diagnostics-index.md) so SKILL.md stays a lean overview pointing one level deep.

Confirm skills/apple-docs-research.md exists in the bundle or remove the dangling reference; currently references/ has no files but the body links to sibling skill paths.

Add a one-line note clarifying that the counts (e.g. '20 files', '46 files') are version-bound to a specific Xcode release, since drift could otherwise make the catalog quietly inaccurate.

Dimension	Reasoning	Score
Conciseness	Lean, dense reference catalog of paths, filename tables, and a routing tree that assumes Claude knows the frameworks; no padding explaining what Swift/SwiftUI/SwiftData are, and every token serves routing.	5 / 5
Actionability	Provides exact base paths, a concrete example Read invocation, an explicit `ls` fallback command, numbered fallback steps, and an MCP invocation path — all copy-paste ready and executable.	5 / 5
Workflow Clarity	The routing decision tree gives an unambiguous sequenced procedure with a clear catch-all ('Other -> ls the base directory') and a non-destructive read skill needs no error-recovery loop; fallback handling is explicitly instructed ('Do not silently fail').	5 / 5
Progressive Disclosure	Well-organized with labeled category sections and signaled sibling-skill references, but the large inlined filename/diagnostic catalog could live in separate index files, and skills/apple-docs-research.md is referenced though no bundle directory exists.	4 / 5
	Total	19 / 20 Passed

Description

85%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, specific description with an explicit 'Use when' trigger and a clear, niche-scoped coverage list. Voice is appropriately third person and triggers are natural and distinctive.

Dimension	Reasoning	Score
Specificity	Names concrete covered domains ("Foundation Models", "StoreKit", "32 Swift compiler diagnostics", "Liquid Glass") rather than vague abstractions, though it frames coverage rather than enumerating discrete actions like 'extract/fill/merge'.	4 / 5
Completeness	Explicit 'Use when ANY question involves Apple framework APIs, Swift compiler errors, or Xcode-bundled documentation' provides concrete trigger phrases, and 'Covers Liquid Glass, Swift 6.2 concurrency, Foundation Models...' states the what clearly.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ("Swift compiler errors", "SwiftData", "StoreKit", "Apple framework APIs") with good coverage; missing a few synonyms or file extensions, and 'ANY question' is slightly off natural voice.	4 / 5
Distinctiveness Conflict Risk	Highly specific Apple/Xcode-bundled-documentation niche with distinct triggers (Swift compiler diagnostics, Xcode docs) and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 4ae86a3

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.