beehiiv agent skills for Claude Code, Cursor and RevampKey

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

Download RevampKey, free I have it: connect beehiiv

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

All 5 beehiiv skills

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

Start hereAsks before writing22 beehiiv tools

Use beehiiv safely with AI

Shows how to work in beehiiv with AI: confirm the publication first, pick the right post, template or automation tool, and wait for your yes before anything changes.

Use it when

You want an assistant to make a change in your beehiiv publication without risking the wrong one
A beehiiv call returned a permission or rate-limit error and you need to know what to do
You are unsure whether a request touches a live post, a template or an automation

Tools it uses

discover_publications
edit_post
edit_post_content
duplicate_post
edit_post_template
edit_post_template_content
duplicate_post_template
get_automation
get_automation_email_content
add_automation_step
delete_automation_step
delete_automation_trigger
edit_automation_email_content
edit_page
add_segment_to_newsletter_list
get_ad_report
delete_podcast_episode
delete_podcast_show
ban_community_member
create_community_invite
generate_image
get_asset

Example

Edit the subject line on my last newsletter, but only after you confirm which publication I mean.

Your account has two publications: Weekly Notes and Founders Digest. Which one should I use? Once you confirm, I'll pull the last sent issue, show you the current subject line and the proposed new one, and wait for your yes before changing anything.

Use in RevampKeyRead the full skill →

Read-only4 beehiiv tools

Ad performance reports for your beehiiv publication

Turns beehiiv advertising and publication numbers into a report that explains what changed, separates real signal from small-sample noise, and says what the data cannot prove. It reads results only and changes nothing.

Use it when

You need a summary of last month's sponsorship and ad results for an advertiser.
Clicks dropped and you want to know whether it is a real trend or a few unusual sends.
You are deciding whether to renew or reprice a sponsor slot and need a clear comparison.

Tools it uses

discover_publications
get_ad_report
get_author
get_asset

Example

How did our ads perform in March compared with February? Tell me what changed and whether it is real.

Ad clicks per delivered email rose from 1.8% in February to 2.4% in March across 12 sends each month. Most of the lift came from two sends with a sponsor who ran a limited offer, so it is concentrated rather than broad. Total ad revenue was up 9%, but that partly reflects a higher send count. The data cannot show whether the offer type will repeat.

Use in RevampKeyRead the full skill →

Read-only2 beehiiv tools

Audit your beehiiv automations with AI

Reviews a welcome, onboarding or re-engagement automation for step order, trigger logic, missing steps and emails that no longer match the sequence goal. It reports prioritised findings and proposed fixes, and asks before changing anything.

Use it when

Your new subscribers stop opening after the second welcome email
You suspect two automations send duplicate emails to the same people
An onboarding sequence still promotes an offer that has ended

Tools it uses

get_automation
get_automation_email_content

Example

Audit my welcome automation. Check the trigger, the spacing and whether the emails still match the goal of turning subscribers into paid members.

Your welcome automation has 4 emails over 10 days, and its goal is a first paid click. Two Critical findings: the trigger also enrols existing free subscribers, and email 3 still promotes a spring offer that has ended. I have proposed 2 edits and applied none. Tell me which to make.

Use in RevampKeyRead the full skill →

Asks before writing4 beehiiv tools

Review a beehiiv newsletter draft before you send it

Reads a draft post or template the way a subscriber would, checking subject and preview consistency, the body, links and calls to action. It reports problems and proposes fixes, and does not publish or change anything without your say-so.

Use it when

You want a second pair of eyes on a newsletter before it goes out
A template has been edited and you need to confirm the footer and placeholders survived
A subject line feels like it promises more than the body delivers

Tools it uses

edit_post
edit_post_content
edit_post_template
edit_post_template_content

Example

Review my draft 'Spring pricing update' for anything that would embarrass me before it goes to subscribers tomorrow morning.

Verdict: ready after fixes. The subject promises a 20% discount, but the body only mentions 15%, so one of them is wrong. The 'Claim your seat' button links to a staging address and needs replacing. Two of the three links checked out; one returned a not-found page. I did not check how it renders in mail clients.

Use in RevampKeyRead the full skill →

Asks before writing7 beehiiv tools

Clean up beehiiv segments before they reach a list

Reviews your beehiiv segments against the purpose of a newsletter list, flags overlap, stale contacts and suspicious tags, and prepares a change set. It asks for your approval before it adds, removes or moves anyone.

