# Shapes agent skills for Claude Code, Cursor and RevampKey

> Ready-made Shapes playbooks for AI agents: find people and build accurate rosters in Shapes, trace reporting lines in Shapes with AI, track a performance review cycle with AI. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Shapes HR connector safely](https://revampkey.com/marketplace/shapes/skills/essentials.md): Shows an AI assistant how to read Shapes HR data within the signed-in account's visibility, pick the right tool family, keep results small and protect sensitive personal fields. Every tool is read-only, so it never changes records.
- [Find people and build accurate rosters in Shapes](https://revampkey.com/marketplace/shapes/skills/employee-directory-lookup.md): Looks up a person or a group of employees by name, job title, office or team, and returns a roster with the right fields and an honest count. Shows its own view scope and never reads a partial list as complete.
- [Trace reporting lines in Shapes with AI](https://revampkey.com/marketplace/shapes/skills/org-chart-reporting-lines.md): Walks Shapes reporting chains up or down to answer who manages whom and what a team's hierarchy looks like. It flags gaps, cycles and out-of-scope managers before answering, and it only reads data.
- [Track a performance review cycle with AI](https://revampkey.com/marketplace/shapes/skills/performance-review-cycle-tracking.md): Shows how far a Shapes performance review cycle has got, who is still outstanding and how late it is, and builds a prioritised chase list for managers. Read-only: it drafts reminders but never sends them.
- [Review team time-away coverage with AI](https://revampkey.com/marketplace/shapes/skills/time-away-coverage-review.md): Checks upcoming bookings, balances, policies and holidays for a team to find coverage gaps and balance risks. It only reads data and never approves or changes a booking.

## Install

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

```bash
for s in essentials employee-directory-lookup org-chart-reporting-lines performance-review-cycle-tracking time-away-coverage-review; do
  curl -fsSL --create-dirs -o .agents/skills/shapes-$s/SKILL.md https://revampkey.com/marketplace/shapes/skills/$s/SKILL.md
done
```

### What is a Shapes agent skill?

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

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

5 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 Shapes.

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

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

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

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