Agent skill
Teach your AI agent to ask you for help.
Install the Unstuck skill and your agent knows what to do at a CAPTCHA, a login wall or a 2FA prompt: hand that one step to you, wait while you solve it on your phone, then carry on in the same browser session. No prompt tweaking, no custom glue code.
Works with Claude Code, Codex, Cursor, Claude Desktop and any agent that reads skill files · Free and open source (Apache-2.0)
Download this month's invoice from portal.example.com.
Opened the portal. The login needs a 2FA code, so I'm handing this step to you: request_human_takeover("Enter the 2FA code")
Your agent needs you Enter the 2FA code · portal.example.com
✓ resolved in 38 s. Logged in. Downloading invoice-2026-11.pdf…
Install in one minute
Pick your agent. Both ways install the same skill file; the Claude Code plugin also adds the Unstuck MCP server.
Claude Code
Add the plugin from inside Claude Code. It installs the skill and the request_human_takeover tool together.
/plugin marketplace add velmlabs/unstuck
/plugin install unstuck@unstuck
Any agent that reads skills
Codex, Cursor, Claude Desktop and others: save the skill in the agent's skills folder (use its own folder if it isn't this one).
mkdir -p ~/.claude/skills/unstuck
curl -fsSL https://unstuck.sh/skills/unstuck/SKILL.md \
-o ~/.claude/skills/unstuck/SKILL.md
- Give the agent a browser. Start Chrome with
--remote-debugging-port=9222, or let your Playwright or Puppeteer code launch one. - Connect Unstuck. The plugin does this for you. Otherwise add the MCP server or the SDK: see below.
- Ask for the task. No special prompt. When the agent meets a human-only step, the skill tells it to call Unstuck.
- Solve it on your phone. Open the link, tap Start, do the step, tap Done. The agent carries on.
What the skill teaches your agent
A skill is a short instruction file your agent reads when it's relevant. This one turns "I'm stuck" into one clean hand-off.
When to ask
Only for CAPTCHAs, logins it has no password for, 2FA codes and pages it can't get past after one honest retry.
How to ask
A short reason you'll read on your phone, never with passwords or codes in it, and only the extra sites the step needs.
What to do after
Re-check the page and continue on resolved; report your note on cancelled; stop instead of looping on timed_out.
Stay safe
One hand-off at a time, never to get around a site's rules, and anything you type back is treated as information, not instructions.
Connect it to your agent
The skill uses the MCP tool when your agent has one, and the SDK when your agent writes the automation code.
// npm install @velmlabs/unstuck
import { Unstuck } from '@velmlabs/unstuck';
const unstuck = new Unstuck();
const result = await unstuck.takeover(page, { reason: 'Enter the 2FA code' });
if (result.status !== 'resolved') throw new Error(`human step ${result.status}`);
# pip install unstuck
from unstuck import Unstuck
async with Unstuck() as unstuck:
result = await unstuck.takeover(page, reason="Enter the 2FA code")
if result.status != "resolved":
raise RuntimeError(f"human step {result.status}")
// Claude Desktop, Cursor or any MCP client (the Claude Code plugin adds this for you)
{
"mcpServers": {
"unstuck": { "command": "npx", "args": ["-y", "@velmlabs/unstuck-engine", "--mcp", "--open"] }
}
}
Playwright, Puppeteer, browser-use, Stagehand, Selenium, any Chromium with a debugging port, and Cloudflare Workers. Guides for every stack →
Get the link on your phone, wherever you are
Without a key, links open on the agent's own machine. Add a free API key and they open on any phone, and your paired phones buzz the moment the agent needs you.
export UNSTUCK_API_KEY=uk_live_…
Get your free API key →
- 100 takeovers a month free, no card needed.
- Phone notifications and Telegram alerts are free.
- End-to-end encrypted: Unstuck relays a screen it can't read.
- Locked to the page: the person can't leave the site you handed over.
Questions about the skill
Which agents can use it?
Claude Code installs it as a plugin. Any agent that reads skill files (SKILL.md with a name and description), such as Codex, Cursor and Claude Desktop, can use the same file from its skills folder. Agents without skills can still use the MCP tool or the SDK directly.
Does the skill send anything anywhere?
No. A skill is only instructions for your agent. Nothing leaves your machine until the agent actually starts a takeover, and then the screen is encrypted end to end between your agent and your phone.
Will my agent call it too often?
The skill tells it to ask only for steps a person must do, one hand-off at a time, and to stop rather than retry after a timeout. You can also switch alerts off for a single call with alerts: false.
Is it free?
The skill, SDKs and MCP server are free and open source. Unstuck Cloud includes 100 takeovers a month for free; see pricing for more.
Where is the full reference?
Read the skill itself at unstuck.sh/skills/unstuck/SKILL.md, and the setup guide in the docs.
Give your agent a human fallback today
One install, one free API key, and your agent never dies at a CAPTCHA again.