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 ./.agents/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.

The body is an efficient, well-organized usage guide with concrete configuration and dispatch commands, but two weaknesses hold it back: the workflow lacks verification checkpoints after dispatch (no run-status check or artifact download command), and its central reference to templates/mac-run.yml is broken — that file is absent from the bundle, so the consumer cannot see the workflow they are installing.

Suggestions

Add the missing templates/mac-run.yml to the bundle (or fix the path) — both the body and scripts/install.sh reference it, but it does not exist.

Add post-dispatch verification guidance: `gh run watch`/`gh run view` to confirm success and `gh run download mac-run` to retrieve the logs and screenshots the Artifact section describes.

Add a pre-dispatch sanity check for the configured values (e.g. confirming XCODE_SCHEME exists via `xcodebuild -list` and that XCODE_DESTINATION names a concrete simulator), since the config section only warns about these in prose.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: a config table for env values, a dispatch table with the three steps, three copy-paste gh commands, and terse behavioral boundary notes ("disables code signing", "do not navigate the app or assert that its UI is ready"). No background concepts are explained, and every sentence carries operational information; it is not 4 because there is no padded or over-explanatory passage to trim.

5 / 5

Actionability

Mostly executable guidance: exact env keys to edit (XCODE_SCHEME, XCODE_DESTINATION), a dispatch table, and ready-to-run `gh workflow run mac-run.yml -f step=...` commands for all three operations. It is not 5 because key operational details are missing — no command to watch or inspect a run, and no command to download the `mac-run` artifact that the Artifact section promises.

4 / 5

Workflow Clarity

The sequence (install → configure env → commit to default branch → dispatch → artifact) is present and readable via section order, but there are no validation checkpoints: nothing to confirm the scheme/destination are valid before dispatching, and no verify step after dispatch (e.g. checking run status or confirming the artifact landed). This matches the 3 anchor 'sequence present but checkpoints missing or implicit'; the destructive/batch cap does not apply since this is a CI dispatch, but the multi-step process still lacks verification, so the simple-skill 5 exception does not fit.

3 / 5

Progressive Disclosure

Section structure is good and the split between usage (SKILL.md) and workflow definition (template file) is the right architecture, but scoring against the actual bundle shows the body's link to `templates/mac-run.yml` points at a file that does not exist in the bundle (only scripts/install.sh is present, and it too targets ../templates/mac-run.yml). A clearly signaled reference to the single most important bundle file that is missing is more than the 'minor organization gaps' of the 4 anchor, so this lands at 3.

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 specific, distinctive one-sentence description that clearly conveys the niche (Xcode CI on GitHub Actions macOS runners) with concrete operations. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps completeness, and slightly thin synonym coverage for trigger terms.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user wants to run Xcode builds, tests, or simulator screenshots on GitHub Actions macOS runners, or asks for iOS/macOS CI."

Add a couple of natural trigger synonyms (CI, Swift/iOS app, unit tests) so the description matches phrasings users actually type.

Optionally mention what a run returns (logs and screenshot PNGs in one artifact) to round out capability coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "install or dispatch", "build, test or simulator screenshot run" — anchored to a concrete domain ("macOS GitHub Actions", "Xcode project"). It falls short of the 5 anchor because coverage has minor gaps: it omits that the run returns logs and PNGs in an artifact and that installation adds a workflow file to the repository.

4 / 5

Completeness

The 'what' is clear (install/dispatch a macOS GitHub Actions build, test, or simulator screenshot run), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by the domain phrasing. Per the judging guideline, a missing explicit trigger clause caps completeness at 3; it is not 2 because the 'what' half is specific and concrete.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "macOS", "GitHub Actions", "Xcode", "build", "test", "simulator screenshot". A few natural variants are missing ("CI", "Swift", "iOS app", "unit tests", "workflow"), keeping it at the 4 anchor rather than the comprehensive-synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The intersection of "macOS GitHub Actions" + "Xcode" + "simulator screenshot" is a clear, narrow niche with distinct trigger vocabulary; it is unlikely to fire for the wrong skill. This clearly matches the 5 anchor rather than 4, which would require some overlap risk with closely related skills.

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

.agents/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.