# Sourcegraph agent skills for Claude Code, Cursor and RevampKey

> Ready-made Sourcegraph playbooks for AI agents: investigate when and why code behaviour changed in Sourcegraph, audit a code pattern across repositories. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use Sourcegraph with AI, safely and precisely](https://revampkey.com/marketplace/sourcegraph/skills/essentials.md): Guides an AI assistant through searching a Sourcegraph instance: it confirms the instance, repository and revision first, picks the right search or navigation tool, and reads the actual code before claiming anything. It stays read-only.
- [Investigate when and why code behaviour changed in Sourcegraph](https://revampkey.com/marketplace/sourcegraph/skills/change-history-investigation.md): Works out when a behaviour changed and which commit caused it, by comparing release tags, searching commits and diffs, and reading the code at each revision. It is read-only and asks before changing the active instance or workspace.
- [Audit a code pattern across repositories](https://revampkey.com/marketplace/sourcegraph/skills/code-search-audit.md): Sweeps many repositories for a pattern, reads each hit in context to confirm it, and reports verified counts with a clear statement of what was covered. It is read-only and never changes code.

## Install

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

```bash
for s in essentials change-history-investigation code-search-audit; do
  curl -fsSL --create-dirs -o .agents/skills/sourcegraph-$s/SKILL.md https://revampkey.com/marketplace/sourcegraph/skills/$s/SKILL.md
done
```

### What is a Sourcegraph agent skill?

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

### Do the Sourcegraph 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 Sourcegraph.

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

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

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

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