Vsql Extension Builder

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:

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

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:

VILLAGESQL_SKILLS_SRC=~/code/villagesql-skills \
CLAUDE_SKILLS_DIR=~/.claude/skills \
  curl -sSL https://villagesql.com/skills | bash

Claude Code plugin

From the official Claude Code plugin marketplace:

/plugin install vsql-extension-builder@claude-plugins-official

Or add this repo as a marketplace:

/plugin marketplace add villagesql/villagesql-skills
/plugin install villagesql@villagesql

Manual install (recommended for contributors)

Claude Code

git clone https://github.com/villagesql/villagesql-skills.git ~/code/villagesql-skills
mkdir -p ~/.claude/skills
ln -s ~/code/villagesql-skills/skills/vsql-extension-builder ~/.claude/skills/vsql-extension-builder