manage-pull-requests

Imported from ThomasVitale/agents-skills-oci-artifacts-spec (examples/skills/manage-pull-requests/SKILL.md). Install upstream with npx skills add ThomasVitale/agents-skills-oci-artifacts-spec --skill manage-pull-requests. Copyright stays with the author (Apache-2.0).

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": "<action>",
  "repo": "<owner/repo>",
  [ "pr_id": "<pr-id>", ]
  [ "branch": "<source-branch>", ]
  [ "target_branch": "<target-branch>", ]
  [ "title": "<pr-title>", ]
  [ "description": "<pr-description>", ]
  [ "comment": "<comment-text>", ]
  [ "force": <boolean> ]
}

Action-Specific Parameters

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