CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-macos

Use when building ANY macOS app — windows, menus, sandboxing, distribution, AppKit bridging or modernization (control events, state restoration, concentric corners), touch input, or macOS-specific SwiftUI patterns.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude-plugin/plugins/axiom/skills/axiom-macos/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 lean, well-organized router: a symptom-to-reference table, cross-suite routing, explicit conflict-resolution rules, and a decision tree, with no filler and concrete agent/file/tool pointers throughout. Its weaknesses are duplicated routing content (the decision tree repeats the quick-reference table; cross-suite routes and conflict resolution overlap) and references that resolve only within the parent suite rather than this bundle. Cutting the duplication would make it a model router skill.

Suggestions

Remove the dot-graph Decision Tree — it duplicates the Quick Reference table's task→skill mapping almost exactly, saving ~20 lines with no information loss.

Merge "Cross-Suite Routes" and "Conflict Resolution" into one section, since both explain the same axiom-macos vs axiom-swiftui (and axiom-security) boundary.

Clarify where referenced files live (e.g., a one-line note that "skills/*.md" paths are relative to the Axiom suite root) so navigation works without the surrounding suite's directory layout in context.

DimensionReasoningScore

Conciseness

There is no padding or explanation of concepts Claude already knows, but the dot-graph Decision Tree restates the Quick Reference table's routing almost row-for-row (~20 redundant lines), and "Cross-Suite Routes" and "Conflict Resolution" both explain the same axiom-macos vs axiom-swiftui boundary. This fits anchor 3 ("mostly efficient but could be tightened") better than anchor 4's "minor instances".

3 / 5

Actionability

Pointers are concrete and executable — "See `skills/windows.md`", "Launch `touch-auditor` agent or `/axiom:audit touch`", "`axiom_get_agent` returns it" — including a fallback path when agents can't launch. Not anchor 5: most table rows name only a destination file without stating the action to take there, and paths are relative to an unstated suite root.

4 / 5

Workflow Clarity

As a single-purpose routing skill, the one action (match task → follow reference) is made near-deterministic by the symptom table, decision tree, and explicit conflict-resolution rules for overlapping cases, with environment-specific fallbacks for agent launch. Minor residual ambiguity (e.g., the Apple Pay/Catalyst row vs ios-apps-on-mac) keeps it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a pure overview/index: all detail is deferred to one-level-deep, clearly signaled references organized by symptom, which is exemplary router structure. However, no bundle files are present — every referenced path ("skills/*.md", "axiom-payments/skills/apple-pay.md") resolves against the surrounding suite rather than this bundle, so navigation is not self-contained; this is anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

15

/

20

Passed

Description

61%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 provides an explicit, richly detailed 'Use when' trigger covering windows, menus, sandboxing, distribution, AppKit work, touch input, and macOS SwiftUI, with good natural keyword coverage and a clear macOS niche. Its main weakness is that it never states what the skill does — it is purely a trigger list with no capability or action statement, which caps both completeness and specificity. Adding a brief third-person capability clause (e.g., what it provides or routes to) alongside the strong trigger would lift it substantially.

Suggestions

State the skill's capabilities before the trigger, e.g., "Routes macOS development tasks to focused reference skills for windows, menus, sandboxing, distribution, AppKit, touch input, and macOS SwiftUI. Use when building any macOS app…" — this fixes the missing 'what' that caps completeness.

Add action verbs per area (e.g., "configures sandboxing entitlements", "modernizes AppKit input handling", "audits touch readiness") so specificity reflects concrete actions rather than a bare topic list.

Include common synonyms users actually say — "notarization", "Developer ID", "Catalyst", "menu bar" — alongside "distribution" and "AppKit bridging" to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Phrases like "windows, menus, sandboxing, distribution, AppKit bridging or modernization (control events, state restoration, concentric corners)" name concrete, well-scoped topic areas, but no action verbs are stated anywhere — it is a trigger list, not a capability list. This matches anchor 3 (clear domain, concrete scope) better than anchor 4 ("lists several specific actions") because zero actions are explicit, and better than anchor 2 because the enumeration is specific rather than generic.

3 / 5

Completeness

The "when" is explicit and detailed ("Use when building ANY macOS app — windows, menus, sandboxing…"), but the "what" — what the skill actually does — is never stated; there is no capability statement at all. Anchor 4 requires both present; anchor 2 ("only 'when' present") fits structurally but its example is vague whereas this 'when' is maximally explicit, placing this between the anchors at 3.

3 / 5

Trigger Term Quality

"building ANY macOS app", "windows", "menus", "sandboxing", "distribution", "touch input" are natural phrases a developer would say when needing this skill. A few common variations are missing ("notarization", "Developer ID", "Catalyst", "menu bar", "Mac"), which fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"ANY macOS app" plus "macOS-specific SwiftUI patterns" carves a clear macOS-only niche with distinct triggers, but any macOS SwiftUI or iOS-adjacent task would also plausibly trigger a general SwiftUI/iOS skill, so overlap risk with closely related skills remains — anchor 4 rather than anchor 5's minimal conflict risk.

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

CharlesWiltgen/Axiom

Path

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