skills.rest
withkynam
withkynamCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

vc-review-situation

Generate read-only repository orientation reports with branch, worktree, and plan status.

1.1k|223|Updated May 27, 2026
Search Tags:#git#worktrees#reporting#handoff#plans#read-only
One-click install
npx skills add https://github.com/withkynam/vibecode-pro-max-kit --skill vc-review-situation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vc-review-situation
Source: https://github.com/withkynam/vibecode-pro-max-kit/tree/main/.claude/skills/vc-review-situation
Command: npx skills add https://github.com/withkynam/vibecode-pro-max-kit --skill vc-review-situation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a concise, read-only overview of the current repository state, including branch status, worktrees, and active project plans, to support handoff and session resumes.

Core Features & Use Cases

  • Surface branch state (current/detached), dirty status, and ahead/behind relationships for quick orientation.
  • Discover in-flight plans from process/general-plans/active and process/features/*/active for awareness without mutation.
  • Surface advisory hints for selected plans via CLI hints or session state, without enforcing execution authority.
  • Produce human-readable text reports by default and machine-readable JSON with --json for automation.
  • Serve as a safe, read-only assistant to route tasks and coordinate plan handoffs.

Quick Start

Run vc-review-situation to generate a quick orientation report for the current checkout.

Frequently Asked Questions about vc-review-situation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a read-only overview of my git repository state for handoff?▼

You can generate a read-only repository state overview by running the vc-review-situation command. It surfaces branch status, worktrees, and active plans to support session resumes and handoffs without mutating the repository.

How do I check active git plans and branch status without modifying the repository?▼

Checking active plans and branch status without modification is possible by running vc-review-situation. It discovers in-flight plans from active directories and surfaces advisory hints about the selected plan context safely.

Can I output my git worktree and branch status as JSON for automation?▼

You can output your git worktree and branch status as JSON by passing the --json flag. This produces a deterministic, machine-readable report for automation instead of the default human-readable text format.

What is the best way to orient an agent on the current git repository state?▼

The best way to orient an agent on the current repository state is to use a read-only reporting tool. It provides a deterministic end-to-end briefing covering branch relationships, dirty status, and active plans that agents can consume.

Does vc-review-situation enforce the execution of discovered active plans?▼

vc-review-situation does not enforce the execution of discovered active plans. It only surfaces advisory hints regarding the likely selected plan context and recommends next checks while remaining strictly read-only.

Why do I need a read-only report for git session resumes and project handoffs?▼

A read-only report for git session resumes prevents accidental mutations while orienting new developers. It safely surfaces detached heads, ahead and behind branch relationships, and active project plans for immediate context recovery.

Related Skills

Explore More Software Engineering Skills→
forecast-bioforecast-bio
27

audit

Dump project rules, git state, issues, and hook configurations for reorientation.

Official
Intermediate
issdandavisissdandavis
6

scbe-ai-to-ai-communication

Coordinates AI agents via standardized JSON handoff messages across platforms.

Community
Intermediate
dlt-hubdlt-hub
5.7k

switch-worktree

Switch the current session to a specified Git worktree.

Official
Intermediate
cryborg1211cryborg1211

vc:watzup

Summarize repository state and active plans for handoff.

Community
Intermediate