AI-powered PR creation after spec completion. Analyzes spec metadata, git diffs, commit history, and journal entries to generate comprehensive PR descriptions with user approval before creation.
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
reference.mdThe sdd-pr skill creates professional, comprehensive pull requests by analyzing your completed specs and git history. Instead of manually writing PR descriptions, this skill uses AI to analyze all available context and generate detailed, well-structured PR descriptions.
Use Skill(foundry:sdd-pr) to:
When NOT to use:
gh CLI directly)This skill works exclusively through the Foundry MCP server (foundry-mcp). Tools use the router+action pattern: mcp__plugin_foundry_foundry-mcp__<router> with action="<action>".
Key tools:
mcp__plugin_foundry_foundry-mcp__pr action="create" - Create PR with spec contextmcp__plugin_foundry_foundry-mcp__pr action="context" - Gather PR context from specmcp__plugin_foundry_foundry-mcp__journal action="list" - Get journal entries for contextTraditional PR creation uses static templates. The sdd-pr skill:
1. Invocation → Skill(foundry:sdd-pr) "Create PR for spec my-feature-001"
2. Context → Gathers spec, tasks, commits, journals, diff
3. AI Analysis → Synthesizes context into coherent description
4. Draft → Shows PR description for review
5. User Approval → User reviews and approves/requests changes
6. Creation → Pushes branch, creates PR, updates spec metadata
| Source | What It Provides |
|---|---|
| Spec Metadata | Title, description, objectives |
| Completed Tasks | Files modified, changes made |
| Commit History | Messages, SHAs, task associations |
| Journal Entries | Technical decisions, rationale |
| Git Diff | Actual code changes |
For detailed context gathering, see
reference.md#context-sources
Generated PRs follow this template:
## Summary
{2-3 sentence overview}
## What Changed
### Key Features
- {feature-1}
- {feature-2}
### Files Modified
- `{file-path}`: {brief description}
## Technical Approach
{Key decisions from journal entries}
## Implementation Details
### Phase 1: {phase-title}
- {task-1}: {status}
- {task-2}: {status}
## Testing
- {verification-step-1}
- {verification-step-2}
## Commits
- {sha}: {task-id}: {message}
For full template with example, see
reference.md#draft-template
# After completing a spec, create PR
Skill(foundry:sdd-pr) "Create PR for spec oauth-feature-2025-11-03-001"
# Agent shows draft, user approves, PR created
This skill may take up to 5 minutes. Always use foreground execution:
Bash(command="...", timeout=300000) # 5 minute timeout
Never use run_in_background=True with frequent polling.
For comprehensive documentation including:
See reference.md