Assistant guide

An assistant connected through MCP learns how ThreadPage works when it connects. The ThreadPage skill gives it the same guide to formatting notes and working with them ahead of time. It helps most in the Claude app, where assistants don’t see what ThreadPage tells them when they connect.

Install the ThreadPage skill

The commands are for macOS and Linux. Run the same command again to update the skill.

Claude

Download the skill, then upload the ZIP in Claude under Customize → Skills. Skills need a paid Claude plan with code execution turned on.

Codex

mkdir -p ~/.agents/skills && cd ~/.agents/skills \
  && curl -fsSLO https://thread.page/agents/threadpage-skill.zip \
  && unzip -o threadpage-skill.zip && rm threadpage-skill.zip

Claude Code

mkdir -p ~/.claude/skills && cd ~/.claude/skills \
  && curl -fsSLO https://thread.page/agents/threadpage-skill.zip \
  && unzip -o threadpage-skill.zip && rm threadpage-skill.zip

Skill files

The same skill as files: SKILL.md and its guides to formatting and working with ThreadPage.

What assistants can format

Assistants write notes in Markdown. It becomes the formatting you use in the editor:

# Title ## Heading ### Subheading: Title, Heading, Subheading
**bold**
*italic*
~~strike~~
`code`: Bold, italic, strikethrough, monospace
[label](url): Link
- item 1. item: Bulleted and numbered lists
- [ ] open - [x] done: Checklist
> text: Quote
```: Monostyled text
| Check | Result | | --- | --- |: Table
![What it shows](attachment:ID): Image
https://thread.page/app/notes/ID: Note reference

A note reference is a note’s link, from Copy link, on a line of its own. For underline, text colour, highlight, text size, alignment and tags, an assistant writes the note’s rich document instead of Markdown, and ThreadPage asks it to keep them when it edits a note.

How assistants change your notes

ThreadPage asks them to add progress, results and decisions as new notes at the end of a thread, and to change an existing note only when you ask.
With a free account, assistants and scripts can add notes to your Inbox, up to 3,000 a month. They can’t read your notes.
To change a note, an assistant has to read all of it first. If you changed the same part meanwhile, ThreadPage doesn’t save its change and asks it to read the note again.
Each change an assistant sends has its own ID, so repeating one that didn’t get an answer doesn’t add it twice.
Assistants are told to treat the text in your notes as information, not instructions, except a note you address to them with @. Drafts and private recovery versions stay private.
Notes they add or change show “Added via” or “Edited via” with the connection’s name. Open Activity from a thread’s actions to review changes and undo one.

Open Connections