# Create Pr

> Prepare and open a safe GitHub pull request for this repository. Use when the user asks to create, open, or prepare a pull request from completed branch work. Inspect the branch and diff, validate changes, follow the repository PR template, push only when authorized, and open a draft PR by default.

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

---


# Create Pull Request

Prepare reviewable pull requests for `main`. Keep the branch focused, preserve unrelated work, and never merge or modify another person's pull request.

## Workflow

1. Inspect the current branch, `git status --short`, the diff against `main`, recent commits, and any existing pull request for the branch.
2. Confirm the branch is not `main` and that it contains a small, coherent change. If the scope, target branch, or included files are unclear, ask before proceeding.
3. Ensure all intended work is committed. Use the `create-commit` skill if a commit is needed.
4. Run the relevant validation commands from `CONTRIBUTING.md`. Report failures accurately; do not weaken checks or use bypass flags.
5. Derive a concise Conventional Commit-style PR title, such as `docs(react): add testing resources`. Reuse a suitable user-provided title.
6. Build the description from `.github/pull_request_template.md`:

   - Explain what changed and why.
   - Add `Closes #<number>` only when an issue is known.
   - Mark only validation commands that actually passed.
   - Keep unchecked items unchecked and do not claim work that was not performed.

7. If the user asked to open the PR, push the current branch and create a **draft** pull request targeting `main`. Use GitHub CLI or an authenticated GitHub integration. If the user asked only to prepare it, provide the title and body without pushing or creating anything.
8. Return the PR URL, target branch, title, validation results, and any limitations.

## Safety rules

- Do not push or create a PR unless the user explicitly requested that external action.
- Do not use `--force`, alter branch history, merge, approve, or request review unless explicitly asked.
- Do not include secrets, generated output, local configuration, or unrelated changes.
- Do not create a duplicate PR. Update or report an existing PR instead.
- Use `main` as the base branch unless the user specifies another target.