This repository enforces that all pull requests must be linked to an issue that has an assignee. PRs that don't meet this requirement are automatically closed.
Requirements
For a PR to be accepted, it must:
Reference an issue - Include Fixes #123, Closes #123, or #123 in the PR title or description
PR author is assigned to the issue - You must be assigned to the issue you're working on
How It Works
┌─────────────────┐
│ PR Opened/ │
│ Reopened │
└────────┬────────┘
│
▼
┌─────────────────┐ No ┌─────────────────┐
│ Has issue │────────────►│ Close PR + │
│ reference? │ │ Comment │
└────────┬────────┘ └─────────────────┘
│ Yes
▼
┌─────────────────┐ No ┌─────────────────┐
│ PR author is │────────────►│ Close PR + │
│ assigned to │ │ Comment │
│ the issue? │ │ │
└────────┬────────┘ └─────────────────┘
│ Yes
▼
┌─────────────────┐
│ PR Passes │
└─────────────────┘
Workflow Triggers
The check runs when a PR is:
opened - New PR created
reopened - Previously closed PR reopened
edited - PR title or description changed
synchronize - New commits pushed
Fixing a Closed PR
If your PR was automatically closed:
Create or find an issue for the work you're doing
Assign yourself to that issue
Re-open your PR
Add the issue reference to your PR description:
Fixes #123
Valid Issue Reference Formats
Any of these patterns in your PR title or description will work:
Fixes #123
fixes #123
Fixed #123
Closes #123
closes #123
Closed #123
Resolves #123
resolves #123
Resolved #123
#123 (plain reference)
Why This Requirement?
Ensures all work is tracked in issues
Guarantees the person submitting the PR is responsible for the work
Prevents PRs for issues assigned to others
Improves project organization and accountability
Makes it easier to understand what each PR accomplishes
1---2name: 275-pr-requirements-03e587e43description: PR Requirements Workflow4---5# PR Requirements Workflow67This repository enforces that all pull requests must be linked to an issue that has an assignee. PRs that don't meet this requirement are automatically closed.89## Requirements1011For a PR to be accepted, it must:12131. **Reference an issue** - Include `Fixes #123`, `Closes #123`, or `#123` in the PR title or description142. **PR author is assigned to the issue** - You must be assigned to the issue you're working on1516## How It Works1718```19┌─────────────────┐20│ PR Opened/ │21│ Reopened │22└────────┬────────┘23 │24 ▼25┌─────────────────┐ No ┌─────────────────┐26│ Has issue │────────────►│ Close PR + │27│ reference? │ │ Comment │28└────────┬────────┘ └─────────────────┘29 │ Yes30 ▼31┌─────────────────┐ No ┌─────────────────┐32│ PR author is │────────────►│ Close PR + │33│ assigned to │ │ Comment │34│ the issue? │ │ │35└────────┬────────┘ └─────────────────┘36 │ Yes37 ▼38┌─────────────────┐39│ PR Passes │40└─────────────────┘41```4243## Workflow Triggers4445The check runs when a PR is:46- `opened` - New PR created47- `reopened` - Previously closed PR reopened48- `edited` - PR title or description changed49- `synchronize` - New commits pushed5051## Fixing a Closed PR5253If your PR was automatically closed:54551. **Create or find an issue** for the work you're doing562. **Assign yourself** to that issue573. **Re-open your PR**584. **Add the issue reference** to your PR description:59 ```60 Fixes #12361 ```6263## Valid Issue Reference Formats6465Any of these patterns in your PR title or description will work:6667- `Fixes #123`68- `fixes #123`69- `Fixed #123`70- `Closes #123`71- `closes #123`72- `Closed #123`73- `Resolves #123`74- `resolves #123`75- `Resolved #123`76- `#123` (plain reference)7778## Why This Requirement?7980- Ensures all work is tracked in issues81- Guarantees the person submitting the PR is responsible for the work82- Prevents PRs for issues assigned to others83- Improves project organization and accountability84- Makes it easier to understand what each PR accomplishes
Run npx skillmds@latest add tools-only/275-pr-requirements-03e587e4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
PR Requirements Workflow It is listed under Productivity on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tools-only