vc-review-situation

Summarizes git branch state, worktrees, and active plans into read-only handoff reports.

2|Updated Sep 15, 2025
One-click install
npx skills add https://github.com/marsley01/Marsley-Portfolio-Web --skill vc-review-situation-marsley01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-review-situation
Source: https://github.com/marsley01/Marsley-Portfolio-Web/tree/main/.agents/skills/vc-review-situation
Command: npx skills add https://github.com/marsley01/Marsley-Portfolio-Web --skill vc-review-situation-marsley01

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? When resuming work after a break or handing off between agents, it is hard to reconstruct what is in flight: which branches are active, which worktrees exist, and which plans are unfinished. This Skill scans the repository and produces a structured orientation summary without mutating any state. ## Core Features & Use Cases - Read-only repo scan: Runs a Node.js scanner over git status, worktrees, local/remote refs, and active plan files under process/general-plans/active/ and process/features/*/active/. - Simple and Deep modes: Simple mode returns a quick handoff summary; Deep Mode additionally reads umbrella plans, phase reports, and resume sections to produce a full program briefing. - Selected-plan hints: Surfaces advisory selected-plan hints from explicit flags, session state, or a single primary plan, never as execute authority. - Use Case: At the start of a session, ask for a handoff summary and receive Current State, Recent Work, In-Flight Plans, Next Steps, and Warnings, optionally as JSON via --json. ## Quick Start Ask the assistant to run the review-situation scan and give you a handoff summary of the current branch, worktrees, and active plans.

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 handoff summary of my git repository state?

Run the review-situation-scan.cjs script with Node.js from the repo root. It reports current branch, dirty files, worktrees, recent branch commits, unfinished plans, suggested next steps, and warnings in a text report or JSON with --json.

What is the difference between Simple mode and Deep mode?

Simple mode runs only the scanner and returns the standard summary sections. Deep mode additionally reads the umbrella plan, latest phase report, and each active plan's resume section to synthesize a full program handoff briefing.

Does the scan modify my repository or fetch remotes automatically?

No. The scan is strictly read-only and never switches branches, edits plans, or fetches. Remote data stays stale-by-default unless you explicitly pass the --fetch flag.

How is the selected-plan hint determined?

Hint priority is: an explicit --selected-plan argument, then a session-state activePlan value, then exactly one primary active plan candidate. Non-explicit hints are labeled advisory and never grant execute authority.

What happens if the scanner script fails?

The skill instructs reporting the failure explicitly and falling back to minimal read-only commands: git status, git worktree list, git for-each-ref, and a find over the active plan directories.