CtrlK
BlogDocsLog inGet started
Tessl Logo

build-and-run-macos-app

Slash command that creates or updates the project-local macOS `script/build_and_run.sh` and uses it as the default build/run entrypoint. Invoke explicitly with /build-and-run-macos-app — this skill never self-triggers.

62

Quality

72%

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/build-and-run-macos-app/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.

The body is an exemplary lean, well-sectioned instruction document with clear sequencing and sensible guardrails. Its weakness is that the single most important artifact — the script itself — is defined by an external cross-skill reference not shipped in this bundle, leaving the workflow's core step under-specified when read standalone.

Suggestions

Inline a minimal skeleton of `build_and_run.sh` (or ship it under `scripts/` in this skill's bundle) so the core deliverable is actionable without the sibling `build-run-debug` skill being present.

Give the concrete detection commands for step 1 (e.g., `ls *.xcodeproj *.xcworkspace Package.swift`) so the branch point is executable rather than descriptive.

Add an explicit validation checkpoint in the Workflow (e.g., "only relaunch if the build exit code is 0; otherwise report the failing target") to complete the feedback loop.

DimensionReasoningScore

Conciseness

At ~35 lines the body is lean and directive throughout — Arguments, Workflow, and Guardrails sections carry only operational content, explain nothing Claude already knows, and assume competence. Only the intro line restates the description, which is a negligible redundancy; this matches the "every token earns its place" anchor rather than the minor-trimming anchor 4.

5 / 5

Actionability

There is concrete guidance (script path, `git init`, `/usr/bin/open -n`, flag names `--debug/--logs/--telemetry/--verify`), but key execution details are missing: the exact script shape is delegated to `../build-run-debug/references/build-script.md`, which is not present in this skill's bundle, and step 1 ("Detect whether the repo uses an Xcode workspace, Xcode project, or SwiftPM package") gives no commands for detection. This lands on anchor 3 (some concrete guidance but incomplete) rather than 4, where concrete commands cover the workflow with only minor gaps.

3 / 5

Workflow Clarity

The seven numbered steps form a clear, ordered sequence, and step 7 ("summarize any build, script, or launch failure") plus the `--verify` flag provide some failure feedback. It is not anchor 5 because there is no explicit validate-before-proceed checkpoint (e.g., confirming the build succeeded before relaunching, or checking the repo state before `git init`); it is above anchor 3 because the sequence and failure handling are explicit rather than implicit.

4 / 5

Progressive Disclosure

For a sub-50-line skill the sectioning (Arguments / Workflow / Guardrails) is clean, and the single external reference is well-signaled and one level deep. It is not anchor 5 because that sole reference (`../build-run-debug/references/build-script.md`) points outside the skill's own bundle, is unresolvable within this skill's directory, and carries the core script contract — a cross-skill dependency with no local fallback, which is a minor organization/navigation gap rather than a severe one.

4 / 5

Total

16

/

20

Passed

Description

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

The description is specific, honest about its invocation model (explicit slash-command only, never self-triggers), and clearly distinguishes the skill's niche. Its main gaps are incomplete action coverage (modes and app-bundle handling are not mentioned) and a trigger clause that explains how to invoke rather than when it is the right tool.

Suggestions

Mention the supported modes (run, debug, logs, telemetry, verify) and the GUI-app .app-bundle launch behavior in the description to lift specificity from 1-2 actions to several.

Add a usage-situation trigger phrase (e.g., "Use when you want to build and launch a macOS app from the project") alongside the invocation instruction to make the "when" fully concrete.

Include natural synonyms users would say — "launch", "Xcode", "debug", "scheme" — to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain (macOS build/run) with two concrete actions — "creates or updates the project-local macOS `script/build_and_run.sh`" and "uses it as the default build/run entrypoint" — but coverage is not comprehensive: the run/debug/logs/telemetry/verify modes and the .app-bundle launch behavior are omitted. Anchor 3 ("1-2 concrete actions, not comprehensive") fits better than anchor 4, whose example lists three or more actions.

3 / 5

Completeness

Both parts are present: the "what" is clear (create/update the script, use it as the default entrypoint) and the "when/how to trigger" is explicit ("Invoke explicitly with /build-and-run-macos-app — this skill never self-triggers"), which counts as equivalent trigger guidance. Not anchor 5 because the trigger clause describes invocation mechanics rather than concrete usage situations (e.g., no "use when you want to build and launch a macOS app" phrasing).

4 / 5

Trigger Term Quality

Good natural keyword coverage: "build", "run", "macOS", "entrypoint", "build_and_run.sh", and the explicit slash-command trigger "Invoke explicitly with /build-and-run-macos-app". A few natural terms users would say are missing ("launch", "Xcode", "debug", "scheme"), so it falls short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A project-local macOS build/run script managed via a specific slash command is a clear, distinct niche — the specific file path and "never self-triggers" framing sharply reduce accidental triggering. Minor overlap risk remains with generic build/run or Xcode-related skills, so anchor 4 rather than 5.

4 / 5

Total

15

/

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.