Agent skill

Build And Run Screendrop

by fayazara in fayazara/Screendrop

Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build.

CC0-1.0Auto-check passedMobile

Install Build And Run Screendrop

skills CLI
$ npx skills add fayazara/Screendrop --skill build-and-run-screendrop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fayazara/Screendrop build-and-run-screendrop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fayazara/Screendrop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/build-and-run-screendrop .claude/skills/build-and-run-screendrop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
build-and-run-screendrop
GitHub stars
2.2k
Token cost
~1.1k tokens
SKILL.md length
429 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
CC0-1.0

At a glance

Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build.

  • The user asks to run
  • SKILL.md covers Steps, When to Use and Notes
  • Calls xcodebuild
  • Try out the app

What it does

Build And Run Screendrop is an agent skill from fayazara/Screendrop. Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build. Use this skill whenever the user asks to run, launch, relaunch, or try out the app, or says things like 'build and run' or 'restart the app'.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with macOS and Xcode. The repository describes itself as: A beautiful screenshot + screen recording + Loom alternative - all native, self hostable and free. The licence is CC0-1.0.

When your agent uses it

  • The user asks to run
  • Try out the app
  • Says things like build and run
  • Restart the app

Example prompts

  • “build and run”
  • “restart the app”
  • “/build-and-run-screendrop”

What it can do on your machine

