Vibe Agent Toolkit
Vibe Agent Toolkit (VAT) is a modular toolkit for building, packaging, and distributing portable AI agents and skills that work across multiple Claude surfaces and adjacent frameworks. Write skill or agent content once; VAT handles validation, packaging, plugin/marketplace layout, and npm publishing.
This is a router skill. Load the sibling sub-skill that matches the work you're doing — each sub-skill owns one slice of VAT's surface and is designed to be pulled in on demand.
When to Use VAT
Good fits:
- Publishing a Claude skill or plugin to npm with a proper marketplace layout
- Multi-runtime agent projects (Vercel AI SDK, LangChain, OpenAI, Claude Agent SDK)
- Validating plugins / skills / marketplaces with
vat audit before shipping
- Enforcing frontmatter schemas across large markdown corpora
- Wiring RAG indexing into an agent project
Poor fits:
- Simple one-off scripts where the framework is already decided
- Non-TypeScript/JavaScript projects
- Cases where you need deep framework-specific features with no reuse goal
Picking a Sub-skill
| If you're working on... |
Load |
New project setup, vibe-agent-toolkit.config.yaml orientation, repo structure, vibe-validate integration, npm postinstall |
vibe-agent-toolkit:vat-adoption-and-configuration |
| Writing or revising a SKILL.md — frontmatter, body, references, packagingOptions, validation overrides |
vibe-agent-toolkit:vat-skill-authoring |
TypeScript agent archetypes, agent.yaml, result envelopes, orchestration, runtime adapters |
vibe-agent-toolkit:vat-agent-authoring |
vat audit on plugins, marketplaces, skills, or settings — including --compat, --exclude, --user, CI use |
vibe-agent-toolkit:vat-audit |
Markdown collections, resources: config, frontmatter schema validation, vat resources validate |
vibe-agent-toolkit:vat-knowledge-resources |
Asking the resource projection SQL questions (vat resources query) or declaring standing SQL assertions that gate CI (vat resources check, --budget) |
vibe-agent-toolkit:vat-knowledge-resources |
vat build, vat verify, plugin/marketplace layout, npm publishing, postinstall |
vibe-agent-toolkit:vat-skill-distribution |
vat rag index / vat rag query, installing the opt-in RAG backends, embedding providers, vector stores, chunking |
vibe-agent-toolkit:vat-rag |
Pre-publication quality review, vat skill review, validation-code triage |
vibe-agent-toolkit:vat-skill-review |
Behaviorally testing a packaged skill in isolation — vat skill test run/configure, friction triage, auth modes, security caveats |
vibe-agent-toolkit:vat-skill-testing |
Anthropic Admin API: org users, cost/usage, workspace skills, ANTHROPIC_ADMIN_API_KEY |
vibe-agent-toolkit:vat-enterprise-org |
| Programmatic markdown/frontmatter edits — moving files, updating references, schema-evolution migrations; comment-preserving FrontmatterEditor + rewriteBodyLinks |
vibe-agent-toolkit:markdown-rewriting |
| Auditing a codebase for COHERENCE rather than bugs — does every lane implement one contract, does a status tell the truth, is a passing test suite blind |
vibe-agent-toolkit:coherence-audit |
CLI Surface at a Glance
vat --help # top-level help
vat validate # validate sources: links + skills (no build needed)
vat build # build all artifacts (skills → claude plugins)
vat verify # verify built artifacts (after vat build)
vat skills validate # validate skill quality
vat resources validate # validate markdown collections
vat resources query <sql> # one read-only SQL statement over the resource projection
vat resources check # run the project's declared SQL assertions (fails CI on violations)
vat audit # audit plugins/skills/marketplaces/settings
vat rag index docs/ # index markdown for RAG (needs @vibe-agent-toolkit/rag-lancedb)
vat skill review <path> # pre-publication review
vat claude org --help # enterprise admin surface
Each sub-skill covers its slice of the CLI in depth — don't memorize this table, load the sub-skill when you need detail.
Getting Help
vat --help and vat <group> --help --verbose for CLI depth- Repo docs: the VAT repository's
docs/ directory carries the full setup guide, architecture notes, and design references (not bundled with this plugin)
- Contributor reference docs (debugging VAT, install architecture) live under
docs/contributing/ in the VAT repo
1---2name: vibe-agent-toolkit-23description: Use when starting VAT work or deciding which VAT sub-skill applies. Router that points at sub-skills for adoption, skill/agent authoring, audit, distribution, RAG, knowledge resources, skill review, and enterprise org admin.4---56# Vibe Agent Toolkit78**Vibe Agent Toolkit (VAT)** is a modular toolkit for building, packaging, and distributing portable AI agents and skills that work across multiple Claude surfaces and adjacent frameworks. Write skill or agent content once; VAT handles validation, packaging, plugin/marketplace layout, and npm publishing.910This is a router skill. Load the sibling sub-skill that matches the work you're doing — each sub-skill owns one slice of VAT's surface and is designed to be pulled in on demand.1112## When to Use VAT1314Good fits:1516- Publishing a Claude skill or plugin to npm with a proper marketplace layout17- Multi-runtime agent projects (Vercel AI SDK, LangChain, OpenAI, Claude Agent SDK)18- Validating plugins / skills / marketplaces with `vat audit` before shipping19- Enforcing frontmatter schemas across large markdown corpora20- Wiring RAG indexing into an agent project2122Poor fits:2324- Simple one-off scripts where the framework is already decided25- Non-TypeScript/JavaScript projects26- Cases where you need deep framework-specific features with no reuse goal2728## Picking a Sub-skill2930| If you're working on... | Load |31|---|---|32| New project setup, `vibe-agent-toolkit.config.yaml` orientation, repo structure, vibe-validate integration, npm postinstall | `vibe-agent-toolkit:vat-adoption-and-configuration` |33| Writing or revising a SKILL.md — frontmatter, body, references, packagingOptions, validation overrides | `vibe-agent-toolkit:vat-skill-authoring` |34| TypeScript agent archetypes, `agent.yaml`, result envelopes, orchestration, runtime adapters | `vibe-agent-toolkit:vat-agent-authoring` |35| `vat audit` on plugins, marketplaces, skills, or settings — including `--compat`, `--exclude`, `--user`, CI use | `vibe-agent-toolkit:vat-audit` |36| Markdown collections, `resources:` config, frontmatter schema validation, `vat resources validate` | `vibe-agent-toolkit:vat-knowledge-resources` |37| Asking the resource projection SQL questions (`vat resources query`) or declaring standing SQL assertions that gate CI (`vat resources check`, `--budget`) | `vibe-agent-toolkit:vat-knowledge-resources` |38| `vat build`, `vat verify`, plugin/marketplace layout, npm publishing, postinstall | `vibe-agent-toolkit:vat-skill-distribution` |39| `vat rag index` / `vat rag query`, **installing the opt-in RAG backends**, embedding providers, vector stores, chunking | `vibe-agent-toolkit:vat-rag` |40| Pre-publication quality review, `vat skill review`, validation-code triage | `vibe-agent-toolkit:vat-skill-review` |41| Behaviorally testing a packaged skill in isolation — `vat skill test run`/`configure`, friction triage, auth modes, security caveats | `vibe-agent-toolkit:vat-skill-testing` |42| Anthropic Admin API: org users, cost/usage, workspace skills, `ANTHROPIC_ADMIN_API_KEY` | `vibe-agent-toolkit:vat-enterprise-org` |43| Programmatic markdown/frontmatter edits — moving files, updating references, schema-evolution migrations; comment-preserving FrontmatterEditor + rewriteBodyLinks | `vibe-agent-toolkit:markdown-rewriting` |44| Auditing a codebase for COHERENCE rather than bugs — does every lane implement one contract, does a status tell the truth, is a passing test suite blind | `vibe-agent-toolkit:coherence-audit` |4546## CLI Surface at a Glance4748```bash49vat --help # top-level help50vat validate # validate sources: links + skills (no build needed)51vat build # build all artifacts (skills → claude plugins)52vat verify # verify built artifacts (after vat build)53vat skills validate # validate skill quality54vat resources validate # validate markdown collections55vat resources query <sql> # one read-only SQL statement over the resource projection56vat resources check # run the project's declared SQL assertions (fails CI on violations)57vat audit # audit plugins/skills/marketplaces/settings58vat rag index docs/ # index markdown for RAG (needs @vibe-agent-toolkit/rag-lancedb)59vat skill review <path> # pre-publication review60vat claude org --help # enterprise admin surface61```6263Each sub-skill covers its slice of the CLI in depth — don't memorize this table, load the sub-skill when you need detail.6465## Getting Help6667- `vat --help` and `vat <group> --help --verbose` for CLI depth68- Repo docs: the VAT repository's `docs/` directory carries the full setup guide, architecture notes, and design references (not bundled with this plugin)69- Contributor reference docs (debugging VAT, install architecture) live under `docs/contributing/` in the VAT repo
jdutton