@vibe-agent-toolkit/vat-development-agents 0.1.15 → 0.1.16-rc.1

package/dist/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "skills": [
         "skills/vibe-agent-toolkit",
         "skills/vibe-agent-toolkit__resources",
-        "skills/vibe-agent-toolkit__distribution",
+        "skills/vibe-agent-toolkit__skills-distribution",
         "skills/vibe-agent-toolkit__agent-authoring",
         "skills/vibe-agent-toolkit__audit",
         "skills/vibe-agent-toolkit__debugging"

package/dist/generated/resources/skills/SKILL.js

@@ -7,7 +7,7 @@ export const meta = {
   description: "Use when building, adopting, or learning vibe-agent-toolkit (VAT). Covers agent creation, CLI commands (vat skills, vat resources, vat audit, vat rag), runtime adapters, skill packaging, and resource validation. Routes to specialized sub-skills."
 };
 
-export const text = "\n# Vibe Agent Toolkit Skill\n\n**Vibe Agent Toolkit (VAT)** is a modular toolkit for building portable AI agents that work across\nmultiple LLM frameworks and deployment targets. Write your agent logic once as plain TypeScript,\nthen deploy it to Vercel AI SDK, LangChain, OpenAI, Claude Agent SDK, or any other runtime using\nframework adapters. No vendor lock-in.\n\n## Purpose: For Users, Not Contributors\n\n- **This skill** = How to USE VAT to build agents\n- **\`vibe-agent-toolkit:debugging\`** = When VAT itself behaves unexpectedly or you need to test a fix\n- **Root CLAUDE.md** = How to DEVELOP the VAT codebase itself\n\n## When to Use VAT\n\n**VAT is great for:** Multi-framework projects, reusable agent libraries, testing across LLM\nproviders, complex multi-agent orchestration, human-in-the-loop workflows.\n\n**VAT may not be needed for:** Simple one-off scripts where the framework is already decided,\nnon-TypeScript/JavaScript projects, or cases where you need deep framework-specific features.\n\n## Skill Routing Table\n\n| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Packaging skills, \`--target claude-web\`, ZIP format | \`vibe-agent-toolkit:distribution\` |\n| Sideloading with \`vat install\`, npm postinstall hooks | \`vibe-agent-toolkit:distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |\n\n## Agent Archetypes (Quick Reference)\n\nFour patterns cover most use cases. For full code examples, see \`vibe-agent-toolkit:agent-authoring\`.\n\n| Archetype | When to Use |\n|---|---|\n| **Pure Function Tool** | Stateless validation, transformation, computation — no LLM needed |\n| **One-Shot LLM Analyzer** | Single LLM call for analysis, classification, or generation |\n| **Conversational Assistant** | Multi-turn dialogue with session state across turns |\n| **External Event Integrator** | Waiting for human approval, webhooks, or third-party APIs |\n\n## Core CLI Commands\n\n\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm\nvat skills build                         # build skills for distribution\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`\n\n## agent-generator: Creating New Agents\n\nThe **agent-generator** is a built-in meta-agent that guides you through designing\nhigh-quality agents via a 4-phase workflow:\n\n1. **GATHER** — Understand your intent and goals\n2. **ANALYZE** — Identify agent pattern and requirements\n3. **DESIGN** — Make architecture decisions (LLM, tools, prompts)\n4. **GENERATE** — Create validated agent package\n\nMinimum input needed:\n\`\`\`json\n{\n  \"agentPurpose\": \"Review PRs for security issues\",\n  \"successCriteria\": \"Catches 100% of critical vulnerabilities\"\n}\n\`\`\`\n\nThe generator produces: \`agent.yaml\`, \`prompts/system.md\`, \`prompts/user.md\`,\n\`schemas/input.schema.json\`, \`schemas/output.schema.json\`, and \`README.md\`.\n\n**Tips for better results:**\n- Be specific about success criteria (\"Under 30s, zero false negatives\") not vague (\"fast enough\")\n- Name the tools the agent needs upfront (file readers, APIs, etc.)\n- Describe domain context (OWASP Top 10, company coding standards, etc.)\n\n## Packaging Markdown for Reuse\n\nVAT\'s resource compiler transforms markdown files into type-safe TypeScript modules,\nenabling prompt libraries, RAG knowledge bases, and shared content across projects.\n\n\`\`\`bash\nnpm install -D @vibe-agent-toolkit/resource-compiler\nnpx vat-compile-resources compile resources/ generated/resources/\n\`\`\`\n\n\`\`\`typescript\nimport * as Doc from \'./generated/resources/doc.js\';\n\nDoc.meta.title;                        // type-safe frontmatter\nDoc.fragments.introduction.text;       // H2 section content\nDoc.text;                              // full markdown\n\`\`\`\n\nUse cases: agent prompt libraries, RAG knowledge bases packaged as npm modules,\nmulti-project content sharing with versioning.\n\n## Common Workflows\n\n**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Skills appear in ~/.claude/skills/ and are auto-loaded by Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Add vat.skills to package.json, then:\nvat skills build          # builds all declared skills\nnpm publish               # publishes to npm\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`\n\n## Success Criteria\n\nYou\'ve successfully adopted VAT when:\n- Agents have clear input/output schemas (Zod-validated)\n- Errors are handled as data (result envelopes), never thrown\n- Tests cover success and error paths without real API calls (mock mode)\n- Agents work across multiple runtimes via adapters\n- Multi-agent pipelines compose via \`andThen()\` / \`match()\` helpers\n\n## Documentation Index\n\n- [Getting Started Guide](../../../../docs/getting-started.md)\n- [Agent Authoring Guide](../../../../docs/agent-authoring.md) — patterns and code examples\n- [Orchestration Guide](../../../../docs/orchestration.md) — multi-agent workflows\n- [RAG Usage Guide](../../../../docs/guides/rag-usage-guide.md)\n- [Resource Compiler Guide](../../../../docs/guides/resource-compiler/compiling-markdown-to-typescript.md)\n- [Runtime Adapters](../../../../docs/adding-runtime-adapters.md)\n- Examples: \`@vibe-agent-toolkit/vat-example-cat-agents\`\n\n## Getting Help\n\n- **CLI Help:** \`vat --help\`, \`vat skills --help\`, etc.\n- **Examples:** \`packages/vat-example-cat-agents/\`\n- **GitHub Issues:** Report bugs or ask questions\n\nHappy agent building!\n";
+export const text = "\n# Vibe Agent Toolkit Skill\n\n**Vibe Agent Toolkit (VAT)** is a modular toolkit for building portable AI agents that work across\nmultiple LLM frameworks and deployment targets. Write your agent logic once as plain TypeScript,\nthen deploy it to Vercel AI SDK, LangChain, OpenAI, Claude Agent SDK, or any other runtime using\nframework adapters. No vendor lock-in.\n\n## Purpose: For Users, Not Contributors\n\n- **This skill** = How to USE VAT to build agents\n- **\`vibe-agent-toolkit:debugging\`** = When VAT itself behaves unexpectedly or you need to test a fix\n- **Root CLAUDE.md** = How to DEVELOP the VAT codebase itself\n\n## When to Use VAT\n\n**VAT is great for:** Multi-framework projects, reusable agent libraries, testing across LLM\nproviders, complex multi-agent orchestration, human-in-the-loop workflows.\n\n**VAT may not be needed for:** Simple one-off scripts where the framework is already decided,\nnon-TypeScript/JavaScript projects, or cases where you need deep framework-specific features.\n\n## Skill Routing Table\n\n| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Setting up \`vat build\` + \`vat claude build\` for a project | \`vibe-agent-toolkit:skills-distribution\` |\n| Configuring \`claude:\` section in vibe-agent-toolkit.config.yaml | \`vibe-agent-toolkit:skills-distribution\` |\n| npm publishing with plugin postinstall | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat build\` / \`vat verify\` orchestration | \`vibe-agent-toolkit:skills-distribution\` |\n| \`--target claude-web\` ZIP format | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |\n\n## Agent Archetypes (Quick Reference)\n\nFour patterns cover most use cases. For full code examples, see \`vibe-agent-toolkit:agent-authoring\`.\n\n| Archetype | When to Use |\n|---|---|\n| **Pure Function Tool** | Stateless validation, transformation, computation — no LLM needed |\n| **One-Shot LLM Analyzer** | Single LLM call for analysis, classification, or generation |\n| **Conversational Assistant** | Multi-turn dialogue with session state across turns |\n| **External Event Integrator** | Waiting for human approval, webhooks, or third-party APIs |\n\n## Core CLI Commands\n\n\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Top-level orchestration\nvat build                                # build all artifacts (skills then claude plugins)\nvat verify                               # verify all artifacts (resources, skills, claude)\n\n# Claude plugin commands\nvat claude build                         # generate plugin artifacts from built skills\nvat claude verify                        # validate plugin artifacts\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm (routes through plugin system)\nvat skills build                         # build portable skills only\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`\n\n## agent-generator: Creating New Agents\n\nThe **agent-generator** is a built-in meta-agent that guides you through designing\nhigh-quality agents via a 4-phase workflow:\n\n1. **GATHER** — Understand your intent and goals\n2. **ANALYZE** — Identify agent pattern and requirements\n3. **DESIGN** — Make architecture decisions (LLM, tools, prompts)\n4. **GENERATE** — Create validated agent package\n\nMinimum input needed:\n\`\`\`json\n{\n  \"agentPurpose\": \"Review PRs for security issues\",\n  \"successCriteria\": \"Catches 100% of critical vulnerabilities\"\n}\n\`\`\`\n\nThe generator produces: \`agent.yaml\`, \`prompts/system.md\`, \`prompts/user.md\`,\n\`schemas/input.schema.json\`, \`schemas/output.schema.json\`, and \`README.md\`.\n\n**Tips for better results:**\n- Be specific about success criteria (\"Under 30s, zero false negatives\") not vague (\"fast enough\")\n- Name the tools the agent needs upfront (file readers, APIs, etc.)\n- Describe domain context (OWASP Top 10, company coding standards, etc.)\n\n## Packaging Markdown for Reuse\n\nVAT\'s resource compiler transforms markdown files into type-safe TypeScript modules,\nenabling prompt libraries, RAG knowledge bases, and shared content across projects.\n\n\`\`\`bash\nnpm install -D @vibe-agent-toolkit/resource-compiler\nnpx vat-compile-resources compile resources/ generated/resources/\n\`\`\`\n\n\`\`\`typescript\nimport * as Doc from \'./generated/resources/doc.js\';\n\nDoc.meta.title;                        // type-safe frontmatter\nDoc.fragments.introduction.text;       // H2 section content\nDoc.text;                              // full markdown\n\`\`\`\n\nUse cases: agent prompt libraries, RAG knowledge bases packaged as npm modules,\nmulti-project content sharing with versioning.\n\n## Common Workflows\n\n**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Plugin-aware packages register in Claude\'s plugin system\n# Skills are invoked as /plugin-name:skill-name in Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Configure vat.skills in package.json + claude: in vibe-agent-toolkit.config.yaml, then:\nvat build                 # builds skills + claude plugin artifacts\nvat verify                # validates everything\nnpm publish               # publishes to npm (postinstall registers the plugin)\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`\n\n## Success Criteria\n\nYou\'ve successfully adopted VAT when:\n- Agents have clear input/output schemas (Zod-validated)\n- Errors are handled as data (result envelopes), never thrown\n- Tests cover success and error paths without real API calls (mock mode)\n- Agents work across multiple runtimes via adapters\n- Multi-agent pipelines compose via \`andThen()\` / \`match()\` helpers\n\n## Documentation Index\n\n- [Getting Started Guide](../../../../docs/getting-started.md)\n- [Agent Authoring Guide](../../../../docs/agent-authoring.md) — patterns and code examples\n- [Orchestration Guide](../../../../docs/orchestration.md) — multi-agent workflows\n- [RAG Usage Guide](../../../../docs/guides/rag-usage-guide.md)\n- [Resource Compiler Guide](../../../../docs/guides/resource-compiler/compiling-markdown-to-typescript.md)\n- [Runtime Adapters](../../../../docs/adding-runtime-adapters.md)\n- Examples: \`@vibe-agent-toolkit/vat-example-cat-agents\`\n\n## Getting Help\n\n- **CLI Help:** \`vat --help\`, \`vat skills --help\`, etc.\n- **Examples:** \`packages/vat-example-cat-agents/\`\n- **GitHub Issues:** Report bugs or ask questions\n\nHappy agent building!\n";
 
 export const fragments = {
   purposeForUsersNotContributors: {
@@ -22,8 +22,8 @@ export const fragments = {
   },
   skillRoutingTable: {
     header: "## Skill Routing Table",
-    body: "| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Packaging skills, \`--target claude-web\`, ZIP format | \`vibe-agent-toolkit:distribution\` |\n| Sideloading with \`vat install\`, npm postinstall hooks | \`vibe-agent-toolkit:distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |",
-    text: "## Skill Routing Table\n\n| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Packaging skills, \`--target claude-web\`, ZIP format | \`vibe-agent-toolkit:distribution\` |\n| Sideloading with \`vat install\`, npm postinstall hooks | \`vibe-agent-toolkit:distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |"
+    body: "| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Setting up \`vat build\` + \`vat claude build\` for a project | \`vibe-agent-toolkit:skills-distribution\` |\n| Configuring \`claude:\` section in vibe-agent-toolkit.config.yaml | \`vibe-agent-toolkit:skills-distribution\` |\n| npm publishing with plugin postinstall | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat build\` / \`vat verify\` orchestration | \`vibe-agent-toolkit:skills-distribution\` |\n| \`--target claude-web\` ZIP format | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |",
+    text: "## Skill Routing Table\n\n| If you\'re working on... | Use this skill |\n|---|---|\n| Writing or structuring a \`SKILL.md\` file | \`vibe-agent-toolkit:agent-authoring\` |\n| Agent archetypes, orchestration patterns, result envelopes | \`vibe-agent-toolkit:agent-authoring\` |\n| \`packagingOptions\` (linkFollowDepth, excludeReferencesFromBundle) | \`vibe-agent-toolkit:agent-authoring\` |\n| Resource collections, frontmatter schema validation | \`vibe-agent-toolkit:resources\` |\n| \`vat resources validate\`, collection config | \`vibe-agent-toolkit:resources\` |\n| Setting up \`vat build\` + \`vat claude build\` for a project | \`vibe-agent-toolkit:skills-distribution\` |\n| Configuring \`claude:\` section in vibe-agent-toolkit.config.yaml | \`vibe-agent-toolkit:skills-distribution\` |\n| npm publishing with plugin postinstall | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat build\` / \`vat verify\` orchestration | \`vibe-agent-toolkit:skills-distribution\` |\n| \`--target claude-web\` ZIP format | \`vibe-agent-toolkit:skills-distribution\` |\n| \`vat audit\`, \`--compat\`, CI validation | \`vibe-agent-toolkit:audit\` |\n| VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | \`vibe-agent-toolkit:debugging\` |"
   },
   agentArchetypesQuickReference: {
     header: "## Agent Archetypes (Quick Reference)",
@@ -32,8 +32,8 @@ export const fragments = {
   },
   coreCliCommands: {
     header: "## Core CLI Commands",
-    body: "\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm\nvat skills build                         # build skills for distribution\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`",
-    text: "## Core CLI Commands\n\n\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm\nvat skills build                         # build skills for distribution\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`"
+    body: "\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Top-level orchestration\nvat build                                # build all artifacts (skills then claude plugins)\nvat verify                               # verify all artifacts (resources, skills, claude)\n\n# Claude plugin commands\nvat claude build                         # generate plugin artifacts from built skills\nvat claude verify                        # validate plugin artifacts\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm (routes through plugin system)\nvat skills build                         # build portable skills only\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`",
+    text: "## Core CLI Commands\n\n\`\`\`bash\n# Install VAT CLI globally\nnpm install -g vibe-agent-toolkit\n\n# Top-level orchestration\nvat build                                # build all artifacts (skills then claude plugins)\nvat verify                               # verify all artifacts (resources, skills, claude)\n\n# Claude plugin commands\nvat claude build                         # generate plugin artifacts from built skills\nvat claude verify                        # validate plugin artifacts\n\n# Skills\nvat skills list                          # list skills in current project\nvat skills list --user                   # list user-installed skills\nvat skills install npm:@org/my-skills    # install from npm (routes through plugin system)\nvat skills build                         # build portable skills only\nvat skills validate                      # validate skill quality\n\n# Resources\nvat resources validate                   # validate collections (reads config)\nvat resources validate docs/ --frontmatter-schema schema.json\n\n# Audit\nvat audit                                # audit current directory recursively\nvat audit --user                         # audit entire Claude installation\nvat audit ./plugins/ --compat            # check surface compatibility\n\n# RAG\nvat rag index docs/                      # index markdown into vector DB\nvat rag query \"my question\" --limit 5    # semantic search\n\n# Get help for any command\nvat --help\nvat skills --help\n\`\`\`"
   },
   agentGeneratorCreatingNewAgents: {
     header: "## agent-generator: Creating New Agents",
@@ -47,8 +47,8 @@ export const fragments = {
   },
   commonWorkflows: {
     header: "## Common Workflows",
-    body: "**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Skills appear in ~/.claude/skills/ and are auto-loaded by Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Add vat.skills to package.json, then:\nvat skills build          # builds all declared skills\nnpm publish               # publishes to npm\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`",
-    text: "## Common Workflows\n\n**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Skills appear in ~/.claude/skills/ and are auto-loaded by Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Add vat.skills to package.json, then:\nvat skills build          # builds all declared skills\nnpm publish               # publishes to npm\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`"
+    body: "**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Plugin-aware packages register in Claude\'s plugin system\n# Skills are invoked as /plugin-name:skill-name in Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Configure vat.skills in package.json + claude: in vibe-agent-toolkit.config.yaml, then:\nvat build                 # builds skills + claude plugin artifacts\nvat verify                # validates everything\nnpm publish               # publishes to npm (postinstall registers the plugin)\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`",
+    text: "## Common Workflows\n\n**Create a new agent:**\n\`\`\`bash\n# Use agent-generator interactively, then:\nvat agent import my-skill/SKILL.md   # import to VAT format\nvat skills validate                   # check quality\nvat skills build                      # package for distribution\n\`\`\`\n\n**Install and use a community skill:**\n\`\`\`bash\nvat skills install npm:@vibe-agent-toolkit/vat-cat-agents\nvat skills list --user\n# Plugin-aware packages register in Claude\'s plugin system\n# Skills are invoked as /plugin-name:skill-name in Claude Code\n\`\`\`\n\n**Build and publish your own skill package:**\n\`\`\`bash\n# Configure vat.skills in package.json + claude: in vibe-agent-toolkit.config.yaml, then:\nvat build                 # builds skills + claude plugin artifacts\nvat verify                # validates everything\nnpm publish               # publishes to npm (postinstall registers the plugin)\n# Users install with: vat skills install npm:@myorg/my-skills\n\`\`\`"
   },
   successCriteria: {
     header: "## Success Criteria",

package/dist/generated/resources/skills/vat-skills-distribution.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generated TypeScript declarations - DO NOT EDIT
+ */
+
+export interface Fragment {
+  readonly header: string;
+  readonly body: string;
+  readonly text: string;
+}
+
+export const meta: {
+  readonly name: string;
+  readonly description: string;
+};
+
+export const text: string;
+
+export const fragments: {
+  readonly overview: Fragment;
+  readonly projectStructure: Fragment;
+  readonly step1PackagejsonConfiguration: Fragment;
+  readonly step2VibeAgentToolkitconfigyaml: Fragment;
+  readonly step3Build: Fragment;
+  readonly step4Publish: Fragment;
+  readonly step5UserInstall: Fragment;
+  readonly sourceLayoutPattern: Fragment;
+  readonly managedSettingsjsonValidationEnterprise: Fragment;
+  readonly -TargetClaudeWebZipUpload: Fragment;
+  readonly quickReference: Fragment;
+};
+
+export type FragmentName = keyof typeof fragments;

package/dist/generated/resources/skills/vat-skills-distribution.js

@@ -0,0 +1,68 @@
+/**
+ * Generated from markdown file - DO NOT EDIT
+ */
+
+export const meta = {
+  name: "vibe-agent-toolkit:skills-distribution",
+  description: "Use when setting up vat build, configuring plugin distribution for the Claude ecosystem (marketplace, plugins, managed settings), npm publishing with postinstall hooks, or vat verify orchestration. Covers the full pipeline from skill source to installed plugin."
+};
+
+export const text = "\n# VAT Distribution: Build, Publish & Install\n\n## Overview\n\nVAT distributes skills as **Claude plugins** via npm packages. The pipeline:\n\n1. \`vat build\` compiles SKILL.md sources into plugin artifacts\n2. \`npm publish\` pushes the package to a registry\n3. \`npm install\` triggers a postinstall hook that registers the plugin in Claude\'s plugin system\n\nSkills installed this way appear in Claude Code as \`/plugin-name:skill-name\`.\n\n## Project Structure\n\n\`\`\`\nmy-project/\n├── package.json                    ← vat.skills + postinstall hook + publishConfig\n├── vibe-agent-toolkit.config.yaml  ← claude: marketplace config\n├── skills/\n│   └── my-skill/\n│       └── SKILL.md\n└── dist/                           ← generated by vat build\n    ├── skills/my-skill/\n    ├── plugins/my-plugin/\n    └── .claude-plugin/\n        └── marketplace.json\n\`\`\`\n\n## Step 1: package.json Configuration\n\n\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"vat\": {\n    \"skills\": [\n      {\n        \"name\": \"my-skill\",\n        \"source\": \"./skills/my-skill/SKILL.md\",\n        \"path\": \"./dist/skills/my-skill\"\n      }\n    ]\n  },\n  \"scripts\": {\n    \"build:vat\": \"vat build\",\n    \"postinstall\": \"vat skills install --npm-postinstall || exit 0\"\n  },\n  \"files\": [\"dist\", \"README.md\"],\n  \"publishConfig\": {\n    \"registry\": \"https://registry.npmjs.org\"\n  }\n}\n\`\`\`\n\nFor private GitHub Packages registry:\n\`\`\`json\n\"publishConfig\": {\n  \"registry\": \"https://npm.pkg.github.com\",\n  \"access\": \"restricted\"\n}\n\`\`\`\n\nUsers installing from GitHub Packages need \`.npmrc\` with the scope registry and auth token:\n\`\`\`\n@myorg:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}\n\`\`\`\n\n## Step 2: vibe-agent-toolkit.config.yaml\n\n\`\`\`yaml\nversion: 1\n\nclaude:\n  marketplaces:\n    my-marketplace:         # org/publisher identity\n      owner:\n        name: My Organization\n      skills:\n        - \"my-*\"            # glob matching skill names from vat.skills\n      plugins:\n        - name: my-plugin   # installable unit\n          skills: \"*\"       # all skills matched by this marketplace\n      output:\n        marketplaceJson: dist/.claude-plugin/marketplace.json\n        pluginsDir: dist/plugins/\n\`\`\`\n\n**Naming convention:** marketplace = org identity (e.g. \`acme\`), plugin = this package\n(e.g. \`acme-tools\`). Registers as \`my-plugin@my-marketplace\` in Claude\'s plugin registry.\n\n### Multiple skills in one package\n\nList all skills in \`vat.skills\` and use a glob in the marketplace config:\n\n\`\`\`json\n\"vat\": {\n  \"skills\": [\n    { \"name\": \"my-linting\", \"source\": \"./skills/linting/SKILL.md\", \"path\": \"./dist/skills/my-linting\" },\n    { \"name\": \"my-testing\", \"source\": \"./skills/testing/SKILL.md\", \"path\": \"./dist/skills/my-testing\" }\n  ]\n}\n\`\`\`\n\n\`\`\`yaml\nskills:\n  - \"my-*\"    # matches both my-linting and my-testing\n\`\`\`\n\nAll matched skills are bundled into the single plugin.\n\n## Step 3: Build\n\n\`\`\`bash\nvat build        # skills phase then claude phase\nvat verify       # validates resources + skills + claude artifacts\n\`\`\`\n\n### What vat build does\n\nTwo phases, run in dependency order:\n\n1. **\`vat skills build\`** — reads \`package.json vat.skills\`, compiles each SKILL.md + referenced resources into \`dist/skills/<name>/\`\n2. **\`vat claude build\`** — reads \`vibe-agent-toolkit.config.yaml claude:\` section, wraps built skills into plugin structure, generates \`marketplace.json\`\n\nIndividual commands still work:\n\`\`\`bash\nvat skills build       # skills phase only\nvat claude build       # claude plugin phase only (requires skills already built)\nvat claude verify      # validate plugin artifacts only\n\`\`\`\n\n## Step 4: Publish\n\n\`\`\`bash\nnpm publish --tag next    # RC/pre-release\nnpm publish               # stable release\n\`\`\`\n\n## Step 5: User Install\n\n\`\`\`bash\nvat skills install npm:@myorg/my-skills\n\`\`\`\n\nOr via standard npm install (postinstall hook triggers automatically):\n\`\`\`bash\nnpm install -g @myorg/my-skills\n\`\`\`\n\n### How plugin installation works\n\nWhen \`npm install\` runs the postinstall hook (\`vat skills install --npm-postinstall\`):\n\n- VAT detects \`dist/.claude-plugin/marketplace.json\` in the installed package\n- Installs via Claude\'s plugin system (NOT \`~/.claude/skills/\`)\n- Writes to these locations:\n  1. \`~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/\` — plugin files\n  2. \`~/.claude/plugins/known_marketplaces.json\` — marketplace registry\n  3. \`~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/\` — version cache\n  4. \`~/.claude/plugins/installed_plugins.json\` — installation record\n  5. \`~/.claude/settings.json\` \`enabledPlugins\` — activates the plugin\n\nIf no \`marketplace.json\` exists (package wasn\'t built before publish): a guidance message is emitted and the hook exits 0. The publisher must run \`vat build\` and re-publish.\n\nSkills are then available in Claude Code as \`/plugin-name:skill-name\`.\n\n## Source-Layout Pattern\n\nFor projects where the repo itself contains \`marketplace.json\` and plugin structure (no build step needed):\n\n\`\`\`yaml\nclaude:\n  marketplaces:\n    my-marketplace:\n      file: .claude-plugin/marketplace.json   # VAT verifies but does NOT generate\n\`\`\`\n\n\`vat verify\` validates the existing file. \`vat build\` skips the claude phase for \`file:\` marketplaces.\n\n## managed-settings.json Validation (Enterprise)\n\n\`\`\`yaml\nclaude:\n  managedSettings: managed-settings.json\n\`\`\`\n\n\`vat verify\` validates this file against the ManagedSettings schema. Catches typos and schema errors before deployment. Does NOT deploy the file — deployment is a separate concern.\n\n## --target claude-web (ZIP Upload)\n\nFor uploading skills directly to \`claude.ai/settings/capabilities\`:\n\n\`\`\`bash\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\`\`\`\n\nProduces a ZIP:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure source path mappings in \`package.json\`:\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\`.\n\n## Quick Reference\n\n| Task | Command |\n|---|---|\n| Build everything | \`vat build\` |\n| Verify everything | \`vat verify\` |\n| Build skills only | \`vat skills build\` |\n| Build claude artifacts only | \`vat claude build\` |\n| Verify claude artifacts only | \`vat claude verify\` |\n| Install from npm | \`vat skills install npm:@org/pkg\` |\n| Package for claude.ai upload | \`vat skills package ./SKILL.md -o ./dist/ --target claude-web\` |\n";
+
+export const fragments = {
+  overview: {
+    header: "## Overview",
+    body: "VAT distributes skills as **Claude plugins** via npm packages. The pipeline:\n\n1. \`vat build\` compiles SKILL.md sources into plugin artifacts\n2. \`npm publish\` pushes the package to a registry\n3. \`npm install\` triggers a postinstall hook that registers the plugin in Claude\'s plugin system\n\nSkills installed this way appear in Claude Code as \`/plugin-name:skill-name\`.",
+    text: "## Overview\n\nVAT distributes skills as **Claude plugins** via npm packages. The pipeline:\n\n1. \`vat build\` compiles SKILL.md sources into plugin artifacts\n2. \`npm publish\` pushes the package to a registry\n3. \`npm install\` triggers a postinstall hook that registers the plugin in Claude\'s plugin system\n\nSkills installed this way appear in Claude Code as \`/plugin-name:skill-name\`."
+  },
+  projectStructure: {
+    header: "## Project Structure",
+    body: "\`\`\`\nmy-project/\n├── package.json                    ← vat.skills + postinstall hook + publishConfig\n├── vibe-agent-toolkit.config.yaml  ← claude: marketplace config\n├── skills/\n│   └── my-skill/\n│       └── SKILL.md\n└── dist/                           ← generated by vat build\n    ├── skills/my-skill/\n    ├── plugins/my-plugin/\n    └── .claude-plugin/\n        └── marketplace.json\n\`\`\`",
+    text: "## Project Structure\n\n\`\`\`\nmy-project/\n├── package.json                    ← vat.skills + postinstall hook + publishConfig\n├── vibe-agent-toolkit.config.yaml  ← claude: marketplace config\n├── skills/\n│   └── my-skill/\n│       └── SKILL.md\n└── dist/                           ← generated by vat build\n    ├── skills/my-skill/\n    ├── plugins/my-plugin/\n    └── .claude-plugin/\n        └── marketplace.json\n\`\`\`"
+  },
+  step1PackagejsonConfiguration: {
+    header: "## Step 1: package.json Configuration",
+    body: "\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"vat\": {\n    \"skills\": [\n      {\n        \"name\": \"my-skill\",\n        \"source\": \"./skills/my-skill/SKILL.md\",\n        \"path\": \"./dist/skills/my-skill\"\n      }\n    ]\n  },\n  \"scripts\": {\n    \"build:vat\": \"vat build\",\n    \"postinstall\": \"vat skills install --npm-postinstall || exit 0\"\n  },\n  \"files\": [\"dist\", \"README.md\"],\n  \"publishConfig\": {\n    \"registry\": \"https://registry.npmjs.org\"\n  }\n}\n\`\`\`\n\nFor private GitHub Packages registry:\n\`\`\`json\n\"publishConfig\": {\n  \"registry\": \"https://npm.pkg.github.com\",\n  \"access\": \"restricted\"\n}\n\`\`\`\n\nUsers installing from GitHub Packages need \`.npmrc\` with the scope registry and auth token:\n\`\`\`\n@myorg:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}\n\`\`\`",
+    text: "## Step 1: package.json Configuration\n\n\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"vat\": {\n    \"skills\": [\n      {\n        \"name\": \"my-skill\",\n        \"source\": \"./skills/my-skill/SKILL.md\",\n        \"path\": \"./dist/skills/my-skill\"\n      }\n    ]\n  },\n  \"scripts\": {\n    \"build:vat\": \"vat build\",\n    \"postinstall\": \"vat skills install --npm-postinstall || exit 0\"\n  },\n  \"files\": [\"dist\", \"README.md\"],\n  \"publishConfig\": {\n    \"registry\": \"https://registry.npmjs.org\"\n  }\n}\n\`\`\`\n\nFor private GitHub Packages registry:\n\`\`\`json\n\"publishConfig\": {\n  \"registry\": \"https://npm.pkg.github.com\",\n  \"access\": \"restricted\"\n}\n\`\`\`\n\nUsers installing from GitHub Packages need \`.npmrc\` with the scope registry and auth token:\n\`\`\`\n@myorg:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}\n\`\`\`"
+  },
+  step2VibeAgentToolkitconfigyaml: {
+    header: "## Step 2: vibe-agent-toolkit.config.yaml",
+    body: "\`\`\`yaml\nversion: 1\n\nclaude:\n  marketplaces:\n    my-marketplace:         # org/publisher identity\n      owner:\n        name: My Organization\n      skills:\n        - \"my-*\"            # glob matching skill names from vat.skills\n      plugins:\n        - name: my-plugin   # installable unit\n          skills: \"*\"       # all skills matched by this marketplace\n      output:\n        marketplaceJson: dist/.claude-plugin/marketplace.json\n        pluginsDir: dist/plugins/\n\`\`\`\n\n**Naming convention:** marketplace = org identity (e.g. \`acme\`), plugin = this package\n(e.g. \`acme-tools\`). Registers as \`my-plugin@my-marketplace\` in Claude\'s plugin registry.\n\n### Multiple skills in one package\n\nList all skills in \`vat.skills\` and use a glob in the marketplace config:\n\n\`\`\`json\n\"vat\": {\n  \"skills\": [\n    { \"name\": \"my-linting\", \"source\": \"./skills/linting/SKILL.md\", \"path\": \"./dist/skills/my-linting\" },\n    { \"name\": \"my-testing\", \"source\": \"./skills/testing/SKILL.md\", \"path\": \"./dist/skills/my-testing\" }\n  ]\n}\n\`\`\`\n\n\`\`\`yaml\nskills:\n  - \"my-*\"    # matches both my-linting and my-testing\n\`\`\`\n\nAll matched skills are bundled into the single plugin.",
+    text: "## Step 2: vibe-agent-toolkit.config.yaml\n\n\`\`\`yaml\nversion: 1\n\nclaude:\n  marketplaces:\n    my-marketplace:         # org/publisher identity\n      owner:\n        name: My Organization\n      skills:\n        - \"my-*\"            # glob matching skill names from vat.skills\n      plugins:\n        - name: my-plugin   # installable unit\n          skills: \"*\"       # all skills matched by this marketplace\n      output:\n        marketplaceJson: dist/.claude-plugin/marketplace.json\n        pluginsDir: dist/plugins/\n\`\`\`\n\n**Naming convention:** marketplace = org identity (e.g. \`acme\`), plugin = this package\n(e.g. \`acme-tools\`). Registers as \`my-plugin@my-marketplace\` in Claude\'s plugin registry.\n\n### Multiple skills in one package\n\nList all skills in \`vat.skills\` and use a glob in the marketplace config:\n\n\`\`\`json\n\"vat\": {\n  \"skills\": [\n    { \"name\": \"my-linting\", \"source\": \"./skills/linting/SKILL.md\", \"path\": \"./dist/skills/my-linting\" },\n    { \"name\": \"my-testing\", \"source\": \"./skills/testing/SKILL.md\", \"path\": \"./dist/skills/my-testing\" }\n  ]\n}\n\`\`\`\n\n\`\`\`yaml\nskills:\n  - \"my-*\"    # matches both my-linting and my-testing\n\`\`\`\n\nAll matched skills are bundled into the single plugin."
+  },
+  step3Build: {
+    header: "## Step 3: Build",
+    body: "\`\`\`bash\nvat build        # skills phase then claude phase\nvat verify       # validates resources + skills + claude artifacts\n\`\`\`\n\n### What vat build does\n\nTwo phases, run in dependency order:\n\n1. **\`vat skills build\`** — reads \`package.json vat.skills\`, compiles each SKILL.md + referenced resources into \`dist/skills/<name>/\`\n2. **\`vat claude build\`** — reads \`vibe-agent-toolkit.config.yaml claude:\` section, wraps built skills into plugin structure, generates \`marketplace.json\`\n\nIndividual commands still work:\n\`\`\`bash\nvat skills build       # skills phase only\nvat claude build       # claude plugin phase only (requires skills already built)\nvat claude verify      # validate plugin artifacts only\n\`\`\`",
+    text: "## Step 3: Build\n\n\`\`\`bash\nvat build        # skills phase then claude phase\nvat verify       # validates resources + skills + claude artifacts\n\`\`\`\n\n### What vat build does\n\nTwo phases, run in dependency order:\n\n1. **\`vat skills build\`** — reads \`package.json vat.skills\`, compiles each SKILL.md + referenced resources into \`dist/skills/<name>/\`\n2. **\`vat claude build\`** — reads \`vibe-agent-toolkit.config.yaml claude:\` section, wraps built skills into plugin structure, generates \`marketplace.json\`\n\nIndividual commands still work:\n\`\`\`bash\nvat skills build       # skills phase only\nvat claude build       # claude plugin phase only (requires skills already built)\nvat claude verify      # validate plugin artifacts only\n\`\`\`"
+  },
+  step4Publish: {
+    header: "## Step 4: Publish",
+    body: "\`\`\`bash\nnpm publish --tag next    # RC/pre-release\nnpm publish               # stable release\n\`\`\`",
+    text: "## Step 4: Publish\n\n\`\`\`bash\nnpm publish --tag next    # RC/pre-release\nnpm publish               # stable release\n\`\`\`"
+  },
+  step5UserInstall: {
+    header: "## Step 5: User Install",
+    body: "\`\`\`bash\nvat skills install npm:@myorg/my-skills\n\`\`\`\n\nOr via standard npm install (postinstall hook triggers automatically):\n\`\`\`bash\nnpm install -g @myorg/my-skills\n\`\`\`\n\n### How plugin installation works\n\nWhen \`npm install\` runs the postinstall hook (\`vat skills install --npm-postinstall\`):\n\n- VAT detects \`dist/.claude-plugin/marketplace.json\` in the installed package\n- Installs via Claude\'s plugin system (NOT \`~/.claude/skills/\`)\n- Writes to these locations:\n  1. \`~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/\` — plugin files\n  2. \`~/.claude/plugins/known_marketplaces.json\` — marketplace registry\n  3. \`~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/\` — version cache\n  4. \`~/.claude/plugins/installed_plugins.json\` — installation record\n  5. \`~/.claude/settings.json\` \`enabledPlugins\` — activates the plugin\n\nIf no \`marketplace.json\` exists (package wasn\'t built before publish): a guidance message is emitted and the hook exits 0. The publisher must run \`vat build\` and re-publish.\n\nSkills are then available in Claude Code as \`/plugin-name:skill-name\`.",
+    text: "## Step 5: User Install\n\n\`\`\`bash\nvat skills install npm:@myorg/my-skills\n\`\`\`\n\nOr via standard npm install (postinstall hook triggers automatically):\n\`\`\`bash\nnpm install -g @myorg/my-skills\n\`\`\`\n\n### How plugin installation works\n\nWhen \`npm install\` runs the postinstall hook (\`vat skills install --npm-postinstall\`):\n\n- VAT detects \`dist/.claude-plugin/marketplace.json\` in the installed package\n- Installs via Claude\'s plugin system (NOT \`~/.claude/skills/\`)\n- Writes to these locations:\n  1. \`~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/\` — plugin files\n  2. \`~/.claude/plugins/known_marketplaces.json\` — marketplace registry\n  3. \`~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/\` — version cache\n  4. \`~/.claude/plugins/installed_plugins.json\` — installation record\n  5. \`~/.claude/settings.json\` \`enabledPlugins\` — activates the plugin\n\nIf no \`marketplace.json\` exists (package wasn\'t built before publish): a guidance message is emitted and the hook exits 0. The publisher must run \`vat build\` and re-publish.\n\nSkills are then available in Claude Code as \`/plugin-name:skill-name\`."
+  },
+  sourceLayoutPattern: {
+    header: "## Source-Layout Pattern",
+    body: "For projects where the repo itself contains \`marketplace.json\` and plugin structure (no build step needed):\n\n\`\`\`yaml\nclaude:\n  marketplaces:\n    my-marketplace:\n      file: .claude-plugin/marketplace.json   # VAT verifies but does NOT generate\n\`\`\`\n\n\`vat verify\` validates the existing file. \`vat build\` skips the claude phase for \`file:\` marketplaces.",
+    text: "## Source-Layout Pattern\n\nFor projects where the repo itself contains \`marketplace.json\` and plugin structure (no build step needed):\n\n\`\`\`yaml\nclaude:\n  marketplaces:\n    my-marketplace:\n      file: .claude-plugin/marketplace.json   # VAT verifies but does NOT generate\n\`\`\`\n\n\`vat verify\` validates the existing file. \`vat build\` skips the claude phase for \`file:\` marketplaces."
+  },
+  managedSettingsjsonValidationEnterprise: {
+    header: "## managed-settings.json Validation (Enterprise)",
+    body: "\`\`\`yaml\nclaude:\n  managedSettings: managed-settings.json\n\`\`\`\n\n\`vat verify\` validates this file against the ManagedSettings schema. Catches typos and schema errors before deployment. Does NOT deploy the file — deployment is a separate concern.",
+    text: "## managed-settings.json Validation (Enterprise)\n\n\`\`\`yaml\nclaude:\n  managedSettings: managed-settings.json\n\`\`\`\n\n\`vat verify\` validates this file against the ManagedSettings schema. Catches typos and schema errors before deployment. Does NOT deploy the file — deployment is a separate concern."
+  },
+  -TargetClaudeWebZipUpload: {
+    header: "## --target claude-web (ZIP Upload)",
+    body: "For uploading skills directly to \`claude.ai/settings/capabilities\`:\n\n\`\`\`bash\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\`\`\`\n\nProduces a ZIP:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure source path mappings in \`package.json\`:\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\`.",
+    text: "## --target claude-web (ZIP Upload)\n\nFor uploading skills directly to \`claude.ai/settings/capabilities\`:\n\n\`\`\`bash\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\`\`\`\n\nProduces a ZIP:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure source path mappings in \`package.json\`:\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\`."
+  },
+  quickReference: {
+    header: "## Quick Reference",
+    body: "| Task | Command |\n|---|---|\n| Build everything | \`vat build\` |\n| Verify everything | \`vat verify\` |\n| Build skills only | \`vat skills build\` |\n| Build claude artifacts only | \`vat claude build\` |\n| Verify claude artifacts only | \`vat claude verify\` |\n| Install from npm | \`vat skills install npm:@org/pkg\` |\n| Package for claude.ai upload | \`vat skills package ./SKILL.md -o ./dist/ --target claude-web\` |",
+    text: "## Quick Reference\n\n| Task | Command |\n|---|---|\n| Build everything | \`vat build\` |\n| Verify everything | \`vat verify\` |\n| Build skills only | \`vat skills build\` |\n| Build claude artifacts only | \`vat claude build\` |\n| Verify claude artifacts only | \`vat claude verify\` |\n| Install from npm | \`vat skills install npm:@org/pkg\` |\n| Package for claude.ai upload | \`vat skills package ./SKILL.md -o ./dist/ --target claude-web\` |"
+  }
+};

package/dist/plugins/vat-development-agents/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "skills": [
     "skills/vibe-agent-toolkit",
     "skills/vibe-agent-toolkit__resources",
-    "skills/vibe-agent-toolkit__distribution",
+    "skills/vibe-agent-toolkit__skills-distribution",
     "skills/vibe-agent-toolkit__agent-authoring",
     "skills/vibe-agent-toolkit__audit",
     "skills/vibe-agent-toolkit__debugging"

package/dist/plugins/vat-development-agents/skills/vibe-agent-toolkit/SKILL.md

@@ -33,8 +33,11 @@ non-TypeScript/JavaScript projects, or cases where you need deep framework-speci
 | `packagingOptions` (linkFollowDepth, excludeReferencesFromBundle) | `vibe-agent-toolkit:agent-authoring` |
 | Resource collections, frontmatter schema validation | `vibe-agent-toolkit:resources` |
 | `vat resources validate`, collection config | `vibe-agent-toolkit:resources` |
-| Packaging skills, `--target claude-web`, ZIP format | `vibe-agent-toolkit:distribution` |
-| Sideloading with `vat install`, npm postinstall hooks | `vibe-agent-toolkit:distribution` |
+| Setting up `vat build` + `vat claude build` for a project | `vibe-agent-toolkit:skills-distribution` |
+| Configuring `claude:` section in vibe-agent-toolkit.config.yaml | `vibe-agent-toolkit:skills-distribution` |
+| npm publishing with plugin postinstall | `vibe-agent-toolkit:skills-distribution` |
+| `vat build` / `vat verify` orchestration | `vibe-agent-toolkit:skills-distribution` |
+| `--target claude-web` ZIP format | `vibe-agent-toolkit:skills-distribution` |
 | `vat audit`, `--compat`, CI validation | `vibe-agent-toolkit:audit` |
 | VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | `vibe-agent-toolkit:debugging` |
 
@@ -55,11 +58,19 @@ Four patterns cover most use cases. For full code examples, see `vibe-agent-tool
 # Install VAT CLI globally
 npm install -g vibe-agent-toolkit
 
+# Top-level orchestration
+vat build                                # build all artifacts (skills then claude plugins)
+vat verify                               # verify all artifacts (resources, skills, claude)
+
+# Claude plugin commands
+vat claude build                         # generate plugin artifacts from built skills
+vat claude verify                        # validate plugin artifacts
+
 # Skills
 vat skills list                          # list skills in current project
 vat skills list --user                   # list user-installed skills
-vat skills install npm:@org/my-skills    # install from npm
-vat skills build                         # build skills for distribution
+vat skills install npm:@org/my-skills    # install from npm (routes through plugin system)
+vat skills build                         # build portable skills only
 vat skills validate                      # validate skill quality
 
 # Resources
@@ -141,14 +152,16 @@ vat skills build                      # package for distribution
 ```bash
 vat skills install npm:@vibe-agent-toolkit/vat-cat-agents
 vat skills list --user
-# Skills appear in ~/.claude/skills/ and are auto-loaded by Claude Code
+# Plugin-aware packages register in Claude's plugin system
+# Skills are invoked as /plugin-name:skill-name in Claude Code
 ```
 
 **Build and publish your own skill package:**
 ```bash
-# Add vat.skills to package.json, then:
-vat skills build          # builds all declared skills
-npm publish               # publishes to npm
+# Configure vat.skills in package.json + claude: in vibe-agent-toolkit.config.yaml, then:
+vat build                 # builds skills + claude plugin artifacts
+vat verify                # validates everything
+npm publish               # publishes to npm (postinstall registers the plugin)
 # Users install with: vat skills install npm:@myorg/my-skills
 ```
 

package/dist/plugins/vat-development-agents/skills/vibe-agent-toolkit__skills-distribution/SKILL.md

@@ -0,0 +1,242 @@
+---
+name: vibe-agent-toolkit:skills-distribution
+description: Use when setting up vat build, configuring plugin distribution for the Claude ecosystem (marketplace, plugins, managed settings), npm publishing with postinstall hooks, or vat verify orchestration. Covers the full pipeline from skill source to installed plugin.
+---
+
+# VAT Distribution: Build, Publish & Install
+
+## Overview
+
+VAT distributes skills as **Claude plugins** via npm packages. The pipeline:
+
+1. `vat build` compiles SKILL.md sources into plugin artifacts
+2. `npm publish` pushes the package to a registry
+3. `npm install` triggers a postinstall hook that registers the plugin in Claude's plugin system
+
+Skills installed this way appear in Claude Code as `/plugin-name:skill-name`.
+
+## Project Structure
+
+```
+my-project/
+├── package.json                    ← vat.skills + postinstall hook + publishConfig
+├── vibe-agent-toolkit.config.yaml  ← claude: marketplace config
+├── skills/
+│   └── my-skill/
+│       └── SKILL.md
+└── dist/                           ← generated by vat build
+    ├── skills/my-skill/
+    ├── plugins/my-plugin/
+    └── .claude-plugin/
+        └── marketplace.json
+```
+
+## Step 1: package.json Configuration
+
+```json
+{
+  "name": "@myorg/my-skills",
+  "version": "1.0.0",
+  "vat": {
+    "skills": [
+      {
+        "name": "my-skill",
+        "source": "./skills/my-skill/SKILL.md",
+        "path": "./dist/skills/my-skill"
+      }
+    ]
+  },
+  "scripts": {
+    "build:vat": "vat build",
+    "postinstall": "vat skills install --npm-postinstall || exit 0"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  }
+}
+```
+
+For private GitHub Packages registry:
+```json
+"publishConfig": {
+  "registry": "https://npm.pkg.github.com",
+  "access": "restricted"
+}
+```
+
+Users installing from GitHub Packages need `.npmrc` with the scope registry and auth token:
+```
+@myorg:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+## Step 2: vibe-agent-toolkit.config.yaml
+
+```yaml
+version: 1
+
+claude:
+  marketplaces:
+    my-marketplace:         # org/publisher identity
+      owner:
+        name: My Organization
+      skills:
+        - "my-*"            # glob matching skill names from vat.skills
+      plugins:
+        - name: my-plugin   # installable unit
+          skills: "*"       # all skills matched by this marketplace
+      output:
+        marketplaceJson: dist/.claude-plugin/marketplace.json
+        pluginsDir: dist/plugins/
+```
+
+**Naming convention:** marketplace = org identity (e.g. `acme`), plugin = this package
+(e.g. `acme-tools`). Registers as `my-plugin@my-marketplace` in Claude's plugin registry.
+
+### Multiple skills in one package
+
+List all skills in `vat.skills` and use a glob in the marketplace config:
+
+```json
+"vat": {
+  "skills": [
+    { "name": "my-linting", "source": "./skills/linting/SKILL.md", "path": "./dist/skills/my-linting" },
+    { "name": "my-testing", "source": "./skills/testing/SKILL.md", "path": "./dist/skills/my-testing" }
+  ]
+}
+```
+
+```yaml
+skills:
+  - "my-*"    # matches both my-linting and my-testing
+```
+
+All matched skills are bundled into the single plugin.
+
+## Step 3: Build
+
+```bash
+vat build        # skills phase then claude phase
+vat verify       # validates resources + skills + claude artifacts
+```
+
+### What vat build does
+
+Two phases, run in dependency order:
+
+1. **`vat skills build`** — reads `package.json vat.skills`, compiles each SKILL.md + referenced resources into `dist/skills/<name>/`
+2. **`vat claude build`** — reads `vibe-agent-toolkit.config.yaml claude:` section, wraps built skills into plugin structure, generates `marketplace.json`
+
+Individual commands still work:
+```bash
+vat skills build       # skills phase only
+vat claude build       # claude plugin phase only (requires skills already built)
+vat claude verify      # validate plugin artifacts only
+```
+
+## Step 4: Publish
+
+```bash
+npm publish --tag next    # RC/pre-release
+npm publish               # stable release
+```
+
+## Step 5: User Install
+
+```bash
+vat skills install npm:@myorg/my-skills
+```
+
+Or via standard npm install (postinstall hook triggers automatically):
+```bash
+npm install -g @myorg/my-skills
+```
+
+### How plugin installation works
+
+When `npm install` runs the postinstall hook (`vat skills install --npm-postinstall`):
+
+- VAT detects `dist/.claude-plugin/marketplace.json` in the installed package
+- Installs via Claude's plugin system (NOT `~/.claude/skills/`)
+- Writes to these locations:
+  1. `~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/` — plugin files
+  2. `~/.claude/plugins/known_marketplaces.json` — marketplace registry
+  3. `~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/` — version cache
+  4. `~/.claude/plugins/installed_plugins.json` — installation record
+  5. `~/.claude/settings.json` `enabledPlugins` — activates the plugin
+
+If no `marketplace.json` exists (package wasn't built before publish): a guidance message is emitted and the hook exits 0. The publisher must run `vat build` and re-publish.
+
+Skills are then available in Claude Code as `/plugin-name:skill-name`.
+
+## Source-Layout Pattern
+
+For projects where the repo itself contains `marketplace.json` and plugin structure (no build step needed):
+
+```yaml
+claude:
+  marketplaces:
+    my-marketplace:
+      file: .claude-plugin/marketplace.json   # VAT verifies but does NOT generate
+```
+
+`vat verify` validates the existing file. `vat build` skips the claude phase for `file:` marketplaces.
+
+## managed-settings.json Validation (Enterprise)
+
+```yaml
+claude:
+  managedSettings: managed-settings.json
+```
+
+`vat verify` validates this file against the ManagedSettings schema. Catches typos and schema errors before deployment. Does NOT deploy the file — deployment is a separate concern.
+
+## --target claude-web (ZIP Upload)
+
+For uploading skills directly to `claude.ai/settings/capabilities`:
+
+```bash
+vat skills package ./SKILL.md -o ./dist/ --target claude-web
+```
+
+Produces a ZIP:
+```
+my-skill.zip
+└── my-skill/
+    ├── SKILL.md             # skill definition (required)
+    ├── scripts/             # executable code (.mjs, .py, .sh) — optional
+    ├── references/          # markdown reference material — optional
+    └── assets/              # static data, templates, config — optional
+```
+
+Configure source path mappings in `package.json`:
+```json
+{
+  "vat": {
+    "skills": [{
+      "name": "my-skill",
+      "packagingOptions": {
+        "claudeWebTarget": {
+          "scripts": ["./src/helpers/**/*.ts"],
+          "assets": ["./assets/**"]
+        }
+      }
+    }]
+  }
+}
+```
+
+TypeScript files in `scripts` are tree-shaken and compiled to standalone `.mjs`.
+
+## Quick Reference
+
+| Task | Command |
+|---|---|
+| Build everything | `vat build` |
+| Verify everything | `vat verify` |
+| Build skills only | `vat skills build` |
+| Build claude artifacts only | `vat claude build` |
+| Verify claude artifacts only | `vat claude verify` |
+| Install from npm | `vat skills install npm:@org/pkg` |
+| Package for claude.ai upload | `vat skills package ./SKILL.md -o ./dist/ --target claude-web` |

package/dist/skills/vibe-agent-toolkit/SKILL.md

@@ -33,8 +33,11 @@ non-TypeScript/JavaScript projects, or cases where you need deep framework-speci
 | `packagingOptions` (linkFollowDepth, excludeReferencesFromBundle) | `vibe-agent-toolkit:agent-authoring` |
 | Resource collections, frontmatter schema validation | `vibe-agent-toolkit:resources` |
 | `vat resources validate`, collection config | `vibe-agent-toolkit:resources` |
-| Packaging skills, `--target claude-web`, ZIP format | `vibe-agent-toolkit:distribution` |
-| Sideloading with `vat install`, npm postinstall hooks | `vibe-agent-toolkit:distribution` |
+| Setting up `vat build` + `vat claude build` for a project | `vibe-agent-toolkit:skills-distribution` |
+| Configuring `claude:` section in vibe-agent-toolkit.config.yaml | `vibe-agent-toolkit:skills-distribution` |
+| npm publishing with plugin postinstall | `vibe-agent-toolkit:skills-distribution` |
+| `vat build` / `vat verify` orchestration | `vibe-agent-toolkit:skills-distribution` |
+| `--target claude-web` ZIP format | `vibe-agent-toolkit:skills-distribution` |
 | `vat audit`, `--compat`, CI validation | `vibe-agent-toolkit:audit` |
 | VAT behaves unexpectedly, debugging VAT, testing local VAT changes, VAT_ROOT_DIR | `vibe-agent-toolkit:debugging` |
 
@@ -55,11 +58,19 @@ Four patterns cover most use cases. For full code examples, see `vibe-agent-tool
 # Install VAT CLI globally
 npm install -g vibe-agent-toolkit
 
+# Top-level orchestration
+vat build                                # build all artifacts (skills then claude plugins)
+vat verify                               # verify all artifacts (resources, skills, claude)
+
+# Claude plugin commands
+vat claude build                         # generate plugin artifacts from built skills
+vat claude verify                        # validate plugin artifacts
+
 # Skills
 vat skills list                          # list skills in current project
 vat skills list --user                   # list user-installed skills
-vat skills install npm:@org/my-skills    # install from npm
-vat skills build                         # build skills for distribution
+vat skills install npm:@org/my-skills    # install from npm (routes through plugin system)
+vat skills build                         # build portable skills only
 vat skills validate                      # validate skill quality
 
 # Resources
@@ -141,14 +152,16 @@ vat skills build                      # package for distribution
 ```bash
 vat skills install npm:@vibe-agent-toolkit/vat-cat-agents
 vat skills list --user
-# Skills appear in ~/.claude/skills/ and are auto-loaded by Claude Code
+# Plugin-aware packages register in Claude's plugin system
+# Skills are invoked as /plugin-name:skill-name in Claude Code
 ```
 
 **Build and publish your own skill package:**
 ```bash
-# Add vat.skills to package.json, then:
-vat skills build          # builds all declared skills
-npm publish               # publishes to npm
+# Configure vat.skills in package.json + claude: in vibe-agent-toolkit.config.yaml, then:
+vat build                 # builds skills + claude plugin artifacts
+vat verify                # validates everything
+npm publish               # publishes to npm (postinstall registers the plugin)
 # Users install with: vat skills install npm:@myorg/my-skills
 ```
 

package/dist/skills/vibe-agent-toolkit-skills-distribution/SKILL.md

@@ -0,0 +1,242 @@
+---
+name: vibe-agent-toolkit:skills-distribution
+description: Use when setting up vat build, configuring plugin distribution for the Claude ecosystem (marketplace, plugins, managed settings), npm publishing with postinstall hooks, or vat verify orchestration. Covers the full pipeline from skill source to installed plugin.
+---
+
+# VAT Distribution: Build, Publish & Install
+
+## Overview
+
+VAT distributes skills as **Claude plugins** via npm packages. The pipeline:
+
+1. `vat build` compiles SKILL.md sources into plugin artifacts
+2. `npm publish` pushes the package to a registry
+3. `npm install` triggers a postinstall hook that registers the plugin in Claude's plugin system
+
+Skills installed this way appear in Claude Code as `/plugin-name:skill-name`.
+
+## Project Structure
+
+```
+my-project/
+├── package.json                    ← vat.skills + postinstall hook + publishConfig
+├── vibe-agent-toolkit.config.yaml  ← claude: marketplace config
+├── skills/
+│   └── my-skill/
+│       └── SKILL.md
+└── dist/                           ← generated by vat build
+    ├── skills/my-skill/
+    ├── plugins/my-plugin/
+    └── .claude-plugin/
+        └── marketplace.json
+```
+
+## Step 1: package.json Configuration
+
+```json
+{
+  "name": "@myorg/my-skills",
+  "version": "1.0.0",
+  "vat": {
+    "skills": [
+      {
+        "name": "my-skill",
+        "source": "./skills/my-skill/SKILL.md",
+        "path": "./dist/skills/my-skill"
+      }
+    ]
+  },
+  "scripts": {
+    "build:vat": "vat build",
+    "postinstall": "vat skills install --npm-postinstall || exit 0"
+  },
+  "files": ["dist", "README.md"],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  }
+}
+```
+
+For private GitHub Packages registry:
+```json
+"publishConfig": {
+  "registry": "https://npm.pkg.github.com",
+  "access": "restricted"
+}
+```
+
+Users installing from GitHub Packages need `.npmrc` with the scope registry and auth token:
+```
+@myorg:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+## Step 2: vibe-agent-toolkit.config.yaml
+
+```yaml
+version: 1
+
+claude:
+  marketplaces:
+    my-marketplace:         # org/publisher identity
+      owner:
+        name: My Organization
+      skills:
+        - "my-*"            # glob matching skill names from vat.skills
+      plugins:
+        - name: my-plugin   # installable unit
+          skills: "*"       # all skills matched by this marketplace
+      output:
+        marketplaceJson: dist/.claude-plugin/marketplace.json
+        pluginsDir: dist/plugins/
+```
+
+**Naming convention:** marketplace = org identity (e.g. `acme`), plugin = this package
+(e.g. `acme-tools`). Registers as `my-plugin@my-marketplace` in Claude's plugin registry.
+
+### Multiple skills in one package
+
+List all skills in `vat.skills` and use a glob in the marketplace config:
+
+```json
+"vat": {
+  "skills": [
+    { "name": "my-linting", "source": "./skills/linting/SKILL.md", "path": "./dist/skills/my-linting" },
+    { "name": "my-testing", "source": "./skills/testing/SKILL.md", "path": "./dist/skills/my-testing" }
+  ]
+}
+```
+
+```yaml
+skills:
+  - "my-*"    # matches both my-linting and my-testing
+```
+
+All matched skills are bundled into the single plugin.
+
+## Step 3: Build
+
+```bash
+vat build        # skills phase then claude phase
+vat verify       # validates resources + skills + claude artifacts
+```
+
+### What vat build does
+
+Two phases, run in dependency order:
+
+1. **`vat skills build`** — reads `package.json vat.skills`, compiles each SKILL.md + referenced resources into `dist/skills/<name>/`
+2. **`vat claude build`** — reads `vibe-agent-toolkit.config.yaml claude:` section, wraps built skills into plugin structure, generates `marketplace.json`
+
+Individual commands still work:
+```bash
+vat skills build       # skills phase only
+vat claude build       # claude plugin phase only (requires skills already built)
+vat claude verify      # validate plugin artifacts only
+```
+
+## Step 4: Publish
+
+```bash
+npm publish --tag next    # RC/pre-release
+npm publish               # stable release
+```
+
+## Step 5: User Install
+
+```bash
+vat skills install npm:@myorg/my-skills
+```
+
+Or via standard npm install (postinstall hook triggers automatically):
+```bash
+npm install -g @myorg/my-skills
+```
+
+### How plugin installation works
+
+When `npm install` runs the postinstall hook (`vat skills install --npm-postinstall`):
+
+- VAT detects `dist/.claude-plugin/marketplace.json` in the installed package
+- Installs via Claude's plugin system (NOT `~/.claude/skills/`)
+- Writes to these locations:
+  1. `~/.claude/plugins/marketplaces/<marketplace>/plugins/<plugin>/` — plugin files
+  2. `~/.claude/plugins/known_marketplaces.json` — marketplace registry
+  3. `~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/` — version cache
+  4. `~/.claude/plugins/installed_plugins.json` — installation record
+  5. `~/.claude/settings.json` `enabledPlugins` — activates the plugin
+
+If no `marketplace.json` exists (package wasn't built before publish): a guidance message is emitted and the hook exits 0. The publisher must run `vat build` and re-publish.
+
+Skills are then available in Claude Code as `/plugin-name:skill-name`.
+
+## Source-Layout Pattern
+
+For projects where the repo itself contains `marketplace.json` and plugin structure (no build step needed):
+
+```yaml
+claude:
+  marketplaces:
+    my-marketplace:
+      file: .claude-plugin/marketplace.json   # VAT verifies but does NOT generate
+```
+
+`vat verify` validates the existing file. `vat build` skips the claude phase for `file:` marketplaces.
+
+## managed-settings.json Validation (Enterprise)
+
+```yaml
+claude:
+  managedSettings: managed-settings.json
+```
+
+`vat verify` validates this file against the ManagedSettings schema. Catches typos and schema errors before deployment. Does NOT deploy the file — deployment is a separate concern.
+
+## --target claude-web (ZIP Upload)
+
+For uploading skills directly to `claude.ai/settings/capabilities`:
+
+```bash
+vat skills package ./SKILL.md -o ./dist/ --target claude-web
+```
+
+Produces a ZIP:
+```
+my-skill.zip
+└── my-skill/
+    ├── SKILL.md             # skill definition (required)
+    ├── scripts/             # executable code (.mjs, .py, .sh) — optional
+    ├── references/          # markdown reference material — optional
+    └── assets/              # static data, templates, config — optional
+```
+
+Configure source path mappings in `package.json`:
+```json
+{
+  "vat": {
+    "skills": [{
+      "name": "my-skill",
+      "packagingOptions": {
+        "claudeWebTarget": {
+          "scripts": ["./src/helpers/**/*.ts"],
+          "assets": ["./assets/**"]
+        }
+      }
+    }]
+  }
+}
+```
+
+TypeScript files in `scripts` are tree-shaken and compiled to standalone `.mjs`.
+
+## Quick Reference
+
+| Task | Command |
+|---|---|
+| Build everything | `vat build` |
+| Verify everything | `vat verify` |
+| Build skills only | `vat skills build` |
+| Build claude artifacts only | `vat claude build` |
+| Verify claude artifacts only | `vat claude verify` |
+| Install from npm | `vat skills install npm:@org/pkg` |
+| Package for claude.ai upload | `vat skills package ./SKILL.md -o ./dist/ --target claude-web` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/vat-development-agents",
-  "version": "0.1.15",
+  "version": "0.1.16-rc.1",
   "description": "VAT development agents - dogfooding the vibe-agent-toolkit",
   "type": "module",
   "keywords": [
@@ -27,9 +27,9 @@
         "path": "./dist/skills/vibe-agent-toolkit-resources"
       },
       {
-        "name": "vibe-agent-toolkit:distribution",
-        "source": "./resources/skills/vat-distribution.md",
-        "path": "./dist/skills/vibe-agent-toolkit-distribution"
+        "name": "vibe-agent-toolkit:skills-distribution",
+        "source": "./resources/skills/vat-skills-distribution.md",
+        "path": "./dist/skills/vibe-agent-toolkit-skills-distribution"
       },
       {
         "name": "vibe-agent-toolkit:agent-authoring",
@@ -87,12 +87,12 @@
     "postinstall": "vat skills install --npm-postinstall || exit 0"
   },
   "dependencies": {
-    "@vibe-agent-toolkit/agent-schema": "0.1.15",
+    "@vibe-agent-toolkit/agent-schema": "0.1.16-rc.1",
     "yaml": "^2.8.2"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
-    "@vibe-agent-toolkit/resource-compiler": "0.1.15",
+    "@vibe-agent-toolkit/resource-compiler": "0.1.16-rc.1",
     "ts-patch": "^3.2.1",
     "typescript": "^5.7.3"
   },

package/dist/generated/resources/skills/vat-distribution.d.ts

@@ -1,27 +0,0 @@
-/**
- * Generated TypeScript declarations - DO NOT EDIT
- */
-
-export interface Fragment {
-  readonly header: string;
-  readonly body: string;
-  readonly text: string;
-}
-
-export const meta: {
-  readonly name: string;
-  readonly description: string;
-};
-
-export const text: string;
-
-export const fragments: {
-  readonly packagingASkill: Fragment;
-  readonly -TargetClaudeWeb: Fragment;
-  readonly sideloadingPrivateDistribution: Fragment;
-  readonly npmDistribution: Fragment;
-  readonly privateEnterpriseDistribution: Fragment;
-  readonly devModeSymlinks: Fragment;
-};
-
-export type FragmentName = keyof typeof fragments;

package/dist/generated/resources/skills/vat-distribution.js

@@ -1,43 +0,0 @@
-/**
- * Generated from markdown file - DO NOT EDIT
- */
-
-export const meta = {
-  name: "vibe-agent-toolkit:distribution",
-  description: "Use when packaging, publishing, or sideloading VAT skills. Covers vat skills package (including --target claude-web), vat install for sideloading, npm publishing, and private distribution patterns."
-};
-
-export const text = "\n# VAT Distribution: Packaging & Sideloading\n\n## Packaging a Skill\n\n\`\`\`bash\n# Standard build (Claude Code skills dir format)\nvat skills package ./SKILL.md -o ./dist/skills/\n\n# Claude.ai web upload format (scripts/, references/, assets/)\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\n# Dry run to preview what gets packaged\nvat skills package ./SKILL.md -o ./dist/ --dry-run\n\`\`\`\n\n## --target claude-web\n\nProduces a ZIP compatible with \`claude.ai/settings/capabilities\` upload.\n\nDirectory structure:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure which source paths map to each directory in \`package.json\`:\n\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\` —\nno build toolchain required at install time.\n\n## Sideloading (Private Distribution)\n\nWhen your project isn\'t on a public marketplace, use \`vat install\` to sideload:\n\n\`\`\`bash\n# Sideload an agent skill\nvat install ./my-skill-dir/              # → ~/.claude/skills/\n\n# Sideload an entire Claude plugin\nvat install ./my-plugin/                 # → ~/.claude/plugins/\n\n# Force overwrite existing installation\nvat install ./my-skill-dir/ --force\n\`\`\`\n\nType is auto-detected from directory structure:\n- Has \`SKILL.md\` at root → \`agent-skill\`\n- Has \`.claude-plugin/plugin.json\` → \`claude-plugin\`\n- Has \`.claude-plugin/marketplace.json\` → \`claude-marketplace\`\n- Use \`--type <type>\` to override detection\n\n## npm Distribution\n\nAdd to \`package.json\`:\n\n\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"private\": false,\n  \"license\": \"MIT\",\n  \"vat\": {\n    \"skills\": [...]\n  },\n  \"scripts\": {\n    \"postinstall\": \"vat skills install --npm-postinstall\"\n  }\n}\n\`\`\`\n\nWhen users run \`npm install -g @myorg/my-skills\`, the postinstall hook automatically\ncopies skills to \`~/.claude/skills/\`. No manual steps.\n\n## Private Enterprise Distribution\n\nFor private repos (not published to npm):\n\n1. Tag a release on GitHub/internal Git\n2. Attach the skill ZIP as a release asset\n3. Users download and sideload:\n   \`\`\`bash\n   vat install ./downloaded-skill.zip\n   \`\`\`\n\nOr use a private npm registry (GitHub Packages, Artifactory):\n\`\`\`bash\nnpm install -g @myorg/my-skills  # pulls from private registry, postinstall triggers\n\`\`\`\n\n## Dev Mode (Symlinks)\n\nDuring active development, use symlinks so rebuilds are instant:\n\n\`\`\`bash\nvat skills install --dev          # symlinks dist/ → ~/.claude/skills/\nvat skills install --build        # builds first, then symlinks\n\`\`\`\n\nAfter each rebuild: \`/reload-skills\` in Claude Code.\n";
-
-export const fragments = {
-  packagingASkill: {
-    header: "## Packaging a Skill",
-    body: "\`\`\`bash\n# Standard build (Claude Code skills dir format)\nvat skills package ./SKILL.md -o ./dist/skills/\n\n# Claude.ai web upload format (scripts/, references/, assets/)\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\n# Dry run to preview what gets packaged\nvat skills package ./SKILL.md -o ./dist/ --dry-run\n\`\`\`",
-    text: "## Packaging a Skill\n\n\`\`\`bash\n# Standard build (Claude Code skills dir format)\nvat skills package ./SKILL.md -o ./dist/skills/\n\n# Claude.ai web upload format (scripts/, references/, assets/)\nvat skills package ./SKILL.md -o ./dist/ --target claude-web\n\n# Dry run to preview what gets packaged\nvat skills package ./SKILL.md -o ./dist/ --dry-run\n\`\`\`"
-  },
-  -TargetClaudeWeb: {
-    header: "## --target claude-web",
-    body: "Produces a ZIP compatible with \`claude.ai/settings/capabilities\` upload.\n\nDirectory structure:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure which source paths map to each directory in \`package.json\`:\n\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\` —\nno build toolchain required at install time.",
-    text: "## --target claude-web\n\nProduces a ZIP compatible with \`claude.ai/settings/capabilities\` upload.\n\nDirectory structure:\n\`\`\`\nmy-skill.zip\n└── my-skill/\n    ├── SKILL.md             # skill definition (required)\n    ├── scripts/             # executable code (.mjs, .py, .sh) — optional\n    ├── references/          # markdown reference material — optional\n    └── assets/              # static data, templates, config — optional\n\`\`\`\n\nConfigure which source paths map to each directory in \`package.json\`:\n\n\`\`\`json\n{\n  \"vat\": {\n    \"skills\": [{\n      \"name\": \"my-skill\",\n      \"packagingOptions\": {\n        \"claudeWebTarget\": {\n          \"scripts\": [\"./src/helpers/**/*.ts\"],\n          \"assets\": [\"./assets/**\"]\n        }\n      }\n    }]\n  }\n}\n\`\`\`\n\nTypeScript files in \`scripts\` are tree-shaken and compiled to standalone \`.mjs\` —\nno build toolchain required at install time."
-  },
-  sideloadingPrivateDistribution: {
-    header: "## Sideloading (Private Distribution)",
-    body: "When your project isn\'t on a public marketplace, use \`vat install\` to sideload:\n\n\`\`\`bash\n# Sideload an agent skill\nvat install ./my-skill-dir/              # → ~/.claude/skills/\n\n# Sideload an entire Claude plugin\nvat install ./my-plugin/                 # → ~/.claude/plugins/\n\n# Force overwrite existing installation\nvat install ./my-skill-dir/ --force\n\`\`\`\n\nType is auto-detected from directory structure:\n- Has \`SKILL.md\` at root → \`agent-skill\`\n- Has \`.claude-plugin/plugin.json\` → \`claude-plugin\`\n- Has \`.claude-plugin/marketplace.json\` → \`claude-marketplace\`\n- Use \`--type <type>\` to override detection",
-    text: "## Sideloading (Private Distribution)\n\nWhen your project isn\'t on a public marketplace, use \`vat install\` to sideload:\n\n\`\`\`bash\n# Sideload an agent skill\nvat install ./my-skill-dir/              # → ~/.claude/skills/\n\n# Sideload an entire Claude plugin\nvat install ./my-plugin/                 # → ~/.claude/plugins/\n\n# Force overwrite existing installation\nvat install ./my-skill-dir/ --force\n\`\`\`\n\nType is auto-detected from directory structure:\n- Has \`SKILL.md\` at root → \`agent-skill\`\n- Has \`.claude-plugin/plugin.json\` → \`claude-plugin\`\n- Has \`.claude-plugin/marketplace.json\` → \`claude-marketplace\`\n- Use \`--type <type>\` to override detection"
-  },
-  npmDistribution: {
-    header: "## npm Distribution",
-    body: "Add to \`package.json\`:\n\n\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"private\": false,\n  \"license\": \"MIT\",\n  \"vat\": {\n    \"skills\": [...]\n  },\n  \"scripts\": {\n    \"postinstall\": \"vat skills install --npm-postinstall\"\n  }\n}\n\`\`\`\n\nWhen users run \`npm install -g @myorg/my-skills\`, the postinstall hook automatically\ncopies skills to \`~/.claude/skills/\`. No manual steps.",
-    text: "## npm Distribution\n\nAdd to \`package.json\`:\n\n\`\`\`json\n{\n  \"name\": \"@myorg/my-skills\",\n  \"version\": \"1.0.0\",\n  \"private\": false,\n  \"license\": \"MIT\",\n  \"vat\": {\n    \"skills\": [...]\n  },\n  \"scripts\": {\n    \"postinstall\": \"vat skills install --npm-postinstall\"\n  }\n}\n\`\`\`\n\nWhen users run \`npm install -g @myorg/my-skills\`, the postinstall hook automatically\ncopies skills to \`~/.claude/skills/\`. No manual steps."
-  },
-  privateEnterpriseDistribution: {
-    header: "## Private Enterprise Distribution",
-    body: "For private repos (not published to npm):\n\n1. Tag a release on GitHub/internal Git\n2. Attach the skill ZIP as a release asset\n3. Users download and sideload:\n   \`\`\`bash\n   vat install ./downloaded-skill.zip\n   \`\`\`\n\nOr use a private npm registry (GitHub Packages, Artifactory):\n\`\`\`bash\nnpm install -g @myorg/my-skills  # pulls from private registry, postinstall triggers\n\`\`\`",
-    text: "## Private Enterprise Distribution\n\nFor private repos (not published to npm):\n\n1. Tag a release on GitHub/internal Git\n2. Attach the skill ZIP as a release asset\n3. Users download and sideload:\n   \`\`\`bash\n   vat install ./downloaded-skill.zip\n   \`\`\`\n\nOr use a private npm registry (GitHub Packages, Artifactory):\n\`\`\`bash\nnpm install -g @myorg/my-skills  # pulls from private registry, postinstall triggers\n\`\`\`"
-  },
-  devModeSymlinks: {
-    header: "## Dev Mode (Symlinks)",
-    body: "During active development, use symlinks so rebuilds are instant:\n\n\`\`\`bash\nvat skills install --dev          # symlinks dist/ → ~/.claude/skills/\nvat skills install --build        # builds first, then symlinks\n\`\`\`\n\nAfter each rebuild: \`/reload-skills\` in Claude Code.",
-    text: "## Dev Mode (Symlinks)\n\nDuring active development, use symlinks so rebuilds are instant:\n\n\`\`\`bash\nvat skills install --dev          # symlinks dist/ → ~/.claude/skills/\nvat skills install --build        # builds first, then symlinks\n\`\`\`\n\nAfter each rebuild: \`/reload-skills\` in Claude Code."
-  }
-};

package/dist/plugins/vat-development-agents/skills/vibe-agent-toolkit__distribution/SKILL.md

@@ -1,124 +0,0 @@
----
-name: vibe-agent-toolkit:distribution
-description: Use when packaging, publishing, or sideloading VAT skills. Covers vat skills package (including --target claude-web), vat install for sideloading, npm publishing, and private distribution patterns.
----
-
-# VAT Distribution: Packaging & Sideloading
-
-## Packaging a Skill
-
-```bash
-# Standard build (Claude Code skills dir format)
-vat skills package ./SKILL.md -o ./dist/skills/
-
-# Claude.ai web upload format (scripts/, references/, assets/)
-vat skills package ./SKILL.md -o ./dist/ --target claude-web
-
-# Dry run to preview what gets packaged
-vat skills package ./SKILL.md -o ./dist/ --dry-run
-```
-
-## --target claude-web
-
-Produces a ZIP compatible with `claude.ai/settings/capabilities` upload.
-
-Directory structure:
-```
-my-skill.zip
-└── my-skill/
-    ├── SKILL.md             # skill definition (required)
-    ├── scripts/             # executable code (.mjs, .py, .sh) — optional
-    ├── references/          # markdown reference material — optional
-    └── assets/              # static data, templates, config — optional
-```
-
-Configure which source paths map to each directory in `package.json`:
-
-```json
-{
-  "vat": {
-    "skills": [{
-      "name": "my-skill",
-      "packagingOptions": {
-        "claudeWebTarget": {
-          "scripts": ["./src/helpers/**/*.ts"],
-          "assets": ["./assets/**"]
-        }
-      }
-    }]
-  }
-}
-```
-
-TypeScript files in `scripts` are tree-shaken and compiled to standalone `.mjs` —
-no build toolchain required at install time.
-
-## Sideloading (Private Distribution)
-
-When your project isn't on a public marketplace, use `vat install` to sideload:
-
-```bash
-# Sideload an agent skill
-vat install ./my-skill-dir/              # → ~/.claude/skills/
-
-# Sideload an entire Claude plugin
-vat install ./my-plugin/                 # → ~/.claude/plugins/
-
-# Force overwrite existing installation
-vat install ./my-skill-dir/ --force
-```
-
-Type is auto-detected from directory structure:
-- Has `SKILL.md` at root → `agent-skill`
-- Has `.claude-plugin/plugin.json` → `claude-plugin`
-- Has `.claude-plugin/marketplace.json` → `claude-marketplace`
-- Use `--type <type>` to override detection
-
-## npm Distribution
-
-Add to `package.json`:
-
-```json
-{
-  "name": "@myorg/my-skills",
-  "version": "1.0.0",
-  "private": false,
-  "license": "MIT",
-  "vat": {
-    "skills": [...]
-  },
-  "scripts": {
-    "postinstall": "vat skills install --npm-postinstall"
-  }
-}
-```
-
-When users run `npm install -g @myorg/my-skills`, the postinstall hook automatically
-copies skills to `~/.claude/skills/`. No manual steps.
-
-## Private Enterprise Distribution
-
-For private repos (not published to npm):
-
-1. Tag a release on GitHub/internal Git
-2. Attach the skill ZIP as a release asset
-3. Users download and sideload:
-   ```bash
-   vat install ./downloaded-skill.zip
-   ```
-
-Or use a private npm registry (GitHub Packages, Artifactory):
-```bash
-npm install -g @myorg/my-skills  # pulls from private registry, postinstall triggers
-```
-
-## Dev Mode (Symlinks)
-
-During active development, use symlinks so rebuilds are instant:
-
-```bash
-vat skills install --dev          # symlinks dist/ → ~/.claude/skills/
-vat skills install --build        # builds first, then symlinks
-```
-
-After each rebuild: `/reload-skills` in Claude Code.

package/dist/skills/vibe-agent-toolkit-distribution/SKILL.md

@@ -1,124 +0,0 @@
----
-name: vibe-agent-toolkit:distribution
-description: Use when packaging, publishing, or sideloading VAT skills. Covers vat skills package (including --target claude-web), vat install for sideloading, npm publishing, and private distribution patterns.
----
-
-# VAT Distribution: Packaging & Sideloading
-
-## Packaging a Skill
-
-```bash
-# Standard build (Claude Code skills dir format)
-vat skills package ./SKILL.md -o ./dist/skills/
-
-# Claude.ai web upload format (scripts/, references/, assets/)
-vat skills package ./SKILL.md -o ./dist/ --target claude-web
-
-# Dry run to preview what gets packaged
-vat skills package ./SKILL.md -o ./dist/ --dry-run
-```
-
-## --target claude-web
-
-Produces a ZIP compatible with `claude.ai/settings/capabilities` upload.
-
-Directory structure:
-```
-my-skill.zip
-└── my-skill/
-    ├── SKILL.md             # skill definition (required)
-    ├── scripts/             # executable code (.mjs, .py, .sh) — optional
-    ├── references/          # markdown reference material — optional
-    └── assets/              # static data, templates, config — optional
-```
-
-Configure which source paths map to each directory in `package.json`:
-
-```json
-{
-  "vat": {
-    "skills": [{
-      "name": "my-skill",
-      "packagingOptions": {
-        "claudeWebTarget": {
-          "scripts": ["./src/helpers/**/*.ts"],
-          "assets": ["./assets/**"]
-        }
-      }
-    }]
-  }
-}
-```
-
-TypeScript files in `scripts` are tree-shaken and compiled to standalone `.mjs` —
-no build toolchain required at install time.
-
-## Sideloading (Private Distribution)
-
-When your project isn't on a public marketplace, use `vat install` to sideload:
-
-```bash
-# Sideload an agent skill
-vat install ./my-skill-dir/              # → ~/.claude/skills/
-
-# Sideload an entire Claude plugin
-vat install ./my-plugin/                 # → ~/.claude/plugins/
-
-# Force overwrite existing installation
-vat install ./my-skill-dir/ --force
-```
-
-Type is auto-detected from directory structure:
-- Has `SKILL.md` at root → `agent-skill`
-- Has `.claude-plugin/plugin.json` → `claude-plugin`
-- Has `.claude-plugin/marketplace.json` → `claude-marketplace`
-- Use `--type <type>` to override detection
-
-## npm Distribution
-
-Add to `package.json`:
-
-```json
-{
-  "name": "@myorg/my-skills",
-  "version": "1.0.0",
-  "private": false,
-  "license": "MIT",
-  "vat": {
-    "skills": [...]
-  },
-  "scripts": {
-    "postinstall": "vat skills install --npm-postinstall"
-  }
-}
-```
-
-When users run `npm install -g @myorg/my-skills`, the postinstall hook automatically
-copies skills to `~/.claude/skills/`. No manual steps.
-
-## Private Enterprise Distribution
-
-For private repos (not published to npm):
-
-1. Tag a release on GitHub/internal Git
-2. Attach the skill ZIP as a release asset
-3. Users download and sideload:
-   ```bash
-   vat install ./downloaded-skill.zip
-   ```
-
-Or use a private npm registry (GitHub Packages, Artifactory):
-```bash
-npm install -g @myorg/my-skills  # pulls from private registry, postinstall triggers
-```
-
-## Dev Mode (Symlinks)
-
-During active development, use symlinks so rebuilds are instant:
-
-```bash
-vat skills install --dev          # symlinks dist/ → ~/.claude/skills/
-vat skills install --build        # builds first, then symlinks
-```
-
-After each rebuild: `/reload-skills` in Claude Code.