CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-watchos

Use when building ANY watchOS app — app structure, independent apps, Watch Connectivity, Smart Stack widgets, complications, controls, RelevanceKit, background tasks, ClockKit migration.

Quality

79%

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-watchos/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-designed router/index skill: the symptom-to-file Quick Reference table and the Conflict Resolution section (especially the watch-device-diag vs watch-connectivity disambiguation) are genuinely non-obvious and actionable. However, it carries redundant weight — the bold opening directive restates the description and the dot decision tree restates the table — and every routing target is a `skills/*.md` file absent from this bundle, leaving the disclosed content unverifiable.

Suggestions

Delete the Decision Tree dot graph: it duplicates the Quick Reference table's mappings label-for-label; keep one representation of the routing.

Remove the bold 'You MUST use this skill for ANY watchOS-specific development including...' line that restates the frontmatter description verbatim.

Ship the eight referenced `skills/*.md` files with the bundle (or point at paths that resolve) so the router's one-level-deep references are real files a reader can open.

DimensionReasoningScore

Conciseness

The body restates the frontmatter description nearly verbatim ("You MUST use this skill for ANY watchOS-specific development including app structure, independent apps, Watch Connectivity...") and the dot Decision Tree duplicates the Quick Reference table mappings line-for-line (same labels: "app structure, independent apps, submission" → "skills/platform-basics.md", "complications, Smart Stack, RelevanceKit" → "skills/smart-stack-and-complications.md", etc.). This is more than minor trimmable padding, fitting the anchor 'mostly efficient but includes some unnecessary [content] or could be tightened'. Not a 2 because the Quick Reference, Conflict Resolution, and Resources sections are dense and earn their tokens; not a 4 because two entire sections (the bold directive and the decision tree) are redundant.

3 / 5

Actionability

Concrete routing decisions name exact target files ("See `skills/watch-device-diag.md`", "See `skills/background-and-networking.md`"), give explicit tie-breakers ("When unsure, start with watch-device-diag") and an executable diagnostic procedure ("Run the app without the debugger attached — if it behaves correctly, the fault is the tunnel"), matching 'mostly executable guidance; concrete... with minor gaps'. Not a 5 because the body contains no code/commands of its own and every pointer resolves to a `skills/*.md` file that is absent from this bundle.

4 / 5

Workflow Clarity

The Conflict Resolution section sequences decisions in numbered steps with a verification heuristic ("Run the app without the debugger attached") and an explicit checkpoint warning ("`isReachable == false` is not a transport failure" — it is the expected value across ordinary lifecycle transitions), giving a clear decision path with most checkpoints present. Not a 5 because the dot decision tree merely duplicates the routing table rather than adding an ordered workflow, and no explicit validate-then-proceed loop exists for any multi-step procedure.

4 / 5

Progressive Disclosure

Navigation is clearly signaled and one level deep within the suite (the symptom→file Quick Reference table mapping to eight `skills/*.md` files), but none of the referenced files exist in the bundle — there are no `references/`, `scripts/`, `assets/`, or `skills/` directories — so the pointers cannot be verified as real files, and cross-suite pointers like "See axiom-health (`skills/workouts.md`)" add a second hop of indirection. This fits the middle anchor: good signaling but organization undermined by unresolvable references.

3 / 5

Total

14

/

20

Passed

Description

87%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, trigger-first description: it explicitly scopes both when (building any watchOS app) and what (the enumerated topic areas), with specific platform terms that make mis-triggering unlikely. Its only weakness is noun-heavy phrasing — it lists coverage areas rather than concrete actions and omits the common synonyms 'Apple Watch' and 'WatchKit'.

DimensionReasoningScore

Specificity

The description names the domain and enumerates many concrete coverage areas — "app structure, independent apps, Watch Connectivity, Smart Stack widgets, complications, controls, RelevanceKit, background tasks, ClockKit migration" — with only one action verb ("building"). This matches 'lists several specific [items]; minor gaps in coverage' better than the 5 anchor, which requires multiple concrete actions, and sits clearly above the 3 anchor's 1-2 actions with incomplete coverage.

4 / 5

Completeness

Both questions are answered explicitly with concrete trigger phrases: the 'when' is maximally explicit ("Use when building ANY watchOS app") and the 'what' is the enumerated scope (app structure through ClockKit migration). This mirrors the 5 anchor's structure; a 4 would require the 'when' to be less explicit or more weakly implied, which is not the case.

5 / 5

Trigger Term Quality

Natural user phrasings are present: "watchOS app", "complications", "Smart Stack widgets", "Watch Connectivity", "background tasks", "controls". A few common terms a user would actually say are missing — notably "Apple Watch" and "WatchKit" — so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-with-synonyms 5 anchor.

4 / 5

Distinctiveness Conflict Risk

"watchOS app" is a clear platform niche with distinct trigger terms (complications, Smart Stack, Watch Connectivity, RelevanceKit) that iOS/macOS or general SwiftUI skills would not fire on — a clear niche with minimal conflict risk, matching the 5 anchor.

5 / 5

Total

18

/

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