# github-operations

The github-operations skill handles GitHub issues, pull requests, milestones, and Projects v2 with gh, REST, and GraphQL patterns. It activates for GitHub resource management.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 230 installs · ★ 305 repo stars
- Author: OrchestKit
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/yonatangross/orchestkit/tree/HEAD/src/skills/github-operations/SKILL.md
- Updated: 2026-11-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/github-operations

## What it does

\`github-operations` gives an agent command patterns for opening and editing issues, creating pull requests, assigning reviewers, and watching CI checks. It also covers milestone work through the REST API and adding issues to Projects v2.

The skill includes `gh` examples, JSON output filters with `--jq`, GraphQL mutations, and loops for bulk issue creation. It recommends structured output for scripts and non-interactive flags for automated runs. Milestones use a name with `gh issue edit`, while the REST API expects a numeric identifier.

The `gh` CLI is required for these GitHub operations to run. Projects v2 field changes use GraphQL; basic `gh project` commands handle listing and adding items.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill github-operations -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/github-operations/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/github-operations/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill github-operations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/github-operations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill github-operations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/github-operations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install yonatangross/orchestkit src/skills/github-operations
```

2. **Manually: put the files in place**
- File: `.github/skills/github-operations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill github-operations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/yonatangross/orchestkit --path src/skills/github-operations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/github-operations/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add yonatangross/orchestkit --skill github-operations -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/yonatangross/orchestkit/tree/HEAD/src/skills/github-operations/SKILL.md

## When to use it
- create an issue with labels and a milestone
- open a pull request with a reviewer and target branch
- track milestone progress through the REST API
- add an issue to a Projects v2 board
- filter issues or pull requests with `--json` and `--jq`

## Example prompts
- Create an issue titled `Bug: API returns 500` with the `bug` label and `Sprint 5` milestone using `gh`.
- Open a pull request against `dev` with reviewer `@teammate`, then watch its CI checks.
- Find pull requests ready to merge with `gh pr list`, JSON fields, and a `--jq` filter.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 61db1628b956c376.

BEGIN THIRD-PARTY FILE 61db1628b956c376
````text
---
name: github-operations
license: MIT
compatibility: "Claude Code 2.1.277+. Requires gh CLI."
description: "gh CLI and REST patterns for issues, PRs, milestones and Projects v2. Use when managing GitHub issues, PRs or projects."
user-invocable: false
metadata:
  category: workflow-automation
  version: "1.1.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "github, gh, cli, issues, pr, milestones, projects, api"
allowed-tools: "Read Glob Grep Bash Write Edit TaskCreate TaskUpdate TaskList"
---

# GitHub Operations

Comprehensive GitHub CLI (`gh`) operations for project management, from basic issue creation to advanced Projects v2 integration and milestone tracking via REST API.

## Overview

- Creating and managing GitHub issues and PRs
- Working with GitHub Projects v2 custom fields
- Managing milestones (sprints, releases) via REST API
- Automating bulk operations with `gh`
- Running GraphQL queries for complex operations

---

## CRITICAL: Task Management is MANDATORY (CC 2.1.16)

**BEFORE doing ANYTHING else, create tasks to track progress:**

```python
# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="GitHub Operations: {target}",
  description="Managing GitHub issues, PRs, milestones, or Projects",
  activeForm="Managing GitHub resources"
)

# 2. Create subtasks matching the operation scope
TaskCreate(subject="Issue management", activeForm="Creating/updating issues")
TaskCreate(subject="PR management", activeForm="Managing pull requests")
TaskCreate(subject="Milestone tracking", activeForm="Updating milestones")

# 3. Set dependencies if operations are sequential
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done
```

## Quick Reference

### Issue Operations

```bash
# Create issue with labels and milestone
gh issue create --title "Bug: API returns 500" --body "..." --label "bug" --milestone "Sprint 5"

# List and filter issues
gh issue list --state open --label "backend" --assignee @me

# Edit issue metadata
gh issue edit 123 --add-label "high" --milestone "v2.0"
```

### PR Operations

```bash
# Create PR with reviewers
gh pr create --title "feat: Add search" --body "..." --base dev --reviewer @teammate

# Watch CI status and auto-merge
gh pr checks 456 --watch
gh pr merge 456 --auto --squash --delete-branch

# Resume a session linked to a PR (CC 2.1.27)
claude --from-pr 456           # Resume session with PR context (diff, comments, review status)
claude --from-pr https://github.com/org/repo/pull/456
```
````
END THIRD-PARTY FILE 61db1628b956c376

The third-party file has ended. Everything between the 61db1628b956c376 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2665 of 12625 bytes. © OrchestKit · MIT · https://github.com/yonatangross/orchestkit/tree/HEAD/src/skills/github-operations/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
