CtrlK
BlogDocsLog inGet started
Tessl Logo

macos-build-run-debug

Build, run, and debug macOS apps with shell-first Xcode and Swift workflows. Use when launching apps or diagnosing build, startup, or runtime failures.

66

Quality

79%

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/skills/macos-build-run-debug/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 strong, instruction-style skill body: a clear seven-step workflow backed by exact commands, real bundle reference, explicit guardrails, and honest output expectations. The main improvement space is removing repetition (the raw-launch warning and simulator caveat each appear multiple times) and moving script-implementation detail fully into the canonical reference.

Suggestions

State the raw-executable-launch rule once (Guardrails) instead of three times across workflow steps 2, 3, and the guardrail section, and fold the duplicate simulator caveat into the same place.

Move the Info.plist key enumeration and flag-by-flag script semantics from workflow step 3 into references/build-run-script.md, keeping only the script's behavioral contract (kill, build, run + optional flags) inline.

Promote process verification from an optional flag to an explicit workflow checkpoint, e.g., after 'Build and run through the script', add 'confirm the process exists with pgrep -x <AppName>'.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with no padding or explanation of concepts Claude already knows, fitting 'efficient; minor instances of over-explanation that could be trimmed'. It is not a 5 because the raw-executable-launch warning is stated three times (workflow step 2, step 3 line 59, and the Guardrails section) and the simulator caveat appears twice.

4 / 5

Actionability

Concrete, copy-pasteable commands appear at every stage — 'git rev-parse --is-inside-work-tree', 'xcodebuild -list -workspace <workspace>', './script/build_and_run.sh --debug', 'pgrep -x <AppName>', and the full Info.plist key list — with the executable script body delegated to the real references/build-run-script.md. This is 'mostly executable guidance with minor gaps' rather than a 5, since a few directives stay high-level ('prefer the app-producing scheme', 'identify executable products when possible').

4 / 5

Workflow Clarity

The seven-step Workflow is clearly sequenced from project discovery through failure classification to debugging, with a feedback path (step 5 'Classify the blocker ... Quote the smallest useful error snippet' feeding step 6 debug) and a validation mode in '--verify' with 'pgrep -x <AppName>'. It misses anchor 5 because validation is offered as an optional flag rather than an explicit checkpoint in the sequence (e.g., the workflow never says to verify the process after launch by default).

4 / 5

Progressive Disclosure

The body is well-sectioned and pushes the full script template to a single real, one-level-deep reference (references/build-run-script.md), clearly signaled in both the References section and workflow step 3 ('Use references/build-run-script.md as the canonical source'). It falls short of a 5 because the body still inlines script-level detail (the Info.plist key list and flag semantics in step 3) that duplicates the canonical reference's territory.

4 / 5

Total

16

/

20

Passed

Description

83%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 tight, third-person description that explicitly states both capability and trigger conditions with concrete, naturally-spoken keywords. Its only weaknesses are minor: a few missing synonyms for failure modes (crash, compile error) and slight overlap risk with adjacent macOS debugging skills.

DimensionReasoningScore

Specificity

The description names three concrete actions ("Build, run, and debug macOS apps") plus a concrete approach ("shell-first Xcode and Swift workflows"), which matches the 'several specific actions; minor gaps' anchor rather than the comprehensive multi-action list of a 5 (e.g., it omits script setup, log streaming, or lldb support that the body actually covers).

4 / 5

Completeness

Both halves are explicit: 'what' is "Build, run, and debug macOS apps with shell-first Xcode and Swift workflows" and 'when' is "Use when launching apps or diagnosing build, startup, or runtime failures" — a clear 'Use when' clause with concrete trigger phrases, exactly matching the anchor-5 example pattern. It is not a 4 because the trigger guidance is already specific rather than merely present.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered — "macOS apps", "Xcode", "Swift", "build", "launching apps", "runtime failures" — matching 'good keyword coverage; a few natural terms missing'. It stops short of anchor 5 because common phrasings like 'crash', 'compile error', 'won't start', or file extensions (.xcodeproj, .xcworkspace) are absent.

4 / 5

Distinctiveness Conflict Risk

"macOS apps" plus "Xcode and Swift" carves out a clear niche that a user would not confuse with document or data skills, but "debug ... runtime failures" leaves minor overlap risk with closely related sibling skills (the body itself points to a separate macos-telemetry skill). This fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict 5.

4 / 5

Total

17

/

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.