gsd-pr-branch

Rewrite Git history excluding commits that modify files in .planning/ to create a pull-ready branch for code review.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-pr-branch-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-pr-branch
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-pr-branch
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-pr-branch-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill creates a pull-request-ready branch by removing GSD .planning/ commits from a working branch so reviewers only see relevant code changes and not PLAN.md / SUMMARY.md / STATE.md artifacts.

Core Features & Use Cases

  • Filter commits: Rewrite history to exclude commits that only modify files under .planning/, preserving code-related changes.
  • Create PR branch: Produce a new branch derived from the current branch that is safe to push for code review.
  • Use Case: When your feature branch includes iterative GSD planning notes that clutter diffs, run the workflow to generate a clean branch for reviewers.

Quick Start

Create a PR-ready branch from the current branch that filters out any .planning/ commits so the diff shows only code changes.

Frequently Asked Questions about gsd-pr-branch

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

FAQPage Schema
How do I remove planning files from a git branch before a pull request?

To remove planning files from a git branch before a pull request, rewrite the branch history to exclude commits that only modify .planning/ artifacts, producing a clean PR branch that shows reviewers only relevant code changes.

How does filtering out .planning/ commits from git history work?

Filtering out .planning/ commits works by rewriting branch history to exclude commits that only modify planning artifacts like PLAN.md, SUMMARY.md, and STATE.md, while preserving and keeping all code-related changes intact.

Do I need git-filter-repo to clean up a PR branch?

You need local git access and the ability to safely rewrite branch history using a tool like git-filter-repo or an equivalent utility, along with permission to force-push the rewritten branch to your remote repository.

What is the best way to hide GSD planning artifacts from code review diffs?

The best way to hide GSD planning artifacts from code review diffs is to generate a dedicated PR-ready branch derived from your working branch, filtering out any commits that solely modify files under the .planning/ directory.

Can I preserve code changes when rewriting git branch history to remove planning files?

Yes, rewriting git branch history to remove planning files preserves code changes by targeting and excluding only those commits that exclusively modify files within the .planning/ directory, ensuring all actual code modifications remain in the final diff.

When should I avoid rewriting branch history to clean a pull request?

You should avoid rewriting branch history to clean a pull request if your local environment lacks safe git history rewrite capabilities or if you lack the necessary permissions to force-push the rewritten branch to the remote repository.