# Noteplan agent skills for Claude Code, Cursor and RevampKey

> Ready-made Noteplan playbooks for AI agents: clean up and organise NotePlan notes, weekly review of your NotePlan tasks and notes. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use NotePlan with AI, safely](https://revampkey.com/marketplace/noteplan/skills/essentials.md): Sets the assistant up to work with your NotePlan notes, tasks, calendar and reminders: it confirms the vault and folder scope first, picks the right tool for each job, and asks before changing anything.
- [Clean up and organise NotePlan notes](https://revampkey.com/marketplace/noteplan/skills/note-cleanup-and-organisation.md): Finds misplaced, duplicate-looking and orphaned notes in your NotePlan vault and turns them into a folder and tidy-up plan. It asks for your approval before moving, merging or archiving anything.
- [Weekly review of your NotePlan tasks and notes](https://revampkey.com/marketplace/noteplan/skills/notes-weekly-review.md): Reads your open NotePlan tasks and recent notes, sorts them into overdue, stalled and unfinished, and gives you a short ranked list. It changes nothing until you approve.

## Install

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

```bash
for s in essentials note-cleanup-and-organisation notes-weekly-review; do
  curl -fsSL --create-dirs -o .agents/skills/noteplan-$s/SKILL.md https://revampkey.com/marketplace/noteplan/skills/$s/SKILL.md
done
```

### What is a Noteplan agent skill?

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

### Do the Noteplan skills change anything on their own?

1 of the 3 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 Noteplan.

### 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 Noteplan; elsewhere you copy the folders into your project or skills directory.

### Do I need the Noteplan MCP server too?

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

MCP setup guide: https://revampkey.com/marketplace/noteplan.md