Skills for working with VillageSQL, a MySQL-compatible database with extensions. They answer questions from the VillageSQL docs, help build custom SQL functions or types in C++ or Rust, and get a local VillageSQL server running.
Claude Code
> /plugin marketplace add villagesql/villagesql-skills> /plugin install villagesql@villagesql
Codex
$ npx skills add villagesql/villagesql-skills -a codex
Cursor
$ npx skills add villagesql/villagesql-skills -a cursor
Gemini CLI
$ npx skills add villagesql/villagesql-skills -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add villagesql/villagesql-skills$ copilot plugin install villagesql@villagesql
OpenCode
$ npx skills add villagesql/villagesql-skills -a opencode
Windsurf
$ npx skills add villagesql/villagesql-skills -a windsurf
Agent skills for working with VillageSQL. Skills run in Claude Code, agy, Codex, Cursor, Amp, Kiro, OpenCode, and OpenClaw.
| 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.
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.
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
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
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
Verify the skill is loaded by typing / in Claude Code — the skill name
should appear in the slash command list.
agy plugin install https://github.com/villagesql/villagesql-skills
agy reads plugin.json, discovers skills from the skills/ subdirectory, and
adds the VillageSQL docs MCP server from mcp_config.json. Check it with
agy plugin list.
git clone https://github.com/villagesql/villagesql-skills.git ~/code/villagesql-skills
mkdir -p ~/.config/opencode/skills
ln -s ~/code/villagesql-skills/skills/vsql-extension-builder ~/.config/opencode/skills/vsql-extension-builder
git clone https://github.com/villagesql/villagesql-skills.git ~/code/villagesql-skills
mkdir -p ~/.openclaw/workspace/skills
ln -s ~/code/villagesql-skills/skills/vsql-extension-builder ~/.openclaw/workspace/skills/vsql-extension-builder
To update later (all agents share the same clone):
git -C ~/code/villagesql-skills pull
Each skill follows the standard Agent Skills directory layout:
skills/
└── <skill-name>/
├── SKILL.md # entry point — frontmatter, workflow, gates
└── references/ # detailed material loaded on demand
└── *.md
SKILL.md is loaded eagerly when the skill triggers and stays thin and
procedural. Detail-heavy material (standards, checklists, environment
commands) lives in references/ and is read by the agent only when the
relevant phase needs it.
Issues and pull requests welcome. For substantive changes — new skills, workflow restructuring, new references — open an issue first to discuss the shape before writing the skill.
A few conventions:
SKILL.md thin. If a section exceeds a screen, ask whether it
belongs in references/ instead.The quick installer clones the repo to ~/.local/share/villagesql-skills/ and
symlinks skills from there into your agent directories — not from your working
clone. If you used the quick installer, your agent reads that managed copy, not
your working branch.
To test local changes, re-point the Claude Code symlink directly to your clone:
rm ~/.claude/skills/vsql-extension-builder
ln -s ~/code/villagesql-skills/skills/vsql-extension-builder ~/.claude/skills/vsql-extension-builder
Branch switches are then live immediately. When you're done, re-running the quick installer restores the managed copy.
If you add a new file to references/, call it out in your PR description —
a maintainer will update the quick-install script to include it.
Apache-2.0 — see LICENSE.
Stars on GitHub
Helps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockA development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookSkills for working with VillageSQL, a MySQL-compatible database with extensions. They answer questions from the VillageSQL docs, help build custom SQL functions or types in C++ or Rust, and get a local VillageSQL server running. Install it with the command on its page. It includes vsql-docs, vsql-extension-builder, vsql-install-server. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it