CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

homebrew

Use when a project depends on Homebrew formulae or casks, when creating or editing a Brewfile, or when adding brew install/upgrade automation to a project.

Quality

77%

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 ./.agents/harness/adapters/antigravity/skills/homebrew/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 extremely lean, well-formed dispatcher body whose single instruction is clear and unambiguous. Its weakness is that the one reference it relies on is an external absolute path that does not resolve here, with no bundled fallback content, so the skill delivers nothing if the shared file is absent.

Suggestions

Vendor the shared skill content into the bundle (e.g., a references/ file) or use a bundle-relative path instead of the absolute `~/.agents/skills/homebrew/SKILL.md`, which does not exist in this environment.

Add a brief fallback line summarizing the core Homebrew guidance so the skill degrades gracefully when the shared skill file is unavailable.

DimensionReasoningScore

Conciseness

The body is two lines — a maintenance comment and one directive — with zero padding or explanation of concepts Claude already knows. Every token earns its place, matching the 'lean and efficient' top anchor.

5 / 5

Actionability

'Load and follow the shared skill at `~/.agents/skills/homebrew/SKILL.md`' is a concrete, executable directive with an exact path and unambiguous action. Not 5 because there is no fallback guidance and no summary of what the shared skill covers, so the reader gets no task-specific detail if the pointer fails.

4 / 5

Workflow Clarity

This is a simple single-action skill and that action ('load and follow the shared skill') is unambiguous, which per the simple-skill note earns the top score. No destructive or batch operations are involved, so no validation cap applies.

5 / 5

Progressive Disclosure

Structurally it is the right pattern — a lean overview with one clearly signaled, one-level-deep reference — but the reference points to an absolute home-directory path that does not exist in this environment, and the bundle ships no references/, scripts/, or assets/ content at all. The disclosure chain is therefore broken, leaving no reachable detailed material.

3 / 5

Total

17

/

20

Passed

Description

61%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 well-targeted, distinctive description with good natural trigger terms, but it is trigger-only: it never states what the skill actually does, which caps its completeness. Adding a brief capability clause before the 'Use when' list would make it fully self-explanatory.

Suggestions

Add a leading 'what' clause stating the skill's capabilities (e.g., 'Installs, upgrades, and audits Homebrew formulae and casks, and manages Brewfiles'), since the description currently answers only 'when' and never 'what'.

Broaden trigger coverage with common variations users say, such as 'brew bundle', 'taps', or 'Homebrew on macOS/Linux'.

DimensionReasoningScore

Specificity

Names several concrete actions — 'creating or editing a Brewfile' and 'adding brew install/upgrade automation to a project' — within the specific Homebrew domain. Not 5 because 'a project depends on Homebrew formulae or casks' states a trigger condition without naming what the skill does for it (install, upgrade, audit?), leaving minor coverage gaps.

4 / 5

Completeness

The description is entirely a 'when' clause ('Use when a project depends on... when creating or editing a Brewfile, or when adding... automation') with no explicit statement of what the skill does. This matches the anchor 'only when is present without what'; scoring only what is explicitly stated, the detailed when-clauses do not supply a stated capability, so it cannot reach 3.

2 / 5

Trigger Term Quality

Strong natural keyword coverage: 'Homebrew', 'formulae', 'casks', 'Brewfile', 'brew install', 'brew upgrade' — terms users would naturally say. Not 5 because common variations like 'brew bundle', 'tap', or 'macOS packages' are missing; not 3 because coverage goes well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Homebrew is a clear niche and the triggers ('Brewfile', 'formulae', 'casks', 'brew install/upgrade') are unambiguous terms unlikely to fire for any other skill. Minimal conflict risk, matching the top anchor.

5 / 5

Total

15

/

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

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/homebrew/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.