Agent skill

github

Interact with GitHub repositories, issues, pull requests, and code via the GitHub MCP server. This skill should be used when managing repositories, creating/updating files, working with issues and PRs, searching code/repos/users, creating branches, and performing code reviews. Supports all major GitHub API operations.

View SKILL.md on GitHub Repository
Stars 5
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/huynguyen03dev/opencode-setup/tree/main/skills/github

SKILL.md

GitHub

Base directory for this skill: /home/hazeruno/.config/opencode/skills/github

Interact with GitHub repositories through the Model Context Protocol (MCP) server for GitHub.

When to Use

  • Managing repository files (create, update, get contents)
  • Working with issues (create, update, list, comment)
  • Managing pull requests (create, review, merge, get status)
  • Searching GitHub (repositories, code, issues, users)
  • Creating and managing branches
  • Forking repositories

Quick Start

Run the CLI script with bun (use absolute path):

bash
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts <command> [options]

Available Commands

Repository Operations

Command Description
create-repository Create a new GitHub repository
fork-repository Fork a repository to your account
search-repositories Search for repositories

File Operations

Command Description
get-file-contents Get file or directory contents
create-or-update-file Create or update a single file
push-files Push multiple files in a single commit

Branch Operations

Command Description
create-branch Create a new branch
list-commits List commits in a repository

Issue Operations

Command Description
create-issue Create a new issue
get-issue Get issue details
list-issues List repository issues
update-issue Update an existing issue
add-issue-comment Add a comment to an issue

Pull Request Operations

Command Description
create-pull-request Create a new PR
get-pull-request Get PR details
list-pull-requests List repository PRs
get-pull-request-files Get files changed in PR
get-pull-request-status Get PR status checks
get-pull-request-comments Get PR review comments
get-pull-request-reviews Get PR reviews
create-pull-request-review Create a PR review
merge-pull-request Merge a PR
update-pull-request-branch Update PR branch from base

Search Operations

Command Description
search-repositories Search repositories
search-code Search code across GitHub
search-issues Search issues and PRs
search-users Search GitHub users

Global Options

  • -t, --timeout <ms>: Call timeout (default: 30000)
  • -o, --output <format>: Output format: text | markdown | json | raw

Common Examples

bash
# Get file contents
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts get-file-contents \
  --owner facebook --repo react --path README.md

# Create an issue
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts create-issue \
  --owner myorg --repo myrepo --title "Bug report" --body "Description here"

# List open PRs
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts list-pull-requests \
  --owner facebook --repo react --state open

# Search code
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts search-code \
  --q "useState filename:*.tsx"

# Create a PR review
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts create-pull-request-review \
  --owner myorg --repo myrepo --pull-number 123 \
  --body "LGTM!" --event APPROVE

Requirements

  • Bun runtime
  • mcporter package (embedded in script)
  • GITHUB_TOKEN environment variable for authentication

Resources

  • scripts/github.ts - Main CLI tool wrapping GitHub MCP server
  • references/api_reference.md - Detailed parameter documentation for all commands

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

huynguyen03dev/opencode-setup

context7

Fetch up-to-date documentation and code examples for any library or framework. Use when needing API references, code examples, library documentation, or framework guides. Supports React, Next.js, MongoDB, Supabase, and thousands of other libraries.

5 0
Explore
huynguyen03dev/opencode-setup

code-review

Use when receiving code review feedback (especially if unclear or technically questionable), when completing tasks or major features requiring review before proceeding, or before making any completion/success claims. Covers three practices - receiving feedback with technical rigor over performative agreement, requesting reviews via code-reviewer subagent, and verification gates requiring evidence before any status claims. Essential for subagent-driven development, pull requests, and preventing false completion claims.

5 0
Explore
huynguyen03dev/opencode-setup

gh-grep

Search real-world code examples across millions of GitHub repositories using grep.app. This skill should be used when looking for implementation patterns, API usage examples, library integration patterns, or production code references. Supports literal code search, regex patterns, and filtering by language/repo/path.

5 0
Explore
huynguyen03dev/opencode-setup

deep-wiki

Access AI-generated documentation and insights for GitHub repositories via DeepWiki. This skill should be used when exploring unfamiliar codebases, understanding repository architecture, finding implementation patterns, or asking questions about how a GitHub project works. Supports any public GitHub repository.

5 0
Explore
huynguyen03dev/opencode-setup

gkg

Global Knowledge Graph for codebase analysis. This skill should be used when searching for code definitions (functions, classes, methods), finding references to symbols, understanding code structure, analyzing import usage, generating repository maps, or performing impact analysis before refactoring. Supports TypeScript, JavaScript, Python, Java, and more.

5 0
Explore
huynguyen03dev/opencode-setup

chrome-devtools

Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.

5 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results