CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-audit-icloud

Use when the user mentions iCloud sync issues, CloudKit errors, ubiquitous container problems, or asks to audit cloud sync.

Quality

73%

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 ./axiom-codex/skills/axiom-audit-icloud/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 strong, highly actionable audit skill with excellent workflow sequencing and built-in verification steps, though slightly padded in places. Its main structural weakness is that everything lives in one long SKILL.md with no reference files to split the eight detection patterns from the core workflow.

Suggestions

Move the eight Phase 2 detection patterns (Issue/Search/Verify/Fix blocks, ~140 lines) into a references/patterns.md and keep one-line summaries in SKILL.md, adding a references/ file to the bundle so the detail is one clearly-signaled level deep.

Trim the Phase 3 'Why it matters' column or merge it into 'What it detects' — the consequences are inferable and cost tokens on every load.

Drop or explain the opaque 'OS27' tag on Pattern 8 and relocate iOS-version-specific notes (iOS 17+, watchOS availability) into a dedicated compatibility section.

DimensionReasoningScore

Conciseness

The body is dense and operational — exact grep patterns, per-pattern Issue/Search/Verify/Fix blocks — and does not re-explain concepts Claude already knows (no 'what is iCloud' padding). It earns level 4 rather than 5 because some material could be tightened: the Phase 3 table's 'Why it matters' column spells out consequences Claude can infer, and version-specific notes (iOS 17+, the cryptic 'OS27' tag) sit inline rather than in a deprecated/versions section, which the guidelines penalize.

4 / 5

Actionability

Guidance is highly concrete: exact grep regexes per pattern, named required error branches ('.quotaExceeded, .networkUnavailable, .serverRecordChanged, .notAuthenticated'), and API-level fixes like 'return await CKSyncEngine.RecordZoneChangeBatch(pendingChanges:recordProvider:)'. It stops short of level 5 because fixes are prose instructions ('Wrap reads/writes in NSFileCoordinator().coordinate(readingItemAt:...)') rather than copy-paste code blocks, and 'Read 2-3 representative files' leaves which files partly to judgment.

4 / 5

Workflow Clarity

Five phases are explicitly sequenced (map → detect → reason about completeness → cross-reference → health score), each pattern carries a mandatory 'Read the surrounding context before reporting' verification checkpoint, and Phase 3 demands evidence ('Require evidence from the Phase 1 map — don't speculate'), with a defined output format, output limits, and a false-positive checklist. This matches level 5's clear sequence with explicit validation steps and error-recovery guidance; the audit is read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The file has good section structure (phases, patterns, output format, false positives) but is a single ~330-line monolith with no bundle files at all — the eight detection patterns, each with Issue/Search/Verify/Fix detail, are prime candidates for a references/ file. The 'Related' section points at external non-bundle paths ('axiom-data (skills/cloudkit-ref.md)') that cannot be verified. This matches level 3's 'some structure but content that should be separate is inline' rather than level 4's 'most content appropriately placed with clear references'.

3 / 5

Total

16

/

20

Passed

Description

56%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 has strong, explicit trigger guidance and a distinct Apple/iCloud niche, but it is entirely 'when'-oriented — it never states what the skill actually does. Adding one sentence of concrete capabilities would lift both completeness and specificity.

Suggestions

Lead with a 'what' clause before the 'Use when...' trigger, e.g., 'Detects iCloud integration anti-patterns: missing NSFileCoordinator on ubiquitous I/O, incomplete CKError handling, missing entitlement/availability checks, SwiftData+CloudKit conflicts. Use when...' — this would move completeness and specificity to levels 4-5.

Add natural trigger synonyms users actually say: 'iCloud Drive', 'CloudKit sync', 'sync failures', 'iCloud not syncing' — 'ubiquitous container' is developer jargon most users would never type.

Narrow 'asks to audit cloud sync' to Apple-specific phrasing (e.g., 'asks to audit iCloud or CloudKit sync') to eliminate overlap risk with generic cloud-storage skills.

DimensionReasoningScore

Specificity

The description names the domain ("iCloud sync issues, CloudKit errors, ubiquitous container problems") but contains no concrete capability statements — the only implied action is "audit cloud sync". It matches the anchor 'Names the domain but actions are minimal or generic' rather than level 3, which requires 1-2 explicitly stated concrete actions (e.g., 'detects missing file coordination, checks CKError handling').

2 / 5

Completeness

The 'when' is explicit and concrete ("Use when the user mentions iCloud sync issues, CloudKit errors, ubiquitous container problems, or asks to audit cloud sync"), but the 'what' is only weakly implied by 'audit cloud sync' — the skill's actual capabilities (detecting anti-patterns, missing conflict resolution, entitlement checks) are never stated. This mirrors level 3's single-sided clarity (there 'what' clear, 'when' missing; here inverted), and falls short of level 4 which requires both a 'what' and a 'when'.

3 / 5

Trigger Term Quality

Phrases like "iCloud sync issues", "CloudKit errors", and "audit cloud sync" are natural user utterances, and "ubiquitous container problems" captures developer phrasing. It misses common variations such as 'iCloud Drive', 'CloudKit sync', 'sync failure', or file extensions (.entitlements), so it is 'good keyword coverage; a few natural terms missing' rather than level 5's comprehensive synonym coverage; 'ubiquitous container' is jargon-leaning, keeping it above level 3.

4 / 5

Distinctiveness Conflict Risk

iCloud/CloudKit/ubiquitous-container triggers carve out a clear Apple-specific niche with minimal conflict risk, but the trailing clause "or asks to audit cloud sync" is broad enough to overlap with generic cloud-sync skills (Dropbox, Google Drive, Firebase sync). That minor overlap with closely related skills matches level 4 rather than level 5's 'minimal conflict risk'.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

CharlesWiltgen/Axiom

Path

axiom-codex/skills/axiom-audit-icloud/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.