# Github CLI

> GitHub CLI operations for repository and workflow management

- Skill: `paulanunes85/github-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add paulanunes85/github-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/paulanunes85/github-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: paulanunes85 (https://skillmd.com/u/paulanunes85)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/paulanunes85/github-cli

---


## When to Use
- GitHub API operations
- Pull request management
- Workflow triggering
- Issue management

## Prerequisites
- GitHub CLI installed and authenticated
- Appropriate repository permissions

## Commands

### Authentication
```bash
# Check auth status
gh auth status

# Login
gh auth login
```

### Repository Operations
```bash
# Clone repository
gh repo clone <owner/repo>

# View repository
gh repo view

# Create repository
gh repo create <name> --public --description "Description"
```

### Pull Request Operations
```bash
# Create PR
gh pr create --title "Title" --body "Description"

# List PRs
gh pr list

# View PR
gh pr view <number>

# Merge PR
gh pr merge <number> --merge
```

### Workflow Operations
```bash
# List workflows
gh workflow list

# Run workflow
gh workflow run <workflow-name>

# View workflow run
gh run view <run-id>

# Watch workflow run
gh run watch <run-id>
```

### Issue Operations
```bash
# Create issue
gh issue create --title "Title" --body "Description"

# List issues
gh issue list

# Close issue
gh issue close <number>
```

## Best Practices
1. Use gh api for advanced operations
2. Set default repository with gh repo set-default
3. Use --json flag for scripting
4. Authenticate with tokens for CI/CD

## Output Format
1. Command executed
2. Operation result
3. URLs for created resources
4. Next steps

## Integration with Agents
Used by: @devops, @reviewer