Overview

vd is a single-binary vendoring package manager for the skills that power your coding agents. Skills live in your repo as plain files — vd fetches them from any upstream, locks them with a SHA, and dispatches them to every agent in your stack.

Install

# Homebrew (recommended)
brew install vanducng/tap/vd

# or with the install script
curl -fsSL https://raw.githubusercontent.com/vanducng/vd-cli/main/install.sh | sh

Pre-built binaries (darwin/linux/windows × amd64/arm64) and a from-source build are covered in the usage guide.

To update an existing install: brew update && brew upgrade vanducng/tap/vd for Homebrew, or vd upgrade for standalone binaries (downloads the latest release and self-replaces; Homebrew installs are deferred back to brew).

Quick start

vd init                                          # bootstrap skills.toml at the repo root
vd add browserbase/skills/browser --as browser   # track an upstream skill
vd sync                                          # vendor it locally (fetch, hash, lock)
vd build                                         # emit manifests for every configured agent
vd install codex                                 # (optional) install into Codex user scope
vd install droid                                 # (optional) install into Droid user scope
vd install pi                                    # (optional) install into Pi user scope

Note

After these, skills/browser/ holds the vendored source, the Claude, Codex, Droid, and Pi targets are written, and skills.lock pins every byte deterministically.

Just want the published skills?

If you only want to install the maintained skill set (no repo of your own), run vd bootstrap to fetch vanducng/skills into ~/.vd/skills, then vd install to symlink them into your agents.

Supported agents

vd build emits the manifest each agent stack expects:

Agent	What vd build emits
Claude Code	.claude-plugin/marketplace.json + plugin.json
OpenAI Codex	.agents/skills/<name> repo-scope symlinks; vd install codex for user scope
Factory Droid	.factory/skills/<name> repo entries (relative symlinks on Unix, copies on Windows); vd install droid for user scope
Pi	.pi/skills/<name> repo entries (relative symlinks on Unix, copies on Windows); vd install pi for user scope

Droid and Pi support covers skills only, not plugins, hooks, extensions, or observability.

What’s inside

Usage guide Install, the end-to-end workflow, and how vd fits into your repo.

Command reference Every vd command, its flags, and what it does.

Configuration The skills.toml manifest and skills.lock schema.

Migration & FAQ Upgrade notes and answers to common questions.