Roam Research agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Roam Research work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Roam Research

Connect Roam Research once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Roam Research skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing20 Roam Research tools

Work with your Roam Research graph using AI

Reads, searches and edits your Roam Research graph with an AI assistant, confirming the graph first and asking before every change.

Use it when

You want to find notes or pages across your Roam graph without scrolling.
You want to add blocks or a daily note entry, and review exactly what will be written first.
You are unsure which of your graphs the assistant is about to change.

Tools it uses

list_graphs
get_graph_guidelines
setup_new_graph
get_page
get_block
search
datalog_query
roam_query
get_backlinks
get_comments
search_templates
create_block
update_block
move_block
delete_block
create_page
update_page
delete_page
append_to_daily_note
add_comment

Example

Find everything in my research graph that links to the page 'Attention economics' and add a summary block under it.

I found 6 pages linking to 'Attention economics' in your research graph. Here is the summary block I would add under that page: 'Six notes connect to this topic, mostly around advertising models and reading habits.' Nothing has been written yet. Should I add this block?

Use in RevampKeyRead the full skill →

Asks before writing8 Roam Research tools

Capture notes into your Roam daily note

Splits a messy stream of thoughts, meeting notes or reading into atomic blocks, links them to existing pages and shows a draft. It writes to your graph only after you approve.

Use it when

After a meeting, to split the notes into tasks, decisions and facts
When you want a reading session logged against the right topic pages
When a rambling voice-memo transcript needs to become organised journal entries

Tools it uses

list_graphs
get_page
append_to_daily_note
search
get_backlinks
create_block
update_block
create_page

Example

Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.

I'll write to your main graph and check today's page first. The notes split into 9 blocks: 4 events, 3 ideas and 2 tasks. I found existing pages for Priya and the Checkout project, so I'll link to them, and I suggest one new page for the pricing experiment, which came up in 3 entries. Here is the draft. Reply yes to write it, or tell me what to change.

Use in RevampKeyRead the full skill →

Asks before writing17 Roam Research tools

Restructure or migrate part of your Roam Research graph

Plans a reorganisation of a section of your Roam graph, such as merging duplicate pages or moving blocks under a new parent, by checking what depends on it first. It lists every change and asks before each one, and it asks again before any deletion.

Use it when

Merging two pages that cover the same topic
Moving a project's notes under a new parent page
Retiring an old daily-note template without breaking the pages that use it

Tools it uses

list_graphs
get_backlinks
get_page
get_block
roam_query
datalog_query
search
get_comments
move_block
update_block
update_page
delete_page
delete_block
create_page
create_block
add_comment
append_to_daily_note

Example

Merge my two 'Q3 planning' pages into one and keep every link pointing to it.

I found 2 pages to merge: 'Q3 planning' and 'Q3 planning (old)'. The old page has 14 blocks to move and 9 backlinks that will need updating. Here is the plan. Steps 1 to 3 are non-destructive, so please approve them. Step 4 deletes the old page and needs its own yes.

Use in RevampKeyRead the full skill →

Asks before writing12 Roam Research tools

Synthesise a literature note in Roam Research

Builds a study or research note from a source by gathering your existing notes on the topic and tracing backlinks to find support and tension. It drafts a synthesis page and waits for your approval before writing anything.

Use it when

You finished a book or paper and want it connected to what you already know
You are preparing a write-up and need your existing notes pulled together
You want to find where your past notes disagree with a new source

Tools it uses

list_graphs
search
roam_query
datalog_query
get_page
get_block
get_comments
get_backlinks
create_page
create_block
update_page
append_to_daily_note

Example

Synthesise my notes on memory consolidation against the paper I just read, and show me the draft before you save it.

I found 6 pages on memory consolidation and traced 14 backlinks. Two notes support the paper's sleep-replay claim, and one older note from 2023 contradicts its timing. I've drafted a synthesis page with 3 connections and 2 open questions. Nothing is saved yet; tell me which parts to keep and I'll write the page.

Use in RevampKeyRead the full skill →

Read-only9 Roam Research tools

Review your Roam Research graph with AI

Audits a Roam graph for dead links, duplicate pages, orphans and unfinished notes, then returns a prioritised cleanup list. It only reads and reports, and asks before changing anything.

Use it when

You want to find pages nothing links to before deciding what to keep
Your graph has grown messy and you need to know where to start tidying
You suspect duplicate pages under slightly different titles

