repository-pull-request-management
Skill1 starsChanged 32 days agoApache-2.0View on GitHub
Open, review, update, merge, or close a pull request (GitHub, Bitbucket) or merge request (GitLab) on a source-control hosting platform — GitHub, GitLab, Bitbucket Cloud, or Bitbucket Server & Data Center. Use when a change needs to move from a source branch into a target branch through a reviewed request, when an open request needs its title/description/target branch updated, when a reviewer needs to approve/request changes, or when a request needs to be merged or closed/declined without merging. Assumes an authenticated API client (personal access token, OAuth app token, or app installation token as the target platform requires) for the target platform is already available; this skill does not provision or authenticate that client. Does not cover repository/branch creation, branch protection rule configuration, CI/pipeline configuration, or webhook management.
In this repository40 other files it gives its agents.
- AGENTS.mdAGENTS.md
- alert-monitor-managementSkill
- automation-job-executionSkill
- casb-policy-managementSkill
- casb-posture-assessmentSkill
- certificate-managementSkill
- change-managementSkill
- cloud-security-group-auditSkill
- cmdb-asset-managementSkill
- compute-instance-provisioningSkill
- config-backup-managementSkill
- connector-tunnel-managementSkill
- container-workload-deploymentSkill
- crm-contact-managementSkill
- dcim-asset-managementSkill
- dhcp-scope-managementSkill
- dns-record-managementSkill
- dns-zone-managementSkill
- firewall-managementSkill
- incident-managementSkill
- infrastructure-plan-executionSkill
- interface-link-troubleshootingSkill
- ipam-allocationSkill
- load-balancingSkill
- log-querySkill
- metric-querySkill
- network-access-control-managementSkill
- network-health-verificationSkill
- network-state-collectionSkill
- notificationsSkill
- routing-troubleshootingSkill
- sdwan-policy-managementSkill
- sdwan-site-onboardingSkill
- secret-retrievalSkill
- software-upgrade-lifecycleSkill
- vpn-tunnel-managementSkill
- vulnerability-lookupSkill
- waf-managementSkill
- wireless-network-managementSkill
- zero-trust-access-policy-managementSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 21
Not for creating the repository or the branches themselves (the source and target branches must already exist before a request can be …
- Distinctive: line 69
Does not cover repository or branch creation — every platform procedure assumes both the source and target branches already exist.
- Distinctive: line 71
Does not cover branch-protection/merge-check rule configuration (required-approval counts, required status checks) — this skill only …
- Distinctive: line 74
Does not cover CI/pipeline configuration or webhook management, even where a platform's merge behavior (e.g.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Repository Pull/Merge Request Management
Opens, reviews, updates, merges, or closes a pull request (GitHub, Bitbucket) or merge request (GitLab) on one of the supported source-control hosting platforms, following that platform's own documented API procedure, field rules, and merge/approval model.
When to use this skill
- A code change on a source branch needs to be proposed for review and integration into a target branch on GitHub, GitLab, Bitbucket Cloud, or Bitbucket Server & Data Center.
- An existing open request's title, description, target branch, or reviewer list needs updating.
- A request needs a review decision recorded (approve, request changes, comment) where the platform exposes that as its own action.
- A request needs to be merged, or closed/declined without merging.
- Not for creating the repository or the branches themselves (the source and target branches must already exist before a request can be opened), configuring branch-protection/merge-check rules, configuring CI pipelines that gate a merge, or managing webhooks — those are separate concerns.
Universal concepts (apply regardless of platform)
- Every request has a source and a target branch, and represents the diff between them. All four platforms require both branches to exist first and require them to actually diverge — an attempt to open a request with no difference between source and target is rejected everywhere, though the exact rejection behavior (error vs. silently empty diff) is platform-specific.
- Closing without merging and merging are distinct, separately-invoked outcomes everywhere. No platform in this skill treats "close" as an implicit merge or vice versa; each is its own action with its own resulting state, and a closed/declined request that was never merged leaves the target branch untouched.
- A merge is not a single fixed operation — every platform offers more than one merge strategy (e.g. a real merge commit, squashing into one commit, or fast-forwarding/rebasing), and the caller must pick one; there is no universal default that's safe to assume without checking the target platform's own procedure.
- Review/approval is where these platforms genuinely diverge — do not assume one model fits all.
Each platform models a reviewer's stance (approve, request changes, comment) as its own distinct
kind of object or field, with its own API shape and its own relationship to branch-protection/
merge-check rules. Treat approval as a platform-specific step every time — see that platform's own
procedure.mdfor exactly how it represents it. - Merging a request is a hard-to-reverse, production-affecting action — once merged, the change is
in the target branch's history; undoing it is a new revert commit/PR, not an in-place undo. Every
platform procedure below requires operator confirmation before a merge call is submitted (see
"Known limitations" and rule enforced in each
procedure.md).
There is no single wire-level standard (no RFC) governing pull/merge requests the way DNS has
RFC 1035 — every concept above is a pattern observed consistently across all four platforms' own
documentation, not a standardized protocol; treat any additional platform added later as capable of
invalidating one of these claims (see each vendor's own notes in references/INDEX.md).
Procedure
- Identify the target platform — from the caller's request or the
platformargument. If it isn't one of the platforms inreferences/INDEX.md, stop: this skill doesn't cover it, and does not improvise a generic procedure for an unsupported platform. - Open
references/<platform>/procedure.mdand follow it exactly — it contains that platform's full operational procedure, error handling, patterns, known limitations, tools, and verification checklist. This file is intentionally the router; the real steps live per platform because the platforms' approval and merge models genuinely do not share one procedure (see "Universal concepts" above). - Report the outcome using that platform procedure's own status vocabulary (e.g.
CREATED,MERGED,DECLINED/CLOSED,REJECTED_*,FAILED) — don't normalize it away.
Known limitations
- Does not cover repository or branch creation — every platform procedure assumes both the source and target branches already exist.
- Does not cover branch-protection/merge-check rule configuration (required-approval counts, required status checks) — this skill only operates within whatever rules are already configured on the target repository/project.
- Does not cover CI/pipeline configuration or webhook management, even where a platform's merge behavior (e.g. GitLab's merge-when-pipeline-succeeds) references pipeline state.
- Merging is treated as a destructive/hard-to-reverse action on every platform — each
procedure.mdrequires operator confirmation before the merge call is submitted; never skip that gate because the API call would otherwise succeed. - Platform coverage is exactly the four vendors in
references/INDEX.md— a platform not listed there needs a newreferences/<platform>/procedure.mdbefore this skill can be used for it.
Contributing to this skill
SKILL.md itself should only ever change for two reasons: a bug in the universal-concepts/router
content above, or adding a pointer to a newly-supported platform. Platform-specific procedure
changes — a new error code, a corrected field name, a changed API path, a revised approval model —
belong in that platform's own references/<platform>/procedure.md and endpoints.md, never here. If
you're about to add vendor-specific detail to this file, put it in the platform's reference file
instead.
Tools
Each platform assumes its own authenticated REST client — see references/INDEX.md for which, and
that platform's procedure.md for the specific operations/mechanisms used.
Verification checklist
- Target platform confirmed against
references/INDEX.mdbefore proceeding - That platform's own
procedure.mdwas followed, including its own confirmation gates and error handling — not a generic/improvised sequence - Merge (or any other hard-to-reverse action) was confirmed with the operator before submission
- Outcome reported using the platform procedure's own status vocabulary
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

