codebase-fix-and-pr

Codebase Fix and Pull Request

When to use this skill

Use this skill when you need to apply code fixes or improvements to a GitHub repository and automatically create a pull request. Specifically, use it when you need to:

• Fix bugs reported by users or found through code review
• Implement feature improvements
• Apply refactoring changes
• Fix documentation or configuration
• Apply automated code corrections
• Update dependencies or package versions

Overview

This skill guides an agent through the complete workflow of analyzing user feedback, making targeted code changes, and creating a pull request. The agent uses GitHub authentication via environment variables and the GitHub MCP tools to complete the entire flow.

Prerequisites

Before using this skill:

1. Configure Git CLI: Use the configure-git-cli skill to set up git user identity and GitHub authentication with your PAT
2. Required environment variables:
   • GITHUB_EMAIL: Your git email
   • GITHUB_NAME: Your git name
   • GITHUB_PAT: GitHub Personal Access Token with repo and workflow scopes

Workflow

Step 0: Configure Git (Prerequisite)

Before performing any git operations, ensure git is configured by invoking the configure-git-cli skill. This will:

• Set your git user email and name
• Configure GitHub authentication with your PAT
• Verify git credentials work correctly

Once configured, you can proceed with the following steps.

Step 1: Parse Requirements

Input required:

• GitHub repository URL or owner/repo format
• User feedback, issue description, or fix requirement
• Specific files or areas to modify (optional)
• PR description and title (optional - will auto-generate if not provided)

Actions:

1. Parse the user feedback to understand:
   • What needs to be fixed
   • Why it needs to be fixed
   • Which files are likely affected
   • Success criteria for the fix
2. Break down complex requests into discrete changes
3. Plan the implementation approach