Golden

Use when running `vat rag index` / `vat rag query` or configuring RAG for agent context — covers installing the RAG backends (they are OPT-IN, not installed with the CLI), the CLI commands, native embedding providers and vector store support, chunking, custom metadata, and extension points for adding new backends.

Use when running vat audit to validate Claude plugins, agent skills, or marketplaces. Covers the audit command, --compat flag for surface compatibility analysis, --exclude for noise filtering, and interpreting audit output.

Use when auditing code for coherence rather than bugs — whether every lane implements one contract, whether a status or report tells the truth, whether a passing test suite is blind, or whether a vendor claim is stale.

Use when reviewing a skill before publication or running `vat skill review`. Pre-publication quality checklist grouped into general (all skills) and CLI-backed items, tied to VAT validation codes and Anthropic's skill-authoring best practices.

Use when running `vat skill test run`/`configure`, triaging friction.json output, reasoning about the test harness's isolation or auth model, or confirming a packaged skill works in a clean install.

Use when programmatically editing markdown or frontmatter — moving files, updating references, batch-renaming, schema-evolution migrations. Steers to comment-preserving FrontmatterEditor + rewriteBodyLinks; away from gray-matter/js-yaml/regex.

Use for Anthropic Enterprise/Team org administration via the Admin API — user management, API-key auditing, cost/usage reporting, workspace admin, and enterprise skill distribution. Requires ANTHROPIC_ADMIN_API_KEY.

Use when authoring TypeScript portable agents — agent archetypes, agent.yaml, result envelopes, orchestration patterns, and runtime adapters (Vercel/LangChain/OpenAI/Claude Agent SDK). Paired with vat-skill-authoring for the SKILL.md side.

Use when authoring or revising a SKILL.md file — frontmatter, body structure, references, packagingOptions, validation overrides — or when writing and bundling the cross-platform Node scripts a skill ships.

Use when setting up `vat build`, configuring plugin distribution (marketplace, plugins, managed settings), npm publishing with postinstall hooks, or `vat verify` — the full pipeline from skill source to installed plugin.

Use when working with VAT resource collections, per-directory frontmatter schema validation, link validation, or the vat resources commands. Covers collection configuration, schema mapping, validation modes, querying the resource projection with SQL via `vat resources query`, and declaring standing SQL assertions that gate CI via `vat resources check`.

Use when starting a new VAT project, adding VAT to an existing repo, or orienting to `vibe-agent-toolkit.config.yaml`. Covers project setup, repo structure, package.json wiring, vibe-validate integration, and the npm postinstall hook.