Use it when

You want to add a segment to your main newsletter list without sending duplicates
Your paid and free audiences seem to overlap and you want to check
A tag import has bloated a segment and you need to know what to keep

Tools it uses

add_segment_to_newsletter_list
add_automation_step
delete_automation_step
delete_automation_trigger
delete_podcast_episode
delete_podcast_show
ban_community_member

Example

Check my 'Engaged readers' segment against the weekly newsletter list and tell me what to add or leave out.

Your 'Engaged readers' segment shows about 4,200 subscribers, but its rule is opens only, so it likely includes habitual openers. I suggest adding it to the weekly list, but first excluding the 'Imported 2021' tag group, which accounts for roughly 900 contacts with no recent activity. Nothing has been changed yet. Reply 'yes' to apply the first row only.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

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

Download RevampKey

How beehiiv skills work

Connect beehiiv
The beehiiv MCP server gives the agent its tools.
Ask in plain words
“How did our ads perform in March compared with February? Tell me what changed and whether it is real.” 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 beehiiv skills

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

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect beehiiv. 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 “How did our ads perform in March compared with February? Tell me what changed and whether it is real.”
Download RevampKeyConnect beehiiv · 1 click
Get RevampKey to connect beehiiv
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and beehiiv is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials ad-performance-report automation-audit post-edit-review segment-list-cleanup; do curl -fsSL --create-dirs -o .claude/skills/beehiiv-$s/SKILL.md https://revampkey.com/marketplace/beehiiv/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the beehiiv MCP server in Claude Code.

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

for s in essentials ad-performance-report automation-audit post-edit-review segment-list-cleanup; do
  curl -fsSL --create-dirs -o .claude/skills/beehiiv-$s/SKILL.md https://revampkey.com/marketplace/beehiiv/skills/$s/SKILL.md
done

Ask in plain language, for example “How did our ads perform in March compared with February? Tell me what changed and whether it is real.”

Into the shared .agents/skills folder

Connect the beehiiv MCP server in Cursor.

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

for s in essentials ad-performance-report automation-audit post-edit-review segment-list-cleanup; do
  curl -fsSL --create-dirs -o .agents/skills/beehiiv-$s/SKILL.md https://revampkey.com/marketplace/beehiiv/skills/$s/SKILL.md
done

Ask in plain language, for example “How did our ads perform in March compared with February? Tell me what changed and whether it is real.”

Into the shared .agents/skills folder

Connect the beehiiv MCP server in Codex.

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

for s in essentials ad-performance-report automation-audit post-edit-review segment-list-cleanup; do
  curl -fsSL --create-dirs -o .agents/skills/beehiiv-$s/SKILL.md https://revampkey.com/marketplace/beehiiv/skills/$s/SKILL.md
done

Ask in plain language, for example “How did our ads perform in March compared with February? Tell me what changed and whether it is real.”

Into the shared .agents/skills folder

Connect the beehiiv MCP server in VS Code.

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

for s in essentials ad-performance-report automation-audit post-edit-review segment-list-cleanup; do
  curl -fsSL --create-dirs -o .agents/skills/beehiiv-$s/SKILL.md https://revampkey.com/marketplace/beehiiv/skills/$s/SKILL.md
done

Ask in plain language, for example “How did our ads perform in March compared with February? Tell me what changed and whether it is real.”

RevampKey or copy the files?

In RevampKey

One click when you connect beehiiv
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 beehiiv MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

beehiiv skills FAQ

What is a beehiiv agent skill?

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

Do the beehiiv skills change anything on their own?

2 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 beehiiv.

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

Do I need the beehiiv MCP server too?

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

beehiiv MCP server setup · This page as Markdown

Put beehiiv’s best workflows in your agent

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

Download RevampKey Connect beehiiv · 1 click

All 5 beehiiv skills

Use beehiiv safely with AI

Use it when

Tools it uses

Ad performance reports for your beehiiv publication

Use it when

Tools it uses

Audit your beehiiv automations with AI

Use it when

Tools it uses

Review a beehiiv newsletter draft before you send it

Use it when

Tools it uses

Clean up beehiiv segments before they reach a list

Use it when

Tools it uses

Get all 5 without copying a file

How beehiiv skills work

How to install beehiiv skills

RevampKey or copy the files?

In RevampKey

Copy into your project

beehiiv skills FAQ

Put beehiiv’s best workflows in your agent

Skills for related tools