Prefect agent skills for Claude Code, Cursor and RevampKey

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

Download RevampKey, free I have it: connect Prefect

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

All 4 Prefect 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-only15 Prefect tools

Use Prefect with AI, safely and read-only

Connects an AI assistant to your Prefect workspaces so it can read flows, runs, deployments and logs. It confirms which workspace and account it is reading, keeps results small, and never changes anything in Prefect.

Use it when

You want to ask questions about your Prefect runs without opening the dashboard.
You need to be sure an answer came from the right workspace before acting on it.
The connector returns a sign-in error or an empty result and you want to know why.

Tools it uses

list_authorized_workspaces
get_identity
orientation
get_dashboard
get_flows
get_deployments
get_work_pools
get_automations
get_flow_runs
get_task_runs
get_flow_run_logs
get_object_schema
read_events
docs_search_prefect
docs_get_release_notes

Example

Which Prefect workspaces can you access, and what is failing in acme-prod right now?

Workspace: acme-prod, signed in as ops@acme.io. I can see 2 authorized workspaces: acme-prod and acme-staging. In acme-prod, the last 24 hours show 41 failed flow runs across 6 deployments. The most frequent error is a timeout in the nightly-etl deployment, which accounts for 18 of them. I looked at the most recent 20 runs, so the full count may differ.

Use in RevampKeyRead the full skill →

Read-only8 Prefect tools

Check Prefect deployment and work pool health

Sweeps your Prefect deployments, work pools and automations to find what is stuck, paused or unscheduled, and reports on infrastructure rather than a single run. It asks before changing anything.

Use it when

Your scheduled flows have not started and you want to know why
You want a quick sweep of which work pools and deployments need attention
You are checking whether automations and schedules are still doing their job

Tools it uses

list_authorized_workspaces
orientation
get_work_pools
get_deployments
get_flows
get_automations
get_dashboard
read_events

Example

Is anything in my Prefect workspace stuck or paused that should be running?

Your workspace has two work pools that look healthy, but the pool 'nightly-etl' has not reported a worker heartbeat recently, so its 6 scheduled deployments cannot start. Those 6 deployments are the blocking issue. Separately, 2 deployments are paused and look intentional, and 1 automation is disabled. I have not changed anything; tell me if you want me to resume any of these.

Use in RevampKeyRead the full skill →

Read-only2 Prefect tools

Prefect docs and release briefing

Answers Prefect how-to and configuration questions from the current documentation, and reports what changed between your version and the one you're upgrading to. It does not change anything in your workspace.

Use it when

You want to know how to configure a feature in your Prefect version
You are planning an upgrade and need to know what breaks
You want to confirm whether a setting or command still exists

Tools it uses

docs_search_prefect
docs_get_release_notes

Example

I'm on Prefect 3.2. Did anything change in how work pool concurrency limits are set before I upgrade to the next release?

Checked the release notes between 3.2 and the next minor release. One behaviour change affects you: the concurrency setting moved to a new name, and the old name is deprecated but still works until its stated removal version. I have not changed anything in your workspace; here is the command to update it, which you can run yourself.

Use in RevampKeyRead the full skill →

Read-only6 Prefect tools

Diagnose a failed Prefect flow run

Traces one failed flow run to its first failing task and exception, separating the root error from downstream cascade failures. It reads run state and logs in the Prefect workspace you choose and makes no changes.

Use it when

A pipeline failed overnight and you need the first error
A run shows Failed but you suspect a cascade from one task
A run crashed with no obvious exception and you want to know why

Tools it uses

list_authorized_workspaces
get_flow_runs
get_deployments
get_flows
get_task_runs
get_flow_run_logs

Example

Why did last night's ingest-orders run fail? It's in the prod workspace.

The run ingest-orders-2024-06-11 started at 02:00 UTC and failed after 14 minutes. The first failing task was load_customers, which raised a connection timeout to the warehouse after two retries. The three tasks that did not run (transform_orders, publish_report, notify_team) were cascade failures from that one error. Confidence is high: the logs show the timeout and the same task succeeded in the previous night's run.

Use in RevampKeyRead the full skill →

Get all 4 without copying a file

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

Download RevampKey

How Prefect skills work

Connect Prefect
The Prefect MCP server gives the agent its tools.
Ask in plain words
“Is anything in my Prefect workspace stuck or paused that should be running?” 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 Prefect skills

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

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Prefect. All 4 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Is anything in my Prefect workspace stuck or paused that should be running?”
Download RevampKeyConnect Prefect · 1 click
Get RevampKey to connect Prefect
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Prefect is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials deployment-and-work-pool-health-check docs-and-release-briefing failed-flow-run-diagnosis; do curl -fsSL --create-dirs -o .claude/skills/prefect-$s/SKILL.md https://revampkey.com/marketplace/prefect/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Prefect MCP server in Claude Code.

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

for s in essentials deployment-and-work-pool-health-check docs-and-release-briefing failed-flow-run-diagnosis; do
  curl -fsSL --create-dirs -o .claude/skills/prefect-$s/SKILL.md https://revampkey.com/marketplace/prefect/skills/$s/SKILL.md
done

Ask in plain language, for example “Is anything in my Prefect workspace stuck or paused that should be running?”

Into the shared .agents/skills folder

Connect the Prefect MCP server in Cursor.

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

for s in essentials deployment-and-work-pool-health-check docs-and-release-briefing failed-flow-run-diagnosis; do
  curl -fsSL --create-dirs -o .agents/skills/prefect-$s/SKILL.md https://revampkey.com/marketplace/prefect/skills/$s/SKILL.md
done

Ask in plain language, for example “Is anything in my Prefect workspace stuck or paused that should be running?”

Into the shared .agents/skills folder

Connect the Prefect MCP server in Codex.

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

for s in essentials deployment-and-work-pool-health-check docs-and-release-briefing failed-flow-run-diagnosis; do
  curl -fsSL --create-dirs -o .agents/skills/prefect-$s/SKILL.md https://revampkey.com/marketplace/prefect/skills/$s/SKILL.md
done

Ask in plain language, for example “Is anything in my Prefect workspace stuck or paused that should be running?”

Into the shared .agents/skills folder

Connect the Prefect MCP server in VS Code.

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

for s in essentials deployment-and-work-pool-health-check docs-and-release-briefing failed-flow-run-diagnosis; do
  curl -fsSL --create-dirs -o .agents/skills/prefect-$s/SKILL.md https://revampkey.com/marketplace/prefect/skills/$s/SKILL.md
done

Ask in plain language, for example “Is anything in my Prefect workspace stuck or paused that should be running?”

RevampKey or copy the files?

In RevampKey

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

See the command

Prefect skills FAQ

What is a Prefect agent skill?

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

Do the Prefect skills change anything on their own?

4 of the 4 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 Prefect.

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

Do I need the Prefect MCP server too?

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

Prefect MCP server setup · This page as Markdown

Put Prefect’s best workflows in your agent

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

Download RevampKey Connect Prefect · 1 click

All 4 Prefect skills

Use Prefect with AI, safely and read-only

Use it when

Tools it uses

Check Prefect deployment and work pool health

Use it when

Tools it uses

Prefect docs and release briefing

Use it when

Tools it uses

Diagnose a failed Prefect flow run

Use it when

Tools it uses

Get all 4 without copying a file

How Prefect skills work

How to install Prefect skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Prefect skills FAQ

Put Prefect’s best workflows in your agent

Skills for related tools