# Pull Request

> Create a GitHub pull request with full context linking back to the original issue. Use after implementation is complete and ready for review. Use when this capability is needed.

- Skill: `tomevault-io/pull-request-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pull-request-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pull-request-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pull-request-3

---


# Pull Request Creation

Create a well-formatted pull request that links back to the original issue and includes the implementation context.

## PR Format

```markdown
## Summary

[Brief description of what this PR accomplishes]

## Related Issue

Closes #[issue_number]

## Implementation

[Summary of the approach taken]

## Plan Reference

[Link to or summary of the implementation plan]

## Changes

[High-level list of changes made]

## Testing

[How was this tested / what validation was done]

---

Generated by ADW [adw_id]
```

## Instructions

1. Parse the provided context to extract:
   - Branch name
   - Issue number
   - Plan file or summary
   - ADW ID if available

2. Generate a PR title from the issue:
   - Format: `[type] Brief description (#issue_number)`
   - Example: `[feat] Add user authentication (#123)`

3. Generate the PR body following the format above

4. Create the PR using:

   ```bash
   gh pr create \
     --title "[title]" \
     --body "[body]" \
     --base main \
     --head [branch_name]
   ```

## Input Variables

$ARGUMENTS should contain:

- Branch name
- Issue number or URL
- Plan file path or summary
- ADW ID (optional)

## Example Output

```bash
gh pr create \
  --title "[feat] Add OAuth authentication (#123)" \
  --body "## Summary

Implements OAuth authentication with Google provider as specified in issue #123.

## Related Issue

Closes #123

## Implementation

Added OAuth flow using passport.js with Google strategy. Created new auth routes and middleware.

## Plan Reference

Implementation followed specs/feature-oauth-auth.md

## Changes

- Added OAuth configuration
- Created auth routes (/auth/google, /auth/callback)
- Added user session management
- Updated environment variables

## Testing

- Verified OAuth flow works end-to-end
- Tested session persistence
- Ran existing test suite

---

Generated by ADW a1b2c3d4"
```

## Context

$ARGUMENTS

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/melodic-software) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->