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.