An open API service indexing awesome lists of open source software.

https://github.com/planetscale/claude-plugin

Plugin for Claude Code and Claude Cowork
https://github.com/planetscale/claude-plugin

Last synced: 4 months ago
JSON representation

Plugin for Claude Code and Claude Cowork

Awesome Lists containing this project

README

          

# PlanetScale Claude Plugin

Plugin for installing the [PlanetScale MCP server](https://planetscale.com/docs/connect/mcp) and [Database Skills](https://db-skills.com/) into Claude Code.

## Install from GitHub

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

```text
/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:

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

If you already cloned without submodules:

```bash
git submodule update --init --recursive
```

### Manual one-off update

To pull the latest upstream skills into this repository:

```bash
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):

```bash
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:

```bash
claude --plugin-dir .
```