vergil

Plugin vergil from marketplace vergil-marketplace in vergil-project/vergil-claude-plugin. Commands read from the repo's manifest — 2 days ago.

Skills (15)

• deferred-review

  Review the deferred queue — re-check every deferred item's revival conditions against the current state of the world and recommend keep, refresh, revive, or drop. Use when the human asks to "review deferred", "what's deferred", "revisit the backlog", "process the deferred queue", or wants the period

• deprecation-triage

  Triage a deprecation warning into a tracked decision. Use whenever a deprecation warning surfaces — the detect-deprecation-warnings PostToolUse hook fires, or the human points at a warning in test/CI/build output and asks how to handle it ("triage this deprecation", "what do we do about this warning

• epic-create

  Use as the DEFAULT entry point for non-trivial work — building a feature, a cross-cutting or multi-PR initiative, or promoting a brainstorm into the epic/task framework. epic-create is the outer workflow that runs brainstorming, creates the epic and its bookend tasks in the org .github, and drives s

• epic-implement

  Drive a GitHub epic's tasks to their human gates as the USER agent. Use whenever the human wants to start or resume work on an epic as a whole — "implement epic #135", "pick up epic X where we left off", "drive this epic", "keep working the epic" — with or without the slash command. A thin layer abo

• epic-retrospective

  Close out an epic by authoring its terminal retrospective — the backward-looking record that partners the spec and plan. Use when the human wants to finish an epic ("run the retrospective", "close out epic <ref>", "we're done with this epic", "wrap up the epic"). The run-once finishing gate of the t

• intake-capture

  Capture an uncurated idea, bug, or to-do into the intake queue so it is never lost. Use whenever the human says "don't forget X", "capture this", "note a todo", "file an issue for…", "remind me to…", or riffs an idea they want to come back to later — especially mid-task or via voice. Creates one int

• intake-review

  Review the intake queue — route every uncurated intake item into the epic/task model, oldest first. Use when the human asks to "review intake", "process the intake queue", "what's in intake", "groom the backlog", "let's do intake", or the old phrasings "review triage", "process the triage queue", "w

• issue-deploy

  Run a deployment task end-to-end as the USER agent — a `deployment`-labelled issue that installs/syncs merged changes so they are usable, then records the result as a comment. Use when the human asks to deploy, install, roll out, or sync merged work ("deploy #129", "run the deployment", "sync the la

• issue-implement

  Implement a GitHub issue end-to-end as the USER agent. Use whenever the human asks to implement, build, fix, or start work on an issue — "implement #170", "go implement this", "let's do issue N", "build out this issue" — with or without the slash command. Also takes a list of small same-epic issues

• issue-validate

  Run a validation task end-to-end as the USER agent — a `validation`-labelled issue whose acceptance is a live check, not a code change. Use when the human asks to validate, verify, or run the checklist on a validation issue ("validate #120", "run the validation", "verify the deployed lab"), or when

• merge-review

  Pre-PR merge review of a task branch, run by issue-implement once `vrg-container-run -- vrg-validate` is green on the committed branch and before `vrg-pr-workflow report-ready`. Asks one question, "is this change good enough to merge?" — one review by the read-only `vergil:merge-reviewer`, at most o

• planning-review

  Review the planning queue with the human and decide what to plan next. Use when the human asks to "review planning", "what should we plan next", "prioritize the planning queue", "what's in planning worth planning", or wants the periodic planning pass. Lists the queue with `vrg-queue planning`, ranks

• pr-watch

  Monitor and reconcile an open PR after vrg-submit-pr. Use whenever a PR has just been opened and needs watching — vrg-submit-pr emits the `/vergil:pr-watch <PR_URL>` line, or the human asks to watch, monitor, or babysit the PR through CI and review. Runs in the USER agent session: block on PR state

• steering-audit

  Review the Claude Code steering and settings files against the Claude config ownership model, one finding at a time with the human. Use when the human asks to "audit steering files", "review CLAUDE.md", "review Claude settings", "steering audit", or wants the periodic (at least quarterly) steering r

• summarize

  Produce a structured summary in decisions, operations, or stream-of-consciousness (SOC) mode. Use when the human asks for a structured summary, a decision or operations writeup, or SOC capture ("summarize this", "write up these decisions", "capture this as SOC", "log this operation"). SOC mode is th

Subagents (2)

• bootstrap

  Session bootstrap agent. Use proactively at the start of every work session to validate the repository profile, check branch state, and load context. Must run before any code changes.

• merge-reviewer

  Read-only pre-PR reviewer for one merge-review step. Dispatched only by the merge-review skill, with one line: the absolute path of a request file. Never use it directly or for any other review.

Hooks (12)

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-raw-git-commit.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-raw-gh-pr-create.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-protected-branch-work.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-heredoc.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-associative-arrays.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/enforce-host-container-split.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-autoclose-linkage.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-agent-merge.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-github-contents-api.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/block-worktree-bypass-write.sh

• PreToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/guard-audit-writes.sh

• PostToolUse

  ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/detect-deprecation-warnings.sh