Tools it uses

list_graphs
search
roam_query
datalog_query
search_templates
get_page
get_block
get_backlinks
get_graph_guidelines

Example

Audit my Roam graph for dead links and duplicate pages, and give me a prioritised cleanup list. Don't change anything yet.

Your graph has 12 dead links, which break navigation, so I'd fix those first. There are 3 duplicate groups, for example "Meeting notes" and "meeting notes", and the likely canonical page has the most references. I also found 41 orphan pages. 29 look intentional, such as reference entries, so I've flagged only the 12 that look like leftovers. Nothing has been changed; tell me which to act on.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Roam Research, updates them for you and removes them when you disconnect.

Download RevampKey

How Roam Research skills work

Connect Roam Research
The Roam Research MCP server gives the agent its tools.
Ask in plain words
“Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Roam Research skills

In RevampKey the skills install themselves when you connect Roam Research. In other tools each skill is one folder with a SKILL.md file, and you also need the Roam Research MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Roam Research. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.”
Download RevampKeyConnect Roam Research · 1 click
Get RevampKey to connect Roam Research
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Roam Research is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials daily-note-capture graph-restructure-and-migration literature-note-synthesis research-knowledge-review; do curl -fsSL --create-dirs -o .claude/skills/roam-research-$s/SKILL.md https://revampkey.com/marketplace/roam-research/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Roam Research MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials daily-note-capture graph-restructure-and-migration literature-note-synthesis research-knowledge-review; do
  curl -fsSL --create-dirs -o .claude/skills/roam-research-$s/SKILL.md https://revampkey.com/marketplace/roam-research/skills/$s/SKILL.md
done

Ask in plain language, for example “Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.”

Into the shared .agents/skills folder

Connect the Roam Research MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials daily-note-capture graph-restructure-and-migration literature-note-synthesis research-knowledge-review; do
  curl -fsSL --create-dirs -o .agents/skills/roam-research-$s/SKILL.md https://revampkey.com/marketplace/roam-research/skills/$s/SKILL.md
done

Ask in plain language, for example “Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.”

Into the shared .agents/skills folder

Connect the Roam Research MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials daily-note-capture graph-restructure-and-migration literature-note-synthesis research-knowledge-review; do
  curl -fsSL --create-dirs -o .agents/skills/roam-research-$s/SKILL.md https://revampkey.com/marketplace/roam-research/skills/$s/SKILL.md
done

Ask in plain language, for example “Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.”

Into the shared .agents/skills folder

Connect the Roam Research MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials daily-note-capture graph-restructure-and-migration literature-note-synthesis research-knowledge-review; do
  curl -fsSL --create-dirs -o .agents/skills/roam-research-$s/SKILL.md https://revampkey.com/marketplace/roam-research/skills/$s/SKILL.md
done

Ask in plain language, for example “Turn my meeting notes from this morning with the design team into my daily note, link the people and projects, and show me what you'd add before saving.”

RevampKey or copy the files?

In RevampKey

One click when you connect Roam Research
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Roam Research MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Roam Research skills FAQ

What is a Roam Research agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Roam Research skill describes one job, which Roam Research tools to use in which order, what to check first and when to stop and ask you.

Do the Roam Research skills change anything on their own?

1 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Roam Research.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Roam Research; elsewhere you copy the folders into your project or skills directory.

Do I need the Roam Research MCP server too?

Yes. The skills tell the agent how to do the work; the Roam Research MCP server gives it the tools to do it. The Roam Research MCP setup guide covers every client.

Roam Research MCP server setup · This page as Markdown

Put Roam Research’s best workflows in your agent

Download RevampKey, connect Roam Research and ask your first question in about a minute.

Download RevampKey Connect Roam Research · 1 click

All 5 Roam Research skills

Work with your Roam Research graph using AI

Use it when

Tools it uses

Capture notes into your Roam daily note

Use it when

Tools it uses

Restructure or migrate part of your Roam Research graph

Use it when

Tools it uses

Synthesise a literature note in Roam Research

Use it when

Tools it uses

Review your Roam Research graph with AI

Use it when

Tools it uses

Get all 5 without copying a file

How Roam Research skills work

How to install Roam Research skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Roam Research skills FAQ

Put Roam Research’s best workflows in your agent

Skills for related tools