Gh Contrib

---
name: gh-contrib
description: "Create GitHub issues and PRs following contribution guidelines. Activate when user says 'contribute this', 'submit pr', 'open issue and pr', or wants to submit changes to upstream."
---

# GitHub Contribution Workflow

## Prerequisites

- Changes committed in a feature branch
- Duplicates already verified by user

## Workflow

### 1. Check Contribution Guidelines

Deploy explore agent to find contribution guidelines:

- Look for CONTRIBUTING.md, README, issue/PR templates
- Extract: title format, target branch, required labels

### 2. Detect Fork & Push

```bash
git remote -v  # identify fork remote
git push -u <fork-remote> <branch>
```

### 3. Create Issue

```bash
gh issue create --repo <owner>/<repo> \
  --title "<title per guidelines>" \
  --body "<body>"
```

### 4. Create PR

```bash
gh pr create --repo <owner>/<repo> \
  --head <fork-user>:<branch> \
  --base <target-branch> \
  --title "<title>" \
  --body "## Summary

<description>

Closes #<issue-number>"
```

### 5. Comment on Issue

```bash
gh issue comment <issue-number> --repo <owner>/<repo> --body "PR: #<pr-number>"
```

## Default Conventions

Use only if no contribution guidelines found:

| Type    | Issue Prefix | PR Prefix |
| ------- | ------------ | --------- |
| Feature | `[FEATURE]:` | `feat:`   |
| Bug     | `[BUG]:`     | `fix:`    |
| Docs    | `[DOCS]:`    | `docs:`   |
| Chore   | `[CHORE]:`   | `chore:`  |

## Flow

```
changes committed -> push to fork -> open issue -> open pr -> comment on issue
```