CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-ai

Use when implementing, testing, or evaluating ANY Apple Intelligence, on-device AI, or speech-to-text feature. Covers Foundation Models, @Generable, LanguageModelSession, Tool protocol, eval suites, model-as-judge scoring, SpeechTranscriber, CoreML.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

An information-dense, highly actionable router with excellent trigger-to-file mapping and one-level-deep reference signaling. Its main cost is token efficiency: the same routing decisions are repeated across Triage, Decision Tree, Critical Patterns, and Example Invocations sections, inflating the body by roughly a third.

Suggestions

Collapse the 'Critical Patterns' and 'Decision Tree' sections into the 'AI Approach Triage' table — they restate the same routes and cost ~30 lines each time they repeat.

State the Opus 4.7 Messages API migration warning (temperature/top_p/top_k/prefill removal) once, in 'External Resources', and drop the near-identical repeats in 'Anti-Rationalization' and the description of `claude-api` routing.

Move the adapter failure-mode symbol lists (compatibleAdapterNotFound, invalidAdapterName, etc.) out of the router body and into the referenced `skills/foundation-models-adapters-diag.md`, keeping only the routing cue in SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious version-specific facts (e.g., "runtime obsoleted in 27.0", "Apple's own sample judge starts at Cohen's kappa −0.037") and pads nothing with concepts Claude already knows, but routing decisions are restated across four sections (AI Approach Triage, Decision Tree, Example Invocations, Critical Patterns) and the Opus 4.7 migration warning appears three times. Above 2 because the redundancy is structural repetition rather than explanatory filler; below 4 because the duplication exceeds minor instances.

3 / 5

Actionability

As a router skill the guidance is fully deterministic: exact file targets per situation ("Read: `skills/foundation-models-diag.md` (Pattern 5a...)"), exact symbols ("compatibleAdapterNotFound", "`provider(from:in:)`"), and explicit gates ("only after documented rung-1-4 failures"), with Example Invocations mapping natural user phrasings to files. The scoring-note allowance for instruction-only skills applies, and the guidance has no gaps for its purpose.

5 / 5

Workflow Clarity

A clear triage-first sequence ("First, determine which kind of AI the developer needs"), a numbered 14-step Decision Tree, and gating rules for the adapter path provide a well-sequenced workflow. Below 5 because there is no validation/feedback checkpoint on the routing decision itself, and the four parallel routing sections leave mild ambiguity about the canonical entry point.

4 / 5

Progressive Disclosure

SKILL.md acts as a router with ~20 one-level-deep `skills/*.md` references, each signaled with a concise content summary — good disclosure structure. Below 5 because none of the referenced files exist in the provided bundle to verify, and sections such as the adapter error-case lists inline detail that the referenced diag files presumably own.

4 / 5

Total

16

/

20

Passed

Description

83%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 description with an explicit, well-scoped 'Use when...' trigger and a concrete inventory of covered technologies. Its main weakness is omitting the debugging/diagnostics trigger and natural speech synonyms (transcription, dictation), which slightly under-sells the skill's routing scope.

DimensionReasoningScore

Specificity

"implementing, testing, or evaluating" lists three concrete actions plus a specific technology list (Foundation Models, @Generable, LanguageModelSession, Tool protocol, eval suites, model-as-judge scoring, SpeechTranscriber, CoreML). Below 5 because the action list is narrow and omits debugging/diagnostics, a major use case the body routes heavily; above 3 because coverage extends well beyond 1-2 actions.

4 / 5

Completeness

Explicitly answers when ("Use when implementing, testing, or evaluating ANY Apple Intelligence, on-device AI, or speech-to-text feature") and what ("Covers Foundation Models, @Generable, LanguageModelSession, Tool protocol, eval suites, model-as-judge scoring, SpeechTranscriber, CoreML") with concrete trigger phrases, matching the top anchor. Not 4 because the 'when' clause is already maximally explicit and specific.

5 / 5

Trigger Term Quality

"Apple Intelligence", "on-device AI", "speech-to-text", and "SpeechTranscriber" are terms developers naturally say when they need this skill. Below 5 because common synonyms like "transcription", "dictation", and "SFSpeechRecognizer" are missing; above 3 because keyword coverage is good, not just partial.

4 / 5

Distinctiveness Conflict Risk

A clear Apple-specific niche with distinct triggers, but "on-device AI" and "CoreML" overlap with the custom-ML/CoreML skills that the body itself routes elsewhere, creating minor wrong-skill trigger risk. Below 5 for that overlap; above 3 because the niche is unmistakably Apple Intelligence/Foundation Models.

4 / 5

Total

17

/

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