create-pr · factory-ai — Claude Code skill: create a PR with local checks
create-pr — a skill that creates a pull request with a Conventional Commits title, templated body, and local verification before submission.
no license 115 installs ★ 129 updated 2026-10-25
npx skills add Factory-AI/factory-plugins --skill create-pr -a claude-codeWhat create-pr does
The skill runs typecheck, linter, tests and other checks locally, formats the PR title and body according to project conventions, optionally links a ticket from your issue tracker (Linear, Jira, GitHub Issues). It works with any language: commands are pulled from Makefile, package.json, pyproject.toml, Cargo.toml and other repo config files.
Workflow: analyze commits and diff, determine change type (feat, fix, docs, refactor, test, chore, perf, ci, build, revert) and scope, run checks for modified packages, build title and body, create PR with gh pr create.
For non-code changes (docs, markdown, config only) checks are skipped. If you modified a dependency manifest, the skill syncs the lockfile before submission — CI often fails when the lockfile is stale.
What it helps with
- Assemble and format a PR with a linked ticket
- Run typecheck, linter and tests for affected parts of the project
- Fill PR body from the repo template
- Sync lockfile after changing dependency manifest
Example prompts for the agent
- Create a PR from the current branch
- Open a pull request linked to
TEAM-1234 - Make a PR to
main, run tests and linter before submission
How to install create-pr
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill create-pr -a claude-code2Manually: put the files in place
~/.claude/skills/create-pr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/create-pr/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill create-pr -a codex2Manually: put the files in place
.agents/skills/create-pr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill create-pr -a cursor2Manually: put the files in place
.cursor/skills/create-pr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Factory-AI/factory-plugins plugins/code-review/skills/create-pr2Manually: put the files in place
.github/skills/create-pr/SKILL.md1Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill create-pr -a gemini-cli2Platform CLI
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/code-review/skills/create-prManually: put the files in place
.devin/skills/create-pr/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Factory-AI/factory-plugins --skill create-pr -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about create-pr
How to install create-pr in Claude Code?
Run npx skills add Factory-AI/factory-plugins --skill create-pr -a claude-code. The skill will appear in ~/.claude/skills/create-pr/SKILL.md.
What does create-pr do?
The skill runs typecheck, linter and tests locally, formats the PR title and body according to Conventional Commits and repo template, optionally links a ticket from your tracker, and creates the PR with gh pr create.
How does the skill determine which commands to run?
It reads config files at repo root (Makefile, package.json, pyproject.toml, Cargo.toml, CI configs) and uses the commands defined there. For monorepos it applies filter flags like --filter, --projects or -p <crate>.
Similar skills
All skills for Git and GitHub →create-pr by other authors comes first.