All Skills
Automation & WorkflowClaude Plugins (Official)

vsql extension builder — Agent Skill

by villagesql · Updated

Builds a VillageSQL extension for MySQL end-to-end through a 7-phase persona-driven workflow. Commonly used to port PostgreSQL extensions to MySQL.

At a glance

vsql-extension-builder is an Agent Skill by villagesql in the Automation & Workflow category. In Claude Code it installs with `/plugin install vsql-extension-builder@claude-plugins-official` after adding the anthropics/claude-plugins-official marketplace; other assistants use its SKILL.md instructions as rules. Its source repository has 5 GitHub stars (as of Oct 28, 2026).

Source 5GitHub stars

How to install vsql extension builder in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install vsql extension builder in Claude CodeAnthropic's agentic CLI

  1. Add the marketplace

    claude
    /plugin marketplace add anthropics/claude-plugins-official
  2. Install the skill

    claude
    /plugin install vsql-extension-builder@claude-plugins-official
  3. Use it

    These are slash commands for a Claude Code session, not your shell. Claude auto-invokes the skill when your request matches its description — or type its slash command if it exposes one.

Documentation

Full README

villagesql-skills

Agent skills for working with VillageSQL. Skills run in Claude Code, agy, Codex, Cursor, Amp, Kiro, OpenCode, and OpenClaw.

Skills

| Skill | What it does | |---|---| | `vsql-install-server` | Gets a working VillageSQL server on your machine — install, start, connect, load an extension, verify. Start here if you do not have a server yet. | | `vsql-docs` | Answers VillageSQL questions from the published docs, for the version of your server. | | `vsql-extension-builder` | Builds a VillageSQL extension end-to-end through a 7-phase persona-driven workflow. Discovers the current VEF API from live SDK headers — no hardcoded API names. |

More skills will be added here over time.

Prerequisites

The skills drive a live VillageSQL server on your machine. Install one as a prebuilt binary or a source build via the server installer:

bash
curl -fsSL https://install.villagesql.com | bash

The villagesql/server Docker image carries the extension SDK, a C++ toolchain, and a vsql-build-extension.sh helper, so you can build and install an extension inside a container. What it does not carry is mysql-test-run.pl, the MTR orchestrator, so vsql-extension-builder cannot complete its test phase there — that phase needs an installer or source build on the host. See each skill's README for its full requirements.

Installing

Quick install

bash
curl -sSL https://villagesql.com/skills | bash

Detects which agents are installed and configures each one. Supports Claude Code, agy, Codex, Cursor, Amp, Kiro, OpenCode, and OpenClaw. Re-running updates in place.

Override locations with env vars:

More Automation & Workflow skills

Catalog data refreshed . Something wrong? Report it.