Official agent skill

Planetscale Webhook Automation Recommendations

by planetscale in planetscale/skills

Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows.

OfficialMITAuto-check passedBackend & APIs

Install Planetscale Webhook Automation Recommendations

skills CLI
$ npx skills add planetscale/skills --skill planetscale-webhook-automation-recommendations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install planetscale/skills planetscale-webhook-automation-recommendations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/planetscale/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/planetscale-webhook-automation-recommendations .claude/skills/planetscale-webhook-automation-recommendations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
planetscale-webhook-automation-recommendations
GitHub stars
133
Token cost
~1.5k tokens
SKILL.md length
641 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows.

  • Works in 8 steps: Receive branch.anomaly. → Verify signature. → Queue job. → …
  • Tasks that involve Webhooks
  • SKILL.md covers Purpose, Webhook design principle, Events to evaluate and Recommended routing, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Planetscale Webhook Automation Recommendations is an agent skill from planetscale/skills, published by the product's own GitHub organization. Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Webhooks. It works with PlanetScale. The repository describes itself as: Skills that help you configure and get the most out of PlanetScale. The licence is MIT.

When your agent uses it

  • Tasks that involve Webhooks

Example prompts

  • “/planetscale-webhook-automation-recommendations”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Receive branch.anomaly.
  2. Verify signature.
  3. Queue job.
  4. Fetch anomaly details and relevant Insights query patterns.
  5. Locate code path by SQLCommenter tags and repository search.
  6. Classify as schema, code, Traffic Control, or unknown.
  7. Generate report and optional PR.
  8. Ask human to approve database-affecting work.

What it can do on your machine

Read from SKILL.md and the folder at commit 999045c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Planetscale Webhook Automation Recommendations loads about 1.5k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 641 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from planetscale/skills at commit 999045c, republished under its MIT licence (© planetscale). 641 words, ~1,503 tokens.

