# Roam Research agent skills for Claude Code, Cursor and RevampKey

> Ready-made Roam Research playbooks for AI agents: capture notes into your Roam daily note, restructure or migrate part of your Roam Research graph, synthesise a literature note in Roam Research. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Work with your Roam Research graph using AI](https://revampkey.com/marketplace/roam-research/skills/essentials.md): Reads, searches and edits your Roam Research graph with an AI assistant, confirming the graph first and asking before every change.
- [Capture notes into your Roam daily note](https://revampkey.com/marketplace/roam-research/skills/daily-note-capture.md): 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.
- [Restructure or migrate part of your Roam Research graph](https://revampkey.com/marketplace/roam-research/skills/graph-restructure-and-migration.md): 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.
- [Synthesise a literature note in Roam Research](https://revampkey.com/marketplace/roam-research/skills/literature-note-synthesis.md): 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.
- [Review your Roam Research graph with AI](https://revampkey.com/marketplace/roam-research/skills/research-knowledge-review.md): 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.

## Install

- RevampKey: connect Roam Research at https://revampkey.com/marketplace/roam-research; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
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
```

### 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.

MCP setup guide: https://revampkey.com/marketplace/roam-research.md