CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fleet-maintenance

Mac fleet inventory and upkeep with full/worker profiles: collect installed apps and packages, compare desired versus observed state, audit local-account escrow references, update Homebrew/global packages, safely sync repos and Xcode, and report disk, service, backup, update, and security health.

70

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 exemplary operational skill body: dense, safety-first policy with executable commands, explicit validation checkpoints around every mutation, and clean separation of schema and executable logic into the bundle. The only structural critique is that the 218-line body carries substantial inlined policy detail (git interpretation rules, Homebrew trust procedure), but that content is safety-critical and appropriately resident in context.

DimensionReasoningScore

Conciseness

The body is pure operational policy and commands with no explanation of concepts Claude already knows; even tool-behavior notes (Homebrew 6 trust refusals, GUI Tailscale clients not acting as SSH servers) are non-obvious, current facts rather than padding. Every sentence carries a constraint, a command, or a classification rule, fitting the 'every token earns its place' anchor.

5 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: fleet-profile.mjs invocations, ssh stdin-piping one-liners with explicit options, git fetch/rev-list commands with a complete interpretation table for each count outcome, the path-verified Trash-emptying bash block, and the brew trust procedure. Score 4 would require minor gaps in executability, and none are present.

5 / 5

Workflow Clarity

A clear 7-step run order is backed by pervasive validation on batch and mutating operations: host-health audits before and after package mutations, post-fast-forward verification requirements (no unmerged entries, expected upstream commit, local modifications preserved), timeout/failure feedback loops (mark pending, continue), a re-audit step, and a Finish report checklist. The destructive/batch cap does not apply because validation is explicit at every mutation point.

5 / 5

Progressive Disclosure

Verified against the actual bundle: executable logic lives in ten real scripts, schema detail is split to references/fleet-schema.md with two clear inline signals, topology is deliberately not duplicated (deferred to computers.yaml), and Xcode/setup logic is delegated to $xcode-sync and fleet-setup.md. All references are one level deep and every referenced path exists; navigation via section headers and named scripts is easy.

5 / 5

Total

20

/

20

Passed

Description

71%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 highly specific, dense description that clearly communicates what the skill does across its full domain with strong natural keywords and a distinct fleet-maintenance niche. Its one real weakness is the complete absence of a 'Use when...' trigger clause, which both caps completeness and slightly weakens discoverability.

Suggestions

Append an explicit trigger clause, e.g. 'Use when Peter asks to maintain, inventory, or update his Mac fleet, update Homebrew or global npm packages across hosts, or check fleet health.'

Add natural synonyms users would actually say — 'brew', 'npm', 'macOS updates', 'check my Macs' — to broaden trigger matching without adding vagueness.

Consider narrowing 'safely sync repos and Xcode' to fleet-level language (e.g. 'fleet-wide repo and Xcode sync reporting') to reduce overlap with the dedicated $xcode-sync and repo-sync skills.

DimensionReasoningScore

Specificity

The description lists six concrete actions ('collect installed apps and packages, compare desired versus observed state, audit local-account escrow references, update Homebrew/global packages, safely sync repos and Xcode, and report disk, service, backup, update, and security health') with comprehensive domain coverage, matching the multiple-specific-actions anchor; score 4 would require identifiable coverage gaps, and none exist.

5 / 5

Completeness

The 'what' is explicit and thorough, but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, so completeness is capped at 3 per the rubric guideline; it is not 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good natural keyword coverage (Mac, fleet, inventory, apps, packages, Homebrew, repos, Xcode, disk, backup, security) that users would plausibly say, but a few natural terms and synonyms are missing (brew, npm, macOS, 'update my Macs'), fitting 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The fleet-profile/escrow/upkeep framing is a clear niche, but 'safely sync repos and Xcode' overlaps with closely related single-purpose skills (the body itself delegates Xcode work to $xcode-sync), creating minor overlap risk; it is more distinct than the 'somewhat specific but could still overlap' anchor at 3.

4 / 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

Path

skills/fleet-maintenance/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.