CtrlK
BlogDocsLog inGet started
Tessl Logo

build-run-debug

Build, run, and debug local macOS apps and desktop executables using shell-first Xcode and Swift workflows. Use when asked to build a Mac app, launch it, diagnose compiler or linker failures, inspect startup problems, or debug desktop-only runtime issues.

70

Quality

85%

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

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

A well-structured, highly actionable skill body: concrete commands at every step, a clear 7-step workflow with sensible debug/verify checkpoints, and proper use of a one-level-deep canonical reference instead of inlining full scripts. The main costs are redundancy — the raw-launch guardrail and script-contract phrasing repeat across three sections plus the reference — and an implicit rather than explicit failure-recovery loop.

Suggestions

Consolidate the raw-executable-launch warning (currently in Workflow step 3, Guardrails, and references/build-script.md) into the single guardrail section, leaving the reference as the canonical source for launch mechanics.

Merge the Quick Start flag list with the Preferred Commands section — both enumerate the same './script/build_and_run.sh' variants, so one canonical list suffices.

Make the failure feedback loop explicit in step 5: after classifying the blocker, state 'fix the root cause and re-run ./script/build_and_run.sh' so the validate-fix-retry cycle is not left implicit.

DimensionReasoningScore

Conciseness

The body is dense with directives and assumes Claude's competence (no explanation of what Xcode, SwiftPM, or Info.plist are), delegating full script bodies to the reference. It is not a 5 because the kill-build-run contract and the raw-executable-launch warning ('Do not recommend direct SwiftPM executable launch...' / 'Do not launch a SwiftUI/AppKit SwiftPM GUI app as a raw executable...') are repeated across Quick Start, Workflow step 3, Guardrails, and the reference, and the Quick Start flag list duplicates the Preferred Commands list.

4 / 5

Actionability

Concrete executable commands appear throughout: 'find . -name '*.xcworkspace' -o ...', 'xcodebuild -list -workspace <workspace>', './script/build_and_run.sh --telemetry', exact Info.plist keys, 'pgrep -x <AppName>', and 'NSApp.setActivationPolicy(.regular)'. The full copy-paste-ready scripts live one level deep in references/build-script.md, covering both common cases (SwiftPM CLI and GUI). This matches anchor 5; anchor 4 would imply missing key details that are instead all present across body plus reference.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced — discover shape, resolve target, create script, build/run, classify failures, debug, use MCP — with concrete checkpoints like '--verify' to 'confirm the process exists with pgrep -x <AppName>' and failure classification in step 5. It stops short of anchor 5 because the validate-fix-retry feedback loop is implicit rather than explicit: there is no 'fix and re-run' step after classifying a blocker, so a validation gap remains.

4 / 5

Progressive Disclosure

Structure is good: a one-level-deep, clearly signaled reference ('references/build-script.md: canonical script/build_and_run.sh shapes...') that is explicitly designated the canonical source, and it is a real file in the bundle. Not a 5 because the body still inlines script-shape detail that also lives in the reference (plist keys, open -n launch details, activation-policy advice appear in both), leaving minor duplication that could be consolidated.

4 / 5

Total

17

/

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 pairs a concrete capability statement with an explicit 'Use when' clause full of natural trigger phrases, and it scopes itself tightly to local macOS desktop work. Its only weaknesses are a few missing natural synonyms and slightly generic compiler/linker trigger wording that could overlap with other build skills.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete, comprehensive actions — 'Build, run, and debug local macOS apps and desktop executables' plus 'diagnose compiler or linker failures, inspect startup problems, or debug desktop-only runtime issues'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it falls short of nothing below it since anchor 4 tolerates coverage gaps this description does not have.

5 / 5

Completeness

It explicitly answers both parts: 'Build, run, and debug local macOS apps and desktop executables using shell-first Xcode and Swift workflows' (what) and 'Use when asked to build a Mac app, launch it, diagnose compiler or linker failures...' (when, with concrete trigger phrases). This matches anchor 5 exactly; anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are present: 'build a Mac app', 'launch it', 'diagnose compiler or linker failures', 'inspect startup problems', 'debug desktop-only runtime issues'. Coverage is good but misses common synonyms users say ('run my app', 'Xcode project', 'SwiftUI', 'crash', '.app'), so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — 'local macOS apps and desktop executables' and 'desktop-only runtime issues' — with triggers mostly distinct from iOS/simulator or general-language build skills. However, 'diagnose compiler or linker failures' is generic enough to invite overlap with non-macOS build skills, matching 'mostly distinct; minor overlap risk' (anchor 4) 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
robinebers/openusage
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.