CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

macos-build

Build a native macOS app using xcodebuild from the command line. Use this skill whenever the user asks to build, compile, or check if their macOS project compiles successfully. Also use it when the user asks to fix build errors, verify changes compile, or run a debug build. Trigger on phrases like "build the app", "does it compile", "run xcodebuild", "fix build errors", or even just "build".

Quality

92%

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

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

Excellent content for a simple skill: every command is executable, the build-interpret-fix-verify loop is explicit, and the troubleshooting table anticipates the most common failures. The only trims worth making are the redundant 'When to Build' section and the version-specific beta example.

DimensionReasoningScore

Conciseness

The body is command-first and lean, but the "When to Build" section repeats trigger guidance already carried by the description, and "e.g., macOS 26 Tahoe" adds version-specific detail; these are minor instances that could be trimmed, fitting anchor 4 rather than 'every token earns its place'.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: project discovery (find, xcodebuild -list), complete build templates for both project and workspace with DEVELOPER_DIR set, and a failure table with exact fixes (xcodebuild -resolvePackageDependencies, CODE_SIGN_IDENTITY="" CODE_SIGNING_ALLOWED=NO), covering the common cases.

5 / 5

Workflow Clarity

A clear ordered sequence (locate project, list schemes, build, interpret results) with an explicit error-recovery feedback loop ("read each error... help the user fix them. After fixing, re-run the build to verify") and a fallback for unclear output; this is a simple, non-destructive build task where the single workflow is unambiguous, so the simple-skill exception applies.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed; the ~77-line body is appropriately self-contained with well-organized sections (Finding the Project, Build Command, Interpreting Results, Common Build Failures), and the compact failure table is rightly inline rather than split out, satisfying the simple-skill guidance.

5 / 5

Total

19

/

20

Passed

Description

88%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 strong description: it clearly states what the skill does and when to use it, with concrete trigger phrases and specific actions. The only weaknesses are the over-broad 'build' trigger, which raises conflict risk with other build skills, and missing common synonyms like 'Xcode' or '.xcodeproj' in the trigger terms.

DimensionReasoningScore

Specificity

"Build a native macOS app using xcodebuild from the command line" plus "fix build errors, verify changes compile, or run a debug build" names multiple concrete actions with comprehensive coverage of the build domain; no minor gaps warranting a 4, and the voice is third person with a standard 'Use when...' trigger clause rather than penalizable second person.

5 / 5

Completeness

Explicitly answers both 'what' (build a native macOS app using xcodebuild from the command line) and 'when' ("Use this skill whenever the user asks to build, compile, or check if their macOS project compiles successfully... Trigger on phrases like...") with concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good natural phrases ("build the app", "does it compile", "fix build errors", "run xcodebuild") but coverage is missing common synonyms and extensions users would say, such as "Xcode", ".xcodeproj", or "build the project"; a 5 requires that comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The macOS/Xcode CLI-build niche is mostly distinct, but the trigger "or even just 'build'" is over-broad and could fire for closely related build skills (iOS builds, other toolchains), fitting 'minor overlap risk with closely related skills' rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

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

freekmurze/dotfiles

Path

config/claude/skills/build/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.