GitHub Integration

Pro v1.0.0

Manage GitHub repositories, issues, pull requests, releases, and workflows using the official GitHub CLI

Requires Claude Code CLI

This skill integrates with GitHub through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Repositories

List repositories for the authenticated user or an organization

Parameters

Name Type Required Description
owner string Optional Filter by repository owner (user or organization)
limit integer Optional Maximum number of results to return

Try saying...

  • "List my GitHub repositories"
  • "Show all repos for organization kubernetes"
  • "List the first 50 repositories I have access to"

Create Repository

Create a new GitHub repository

Parameters

Name Type Required Description
name string Required Repository name
visibility string Optional Repository visibility
description string Optional Repository description

Try saying...

  • "Create a new public repository called awesome-project"
  • "Create a private repo named my-secret-project with description 'Internal tools'"

Clone Repository

Clone a repository to the local machine

Parameters

Name Type Required Description
repository string Required Repository in 'owner/repo' format

Try saying...

  • "Clone the repository kubernetes/kubernetes"
  • "Clone torvalds/linux to my machine"

View Repository

View repository details and metadata

Parameters

Name Type Required Description
repository string Optional Repository in 'owner/repo' format (defaults to current repo)

Try saying...

  • "Show me details for the kubernetes/kubernetes repository"
  • "View info about the current repository"

List Issues

List issues in a repository

Parameters

Name Type Required Description
state string Optional Filter by issue state
assignee string Optional Filter by assignee (@me for current user)
label string Optional Filter by label

Try saying...

  • "List all open issues in the current repository"
  • "Show me all my assigned issues"
  • "List closed issues with label bug"

Create Issue

Create a new issue in a repository

Parameters

Name Type Required Description
title string Required Issue title
body string Optional Issue description
label string[] Optional Labels to add

Try saying...

  • "Create a new issue about the broken login button"
  • "File a bug report for the search feature"

View Issue

Display details of a specific issue

Parameters

Name Type Required Description
number integer Required Issue number

Try saying...

  • "Show me issue #42"
  • "View details of issue 123"

Close Issue

Close an issue

Parameters

Name Type Required Description
number integer Required Issue number to close
comment string Optional Comment to add when closing

Try saying...

  • "Close issue #42"
  • "Close issue 123 with comment 'Resolved'"

List Pull Requests

List pull requests in a repository

Parameters

Name Type Required Description
state string Optional Filter by PR state
author string Optional Filter by author (@me for current user)

Try saying...

  • "List all open pull requests"
  • "Show me all PRs I've created"
  • "List merged pull requests"

Create Pull Request

Create a new pull request

Parameters

Name Type Required Description
title string Required Pull request title
body string Optional Pull request description
base string Optional Base branch to merge into

Try saying...

  • "Create a pull request for my feature branch"
  • "Open a PR to merge my changes into main"

View Pull Request

Display details of a specific pull request

Parameters

Name Type Required Description
number integer Required Pull request number

Try saying...

  • "Show me pull request #42"
  • "View details of PR 456"

Checkout Pull Request

Check out a pull request branch locally for testing

Parameters

Name Type Required Description
number integer Required Pull request number

Try saying...

  • "Check out pull request #42 to test it locally"
  • "Switch to the branch for PR 456"

Merge Pull Request

Merge a pull request

Parameters

Name Type Required Description
number integer Required Pull request number to merge
merge_method string Optional How to merge the PR

Try saying...

  • "Merge pull request #42"
  • "Squash and merge PR 456"

Review Pull Request

Add a review to a pull request

Parameters

Name Type Required Description
number integer Required Pull request number
action string Optional Review action
body string Optional Review comment

Try saying...

  • "Approve pull request #42"
  • "Request changes on PR 456"
  • "Add a comment to PR 789"

List Releases

List releases in a repository

Parameters

Name Type Required Description
limit integer Optional Maximum number of releases to show

Try saying...

  • "Show all releases for this project"
  • "List the last 10 releases"

Create Release

Create a new release

Parameters

Name Type Required Description
tag string Required Git tag for the release
title string Optional Release title
notes string Optional Release notes

Try saying...

  • "Create a new release v1.0.0"
  • "Publish release v2.1.0 with notes"

Download Release Assets

Download assets from a release

Parameters

Name Type Required Description
tag string Optional Release tag (defaults to latest)
pattern string Optional File pattern to match

Try saying...

  • "Download assets from the latest release"
  • "Download all .tar.gz files from release v1.0.0"

List Workflows

List GitHub Actions workflows in a repository

Try saying...

  • "Show all workflows in this repository"
  • "List available GitHub Actions workflows"

Run Workflow

Trigger a workflow run

Parameters

Name Type Required Description
workflow string Required Workflow name or ID
ref string Optional Branch or tag to run workflow on

Try saying...

  • "Run the CI workflow"
  • "Trigger the deploy workflow on branch staging"

View Workflow Runs

View recent workflow runs

Parameters

Name Type Required Description
workflow string Optional Filter by workflow name
limit integer Optional Maximum number of runs to show

Try saying...

  • "Show recent workflow runs"
  • "List the last 10 CI workflow runs"

List Gists

List your gists

Parameters

Name Type Required Description
limit integer Optional Maximum number of gists to show

Try saying...

  • "List all my gists"
  • "Show my recent gists"

Create Gist

Create a new gist from a file

Parameters

Name Type Required Description
file string Required File to create gist from
visibility string Optional Gist visibility
description string Optional Gist description

Try saying...

  • "Create a public gist from script.sh"
  • "Create a secret gist with my notes"

View Gist

Display gist contents

Parameters

Name Type Required Description
gist_id string Required Gist ID

Try saying...

  • "Show me gist abc123"
  • "View the contents of gist def456"

Getting Started

CLI Authentication Easy Setup
  1. 1 Install the CLI: brew install gh (macOS) or follow Linux instructions
  2. 2 Run: gh auth login
  3. 3 Follow interactive prompts to authenticate via browser
  4. 4 CLI stores token securely for subsequent commands

Verify Setup

gh auth status

Success: Logged in to github.com

Security & Access

Access Scope

Full access to repositories, issues, pull requests, and other GitHub resources accessible by the authenticated account

  • The CLI has full access to your GitHub account and all repositories you can access
  • Be careful when creating or deleting repositories, merging PRs, or managing releases
  • On shared systems, use 'gh auth logout' when finished
  • Regularly review authorized applications at https://github.com/settings/apps/authorizations

Limitations

  • Some advanced GitHub features may require direct API access
  • Enterprise features require GitHub Enterprise Server authentication

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
CLI
Auth
CLI Authentication
Setup
Easy Setup
Tools Required
Bash
CLI Dependencies
gh

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements