skills.rest
foundry-works
foundry-worksOFFICIAL
Explore all skills by this author →
GitHub

foundry-pr

Generate PR descriptions from spec metadata, tasks, and git history.

4|Updated Dec 3, 2025
Search Tags:#automation#spec-driven#journal#PR#git-diff#pr-drafting
One-click install
npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-pr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: foundry-pr
Source: https://github.com/foundry-works/claude-foundry/tree/main/skills/foundry-pr
Command: npx skills add https://github.com/foundry-works/claude-foundry --skill foundry-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AI-powered PR description generation after spec completion. It analyzes spec metadata, completed tasks, commit history, and journal entries to produce a detailed PR description, with user approval before creation.

Core Features & Use Cases

  • Context-rich PR drafts: Generates PR descriptions using spec metadata, tasks, commits, and journals.
  • Approval-driven: Drafts are shown for user review before PR creation.
  • Spec updates: Automatically records PR URLs and numbers back to the spec metadata.

Quick Start

Invoke after finishing a spec with: Skill(foundry:foundry-pr) "Create PR for spec oauth-feature-2025-11-03-001" The agent presents a draft for review; approve to create the PR and update metadata.

Frequently Asked Questions about foundry-pr

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

FAQPage Schema
How do I auto-draft PR descriptions from git commit history and spec metadata?▼

To auto-draft PR descriptions, the Skill aggregates spec metadata, completed tasks, journal entries, and git diffs to generate a structured PR outline. It presents the draft for your approval before creating the PR and updating the spec metadata with the PR URL and number.

What is spec-driven PR generation and how does it work?▼

Spec-driven PR generation produces context-rich PR drafts by analyzing spec metadata, task completion history, and commit logs. It aggregates this data to outline a comprehensive description, requiring user approval before creation to ensure accuracy and relevance.

Can I generate PR drafts for complex feature work and bug fixes automatically?▼

Yes, you can generate PR drafts for complex changes, bug fixes, or feature work. The Skill analyzes your completed spec tasks and commit history to produce a detailed PR description tailored to the specific changes made.

How do I review and approve an automated PR draft before creation?▼

To review an automated PR draft, invoke the Skill after spec completion and it will present a structured outline. You must explicitly approve the generated draft before the PR is actually created and the spec metadata is updated with the PR URL.

Does generating PR drafts from git diffs require manual spec metadata updates?▼

No, generating PR drafts from git diffs does not require manual spec metadata updates. After you approve the drafted PR description, the Skill automatically records the PR URL and number back into the spec metadata.

What's the best way to create context-rich PRs from completed development tasks?▼

The best way to create context-rich PRs is to use an approval-driven automation tool that aggregates spec history, journal entries, and commits. This ensures the PR draft captures comprehensive project context before submission.

Related Skills

Explore More Software Engineering Skills→
tylerburleightylerburleigh
4

sdd-pr

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

Community
Intermediate
szaherszaher

speckit-taskstoissues

Convert tasks from a markdown file into GitHub issues.

Community
Intermediate
tylerburleightylerburleigh
9

sdd-update

Update SDD task statuses and journals via CLI commands.

Community
Intermediate
vincent-kkvincent-kk
1

git-change-analyzer

Aggregate Git commits, branch diffs, and staged changes into JSON.

Community
Basic