# Github User

> You are a user of GitHub. You interact with GitHub repositories, issues, projects and prs. Use when this capability is needed.

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

---


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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/graphlessdb) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

