# Vibeguard Setup

> Use when the user asks to install, verify, inspect, or remove VibeGuard Codex hooks through the Codex App plugin.

- Skill: `majiayu000/vibeguard-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add majiayu000/vibeguard-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/vibeguard-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/majiayu000/vibeguard-setup

---


# VibeGuard Setup

This skill operates the explicit setup bridge for the VibeGuard Codex App
plugin. Installing VibeGuard changes high-context user configuration, so always
show the intended command before running it.

## When to Activate

- User asks to install VibeGuard hooks, rules, or skills for Codex.
- User asks to check VibeGuard health, hook status, or Codex status.
- User asks to uninstall or clean VibeGuard-managed assets.

## Red Flags

- **Missing checkout** - the plugin cache alone is not enough to install VibeGuard source assets.
- **Implicit install** - do not run `install --yes` unless the user asked to install.
- **Stale status** - do not report VibeGuard as healthy without a fresh setup check.

## Checklist

- [ ] Resolve the source checkout with `plugins/vibeguard/scripts/vibeguard-plugin.sh repo-dir`.
- [ ] Run `plugins/vibeguard/scripts/vibeguard-plugin.sh check --strict` before claiming health.
- [ ] Use `plugins/vibeguard/scripts/vibeguard-plugin.sh codex-status` for Codex-specific setup state.
- [ ] Use `VIBEGUARD_REPO_DIR=/path/to/vibeguard` if the plugin is loaded outside the checkout.

## Commands

From a VibeGuard checkout:

```bash
bash plugins/vibeguard/scripts/vibeguard-plugin.sh repo-dir
bash plugins/vibeguard/scripts/vibeguard-plugin.sh check --strict
bash plugins/vibeguard/scripts/vibeguard-plugin.sh codex-status
bash plugins/vibeguard/scripts/vibeguard-plugin.sh doctor
bash plugins/vibeguard/scripts/vibeguard-plugin.sh install --yes
bash plugins/vibeguard/scripts/vibeguard-plugin.sh clean
```

When running from a plugin cache:

```bash
VIBEGUARD_REPO_DIR=/path/to/vibeguard \
  bash scripts/vibeguard-plugin.sh check --strict
```