Manage Pull Requests

Manage Pull Requests

Overview

This skill enables agents to automate pull request (PR) management in Forgejo repositories using the forgejo-cli tool. It supports common PR operations, making it ideal for CI/CD pipelines, code reviews, and team collaboration workflows.

---

Instructions

Prerequisites

• forgejo-cli must be installed and configured with Forgejo API credentials.
• The agent must have access to the target repository.

Supported Actions

• List PRs: Fetch all open PRs for a repository.
• View PR: Retrieve details of a specific PR.
• Create PR: Open a new PR from a branch or fork.
• Merge PR: Merge an approved PR into the target branch.
• Close PR: Close a PR without merging.
• Comment on PR: Add or update comments on a PR.

---

Parameters

Input Format

All actions require a JSON object with the following structure:

{
  "action": "",
  "repo": "",
  [ "pr_id": "", ]
  [ "branch": "", ]
  [ "target_branch": "", ]
  [ "title": "", ]
  [ "description": "", ]
  [ "comment": "", ]
  [ "force":  ]
}

Action-Specific Parameters

| Action | Required Parameters | Optional Parameters | |-----------|----------------------------------------------|-----------------------------------------| | list | repo | — | | view | repo, pr_id | — | | create | repo, branch, title | target_branch, description | | merge | repo, pr_id | force | | close | repo, pr_id | — | | comment | repo, pr_id, comment | — |

---

Examples

1. List all open PRs

Input:

{
  "action": "list",
  "repo": "owner/repo"
}

Output: List of open PRs with their IDs, titles, and authors.

---

2. Create a new PR

Input:

{
  "action": "create",
  "repo": "owner/repo",
  "branch": "feature/new-feature",
  "target_branch": "main",
  "title": "Add new feature",
  "description": "This PR introduces a new feature."
}

Output: Confirmation of PR creation with PR ID.

---

3. Merge a PR

Input:

{
  "action": "merge",
  "repo": "owner/repo",
  "pr_id": "123",
  "force": false
}

Output: Confirmation of merge or error if PR cannot be merged.

---

4. Add a comment to a PR

Input:

{
  "action": "comment",
  "repo": "owner/repo",
  "pr_id": "123",
  "comment": "Please review the changes."
}

Output: Confirmation of comment added.

---

Error Handling

• If forgejo-cli is not found:

> "Error: forgejo-cli is required but not installed. Install it from [forgejo-cli wiki](https://codeberg.org/forgejo-contrib/forgejo-cli/wiki/PRs)."

• If the repository or PR ID is invalid:

> "Error: Invalid repository or PR ID."

• For CLI errors:

> Return the raw error message from forgejo-cli.

---

References

• Forgejo CLI PRs Wiki
• Agent Skills Specification

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ThomasVitale
• Source: ThomasVitale/agents-skills-oci-artifacts-spec
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.