Create Github Pull Request From Specification
Open a single, review-ready GitHub pull request whose title and body match your repo PR template and the feature specification.
Overview
Create-github-pull-request-from-specification is an agent skill for the Ship phase that creates or updates a GitHub pull request from your spec using the repo PR template.
Install
npx skills add https://github.com/github/awesome-copilot --skill create-github-pull-request-from-specificationWhat is this skill?
- 7-step process from template search through assignee and URL handback
- Reuses existing PR on the branch via get_pull_request instead of duplicating
- Fills body and title from .github/pull_request_template.md plus diff analysis
- Promotes draft PRs to ready for review and assigns creator from get_me
- 7-step PR creation and update process
- Single pull request required per complete specification
Adoption & trust: 9k installs on skills.sh; 34.6k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your branch is done and the spec is in the repo, but opening a PR with the right template fields and review state still takes manual GitHub clicking.
Who is it for?
Solo builders using GitHub with .github/pull_request_template.md and agent tools that can create and update pull requests.
Skip if: Repositories without GitHub PR APIs or when you need stacked PRs or multiple PRs per spec.
When should I use this skill?
Feature work on a branch is complete and you need a GitHub PR aligned to the workspace specification and PR template.
What do I get? / Deliverables
You get one ready-for-review pull request with template-driven title and body, self-assigned author, and a shareable URL.
- One ready-for-review GitHub pull request URL
- PR title and body populated from template and spec context
Recommended Skills
Journey fit
Canonical shelf is Ship because the outcome is a PR ready for human review, not ideation or greenfield coding. Subphase review: it drafts or updates PR metadata from a spec and template, assigns the author, and moves draft to ready for review.
How it compares
Structured PR workflow from a spec file—not a generic commit-message or changelog generator.
Common Questions / FAQ
Who is create-github-pull-request-from-specification for?
Indie developers and small teams on GitHub who want their agent to file spec-complete PRs using the repo template.
When should I use create-github-pull-request-from-specification?
In Ship after implementation when the feature matches a specification file and you need a single draft-to-ready PR on your target branch.
Is create-github-pull-request-from-specification safe to install?
The skill drives GitHub issue/PR mutations via your connected tools; review the Security Audits panel on this page and limit repo tokens to least privilege.
SKILL.md
READMESKILL.md - Create Github Pull Request From Specification
# Create GitHub Pull Request from Specification Create GitHub Pull Request for the specification at `${workspaceFolder}/.github/pull_request_template.md` . ## Process 1. Analyze specification file template from '${workspaceFolder}/.github/pull_request_template.md' to extract requirements by 'search' tool. 2. Create pull request draft template by using 'create_pull_request' tool on to `${input:targetBranch}`. and make sure don't have any pull request of current branch was exist `get_pull_request`. If has continue to step 4, and skip step 3. 3. Get changes in pull request by using 'get_pull_request_diff' tool to analyze information that was changed in pull Request. 4. Update the pull request body and title created in the previous step using the 'update_pull_request' tool. Incorporate the information from the template obtained in the first step to update the body and title as needed. 5. Switch from draft to ready for review by using 'update_pull_request' tool. To update state of pull request. 6. Using 'get_me' to get username of person was created pull request and assign to `update_issue` tool. To assign pull request 7. Response URL Pull request was create to user. ## Requirements - Single pull request for the complete specification - Clear title/pull_request_template.md identifying the specification - Fill enough information into pull_request_template.md - Verify against existing pull requests before creation