nv-park-and-review

Commits local changes and runs a scoped code quality review in a temporary git worktree.

39.7k|4.4k|Updated Aug 26, 2021
One-click install
npx skills add https://github.com/novuhq/novu --skill nv-park-and-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nv-park-and-review
Source: https://github.com/novuhq/novu/tree/main/.cursor/skills/nv-park-and-review
Command: npx skills add https://github.com/novuhq/novu --skill nv-park-and-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviewing uncommitted local changes for AI slop and redundant code is messy when done in the main working tree, and mixing the original work with review-driven refactors in one commit makes both hard to evaluate. This Skill snapshots the work as a baseline commit, moves the review into a throwaway git worktree, and lands the cleanup as a separate refactor commit.

Core Features & Use Cases

  • Baseline Commit Isolation: Stages and commits only the cohesive local change using the repo's conventional commit style, capturing the exact SHA as the sole review target.
  • Worktree-Based Review: Creates a lightweight git worktree so the main checkout stays free while a thermo-nuclear code quality review runs scoped strictly to that one commit.
  • Separate Refactor Commit: Triages findings, verifies dead-code claims with grep, applies behavior-preserving fixes, and lands them as a distinct follow-up commit before fast-forward merging back.
  • Use Case: After finishing a feature with uncommitted changes, invoke the skill to get an independent audit of just that work, with the cleanup kept as its own reviewable commit.

Quick Start

Ask the assistant to run nv-park-and-review on your current uncommitted changes to audit them for AI slop and redundant code.

Frequently Asked Questions about nv-park-and-review

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

FAQPage Schema
How do I review uncommitted changes for AI slop and redundant code?

Invoke nv-park-and-review, which commits your local changes as a baseline, then runs a thermo-nuclear code quality review scoped strictly to that commit in a separate git worktree. Findings are triaged and fixed as a separate refactor commit.

How to review a single git commit without disturbing my working tree?

The skill creates a lightweight worktree with git worktree add pointed at the baseline commit, so all review and refactor work happens outside your main checkout. The main tree is freed immediately after the baseline commit.

Does the review cover my whole branch or just one commit?

Only the single baseline commit is reviewed. The subagent prompt explicitly restricts findings to lines introduced or modified by that commit, though full files may be read for context.

What happens if the fast-forward merge fails after the review?

If git merge --ff-only fails, the original branch moved during the review. The skill does not force anything; it reports the divergence and leaves the review branch in place for you to reconcile manually.

When should I not use this park-and-review workflow?

Skip it when there is nothing worth committing yet or when the review surfaces no actionable findings, in which case the worktree and branch are simply removed. It also never pushes or opens a PR unless you explicitly ask.