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.