# Whimsical agent skills for Claude Code, Cursor and RevampKey

> Ready-made Whimsical playbooks for AI agents: turn a brief into a Whimsical diagram, review and tidy a Whimsical workspace. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Whimsical connector safely](https://revampkey.com/marketplace/whimsical/skills/essentials.md): Sets out how an AI agent should work with Whimsical: confirm the workspace first, pick the right tool, keep searches small, and ask before any file is created or changed.
- [Turn a brief into a Whimsical diagram](https://revampkey.com/marketplace/whimsical/skills/create-diagram-from-brief.md): Turns loose notes or a brief into a flowchart, mind map or wireframe in Whimsical. It drafts the structure first and creates the file only after you approve it.
- [Review and tidy a Whimsical workspace](https://revampkey.com/marketplace/whimsical/skills/review-and-tidy-workspace.md): Surveys a Whimsical workspace or folder for duplicate, stale and misplaced files, then proposes a clean-up plan. It changes nothing until you approve each group.

## Install

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

```bash
for s in essentials create-diagram-from-brief review-and-tidy-workspace; do
  curl -fsSL --create-dirs -o .agents/skills/whimsical-$s/SKILL.md https://revampkey.com/marketplace/whimsical/skills/$s/SKILL.md
done
```

### What is a Whimsical agent skill?

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

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

The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Whimsical.

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

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

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

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