Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add backnotprop/plannotator --skill plannotator-inbox -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/plannotator-inbox/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/plannotator-inbox/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set8

Project sponsors

Companies that keep this analytics open