# Dovetail agent skills for Claude Code, Cursor and RevampKey

> Ready-made Dovetail playbooks for AI agents: find evidence for a research question in Dovetail, synthesise a Dovetail project's insights. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Dovetail connector safely with AI](https://revampkey.com/marketplace/dovetail/skills/essentials.md): Shows how to connect Dovetail, confirm the right workspace and project, and read research content without flooding the conversation. Dovetail data stays read-only, and the assistant asks before changing anything.
- [Find evidence for a research question in Dovetail](https://revampkey.com/marketplace/dovetail/skills/find-evidence-for-a-question.md): Answers a specific research question across your whole Dovetail workspace by checking which insights, data and highlights actually support it, and says how strong that evidence is. Read-only: it asks before changing anything.
- [Synthesise a Dovetail project's insights](https://revampkey.com/marketplace/dovetail/skills/synthesise-project-insights.md): Reads one Dovetail project's highlights, insights and linked data and reports grounded themes, the evidence behind each, contradictions and gaps. It only reads; it asks before changing anything.

## Install

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

```bash
for s in essentials find-evidence-for-a-question synthesise-project-insights; do
  curl -fsSL --create-dirs -o .agents/skills/dovetail-$s/SKILL.md https://revampkey.com/marketplace/dovetail/skills/$s/SKILL.md
done
```

### What is a Dovetail agent skill?

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

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

3 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 Dovetail.

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

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

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

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