# github

> Interface for GitHub using gh CLI. Use this skill when users want to create, view, edit, or close issues; create, review, or merge pull requests; manage projects; create repositories; manage releases; search code or issues; or perform any GitHub-related operations.

- Author: James Felix Black
- Repository: tftio/claude-skills
- Version: 20260130135044
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/tftio/claude-skills
- Web: https://mule.run/skillshub/@@tftio/claude-skills~github:20260130135044

---

---
name: github
description: Interface for GitHub using gh CLI. Use this skill when users want to create, view, edit, or close issues; create, review, or merge pull requests; manage projects; create repositories; manage releases; search code or issues; or perform any GitHub-related operations.
tools: Bash, Read, Glob
metadata:
  version: 1.0.0
  tags: [github, version-control, cli-wrapper]
---

# GitHub CLI Integration

This skill provides access to GitHub through the `gh` command-line tool (GitHub CLI v2.82.0+).

## Tool Location

```bash
# Verify installation
gh --version
gh auth status
```

## Resource Files

Detailed references are in `resources/`:

- **commands.md**: Full command syntax for issues, PRs, projects, repos, releases
- **workflows.md**: Work tracking integration, commit conventions, best practices

## Quick Reference

### Issues

```bash
# Create issue
gh issue create --title "Bug" --body "Description" --label "bug" --assignee "@me"

# List issues
gh issue list --state open --assignee "@me" --json number,title,state

# Edit issue
gh issue edit 123 --add-label "priority" --add-assignee "username"

# Close issue
gh issue close 123 --comment "Fixed in PR #456"
```

### Pull Requests

```bash
# Create PR
gh pr create --title "Fix bug" --body "Description" --reviewer username

# List PRs
gh pr list --state open --author "@me" --json number,title,reviewDecision

# Review PR
gh pr review 123 --approve --body "LGTM!"
gh pr review 123 --request-changes --body "Please fix"

# Merge PR
gh pr merge 123 --squash --delete-branch
gh pr merge 123 --auto  # Auto-merge when checks pass
```

### Projects

**Note:** Requires `gh auth refresh -s project`

```bash
# List projects
gh project list --owner username

# Add to project
gh project item-add 1 --owner username --url https://github.com/owner/repo/issues/123
```

### Search

```bash
# Search issues
gh search issues "bug is:open label:priority"

# Search PRs
gh search prs "fix is:merged author:username"

# Search code
gh search code "function parseJSON" --language typescript
```

## Output Formats

```bash
# JSON output (recommended for parsing)
gh issue list --json number,title,state

# Filter with jq
gh issue list --json number,title --jq '.[] | select(.number > 100)'
```

## Special Values

- `@me` - Assign to yourself
- `@copilot` - Assign to GitHub Copilot (requires Copilot Pro+)
- `--repo owner/repo` - Override repo context

## Work Tracking

**See `resources/workflows.md` for complete integration details.**

```bash
# Check for work context
if [ -f .work-metadata.toml ]; then
  ASANA_TASK=$(toml get .work-metadata.toml work.asana_task)
fi

# Load standards
prompter workflow.issue-tracking
```

## Authentication

```bash
# Login
gh auth login

# Check status
gh auth status

# Add project scope
gh auth refresh -s project
```

## Troubleshooting

- **Auth errors**: `gh auth login` or `gh auth refresh`
- **Project errors**: `gh auth refresh -s project`
- **Permission denied**: Check repo access and auth status
- **Not in repo**: Use `--repo owner/repo` flag

## Notes

- Most commands auto-detect repo from git remote
- Use `--json` for reliable parsing in scripts
- Use `--web` to open GitHub UI for complex operations