Shapes agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Shapes work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Shapes

Connect Shapes once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Shapes skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereRead-only10 Shapes tools

Use the Shapes HR connector safely

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.

Use it when

Your first HR question in a session, when the assistant should confirm whose view it is answering from
An answer that looks too small or empty, and you need to know whether data is hidden or missing
Working out whether to ask for a headcount summary or a full list of people

Tools it uses

get_employees
get_employee
get_employee_field_types
get_employee_field_values
get_reporting_chain
search_in_hierarchy
employee_insights
performance_review_cycle_insights
performance_review_participation_insights
time_away_insights

Example

How many people in the Berlin office are in engineering, and does the answer cover the whole company?

Your account is Priya Shah in the Berlin office, so I can see the Berlin team and the company-wide totals your role allows. Filtering by office and team gives 42 people in engineering, out of 61 in Berlin. I did not check other offices, so this covers only what your account can see.

Use in RevampKeyRead the full skill →

Read-only7 Shapes tools

Find people and build accurate rosters in Shapes

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.

Use it when

You need the contact or profile details for one person with a common name
You want everyone in a given office or job title as a roster
You need to confirm whether a person exists in the directory before messaging them

Tools it uses

get_current_user
get_employees
get_employee
get_entities
get_employee_field_types
get_employee_field_values
get_profile_picture

Example

List everyone in the Tel Aviv office with the title Engineer, with their team and manager.

Found 14 people in the Tel Aviv office with the title Engineer, across 2 pages of results, so the full list is 14. Two share the name Dana Levi; I have listed both with their teams so you can confirm which one you mean. Team and manager are shown; personal fields were left out as you did not ask for them.

Use in RevampKeyRead the full skill →

Read-only5 Shapes tools

Trace reporting lines in Shapes with AI

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.

Use it when

You need to know who someone reports to, all the way up the chain
You want the direct reports and full subtree of a leader
You suspect a manager link is missing or a reporting line is out of date

Tools it uses

get_current_user
get_employees
search_in_hierarchy
get_employee
get_reporting_chain

Example

Who does Priya Raman report to, and who sits under Marcus Lee's team?

Priya Raman reports to Marcus Lee, Head of Platform, who reports to the VP Engineering. Marcus has 4 direct reports and 11 people in his full subtree across 3 levels. One break: Dana Okafor has no manager recorded, so her line stops at her own record.

Use in RevampKeyRead the full skill →

Read-only7 Shapes tools

Track a performance review cycle with AI

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.

Use it when

A review cycle is closing and you need to know who has not submitted
You want the completion rate broken down by team or manager
A calibration meeting is blocked and you need the reviews holding it up

Tools it uses

get_performance_review_cycles
performance_review_cycle_insights
performance_review_participation_insights
get_performance_review_participants
get_performance_review_reviewers
get_employee
get_employee_field_values

Example

How is the Q1 performance review going? Who do I need to chase?

The Q1 cycle is 82 of 96 reviews complete (85%), 9 days past its due date. Three managers account for 11 of the 14 outstanding reviews, led by Priya Shah with 5 pending, so the Engineering group is the main blocker. Two participants have no assigned reviewer, which looks like a setup gap for the cycle admin.

Use in RevampKeyRead the full skill →

Read-only11 Shapes tools

Review team time-away coverage with AI

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.

Use it when

Before a busy period, to see who will be out and whether the team can cover it
When a manager asks whether a team has enough people in the office next month
When someone's balance may not cover their planned leave

Tools it uses

time_away_insights
get_employees
search_in_hierarchy
get_time_away_bookings
get_time_away_holidays
get_attendances
get_time_away_balance
get_time_away_days_grants
get_time_away_policy_assignments
get_time_away_reason_policies
get_time_away_reasons

Example

Will the Tel Aviv engineering team have enough people in the office for the two weeks starting 9 March?

Eleven of the fourteen engineers are on the team's schedule for those two weeks. Three days are below the minimum of seven: 11 March has five available, with two out on approved vacation and one on a public holiday. Two people have pending requests that would add a further gap on 13 March, so that day is at risk if they are approved. Nothing here has been changed.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Shapes, updates them for you and removes them when you disconnect.

Download RevampKey

How Shapes skills work

Connect Shapes
The Shapes MCP server gives the agent its tools.
Ask in plain words
“List everyone in the Tel Aviv office with the title Engineer, with their team and manager.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Shapes skills

In RevampKey the skills install themselves when you connect Shapes. In other tools each skill is one folder with a SKILL.md file, and you also need the Shapes MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Shapes. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “List everyone in the Tel Aviv office with the title Engineer, with their team and manager.”
Download RevampKeyConnect Shapes · 1 click
Get RevampKey to connect Shapes
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Shapes is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
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 .claude/skills/shapes-$s/SKILL.md https://revampkey.com/marketplace/shapes/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Shapes MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

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 .claude/skills/shapes-$s/SKILL.md https://revampkey.com/marketplace/shapes/skills/$s/SKILL.md
done

Ask in plain language, for example “List everyone in the Tel Aviv office with the title Engineer, with their team and manager.”

Into the shared .agents/skills folder

Connect the Shapes MCP server in Cursor.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “List everyone in the Tel Aviv office with the title Engineer, with their team and manager.”

Into the shared .agents/skills folder

Connect the Shapes MCP server in Codex.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “List everyone in the Tel Aviv office with the title Engineer, with their team and manager.”

Into the shared .agents/skills folder

Connect the Shapes MCP server in VS Code.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “List everyone in the Tel Aviv office with the title Engineer, with their team and manager.”

RevampKey or copy the files?

In RevampKey

One click when you connect Shapes
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Shapes MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Shapes skills FAQ

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.

Shapes MCP server setup · This page as Markdown

Put Shapes’s best workflows in your agent

Download RevampKey, connect Shapes and ask your first question in about a minute.

Download RevampKey Connect Shapes · 1 click

All 5 Shapes skills

Use the Shapes HR connector safely

Use it when

Tools it uses

Find people and build accurate rosters in Shapes

Use it when

Tools it uses

Trace reporting lines in Shapes with AI

Use it when

Tools it uses

Track a performance review cycle with AI

Use it when

Tools it uses

Review team time-away coverage with AI

Use it when

Tools it uses

Get all 5 without copying a file

How Shapes skills work

How to install Shapes skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Shapes skills FAQ

Put Shapes’s best workflows in your agent

Skills for related tools