Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/swt-labs/vibe-better-with-claude-code-vbw/llms.txt

Use this file to discover all available pages before exploring further.

VBW integrates with skills.sh — an open-source skill registry for AI agents with 20+ supported platforms and thousands of community-contributed skills. Skills teach your agents framework conventions, project patterns, and best practices for your specific tech stack.

​
How VBW integrates with skills.sh

Skills enter your project at three points:
  1. Automatic detection on init — /vbw:init scans your project, identifies your tech stack, and recommends relevant skills from a curated mapping. You get targeted suggestions based on what’s actually in your codebase.
  2. On-demand discovery — /vbw:skills lets you browse installed skills, view curated suggestions, and search the full registry at any time.
  3. Agent injection — installed skills are automatically injected into every agent’s context via the SubagentStart hook. Agents use them without any extra prompting.

​
Using /vbw:skills

/vbw:skills
/vbw:skills --search nextjs
/vbw:skills --search "database migrations"
/vbw:skills --list
/vbw:skills --refresh
When you run /vbw:skills with no arguments, it:
  1. Displays your currently installed skills (global and project-scoped)
  2. Shows your detected stack
  3. Presents curated suggestions for skills you haven’t installed yet
  4. Searches the live registry for additional matches
  5. Prompts you to select and install skills in one step
Skills can be installed globally (~/.agents/skills/) or scoped to the current project (./.claude/skills/). VBW asks which scope to use before installing.

​
Configuration options

SettingDefaultDescription
skill_suggestionstrueShow skill suggestions during /vbw:init
auto_install_skillsfalseInstall detected skills without prompting
discovery_questionstrueAsk discovery questions to refine suggestions
Change these with /vbw:config: 
/vbw:config auto_install_skills true
/vbw:config skill_suggestions false

​
Supported stacks

VBW ships with curated skill mappings for the following stacks. When your project matches one of these, VBW recommends the right skills automatically. Languages
StackDetected from
Pythonpyproject.toml, requirements.txt, setup.py
RustCargo.toml
Gogo.mod
Elixirmix.exs
Javapom.xml, build.gradle
.NET*.csproj, *.sln
RubyGemfile, *.gemspec
PHPcomposer.json
Kotlinbuild.gradle.kts
Denodeno.json, deno.lock
Bunbun.lockb, bunfig.toml
Frameworks
StackDetected from
Next.jsnext.config.js, next.config.mjs
Reactpackage.json (react dependency)
Vue.jsvue.config.js, package.json (vue)
Svelte / SvelteKitsvelte.config.js
Angularangular.json, @angular/core
Astroastro.config.mjs
Remixremix.config.js
Nuxt.jsnuxt.config.ts
NestJSnest-cli.json, @nestjs/core
SolidJSpackage.json (solid-js)
Expresspackage.json (express)
Django / FastAPI / Flaskrequirements.txt or pyproject.toml
Ruby on Railsconfig/routes.rb, Gemfile
Laravelartisan, composer.json
Spring Bootpom.xml or build.gradle (spring-boot)
Phoenixmix.exs (phoenix)
Prismaprisma/schema.prisma
Tailwind CSStailwind.config.js
TypeScripttsconfig.json
Testing frameworks (Vitest, Jest, Playwright, Cypress, and more) are also detected and mapped to the appropriate testing skills.

​
Adding skills manually

Skills are Markdown files stored in your skills directory. To add a skill outside the registry:
  1. Create a .md file in .claude/skills/ (project scope) or ~/.agents/skills/ (global)
  2. Write your skill as instructions an agent would follow
  3. Skills take effect immediately — no restart needed
VBW’s SubagentStart hook dispatches installed skills to each agent at the start of every task.

​
Teaching project-specific conventions

For conventions that aren’t in the public registry, use /vbw:teach: 
/vbw:teach
/vbw:teach "Always use async/await, never .then() chains"
/vbw:teach "Database queries go in the repository layer, not the service layer"
Taught conventions are:
  • Injected into every agent’s context via CLAUDE.md
  • Verified by QA against completed work
  • Auto-detected from your codebase patterns during /vbw:init
Running /vbw:teach with no arguments opens an interactive prompt that scans your codebase and surfaces conventions worth capturing.

Working with existing codebases

How brownfield init, codebase mapping, and session resumption work.

Supporting commands

Full reference for /vbw:skills, /vbw:teach, /vbw:doctor, and more.

Build docs developers (and LLMs) love

Get started for freeTalk to us