CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

67

Quality

80%

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/fleet-maintenance/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 actionable, well-sequenced maintenance runbook with explicit validation checkpoints and feedback loops for risky batch operations, and a bundle whose referenced scripts and reference file all exist and are clearly signaled. Its weaker spots are mild cross-section redundancy in the safety rules and most (not all) detailed policy being appropriately split out of the main file.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes Claude's competence — no concept explanations and every line carries policy — but at 218 lines a few rules are repeated across sections ("do not manually restart services" appears in Safety contract, Homebrew, and npm; the 'pending' semantics are restated several times), fitting the 4 anchor 'minor instances that could be trimmed' rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Guidance is fully executable throughout: exact script invocations with flags (e.g. `scripts/op-profile-audit.sh --cli-only`), a copy-paste Trash-verification bash block, concrete git command sequences with bounded fetches, and hard numeric thresholds (100 GiB/15% disk, 30 GiB memory, five-minute fetch bound) — copy-paste ready and covering the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The 'Run order' section gives an explicit 1–7 sequence backed by Preflight, with validation checkpoints everywhere: safety rechecks "immediately before every repo or Xcode mutation", pre/post host-health audits, post-fast-forward verification requirements (no unmerged entries, expected upstream commit, local modifications intact), and defined feedback loops for Git refusal, fetch timeout, and Homebrew trust refusal — the batch/destructive operations all carry validation, so the cap at 3 does not apply and there are no minor gaps that would drop it to 4.

5 / 5

Progressive Disclosure

All referenced bundle files exist (14 scripts plus `references/fleet-schema.md`, signaled clearly at point of use, one level deep), but only one reference file is provided while substantial policy detail (SSH mesh rules, repo-sync branch semantics) remains inline in a long single body, fitting the 4 anchor 'good structure; most content appropriately placed; minor organization gaps' rather than the 5 anchor's well-split overview.

4 / 5

Total

18

/

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, comprehensive, third-person description of capabilities that is clearly distinguishable as a Mac fleet-maintenance niche. Its main weakness is the complete absence of a 'Use when...' clause or equivalent trigger guidance, which both caps completeness and weakens natural trigger-term coverage.

Suggestions

Append an explicit trigger clause, e.g. "Use when maintaining Peter's Macs, updating Homebrew or global npm packages across the fleet, auditing fleet configuration, or syncing repos/Xcode on multiple Macs."

Add natural user phrasings and synonyms such as "brew", "macOS updates", and "multi-Mac" to improve trigger-term coverage beyond internal jargon like "full/worker profiles".

Briefly gloss what the full/worker profiles mean in user terms (e.g. "daily-driver vs. lean remote Mac") so the distinctiveness of the niche is legible without reading the body.

DimensionReasoningScore

Specificity

The description lists six concrete action clusters — "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" — giving comprehensive coverage of the domain, matching the 5 anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description, which per the judging guidelines caps completeness at 3; it is not 2 because the 'what' is specific and multi-faceted rather than vague.

3 / 5

Trigger Term Quality

Good natural keywords are present ("Mac fleet", "inventory", "Homebrew", "packages", "repos", "Xcode", "disk", "backup"), but internal jargon like "full/worker profiles" and "local-account escrow references" is not user phrasing, and common variations such as "brew", "macOS updates", or "sync my Macs" are missing, so it fits the 4 anchor rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The multi-Mac fleet-maintenance framing is a clear niche unlikely to trigger the wrong skill, but the description covers repo syncing, Xcode, and package updates — domains with adjacent skills — without explicit trigger phrases to disambiguate, placing it at 'mostly distinct; minor overlap risk' rather than the 5 anchor's 'distinct triggers'.

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