Agent Skills › withkynam/vibecode-pro-max-kit › vc-audit-vc

vc-audit-vc

GitHub

用于审计 Agent 框架健康度，验证 Claude/Codex 一致性、技能注册表、README 同步及协议文件连接。在相关文件或结构变动时触发。

.claude/skills/vc-audit-vc/SKILL.md withkynam/vibecode-pro-max-kit

Trigger Scenarios

Agent 或 Skill 文件发生移动、拆分或漂移需要验证版本控制层内部一致性和正确连接性

Install

npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-vc -g -y

More Options

Non-standard path

npx skills add https://github.com/withkynam/vibecode-pro-max-kit/tree/main/.claude/skills/vc-audit-vc -g -y

Use without installing

npx skills use withkynam/vibecode-pro-max-kit@vc-audit-vc

指定 Agent (Claude Code)

npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-vc -a claude-code -g -y

安装 repo 全部 skill

npx skills add withkynam/vibecode-pro-max-kit --all -g -y

预览 repo 内 skill

npx skills add withkynam/vibecode-pro-max-kit --list

SKILL.md

Frontmatter

{
    "name": "vc-audit-vc",
    "layer": "contract",
    "description": "Audit agent harness health: Claude\/Codex agent parity, skill registry consistency, README.md sync, and protocol file wiring. Use when agents, skills, README.md, or development-protocol files move, split, or drift.",
    "trigger_keywords": "harness audit, agent parity, skill audit, guide sync"
}

Audit VC (Version Control Harness Health)

Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.

Use this skill to verify that the agent harness layer is internally consistent and correctly wired across Claude, Codex, README.md, and protocol files.

For context routing, grouping, and discoverability audits, use the audit-context skill instead.

Workflow

Run the Claude/Codex agent parity validator:

node .claude/skills/vc-audit-vc/scripts/validate-agent-parity.mjs

Run the shared skill discovery validator:

node .claude/skills/vc-audit-vc/scripts/validate-skills.mjs

Run the README.md sync validator:

node .claude/skills/vc-audit-vc/scripts/validate-guide-sync.mjs

Run the protocol wiring validator:

node .claude/skills/vc-audit-vc/scripts/validate-protocol-wiring.mjs

Run the seed/scaffold consistency validator:

node .claude/skills/vc-audit-vc/scripts/validate-seeds.mjs

Run the kit portability validator:

node .claude/skills/vc-audit-vc/scripts/validate-kit-portability.mjs

Run the skill invocation wiring validator:

node .claude/skills/vc-audit-vc/scripts/validate-skill-invocation-wiring.mjs

Run the agent frontmatter validator:

node .claude/skills/vc-audit-vc/scripts/validate-agent-frontmatter.mjs

If any script reports failures, inspect the referenced files and patch the smallest relevant surface.
Re-run the failed validators until they pass.

Rules

Treat .claude/agents/ as canonical for agent definitions; .codex/agents/ mirrors them.
Treat .claude/skills/ as canonical for skills; .agents/skills/ is the Codex discovery symlink.
When updating agents, mirror Claude markdown and Codex TOML surfaces together.
Treat process/_seeds/ as an optional legacy scaffold surface in the live repo. Its absence is a warning-only audit result unless the user is explicitly auditing export-kit scaffolding.
Treat validator warnings as audit findings unless the user asks for a strict cleanup.
For context routing and discoverability audits, delegate to audit-context.