Let Your Agent Organize Your Workflowy Inbox
github.com/mholzen/workflowy-triageVideo Walkthrough
The Problem
If you’re like me, you add a lot of things to your inbox with the intent of coming back later to file them. While I think it’s critically important to re-read notes and decide whether they’re worth keeping, that task can be daunting when the inbox grows.
So I wrote a skill to help.
What It Does
This skill instructs your agent to triage nodes by proposing a location based on rules you define. It analyzes each item, suggests where it should go, and explains its reasoning.
For each node in your list, it creates a proposal structure:
[inbox]
├── [node name](id) -> [target name]
│ ├── [original node]
│ ├── target: [link to proposed location]
│ ├── reason: [why this location fits]
│ └── alternative targets: [other options]
You then review each proposal, move the node to the target (or choose a better location), and clean up the scaffolding.
Why an Agent Works Well Here
Two things make this approach interesting:
Semantic understanding. The agent uses its understanding of the world to interpret your notes. A cryptic “science of achievement vs art of fulfillment” gets matched to your philosophical reflection category, not your TODO list. The agent reads meaning, not just keywords.
Learning from your choices. At the end of the process, you can instruct the agent to review your decisions and update its rules. If you consistently move meeting notes to “grow understanding” instead of “relationships,” the agent notices and proposes a rule update.
The Workflow
Phase 1: Propose Locations
Run the skill on your inbox:
/workflowy-triage inbox [rules-node-id]
The rules node is optional. If you don’t provide one, Claude searches your workspace for a node named “rules for triage” and uses that.
Claude reads your triage rules, analyzes each node, and creates proposal structures with primary and alternative suggestions.
Phase 2: Review
For each proposal:
- Click the target link to preview the destination
- Accept the suggestion or choose an alternative
- Move the original node to your chosen location
- Delete the proposal scaffolding
Phase 3: Learn
After you’ve made your choices:
/workflowy-triage inbox --review
Claude examines which suggestions you accepted versus rejected, identifies patterns, and proposes rule updates.
Defining Your Rules
Create a node called “rules for triage” with simple pattern-to-location mappings:
rules for triage
├── find the deepest most applicable node under synthesize
├── before finalizing a location, always call workflowy_get on it to see its children
│ └── only stop when the node is a leaf or no children match the item's content
The agent matches items against these patterns and proposes locations accordingly.
Taking It Further
While I think reviewing notes is a crucial step for integrating knowledge, this skill is easily extended. A future pass could move nodes to their target locations automatically, turning this from a review tool into a fully automated filing system.
Installation
This skill requires the Workflowy MCP server to be configured in Claude Code first.
Then install the skill:
npx workflowy-triage
This copies the skill files into ~/.claude/skills/workflowy-triage/.
Usage:
/workflowy-triage <node-id> [rules-node-id]
See the full documentation for details.
Related Posts
- Setting Up Workflowy as an MCP Server for Claude Code
- A Workflowy MCP Server with Recursive Get, Search, Replace and Reports
- Workflowy CLI: Transform Commands