vanillagreencom/kendex/xcode-run

Claude Code and agent skill by vanillagreencom/kendex

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

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

Install

npx vskill@latest install vanillagreencom/kendex/xcode-run

SKILL.md

Xcode run

Install this skill in project scope and consent to its repository effects. kendex runs scripts/install.sh to add templates/mac-run.yml as .github/workflows/mac-run.yml. The installer preserves an existing workflow. Commit the workflow to the default branch so GitHub can dispatch it.

Consumer configuration

Edit the top-level env values in .github/workflows/mac-run.yml:

ValueMeaning
XCODE_SCHEMEA shared Xcode scheme. Replace the App placeholder.
XCODE_DESTINATIONAn Xcode destination available on macos-latest. Replace the example with a simulator supported by the selected Xcode. Screenshots require a concrete simulator, not a generic destination.

The workflow runs xcodebuild from the repository root. A workspace, multiple projects or a project in a subdirectory needs the corresponding path or working directory in the installed workflow. The screenshot scheme must build one simulator application target. The workflow reads its app path and simulator identifier from xcodebuild -showBuildSettings -json. It reads the bundle identifier from the built app's Info.plist.

Dispatch

workflow_dispatch is the only trigger. Its only input is step:

stepOperation
buildxcodebuild build. This is the default.
testxcodebuild test. The scheme must have a test action.
screenshotsBoot the selected simulator, build, install and launch the app, then capture screenshots/launch.png.
bash
gh workflow run mac-run.yml -f step=build
gh workflow run mac-run.yml -f step=test
gh workflow run mac-run.yml -f step=screenshots

Screenshots capture the launch view after a short wait. They do not navigate the app or assert that its UI is ready.

Artifact

Each run uploads one artifact named mac-run:

  • logs/<step>.log: combined command output for the selected operation.
  • screenshots/*.png: simulator images from a screenshot run.

The upload runs with if: always(). A failing command fails the run and keeps its log for upload. A failed checkout or runner interruption can prevent log creation or upload.

The workflow disables code signing. It does not archive, export or deploy an app.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/vanillagreencom/kendex/xcode-run/badge)](https://verified-skill.com/skills/vanillagreencom/kendex/xcode-run)

Something wrong with this skill or its page? Tell us.