v1tamins

v1tamins

██╗   ██╗  ██╗ ████████╗ █████╗ ███╗   ███╗██╗███╗   ██╗███████╗
██║   ██║ ███║ ╚══██╔══╝██╔══██╗████╗ ████║██║████╗  ██║██╔════╝
██║   ██║ ╚██║    ██║   ███████║██╔████╔██║██║██╔██╗ ██║███████╗
╚██╗ ██╔╝  ██║    ██║   ██╔══██║██║╚██╔╝██║██║██║╚██╗██║╚════██║
 ╚████╔╝   ██║    ██║   ██║  ██║██║ ╚═╝ ██║██║██║ ╚████║███████║
  ╚═══╝    ╚═╝    ╚═╝   ╚═╝  ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝

Daily supplements for healthy code. A shared collection of AI development tools from the Version1 team.

This repository is public-facing. Shared skills and instructions must be generalizable and must not include secrets, private customer/project details, internal URLs, absolute local paths, incident-specific facts, or guidance that only makes sense inside one private repository.

What's Inside

v1tamins/
├── .agents/
│   ├── plugins/marketplace.json  # Codex marketplace manifest
│   └── skills/          # Canonical shared skills for Codex and other agent runtimes
│       ├── md2docs/
│       └── ...
├── .claude-plugin/
│   └── marketplace.json  # Claude Code marketplace manifest
├── claude/
│   ├── skills/          # Claude-compatible entries, symlinked or mirrored from .agents/skills
│   │   ├── code-review/
│   │   ├── pr-description/
│   │   ├── write-tests/
│   │   ├── fix-tests/
│   │   ├── deslop/
│   │   └── ...
│   └── hooks/           # Pre/post execution hooks
│       └── format.sh
├── cursor/
│   ├── commands/        # Cursor slash commands
│   │   ├── code-review.md
│   │   ├── security-audit.md
│   │   ├── write-unit-tests.md
│   │   └── ...
│   └── rules/           # Cursor rules
│       └── development.mdc
├── plugins/
│   └── v1tamins/        # Plugin package for Claude Code and Codex with generated v1-* skill mirrors
│       ├── .claude-plugin/plugin.json
│       ├── .codex-plugin/plugin.json
│       └── skills/
├── .github/
│   └── copilot-instructions.md  # Repository-wide GitHub Copilot guidance
├── mcp/
│   └── mcp.json         # MCP server configurations
├── scripts/
│   └── sync-skill-hosts.sh  # Validate skill frontmatter and sync host metadata
└── templates/           # Reusable templates (CLAUDE.md, etc.)

Quick Install

# Clone the repo
git clone [email protected]:v1-io/v1tamins.git ~/v1tamins

# Run the compatibility install script
~/v1tamins/install.sh

# Copy-mode install for runtimes that reject symlink targets outside ~/.agents/skills
~/v1tamins/install.sh --copy-agent-skills

Manual Setup

Plugin Install (Claude Code and Codex)

The preferred distribution is the plugin package in plugins/v1tamins/. The same package serves both Claude Code and Codex through sibling per-runtime manifests (.claude-plugin/plugin.json and .codex-plugin/plugin.json) reading from one shared skills/ directory. Plugin-distributed skills use a v1- prefix, such as v1-pr, v1-debug, and v1-address-review, to avoid collisions with other public or personal skills.

Claude Code

/plugin marketplace add v1-io/v1tamins
/plugin install v1tamins@v1tamins

For local development, point the marketplace at the checkout instead:

/plugin marketplace add ~/v1tamins

Codex

codex plugin marketplace add v1-io/v1tamins

Then install or enable the v1tamins plugin from Codex's plugin UI. For local development, use the checkout path instead:

codex plugin marketplace add ~/v1tamins

install.sh does not install the plugin. It remains the compatibility adapter for shared agent installs, Claude hooks, Cursor commands/rules, and older local setups.

The plugin skill files under plugins/v1tamins/skills/ are generated mirrors. Edit .agents/skills/ first, then run:

scripts/sync-skill-hosts.sh --write
scripts/sync-skill-hosts.sh

Shared Agent Skills

The canonical repo path for portable skills is .agents/skills/.

For repo-managed installs, keep ~/.agents/skills/ as a real user-owned directory and symlink each v1tamins skill into it:

mkdir -p ~/.agents/skills
for skill in ~/v1tamins/.agents/skills/*; do
  ln -sfn "$skill" ~/.agents/skills/"$(basename "$skill")"
done

Some runtimes treat a skill symlink that resolves outside ~/.agents/skills/ as an escaped path and refuse to load it. For those runtimes, use copied agent skills instead:

~/v1tamins/install.sh --copy-agent-skills

Copied installs are refreshed by rerunning the installer. The installer marks copied v1tamins skill directories with .v1tamins-managed-copy so future runs can replace them without accumulating stale snapshots. Backups are moved to sibling .backups directories instead of staying under skill roots, because some runtimes load every SKILL.md under the root.

Do not symlink the whole ~/.agents/skills directory to this repo. Public, vendor, and personal skills installed into global skill directories should remain outside v1tamins so they do not appear in git status.