Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 1.57 KB

README.md

File metadata and controls

57 lines (41 loc) · 1.57 KB

/ss - iOS Simulator Screenshot

Capture a screenshot from the iOS Simulator and attach it to the conversation. Type /ss, ask Claude to take a screenshot, or just let it trigger automatically when a screenshot is needed — no permission prompts either way.

Requirements

  • macOS with Xcode installed
  • iOS Simulator running
  • Claude Code CLI

Installation

1. Copy the skill files

mkdir -p ~/.claude/skills/ss/scripts
cp skills/ss/SKILL.md ~/.claude/skills/ss/SKILL.md
cp skills/ss/scripts/screenshot.sh ~/.claude/skills/ss/scripts/screenshot.sh
chmod +x ~/.claude/skills/ss/scripts/screenshot.sh

2. Add permissions to your settings

Open ~/.claude/settings.json and merge these entries:

{
  "permissions": {
    "allow": [
      "Bash(bash ~/.claude/skills/ss/scripts/screenshot.sh)",
      "Read(/tmp/claude-screenshots/*)"
    ],
    "additionalDirectories": [
      "/tmp/claude-screenshots"
    ]
  }
}

If you already have existing entries in allow or additionalDirectories, just append the new values to the arrays.

Usage

In any Claude Code session with an iOS Simulator running:

/ss

The screenshot is captured and attached to the conversation. You can then ask Claude to analyze the UI, find bugs, compare with a design, etc.

How it works

  1. /ss triggers the skill
  2. A bash script runs xcrun simctl io booted screenshot to capture the screen
  3. The screenshot is saved to /tmp/claude-screenshots/latest.png
  4. Claude reads the image and attaches it to the conversation