plannotator-inbox — Claude Code skill: installation
This Claude Code skill opens the Plannotator Inbox in a browser and reports its address. During the session, it routes decisions and completed long-form work through the Inbox.
Apache-2.0 199 installs ★ 14,187 updated 2026-10-25
npx skills add backnotprop/plannotator --skill plannotator-inbox -a claude-codeWhat plannotator-inbox does
The skill runs plannotator inbox --open, opens the Plannotator Inbox in a browser, and reports its address. The command starts the Inbox if it is stopped. The plannotator program is required.
For the rest of the session, the skill uses the Inbox for questions that need a person’s decision and for handing over completed long tasks with a short summary and files. Inbox replies do not block the agent’s work; it can continue with other tasks and return to the thread later. Before the first message, the skill instructs the agent to read plannotator inbox --help.
What it helps with
- open the Plannotator Inbox in a browser
- send a decision request to a person
- hand over a completed long task with a summary and files
Example prompts for the agent
- Open the Plannotator Inbox and tell me its address.
- Send an Inbox question that needs my decision.
- Share a short report on the completed work in the Inbox and attach the files.
How to install plannotator-inbox
1Skills CLI (Vercel)
npx skills add backnotprop/plannotator --skill plannotator-inbox -a claude-code2Manually: put the files in place
~/.claude/skills/plannotator-inbox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/plannotator-inbox/
1Skills CLI (Vercel)
npx skills add backnotprop/plannotator --skill plannotator-inbox -a codex2Manually: put the files in place
.agents/skills/plannotator-inbox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add backnotprop/plannotator --skill plannotator-inbox -a cursor2Manually: put the files in place
.cursor/skills/plannotator-inbox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install backnotprop/plannotator apps/skills/claude/plannotator-inbox2Manually: put the files in place
.github/skills/plannotator-inbox/SKILL.md1Skills CLI (Vercel)
npx skills add backnotprop/plannotator --skill plannotator-inbox -a gemini-cli2Platform CLI
gemini skills install https://github.com/backnotprop/plannotator --path apps/skills/claude/plannotator-inboxManually: put the files in place
.devin/skills/plannotator-inbox/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add backnotprop/plannotator --skill plannotator-inbox -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about plannotator-inbox
How do I install plannotator-inbox in Claude Code?
Run npx skills add backnotprop/plannotator --skill plannotator-inbox -a claude-code. The skill file is installed at ~/.claude/skills/plannotator-inbox/SKILL.md.
What does plannotator-inbox do?
It opens the Plannotator Inbox in a browser and reports its address. During the session, it also uses the Inbox for questions that need a person’s decision and handoffs for long tasks.
What does plannotator-inbox need to run?
The plannotator program is required. The skill starts it with plannotator inbox --open.
Source text
SKILL.md · Apache-2.0
--- name: plannotator-inbox description: Open the Plannotator Inbox in the browser (starting it if needed), say its address, and learn how to use the Inbox for the rest of the session. allowed-tools: Bash(plannotator:*) disable-model-invocation: true --- # Plannotator Inbox ## Inbox address !`plannotator inbox --open` ## Using the Inbox The Plannotator Inbox is one window on this computer where you leave the person messages, `:::question` blocks they answer with a click, and files. They answer when they can. Nothing blocks: you send, then keep working or end your turn. - Use it for a decision only they can make (a :::question block; go on with other work), finished long work (a short summary with its pictures inline, files in `attachments`), or when they ask. - One thread per work stream, unless the person says otherwise. - Send with a `plannotator_inbox` tool when you have one (it can be listed with a prefix and may need loading through tool search first): `action` `send_message`, with a markdown `body`. Otherwise call `send_message` on the Inbox's MCP server, `plannotator inbox mcp`. - send_message's result says whether the person's reply arrives in this session by itself. When it does, do not wait or poll for it: end your turn or go on with other work. When it does not, go on with your work and read the thread later with read_thread. - A decision in the Inbox stays there: when the person writes in the chat, say what waits and link its thread, but never also ask it in the chat with a blocking question tool (AskUserQuestion or similar). Ask in the chat only about something new they raised there that needs no pictures or files, or when they ask. - Be proactive about Inbox updates and about replying to the person through the Inbox when you think they would want you to. Don't withhold important updates or decisions, and don't batch updates to send later: proactivity is better than procrastination. - Never run `plannotator inbox` just to send: send_message starts a stopped Inbox itself, and bare `plannotator inbox` opens the window for the person. - Before your first send, run `plannotator inbox --help` and read it: every field, the full question syntax, and how to connect the MCP server. - The `plannotator` skill, where you have it, has more. ## Your task The output above is the Plannotator Inbox's address; it opened in the person's browser unless the output says why not. Tell them the address in one sentence, with that reason when there is one. If the output is an error, tell them what it says; `Unknown inbox option: --open` means their Plannotator is older than this command (update with `plannotator update`, or run `plannotator inbox` in a terminal). This command starts no new work and resumes none: do anything else the person asked in the same message, otherwise stop there. For the rest of this session, use the Inbox as above: for a decision the person is not here to make, and to hand over long work you finished.
© backnotprop · Apache-2.0 · backnotprop/plannotator