Download SKILL.mdSave it as .claude/skills/planetscale-webhook-automation-recommendations/SKILL.md (or your agent's skills folder).
name
planetscale-webhook-automation-recommendations
description
Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows.

Webhook automation recommendations

Purpose

Review and recommend PlanetScale webhooks that notify humans and trigger safe automation. Do not create or update webhooks without approval.

Webhook design principle

Webhooks may trigger automation, but automation must produce recommendations, issues, branches, or pull requests by default. It must not directly mutate production databases or production application behavior without explicit human approval.

Events to evaluate

General and Postgres
  • branch.anomaly: new Insights anomaly.
  • branch.out_of_memory: Postgres out-of-memory event.
  • branch.primary_promoted: primary failover/promotion.
  • branch.ready: branch created and ready.
  • branch.sleeping: branch sleeping.
  • branch.start_maintenance: maintenance starting.
  • cluster.storage: storage threshold or growth event.
  • database.access_request: access request.
  • branch.schema_recommendation: schema recommendation event when available.
  • webhook.test: test event.
Vitess deploy lifecycle
  • deploy_request.opened
  • deploy_request.queued
  • deploy_request.in_progress
  • deploy_request.pending_cutover
  • deploy_request.schema_applied
  • deploy_request.errored
  • deploy_request.reverted
  • deploy_request.closed
  • keyspace.storage
Human alerting

Send these to incident or operations channels:

  • branch.anomaly
  • branch.out_of_memory
  • branch.primary_promoted
  • branch.start_maintenance
  • cluster.storage
  • keyspace.storage
  • deploy_request.errored
  • deploy_request.reverted
Engineering notification

Send these to Slack, Linear/Jira, or deployment channels:

  • deploy_request.opened
  • deploy_request.queued
  • deploy_request.in_progress
  • deploy_request.pending_cutover
  • deploy_request.schema_applied
  • deploy_request.closed
  • branch.schema_recommendation
Agent intake queue

Send these to an agent-safe workflow:

  • branch.anomaly
  • branch.schema_recommendation
  • deploy_request.errored
  • cluster.storage
  • keyspace.storage

Agent output may include, without approval:

  • Triage summary, probable cause, linked Insights/query patterns.
  • Recommended schema, code, Traffic Control, or operational change.
  • Pull request against application code.
  • Development branch with DDL or migration applied.
  • Open deploy request into a review-protected branch.
  • Issue or ticket.

Agent output must not cross the review gate on its own: no production deploys, PR merges, Traffic Control enforcement, credential rotation, or network changes — those require human action or a standing authorization per ../planetscale-autonomous-execution-mode/SKILL.md.

Webhook receiver requirements

Recommend only receivers that meet these requirements:

  • HTTPS endpoint.
  • Fast 2xx response; expensive work is queued asynchronously.
  • No dependency on following redirects.
  • Signature verification using PlanetScale webhook signature header and the webhook secret.
  • Idempotency by event ID or timestamp/resource tuple.
  • Dead-letter queue or retry-safe logging.
  • Human-readable audit trail.
  • Clear owner and escalation path.
  • Secret rotation procedure.
Anomaly to PR flow
  1. Receive branch.anomaly.
  2. Verify signature.
  3. Queue job.
  4. Fetch anomaly details and relevant Insights query patterns.
  5. Locate code path by SQLCommenter tags and repository search.
  6. Classify as schema, code, Traffic Control, or unknown.
  7. Generate report and optional PR.
  8. Ask human to approve database-affecting work.
Show full SKILL.md (282 more words)Show less
Schema recommendation to branch/deploy flow

For Vitess:

  1. Receive branch.schema_recommendation.
  2. Fetch recommendation details.
  3. Apply the DDL to a development branch.
  4. Open a pull request with fingerprint, metrics, and expected effect.
  5. Open the deploy request — the DR and PR together are the reviewable unit; opening them requires no approval.
  6. Deploy on human approval, or autonomously under a standing authorization that allowlists this deploy class (../planetscale-autonomous-execution-mode/SKILL.md).

For Postgres:

  1. Receive branch.schema_recommendation.
  2. Fetch recommendation details.
  3. Convert DDL to application migration.
  4. Test on a non-production branch and record the result in the PR.
  5. Open PR.
  6. Apply to production on merge via the deployment pipeline, or on explicit approval where no pipeline exists.
Deploy request lifecycle flow for Vitess
  • Notify when opened.
  • Validate owner and linked application PR.
  • Alert when queued or in progress.
  • Alert strongly when errored or reverted.
  • Notify pending cutover and require owner acknowledgement for gated deployments.
  • Record schema applied and correlate with application deploy.

Anti-patterns to block

Do not recommend:

  • Webhook directly runs production DDL, bypassing the PR/deploy-request workflow. (Driving the DDL through a branch, PR, and deploy request is the supported pattern, not an anti-pattern.)
  • Webhook applies schema recommendations straight to production with no reviewable artifact.
  • Webhook directly enforces Traffic Control.
  • Webhook directly changes IP restrictions.
  • Webhook directly rotates credentials.
  • Webhook posts secrets or raw SQL with literals into public Slack channels.
  • Webhook receiver ignores signature verification.
  • Webhook receiver does long-running work before returning 2xx.

Output

Return:

  • Existing webhook inventory.
  • Missing recommended subscriptions.
  • Destination quality review.
  • Signature verification status.
  • Automation opportunities.
  • Unsafe automation risks.
  • Proposed webhook changes requiring approval.

End with:

“No webhooks or automation endpoints have been created, updated, or deleted.”

© planetscale, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in planetscale-webhook-automation-recommendations of planetscale/skills.

Open the folder on GitHubat commit 999045c

Compare with similar skills

Planetscale Webhook Automation Recommendations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Planetscale Webhook Automation Recommendations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Planetscale Webhook Automation Recommendations this skillplanetscale/skills133—~1.5kAutomated safety check: PassMIT
cmux Backend Rulesmanaflow-ai/cmux28k1 repos~682Automated safety check: PassCustom licence
Novu Design Workflownovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.2k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • cmux Backend Rules

    manaflow-ai/cmux

    Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.

    28k GitHub starsUsed in 1 repo~682 tokens
    Backend & APIsAuto-check passed
  • Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

    40k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.2k GitHub stars~13k tokensUpdated 5 days ago
    Backend & APIsAuto-check: notes
  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人(批量单聊/群聊)和 Webhook 自定义机器人两种接入方式,支持多机器人管理,支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from planetscale/skills

All 15 skills in this repo
  • Official

    Use the PlanetScale CLI (pscale) from automated agents with --format json, auth check, pscale sql, and per-command --force.

    133 GitHub stars~880 tokensUpdated today
    Auto-check passed
  • Official

    Master skill that runs the full PlanetScale safe best-practices assessment — inventory, engine review, Insights, Traffic Control, webhooks, schema recommendations, codebase instrumentation, and…

    133 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Official

    Execute approved PlanetScale changes end-to-end without per-step approval when the operator has explicitly acknowledged the risk.

    133 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Official

    A concise feature matrix for deciding which PlanetScale safety, observability, and automation recommendations apply by engine.

    133 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Enforce explicit approval gates for any PlanetScale, database, repository, credential, network, or automation mutation.

    133 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Inspect an application repository connected to PlanetScale and recommend SQLCommenter-compatible query tagging packages and conventions.

    133 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Planetscale Webhook Automation Recommendations

What does Planetscale Webhook Automation Recommendations do?

Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows. Planetscale Webhook Automation Recommendations is an agent skill from planetscale/skills, published by the product's own GitHub organization. Recommend webhook subscriptions and safe automation patterns for PlanetScale alerts, anomalies, schema recommendations, deploy requests, and agent workflows.

When should I use Planetscale Webhook Automation Recommendations?

Planetscale Webhook Automation Recommendations fits situations like: tasks that involve Webhooks.

How do I install Planetscale Webhook Automation Recommendations in Claude Code?

Run `npx skills add planetscale/skills --skill planetscale-webhook-automation-recommendations -a claude-code`. Or copy the skill folder (planetscale-webhook-automation-recommendations in planetscale/skills) into .claude/skills/planetscale-webhook-automation-recommendations in your project. Claude Code loads it when a task matches its description.

How do I install Planetscale Webhook Automation Recommendations in Codex?

Run `npx skills add planetscale/skills --skill planetscale-webhook-automation-recommendations -a codex`. Or copy the skill folder (planetscale-webhook-automation-recommendations in planetscale/skills) into .agents/skills/planetscale-webhook-automation-recommendations in your project. Codex loads it when a task matches its description.

Can I use Planetscale Webhook Automation Recommendations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add planetscale/skills --skill planetscale-webhook-automation-recommendations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/planetscale-webhook-automation-recommendations, .gemini/skills/planetscale-webhook-automation-recommendations, .github/skills/planetscale-webhook-automation-recommendations and .opencode/skills/planetscale-webhook-automation-recommendations in your project.

What does Planetscale Webhook Automation Recommendations need to run?

SKILL.md names no scripts, command-line tools or credentials: Planetscale Webhook Automation Recommendations is instructions for the agent only.

Does Planetscale Webhook Automation Recommendations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Planetscale Webhook Automation Recommendations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Planetscale Webhook Automation Recommendations use?

Planetscale Webhook Automation Recommendations is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Planetscale Webhook Automation Recommendations use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Planetscale Webhook Automation Recommendations?

Skills that share tags, products or a category with Planetscale Webhook Automation Recommendations: cmux Backend Rules (manaflow-ai/cmux, 28k stars), Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.2k stars) and Stripe Apps (fossasia/eventyay, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Planetscale Webhook Automation Recommendations?

planetscale (a GitHub organization, an official publisher) maintains it in planetscale/skills, which has 133 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

Source: planetscale/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.