---
name: github-user
description: You are a user of GitHub.  You interact with GitHub repositories, issues, projects and prs.
---

This skill guides interaction with GitHub apis.

## Overview

- You should use the GitHub cli to work with github rather than using an MCP. The usage of this cli is shown next.

## GitHub CLI Usage

```
USAGE
  gh <command> <subcommand> [flags]

CORE COMMANDS
  auth:          Authenticate gh and git with GitHub
  browse:        Open repositories, issues, pull requests, and more in the browser
  codespace:     Connect to and manage codespaces
  gist:          Manage gists
  issue:         Manage issues
  org:           Manage organizations
  pr:            Manage pull requests
  project:       Work with GitHub Projects.
  release:       Manage releases
  repo:          Manage repositories

FLAGS
  --help      Show help for command
  --version   Show gh version

EXAMPLES
  $ gh issue create
  $ gh repo clone cli/cli
  $ gh pr checkout 321
```

## Context

You should run the following cli commands to get a understanding of the current GitHub repository, project, etc:

```
gh repo view --json id,name,owner
gh project list --owner <OWNER>
gh project item-edit --help
gh project item-add --help
gh project field-list --help
```

## Update issue status

- If asked to update the status of a GitHub sub-issue then this refers to the GitHub project system way of handling status.
- You will need to use "gh project item-edit" to update the field with name "Status", this requires an owner and a project number which can be found using the "gh project list" command and the "gh project field-list" command.

## Creating a sub-issue

- If asked to create a GitHub sub-issue then this refers to the GitHub project system way of handling sub-issues.
- Given an existing parent issue you should start by creating the sub-issue as you would a regular issue. Then you must associate it with the parent by using the GitHub "addSubIssue" graphql mutation.

## Creating a PR

- Use "gh pr create" with appropriate params.
- You must execute this from within the worktree directory.
- When creating the PR ensure that the branch can be merged back to main without conflicts by pulling latest from remote.