vd skills¶
skills.vanducng.dev
Portable agent skills, versioned with the repo that uses them.
Use one catalog for Claude Code plugin installs, Codex skill discovery, and repository-local workflows. The source of truth is plain Markdown under skills/; the build products are generated and validated.
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.
Source references: skills.toml, .claude-plugin/plugin.json, .claude-plugin/marketplace.json, scripts/validate.sh.
Fast Paths¶
Install for Claude Code¶
Use the marketplace plugin for normal use:
Install for Codex¶
Use vd when you want symlinks into Codex discovery paths:
Work Locally¶
Validate all skill frontmatter and release versions before shipping:
How The Pieces Fit¶
The catalog stays small and explicit: skill sources are human-readable, vd build emits agent-specific surfaces, GitHub Actions validates the catalog, and Release Please keeps the skill-catalog version synchronized across version.txt, skills.toml, and the Claude plugin manifests.
Read next: Install, Skill Catalog, System Architecture.
Agent Entry Points¶
Agents should start with /llms.txt for the curated index or /llms-full.txt for a fuller single-file context. The singular /llm.txt path is a compatibility pointer to the canonical plural file.