vsql-extension-builder — Claude Code plugin
Walks an agent through seven phases of building a VillageSQL extension for MySQL. A common reason to reach for it: porting an extension off PostgreSQL.
/plugin install vsql-extension-builder@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialWhat vsql-extension-builder does
The plugin turns extension work into a staged job. Seven phases, each with its own persona, and the extension API is read from live SDK headers instead of being baked into the skill as fixed names.
The skills expect a running VillageSQL server on your machine. No server yet? Install one with curl -fsSL https://install.villagesql.com | bash, or build from source. The villagesql/server image ships the extension SDK, a C++ toolchain and vsql-build-extension.sh, so building and installing an extension inside a container works. Testing does not: mysql-test-run.pl is absent, so the test phase needs an installer or a source build on the host.
The skill lives in skills/vsql-extension-builder/. SKILL.md is the entry point and holds the phases and gates; heavier material sits in references/ and loads only when a phase calls for it. You can install it from the Claude plugin marketplace or manually by symlinking into ~/.claude/skills.
What it helps with
- build a VillageSQL extension for MySQL step by step
- port a PostgreSQL extension to MySQL
- pull current extension API names from SDK headers
- get through the test phase instead of stalling on it
- load the extension into a server and confirm it works
Example prompts for the agent
- Build a VillageSQL extension for MySQL and walk me through the phases
- Port this PostgreSQL extension to MySQL with vsql-extension-builder
- Which phases are left, and what do I need for the test phase?
How to install vsql-extension-builder
Plugin marketplace
/plugin install vsql-extension-builder@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about vsql-extension-builder
How do I install vsql-extension-builder in Claude Code?
From the official plugin marketplace: run /plugin marketplace add anthropics/claude-plugins-official, then /plugin install vsql-extension-builder@claude-plugins-official.
What does vsql-extension-builder do?
It drives an agent through seven phases of building a VillageSQL extension for MySQL, with a persona per phase. API names come from live SDK headers.
Can I run every phase inside a Docker container?
No. The villagesql/server image has the SDK, the C++ toolchain and vsql-build-extension.sh, but not mysql-test-run.pl, so the test phase needs an installer or a source build on the host.
