create-github-pull-request-from-specification

github/awesome-copilot

Create GitHub pull requests from specification files using your pull_request_template.md

What is create-github-pull-request-from-specification?

Automates GitHub pull request creation by analyzing specification files and populating them with your project's pull request template. Use this when you need to convert feature specifications into properly formatted PRs ready for review.

Analyzes specification files and extracts requirements
Generates pull request drafts with template-based formatting
Checks for existing pull requests to avoid duplicates
Updates PR title and body with specification details
Transitions pull requests from draft to ready for review
Auto-assigns pull requests to the creator

How to install create-github-pull-request-from-specification

npx skills add https://github.com/github/awesome-copilot --skill create-github-pull-request-from-specification

Prerequisites

GitHub repository with .github/pull_request_template.md file
Access to create and manage pull requests in the repository
Specification file to be converted into a pull request

Claude Code

Cursor

Windsurf

Cline

How to use create-github-pull-request-from-specification

1.Prepare your specification file in the workspace
2.Ensure .github/pull_request_template.md exists in your repository
3.Run the skill and specify the target branch for the pull request
4.The skill will analyze the specification and create a draft PR
5.Review the generated PR title and body
6.Approve the transition from draft to ready for review
7.The PR will be auto-assigned and a URL will be provided

Use cases

Good for

Converting feature specifications into GitHub pull requests
Automating PR creation with consistent template formatting
Ensuring specifications are properly documented in pull request bodies
Preventing duplicate pull requests for the same specification
Streamlining the handoff from specification to code review

Who it's for

Software developers managing feature requests
Teams using GitHub pull request templates
Project maintainers automating PR workflows
Developers working with specification-driven development

create-github-pull-request-from-specification FAQ

What if a pull request already exists for this branch?

The skill checks for existing pull requests using get_pull_request and skips the creation step, proceeding directly to update the existing PR instead.

Can I customize the pull request template?

Yes, the skill uses your project's .github/pull_request_template.md file, so customize that file to control PR formatting.

Will the PR be automatically merged?

No, the skill creates and prepares the PR for review but does not merge it. You must review and merge manually.

What information does the skill extract from the specification?

The skill analyzes your specification file and incorporates the requirements and details into the PR title and body according to your template structure.

Full instructions (SKILL.md)

Source of truth, from github/awesome-copilot.

name: create-github-pull-request-from-specification description: 'Create GitHub Pull Request for feature request from specification file using pull_request_template.md template.'

Create GitHub Pull Request from Specification

Create GitHub Pull Request for the specification at ${workspaceFolder}/.github/pull_request_template.md .

Process

Analyze specification file template from '${workspaceFolder}/.github/pull_request_template.md' to extract requirements by 'search' tool.
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.
Get changes in pull request by using 'get_pull_request_diff' tool to analyze information that was changed in pull Request.
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.
Switch from draft to ready for review by using 'update_pull_request' tool. To update state of pull request.
Using 'get_me' to get username of person was created pull request and assign to update_issue tool. To assign pull request
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

Surgical code refactoring to improve maintainability without changing behavior.

19k installsAudited