# vd skills full agent context

> Full single-file context for agents working with the `vanducng/skills` catalog.

Canonical site: https://skills.vanducng.dev/
Canonical repository: https://github.com/vanducng/skills
Standalone CLI repository: https://github.com/vanducng/vd-cli

## What This Repo Is

`vanducng/skills` is a daily-driver catalog of reusable agent skills. Each skill is a directory at `skills/<name>/` with a required `SKILL.md` frontmatter block. The repo publishes a Claude Code plugin from `.claude-plugin/` and supports Codex through `.agents/skills` symlinks generated by the standalone `vd` CLI.

The skill catalog and the `vd` CLI are separate products. Skill catalog version surfaces are `version.txt`, `skills.toml`, `.claude-plugin/plugin.json`, and `.claude-plugin/marketplace.json`. The CLI versions independently in `vanducng/vd-cli`; the current verified CLI release is `v2.1.0`.

## Install Summary

Install `vd` on macOS with Homebrew:

```sh
brew install vanducng/tap/vd
vd --version
```

Install with Go on any platform with Go available:

```sh
go install github.com/vanducng/vd-cli/v2/cmd/vd@latest
```

Install this catalog in Claude Code plugin mode:

```text
/plugin marketplace add vanducng/skills
/plugin install vd@vd-skills
```

Install local dev symlinks for Claude Code:

```sh
vd install claude --dev
```

Install Codex user-scope symlinks:

```sh
vd install codex
```

Install Codex repo-scope symlinks:

```sh
vd install codex --scope repo
```

## Repo Layout

```text
.claude-plugin/   Claude Code plugin and marketplace manifests
.github/          validation, release, and GitHub Pages workflows
docs/             Zensical docs source for skills.vanducng.dev
scripts/          validation, release-version check, docs check, scaffolding
skills/           one directory per skill, each with SKILL.md
skills.toml       tracked upstream sources and agent target settings
version.txt       skill-catalog release version
zensical.toml     docs site configuration
```

## Validation Commands

```sh
bash scripts/validate.sh
bash scripts/check-release-versions.sh
bash scripts/check-docs-site.sh --check
zensical build --clean --strict
vd doctor
```

`scripts/validate.sh` checks every skill frontmatter block and rejects runtime-prefixed skill IDs in validated repo docs. `scripts/check-release-versions.sh` checks SemVer consistency. `scripts/check-docs-site.sh` scores the Zensical docs and agent-facing files.

## Skill Taxonomy

Core delivery flow:

- Discover: `vd:scout`, `vd:research`, `vd:brainstorm`
- Plan: `vd:plan`, `vd:plan-audit`, `vd:scenario`
- Execute: `vd:cook`, `vd:fix`, `vd:debug`
- Review and ship: `vd:code-review`, `vd:security`, `vd:ship`, `vd:git`
- Iterate: `vd:auto-loop`, `vd:optimize-loop`, `vd:pursue`

Tooling and operations:

- Browser automation: `vd:browser`, `vd:browser-profile`, `vd:browser-trace`
- Docs and diagrams: `vd:docs`, `vd:zensical`, `vd:diagram`, `vd:text-diagram`, `vd:excalidraw`, `vd:open-design`
- Media and files: `vd:omnimedia`, `vd:file-browser`
- Data and workspace: `vd:miudb`, `vd:sqlit`, `vd:gws`, `vd:jira`, `vd:qmd`
- Local operations: `vd:computer-clean`, `vd:worktree`, `vd:gopass`, `vd:journal`
- Skill lifecycle: `vd:skill-management`

Use `vd:scout` for a file map, `vd:debug` for failing behavior, `vd:plan` when the path is not concrete, `vd:cook` when a plan is ready, `vd:docs` for canonical docs, and `vd:zensical` for Zensical site work.

## Architecture

Authors edit `skills/<name>/SKILL.md`. Validation checks metadata and canonical skill ID conventions. `vd doctor` reports drift between tracked sources, the lock, and local skill directories. `vd build` emits Claude Code plugin metadata and Codex repo-scope links from `skills.toml`. Release Please updates skill-catalog SemVer surfaces. Zensical builds `docs/` into `site/` for GitHub Pages.

The public documentation deploys to `https://skills.vanducng.dev/`. The Pages workflow installs `zensical==0.0.43`, runs `zensical build --clean --strict`, writes `site/CNAME`, uploads `site/`, and deploys with GitHub Pages.

## Source Links

- Install: https://skills.vanducng.dev/install/
- Getting started: https://skills.vanducng.dev/getting-started/
- Agent context: https://skills.vanducng.dev/agent-context/
- Skills: https://skills.vanducng.dev/skills/
- Workflows: https://skills.vanducng.dev/workflows/
- Architecture: https://skills.vanducng.dev/system-architecture/
- Tech stack: https://skills.vanducng.dev/tech-stack/
- Development: https://skills.vanducng.dev/development-guidelines/
- Deployment: https://skills.vanducng.dev/deployment/