Read from SKILL.md and the folder at commit 062a978. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • xcodebuild

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Build And Run Screendrop loads about 1.1k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 429 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fayazara/Screendrop at commit 062a978, republished under its CC0-1.0 licence (© fayazara). 429 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/build-and-run-screendrop/SKILL.md (or your agent's skills folder).
name
build-and-run-screendrop
description
Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build. Use this skill whenever the user asks to run, launch, relaunch, or try out the app, or says things like 'build and run' or 'restart the app'.

Build and Run Screendrop

This skill builds the Screendrop macOS application via xcodebuild, kills any running instance of the app (regardless of which scheme it was launched from), then launches the newly built app.

Steps

  1. Pick a scheme. List the schemes available in the project:
bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild \
  -project "/Users/fayazahmed/Developer/fayazara/mac/Screendrop/Screendrop.xcodeproj" \
  -list 2>/dev/null | sed -n '/Schemes:/,$p' | tail -n +2
  • If there is only one scheme, use it without asking.
  • If there is more than one scheme, ask the user which one to build/run (via AskUserQuestion) before proceeding, unless the user already named a scheme in their request (e.g. "run the Dev scheme"). Don't assume - the schemes can point at different configurations, bundle IDs, and even different launch arguments (e.g. Screendrop Demo builds the same Screendrop.app as the plain scheme but launches it with --demo-mode).
  1. Resolve build settings for the chosen scheme - don't hardcode the configuration or output path, since it varies per scheme:
bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild \
  -project "/Users/fayazahmed/Developer/fayazara/mac/Screendrop/Screendrop.xcodeproj" \
  -scheme "<SCHEME_NAME>" -showBuildSettings 2>/dev/null \
  | grep -E "^\s*(CONFIGURATION|BUILT_PRODUCTS_DIR|FULL_PRODUCT_NAME|EXECUTABLE_NAME) "

Use CONFIGURATION for the -configuration flag in the build step, and BUILT_PRODUCTS_DIR + FULL_PRODUCT_NAME to construct the .app path for the run step.

  1. Build the project with the resolved scheme/configuration:
bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild build \
  -project "/Users/fayazahmed/Developer/fayazara/mac/Screendrop/Screendrop.xcodeproj" \
  -scheme "<SCHEME_NAME>" \
  -configuration "<CONFIGURATION>" \
  -destination "platform=macOS" \
  2>&1 | grep -E "(BUILD SUCCEEDED|BUILD FAILED|error:)" | head -20

If the output shows BUILD FAILED, stop here, read the error: lines, and help the user fix them. Do not proceed to run a broken build. If the output is empty or unclear, re-run without the grep filter to get full output for diagnosis.

  1. Kill every running instance of the app, across all schemes - not just the one being launched. Different schemes can produce different executable names (Screendrop, Screendrop Dev), and leaving an old instance from another scheme running is confusing (duplicate menu bar icons, port/state conflicts, etc). Kill all known variants unconditionally before relaunching:
Show full SKILL.md (162 more words)Show less
bash
killall Screendrop 2>/dev/null
killall "Screendrop Dev" 2>/dev/null

(It's fine if these error because that variant wasn't running. If a new scheme is added later with a different EXECUTABLE_NAME, add its killall line here too - check with EXECUTABLE_NAME from step 2.)

  1. Run the freshly built app using the path resolved in step 2:
bash
open "<BUILT_PRODUCTS_DIR>/<FULL_PRODUCT_NAME>"

For the Screendrop Demo scheme specifically, pass the demo launch argument (the scheme's LaunchAction sets --demo-mode, but open won't pass it automatically):

bash
open "<BUILT_PRODUCTS_DIR>/Screendrop.app" --args --demo-mode

When to Use

  • User says "run it", "build and run", "try it out", "relaunch the app"
  • After making code changes, when the user wants to see the change live rather than just verify it compiles (for compile-only checks, use build-screendrop instead)

Notes

  • DerivedData paths are specific to this machine/checkout and can change between clean builds - always resolve BUILT_PRODUCTS_DIR via -showBuildSettings (step 2) rather than assuming a fixed path.
  • Screendrop Demo and plain Screendrop share the same Screendrop.app bundle and Screendrop executable name - they're only distinguished by the --demo-mode launch argument, not by build output.

© fayazara, CC0-1.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/build-and-run-screendrop of fayazara/Screendrop.

Open the folder on GitHubat commit 062a978

Compare with similar skills

Build And Run Screendrop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Build And Run Screendrop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Build And Run Screendrop this skillfayazara/Screendrop2.2k—~1.1kAutomated safety check: PassCC0-1.0
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca89k1 repos~584Automated safety check: PassApache-2.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
App Store Preflight Skillstruongduy2611/app-store-preflight-skills1.4k—~1.4kAutomated safety check: PassMIT
Macios Xcode Beta Updatedotnet/macios2.9k—~1.8kAutomated safety check: PassCustom licence

Similar skills

  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    89k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • App Store Preflight Skills

    truongduy2611/app-store-preflight-skills

    Scan an iOS/macOS Xcode project for common App Store rejection patterns before submission.

    1.4k GitHub stars~1.4k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Official

    Update dotnet/macios to a new Xcode beta and validate it end-to-end.

    2.9k GitHub stars~1.8k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Odevio

    Odevio/Odevio-CLI

    Take a Flutter project to an iPhone or the App Store with Odevio - build, sign and publish iOS apps from Windows, Linux or macOS with no Mac and no Xcode.

    423 GitHub stars~7.6k tokensUpdated 17 days ago
    MobileAuto-check passed

More from fayazara/Screendrop

  • macOS Notch UI

    fayazara/Screendrop

    Add a Dynamic Island-style notch UI to a macOS app. An agent skill from fayazara/Screendrop.

    2.2k GitHub stars~1.8k tokensUpdated 9 days ago
    Auto-check passed
  • Release Screendrop

    fayazara/Screendrop

    Release the Screendrop macOS app to GitHub using the screendrop-release CLI tool.

    2.2k GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • Build Screendrop

    fayazara/Screendrop

    Build the Screendrop macOS app using xcodebuild. An agent skill from fayazara/Screendrop.

    2.2k GitHub stars~346 tokensUpdated 9 days ago
    Auto-check passed

Works with

Categories

Questions about Build And Run Screendrop

What does Build And Run Screendrop do?

Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build. Build And Run Screendrop is an agent skill from fayazara/Screendrop. Build the Screendrop macOS app with xcodebuild, kill any running instance (of any scheme), and launch the fresh build.

When should I use Build And Run Screendrop?

Build And Run Screendrop fits situations like: the user asks to run; try out the app; says things like build and run; restart the app.

How do I install Build And Run Screendrop in Claude Code?

Run `npx skills add fayazara/Screendrop --skill build-and-run-screendrop -a claude-code`. Or copy the skill folder (.agents/skills/build-and-run-screendrop in fayazara/Screendrop) into .claude/skills/build-and-run-screendrop in your project. Claude Code loads it when a task matches its description.

How do I install Build And Run Screendrop in Codex?

Run `npx skills add fayazara/Screendrop --skill build-and-run-screendrop -a codex`. Or copy the skill folder (.agents/skills/build-and-run-screendrop in fayazara/Screendrop) into .agents/skills/build-and-run-screendrop in your project. Codex loads it when a task matches its description.

Can I use Build And Run Screendrop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fayazara/Screendrop --skill build-and-run-screendrop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-and-run-screendrop, .gemini/skills/build-and-run-screendrop, .github/skills/build-and-run-screendrop and .opencode/skills/build-and-run-screendrop in your project.

What does Build And Run Screendrop need to run?

Going by SKILL.md and its folder, Build And Run Screendrop needs the command-line tools its instructions call (xcodebuild).

Does Build And Run Screendrop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Build And Run Screendrop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Build And Run Screendrop use?

Build And Run Screendrop is published under the CC0-1.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Build And Run Screendrop use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Build And Run Screendrop?

Skills that share tags, products or a category with Build And Run Screendrop: macOS Spm App Packaging (Dimillian/Skills, 4k stars), Orca iOS Simulator Control (stablyai/orca, 89k stars), Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars) and App Store Preflight Skills (truongduy2611/app-store-preflight-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Build And Run Screendrop?

fayazara (a GitHub user) maintains it in fayazara/Screendrop, which has 2,154 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 1, 2026.

Source: fayazara/Screendrop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.