Github Skill

GitHub Skill

Comprehensive GitHub integration with 25 tools for repositories, issues, pull requests, branches, releases, and GitHub Actions.

Overview

This skill provides full access to the GitHub API, enabling automation of development workflows. It uses the GitHub REST API v3 with Bearer token authentication.

When to Use This Skill

Use this skill when you need to:

• Create, manage, and fork repositories
• List, create, update, close issues and add comments
• Work with pull requests (create, merge, review, request reviewers)
• Manage branches (create, delete, list)
• Create and list releases
• Trigger GitHub Actions workflows

Prerequisites

1. GitHub Account: An active GitHub account
2. Personal Access Token: A token with appropriate permissions

Getting a Personal Access Token

1. Go to https://github.com/settings/tokens
2. Click "Generate new token" > "Generate new token (classic)"
3. Select scopes:

• repo - Full repository access
• workflow - Actions workflow access
• read:org - Read organization info

1. Generate and copy the token

Configuration

Set the token as an environment variable:

export SKILL_GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Tools

Repository Tools (5)

repo-list

List repositories for user or organization.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | org | string | No | - | Organization name | | type | string | No | all | Filter: all, owner, member, private, public | | sort | string | No | updated | Sort: created, updated, pushed, fullname | | perpage | number | No | 30 | Results per page (max 100) |

repo-get

Get detailed repository information.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format |

repo-create

Create a new repository.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | name | string | Yes | - | Repository name | | description | string | No | - | Repository description | | private | boolean | No | false | Make private | | org | string | No | - | Organization to create in | | auto_init | boolean | No | false | Initialize with README |

repo-delete

Delete a repository (requires admin access).

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format |

repo-fork

Fork a repository.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository to fork | | organization | string | No | Org to fork to | | name | string | No | Name for forked repo |

Issue Tools (6)

issue-list

List issues in a repository.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | state | string | No | open | Filter: open, closed, all | | assignee | string | No | - | Filter by assignee | | labels | string | No | - | Filter by labels (comma-separated) | | per_page | number | No | 30 | Results per page |

issue-get

Get detailed issue information.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | issue_number | number | Yes | Issue number |

issue-create

Create a new issue.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | title | string | Yes | Issue title | | body | string | No | Issue description | | labels | string | No | Labels (comma-separated) | | assignees | string | No | Assignees (comma-separated) |

issue-update

Update an existing issue.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | issue_number | number | Yes | Issue number | | title | string | No | New title | | body | string | No | New body | | state | string | No | State: open or closed | | labels | string | No | Labels (replaces existing) | | assignees | string | No | Assignees (replaces existing) |

issue-close

Close an issue.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | issuenumber | number | Yes | - | Issue number | | reason | string | No | completed | Reason: completed or notplanned |

issue-comment

Add a comment to an issue.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | issue_number | number | Yes | Issue number | | body | string | Yes | Comment text |

Pull Request Tools (7)

pr-list

List pull requests.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | state | string | No | open | Filter: open, closed, all | | head | string | No | - | Filter by head branch | | base | string | No | - | Filter by base branch | | per_page | number | No | 30 | Results per page |

pr-get

Get detailed PR information.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | pr_number | number | Yes | PR number |

pr-create

Create a new pull request.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | title | string | Yes | - | PR title | | head | string | Yes | - | Branch with changes | | base | string | Yes | - | Branch to merge into | | body | string | No | - | PR description | | draft | boolean | No | false | Create as draft |

pr-merge

Merge a pull request.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | prnumber | number | Yes | - | PR number | | mergemethod | string | No | merge | Method: merge, squash, rebase | | committitle | string | No | - | Commit title | | commitmessage | string | No | - | Commit message |

pr-close

Close a PR without merging.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | pr_number | number | Yes | PR number |

pr-review

Submit a PR review.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | prnumber | number | Yes | PR number | | event | string | Yes | Action: APPROVE, REQUESTCHANGES, COMMENT | | body | string | No | Review comment |

pr-request-reviewers

Request reviewers for a PR.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | prnumber | number | Yes | PR number | | reviewers | string | No | Usernames (comma-separated) | | teamreviewers | string | No | Team slugs (comma-separated) |

Branch Tools (3)

branch-list

List branches.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | protected | boolean | No | false | Only show protected branches | | per_page | number | No | 30 | Results per page |

branch-create

Create a new branch.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | branch | string | Yes | New branch name | | from | string | No | Source branch or SHA (defaults to default branch) |

branch-delete

Delete a branch.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | branch | string | Yes | Branch name to delete |

Release Tools (2)

release-list

List releases.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | per_page | number | No | 30 | Results per page |

release-create

Create a new release.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | tagname | string | Yes | - | Tag name for release | | name | string | No | - | Release title | | body | string | No | - | Release notes | | targetcommitish | string | No | - | Branch or commit to tag | | draft | boolean | No | false | Create as draft | | prerelease | boolean | No | false | Mark as pre-release | | generatereleasenotes | boolean | No | false | Auto-generate notes |

Actions/Workflow Tools (2)

workflow-list

List workflows.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | repo | string | Yes | - | Repository in "owner/repo" format | | per_page | number | No | 30 | Results per page |

workflow-run

Trigger a workflow run.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | repo | string | Yes | Repository in "owner/repo" format | | workflow_id | string | Yes | Workflow ID or filename (e.g., "ci.yml") | | ref | string | Yes | Branch or tag to run on | | inputs | string | No | Workflow inputs as JSON |

Examples

Create Repository and Initialize

# Create repo
skill run github-skill repo-create name=my-project description="New project" private=true

# Create initial issue
skill run github-skill issue-create repo=myuser/my-project title="Setup project" labels=setup

PR Workflow

# Create feature branch
skill run github-skill branch-create repo=owner/repo branch=feature/auth from=main

# After pushing commits, create PR
skill run github-skill pr-create repo=owner/repo title="Add auth" head=feature/auth base=main

# Request reviewers
skill run github-skill pr-request-reviewers repo=owner/repo pr_number=42 reviewers=reviewer1,reviewer2

# Merge PR
skill run github-skill pr-merge repo=owner/repo pr_number=42 merge_method=squash

Release Workflow

# Create release
skill run github-skill release-create repo=owner/repo tag_name=v1.0.0 name="Version 1.0.0" generate_release_notes=true

Rate Limits

• Authenticated: 5,000 requests/hour
• Search API: 30 requests/minute

Troubleshooting

| Error | Solution | |-------|----------| | 401 Unauthorized | Check GITHUB_TOKEN is set correctly | | 403 Forbidden | Token lacks permissions or rate limited | | 404 Not Found | Check repo exists and you have access | | 422 Validation | Invalid parameters (e.g., branch exists) |

Resources

• GitHub REST API
• Personal Access Tokens
• GitHub CLI

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kubiyabot
• Source: kubiyabot/skill
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.