gsd-pr-branch

Filter .planning/ commits from a branch to produce a clean PR diff.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill gsd-pr-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-pr-branch
Source: https://github.com/onelee85/my-skills/tree/main/gsd-pr-branch
Command: npx skills add https://github.com/onelee85/my-skills --skill gsd-pr-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Filter out .planning/ commits from the current branch to produce a clean PR diff, so code reviews focus on the actual changes.

Core Features & Use Cases

  • Excludes planning artifacts such as PLAN.md, SUMMARY.md, and STATE.md from the PR diff
  • Keeps all actual code changes intact for accurate review
  • Use Case: Prepare a feature branch for PR review without planning artifacts cluttering the diffs

Quick Start

Create a clean PR branch from the current branch by filtering out .planning/ commits

Frequently Asked Questions about gsd-pr-branch

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

FAQPage Schema
How do I exclude planning artifacts from a git PR diff?

Filtering planning artifacts from a PR diff involves rewriting your feature branch to drop `.planning/` commits. This process ensures files like PLAN.md and SUMMARY.md are excluded while keeping all actual code changes intact for accurate review.

Why does my code review include PLAN.md and SUMMARY.md files?

Your code review includes these planning files because they exist in your branch history. Filtering out `.planning/` commits removes PLAN.md, SUMMARY.md, and STATE.md from the diff, ensuring reviews focus strictly on actual code changes.

What is the best way to clean up a feature branch before creating a PR?

The best way to clean up a feature branch is to filter out planning artifacts using a deterministic workflow. This rewrites the branch to drop `.planning/` commits, producing a clean PR diff that excludes planning artifacts while preserving code changes.

Does filtering out planning commits preserve my actual code changes?

Yes, filtering out planning commits preserves your code changes. The workflow specifically targets and drops `.planning/` artifacts while keeping all code modifications intact, ensuring the final PR diff remains accurate for code review.

Can I remove planning artifacts from a branch without losing my code history?

Yes, you can remove planning artifacts without losing code history. The workflow rewrites the branch to drop only `.planning/` commits while preserving all code changes, ensuring teams maintain clean histories on feature branches for review.