sdd-pr

Generate PR descriptions from spec metadata, git diffs, and commit history.

4|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tylerburleigh/claude-foundry --skill sdd-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-pr
Source: https://github.com/tylerburleigh/claude-foundry/tree/main/skills/sdd-pr
Command: npx skills add https://github.com/tylerburleigh/claude-foundry --skill sdd-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually writing comprehensive Pull Request (PR) descriptions is time-consuming and often lacks the full context of the changes, leading to incomplete reviews and delays.

Core Features & Use Cases

  • AI-powered PR Descriptions: Analyzes spec metadata, git diffs, commit history, and journal entries to generate comprehensive PR descriptions.
  • Context-Aware Synthesis: Explains the "why" behind changes, not just the "what," for better understanding.
  • User Approval Workflow: Always presents a draft PR description for your review and approval before creation.

Quick Start

Create a PR for spec 'oauth-feature-2025-11-03-001' after completing the implementation.

Frequently Asked Questions about sdd-pr

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

FAQPage Schema
How do I automate pull request descriptions from my spec and git history?

This Skill generates comprehensive PR descriptions by synthesizing spec metadata, commit history, git diffs, and journal entries. It analyzes your changes to produce a draft with summary, technical approach, implementation details, testing notes, and commit list for your review before creation.

Can I use AI to write better PR descriptions that explain the 'why' behind code changes?

Yes. The Skill creates context-aware PR descriptions that explain not just what changed, but why—drawing from your spec context, completed tasks, and implementation journal to help reviewers understand your reasoning and decisions.

What information does the Skill pull into a PR description?

It pulls spec metadata, completed task lists, git commit history, journal entries, and git diffs to construct a full-context PR draft covering summary, changes, technical approach, implementation details, testing, and commits.

Do I review the PR description before it's created?

Yes. The Skill always presents a draft PR description for your review and approval before creating the pull request, ensuring accuracy and alignment with your intent.

When should I run this Skill in my workflow?

Apply this Skill after you've completed your spec implementation. It synthesizes all your work—commits, changes, and notes—into a polished PR description ready for team review.

Does this work with existing git workflows and code review tools?

Yes. The Skill integrates with Foundry MCP tooling and standard git workflows, generating PR descriptions that work with your existing code review platform and approval processes.