# Clipcap Agent Tools

> Annotate existing image files with the clipcap command-line agent. Use only when the user supplies an image file and wants deterministic arrows, boxes, labels, mosaic blocks, or callouts rendered into a PNG. This skill must not capture the screen or request macOS privacy permissions.

- Skill: `realskyrin/clipcap-agent-tools` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add realskyrin/clipcap-agent-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/realskyrin/clipcap-agent-tools/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: realskyrin (https://skillmd.com/u/realskyrin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/realskyrin/clipcap-agent-tools

---


# clipcap-agent-tools

Use clipcap as an annotate-only image tool:

```bash
CLIPCAP="/Applications/clipcap.app/Contents/MacOS/clipcap"
"$CLIPCAP" agent annotate --input input.png --spec marks.json --out output.png --meta output.json --pretty
```

If the app is not installed, build it from the repository first:

```bash
bash scripts/rebuild-and-open.sh
```

The agent accepts existing image files only. Do not use this skill for screen capture, window enumeration, Finder selection, or any task that would require system privacy prompts.