PlanetScale Claude Plugin

Plugin for installing the PlanetScale MCP server and Database Skills into Claude Code.

Install from GitHub

In Claude Code, add this GitHub repository as a marketplace, then install the plugin:

/plugin marketplace add planetscale/claude-plugin
/plugin install planetscale@planetscale

Verify it loaded

In Claude Code, run /mcp to see the planetscale MCP server.

If it does not appear immediately after install, fully restart Claude Code and check /mcp again. Plugin-provided MCP server changes are applied on restart.

Skills Source and Sync

This plugin pulls in skills from the upstream planetscale/database-skills repository via the database-skills Git submodule.

• Source repo: https://github.com/planetscale/database-skills
• Submodule path: database-skills
• Tracked branch: main

Local bootstrap

Clone with submodules:

git clone --recurse-submodules https://github.com/planetscale/claude-code-plugin.git

If you already cloned without submodules:

git submodule update --init --recursive

Manual one-off update

To pull the latest upstream skills into this repository:

git submodule sync --recursive
git submodule update --init --remote database-skills

Commit the resulting submodule pointer change in this repository.

Local testing

To test this plugin from your local working copy (before branching/PR):

claude --plugin-dir .

1. Run /mcp to verify the planetscale MCP server is loaded (will require authentication).
2. Run /skills to verify the planetscale skills are loaded.

Automated weekly updates

GitHub Actions runs .github/workflows/update-skills.yml weekly and also supports manual runs (workflow_dispatch).

When database-skills has new commits, the workflow opens or updates a PR that contains only:

• The database-skills submodule pointer update
• .gitmodules (if submodule metadata changed)

Alternative (development only)

You can also use this direct local plugin load command:

claude --plugin-dir .