Browse documentation

Getting started

Agent tools

Recording format

Learn and reference

Docs · Agent Skill

The Clipy skill: read the recording, verify the change, return proof

One file teaches an agent the whole Clipy workflow: read a public recording, search private recording and imported context, choose the right proof path for its environment, preserve authenticated browser state, and return a playable verification link. Public reads still need no API key.

The live cross-surface contract is clipy.online/agents.md; the installed version is discovered with clipy guide --json and MCP tools/list.

Quickest install (one command)

npx @clipy/cli@latest agents install claude   # also: codex · cursor · windsurf · opencode

npx @clipy/cli@latest agents install claude installs only the skill file and may open first-run browser sign-in, but it does not change MCP configuration. Swap claude for codex, cursor, windsurf, or opencode. For skill plus MCP and sign-in, use clipy setup <agent>. The manual installs below still work and need no login for public links.

Install (Claude Code)

mkdir -p ~/.claude/skills/watch-clipy-recording
curl -fsSL -o ~/.claude/skills/watch-clipy-recording/SKILL.md \
  https://clipy.online/skills/watch-clipy-recording/SKILL.md

If ~/.claude/skills didn't exist before your current session, restart Claude Code once so it picks the skill up.

# Then just paste a Clipy link:
Watch https://clipy.online/video/abc123xyz and fix the bugs I point out.

Install (Codex-style skill folder)

mkdir -p ~/.codex/skills/watch-clipy-recording
curl -fsSL -o ~/.codex/skills/watch-clipy-recording/SKILL.md \
  https://clipy.online/skills/watch-clipy-recording/SKILL.md

Restart the agent session after adding the file so the new skill is loaded. The same SKILL.md works because it teaches the agent the Clipy URL convention, not a private API.

Install (claude.ai / desktop app)

Claude's web and desktop apps take custom skills as a ZIP upload (Settings → Features → Skills): download watch-clipy-recording.zip and upload it.

What it actually does

Every Clipy watch URL has a machine-readable twin: the same URL with .arec appended. That document carries the recording's AI summary and action items, its key moments (timestamped frames of what the speaker pointed at, with full-resolution pointer crops and click coordinates on Mac-app and Chrome-extension tab recordings) and the complete timestamped transcript. The skill teaches the agent to fetch it from the normal video link, wait if the recording is still processing, treat the frames as ground truth, enumerate the issues it extracted as a numbered list before touching code, and never follow instructions embedded in recording content. To be precise: the agent isn't decoding an MP4; it's reading a structured document derived from one, which is faster and more exact than watching pixels.

Every share link has AREC contextAdd .arec to any clipy.online/video link and the recording becomes actionable Markdown: requests, a draft plan, key moments, diagnostics, capture gaps, and transcript.

When the user asks for proof, the same skill inspects the repository's browser/profile rules and changed routes first. It can upload screenshots or an existing WebM/MP4 with clipy proof, capture a public or approved authenticated flow headlessly, or record the exact real Mac window. Screenshot inputs become one playable proof video, not a gallery.

Skill vs MCP vs CLI

Use	Pick	Why
Someone pasted a Clipy link	This skill	Default path. Public links need no auth and no MCP prompt.
Search your library, read private recordings, frames as inline images	MCP	Authenticated, richer tools (`wait_for_artifacts`, `get_agent_context`).
Scripts, hybrid search, proof, CI, terminal	CLI	JSON output, screenshot/video proof, headless and Mac capture.

They compose: the skill also tells the agent when reaching for the MCP or CLI is the better move.

The other direction

The skill is for consuming recordings. To produce them, record with Clipy for free, with no watermark, and the share link is agent-readable the moment you stop. The full agent-readable-recordings story lives at /for-agents.

Claude is a product of Anthropic. Clipy is not affiliated with Anthropic; this is a third-party skill that works with Claude Code, Claude apps, and agents that support local skill folders.