CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

xcode-run

Load to install or dispatch a macOS GitHub Actions build, test or simulator screenshot run for an Xcode project.

Quality

75%

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

Quality

Content

72%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 efficient, well-structured body with copy-paste dispatch commands and honest limitation notes. The weaknesses are the missing verification/feedback steps in the install-configure-dispatch-retrieve workflow and the absent templates/mac-run.yml bundle file that the body and installer both depend on.

Suggestions

Add a verification/feedback step after dispatch, e.g. `gh run watch` and `gh run download mac-run` to retrieve logs/<step>.log and screenshots/*.png, so the artifact-retrieval half of the skill is actionable.

Include templates/mac-run.yml in the skill bundle — the body links to it and scripts/install.sh copies from it, but the file is not present, breaking both navigation and the installer.

Add a brief pre-dispatch check that XCODE_SCHEME is a shared scheme and XCODE_DESTINATION is a concrete simulator available on macos-latest, to catch the most common configuration failures before a run.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout — e.g. "The workflow disables code signing. It does not archive, export or deploy an app." and the dense env/step tables — with no explanations of concepts Claude already knows. Every sentence carries setup or dispatch information, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Copy-paste-ready commands cover all three dispatch cases ("gh workflow run mac-run.yml -f step=build/test/screenshots") and configuration is concrete ("Replace the `App` placeholder", "Screenshots require a concrete simulator"). Not 5 because the run-monitoring and artifact-retrieval steps have no commands (e.g. `gh run watch` / `gh run download mac-run`), leaving a minor gap in the executable flow.

4 / 5

Workflow Clarity

The section order gives a clear sequence (install → configure env → commit to default branch → dispatch → artifact), but checkpoints are missing or implicit: there is no pre-dispatch validation that XCODE_SCHEME is shared and XCODE_DESTINATION is available, and no step to verify the run succeeded before expecting the artifact. Failure behavior is described ("A failing command fails the run and keeps its log for upload") but there is no validate/fix/retry loop, so it fits the 'sequence present but checkpoints missing or implicit' anchor rather than the 'most checkpoints present' anchor at 4.

3 / 5

Progressive Disclosure

The body is short and well-sectioned with clearly signaled, one-level-deep references ("[templates/mac-run.yml](templates/mac-run.yml)" and "scripts/install.sh"). However, scoring against the actual bundle structure, the primary referenced payload templates/mac-run.yml is absent (only scripts/install.sh exists), so the central link is broken and scripts/install.sh's "cat -- "$SCRIPT_DIR/../templates/mac-run.yml"" would fail — a real navigation failure rather than a minor organization gap, which rules out 4.

3 / 5

Total

15

/

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.

A tight, specific description that clearly conveys the niche (macOS GitHub Actions build/test/simulator-screenshot runs for Xcode projects) with mostly natural trigger terms. Its main weakness is the absence of an explicit "Use when..." trigger clause, which leaves the use-conditions implied rather than stated.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks to build, test, or take simulator screenshots of an Xcode project on GitHub Actions / macOS CI."

Mention the returned output ("each run returns its logs and PNG screenshots in one artifact") to close the coverage gap in stated capabilities.

Add one or two natural synonyms such as "CI" or "workflow run" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"install or dispatch a macOS GitHub Actions build, test or simulator screenshot run" names the domain and several concrete actions (install, dispatch, build, test, simulator screenshot), matching the 'several specific actions; minor gaps' anchor. It is not 5 because it omits that runs return logs and PNG artifacts, a core capability stated in the frontmatter summary.

4 / 5

Completeness

The "what" is clear ("install or dispatch a macOS GitHub Actions build, test or simulator screenshot run for an Xcode project") but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by "Load to install or dispatch". Per the judging guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "Xcode", "build", "test", "simulator screenshot", "GitHub Actions", "macOS". Not 5 because common variations such as "CI", "workflow run", or "Swift" are missing, so keyword coverage is good but not comprehensive.

4 / 5

Distinctiveness Conflict Risk

"macOS GitHub Actions ... for an Xcode project" plus "simulator screenshot" define a clear niche with distinct triggers, so it is unlikely to fire for the wrong skill (local xcodebuild requests or generic CI requests are distinguishable because GitHub Actions and Xcode are both named).

5 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

vanillagreencom/kendex

Path

skills/xcode-run/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.