CtrlK
BlogDocsLog inGet started
Tessl Logo

xcode-sync

Xcode fleet sync: signed archives, compatibility, install, selection, first launch.

66

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 ./skills/xcode-sync/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 exceptionally dense, operational skill body: exact commands, real bundle scripts, sequenced workflow with validation, rollback, and failure-recovery loops for destructive install operations. The main weaknesses are hard-coded, time-sensitive version pins that will go stale and aren't quarantined in a deprecated section, some duplicated rollback procedure text, and reference-style pointers that could be more clearly organized.

Suggestions

Move fleet version rules (Xcode 26.6 / macOS 26 Tahoe 26.2+ / macOS 27 exclusion) into a clearly labeled, updateable compatibility-matrix section or reference file so stale pins are easy to spot and replace.

Deduplicate the point-release replacement (item 5) and major-version rotation (item 6) rollback procedures into a single shared rollback/verify/restore procedure referenced by both.

Add a brief 'Bundle files' or 'References' section listing the three scripts (and the smoke test) with one-line descriptions so navigation to the bundle is explicit rather than incidental.

DimensionReasoningScore

Conciseness

The body is dense and lean — it assumes Claude's competence throughout, explains no background concepts, and packs exact commands, exit codes, and policies with no padding, which is above the 'mostly efficient' anchor. It misses a 5 because it embeds time-sensitive version pins ('install Xcode 26.6 only on macOS 26 Tahoe, version 26.2 or newer. Skip macOS 27 Golden Gate') outside any 'old patterns'/'deprecated' section — a conciseness penalty per the judging guidelines — and the rollback procedures in items 5 and 6 repeat substantially.

4 / 5

Actionability

The guidance is fully executable: complete bash snippets for signature verification, xip expansion, plutil extraction, rsync transfer, first-launch checks, plus three real, substantive helper scripts in the bundle invoked with exact usage and argument semantics ('xcode-post-install-smoke.sh "$app" "$rollback"', omit the rollback argument for fresh installs). Commands cover the common cases copy-paste ready, matching the score-5 anchor.

5 / 5

Workflow Clarity

The pipeline is clearly sequenced (Inventory → Simulator hygiene → Inspect source → Compatibility → Transfer and install → First launch and verification) with validation checkpoints throughout: signature and SHA-256 verification before expansion, recheck-until-status-0 license loop, a CLI smoke gate before rollback deletion, explicit restore-on-failure feedback loops, and a final host matrix. Despite being destructive (app replacement/deletion), validation and recovery are pervasive, matching the score-5 anchor.

5 / 5

Progressive Disclosure

Structure is good: the body delegates executable machinery to three real one-level-deep bundle scripts (xcode-host-inventory.sh, xcode-simulator-hygiene.sh, xcode-post-install-smoke.sh, all present in ./scripts/) with inline usage shown, keeping SKILL.md to policy and sequence. It falls short of a 5 because the script pointers are bare inline paths rather than clearly signaled reference sections, there is no explicit pointer documentation for the smoke test (xcode-post-install-smoke.test.sh is unreferenced), and long dense policy paragraphs (e.g., the rotation and smoke-failure rules) inline detail that could be split into a reference file.

4 / 5

Total

18

/

20

Passed

Description

70%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 terse, domain-specific description that clearly communicates what the skill does and is highly distinct, but it omits any explicit 'Use when...' trigger clause and underuses natural trigger synonyms. Adding trigger phrasing (e.g., 'Use when installing or updating Xcode across multiple Macs, when the user mentions .xip archives or xcode-select') would raise completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when installing, updating, or verifying Xcode across a fleet of Macs, or when the user mentions .xip archives, xcode-select, or Xcode betas.'

Convert noun phrases into concrete third-person actions ('Verifies signatures, checks macOS compatibility, installs, selects, and completes first launch') to sharpen specificity.

Include natural synonyms users would say — 'update Xcode', 'Xcode beta/RC', 'xcode-select', 'xip' — to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Xcode fleet sync') and lists several concrete capability areas — 'signed archives, compatibility, install, selection, first launch' — matching the 'several specific actions; minor gaps' anchor. It falls short of a 5 because the items are noun-phrase topics rather than explicit actions, and coverage gaps exist (e.g., no mention of verification/smoke-testing, rollback, or simulator hygiene, all of which the body treats as core).

4 / 5

Completeness

The 'what' is clear (sync signed Xcode archives across a fleet, checking compatibility, installing, selecting, first-launch), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the judging guidelines explicitly cap completeness at 3 in that case. Not a 4: the 'when' is entirely absent rather than merely weakly implied; not a 2: the 'what' is concrete and multi-part, not vague.

3 / 5

Trigger Term Quality

Natural terms a user would say are present — 'Xcode', 'sync', 'install', 'compatibility', 'first launch' — giving good keyword coverage per the score-4 anchor. It misses common variations and specifics a user might actually utter, such as 'xcode-select', '.xip', 'xcodebuild', 'update Xcode', or 'Xcode beta', which the score-5 anchor expects as synonyms/extensions.

4 / 5

Distinctiveness Conflict Risk

'Xcode fleet sync' occupies a clear niche with distinct triggers (Apple toolchain deployment across multiple Macs); it is unlikely to fire for other skills and shares no meaningful overlap with generic file- or code-handling skills. This matches the score-5 anchor for a clear niche with minimal conflict risk.

5 / 5

Total

16

/

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
steipete/agent-scripts
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.