Skip to content
cccskills
FreePublished on GitHub

github-mcp

GitHub API operations - repositories, issues, pull requests, actions, code security, discussions, gists, and more. Use for GitHub-related tasks like managing PRs, issues, searching code, and monitoring workflows.

The English summary is being prepared. Showing the original description.

Works withGitHubDocker
See how to install

Files included (10)

  • SKILL.md6.2 KB
  • commands/github-mcp.md110 B
  • hooks/post-execute.cjs2.0 KB
  • hooks/pre-execute.cjs2.5 KB
  • references/research-requirements.md483 B
  • rules/github-mcp.md445 B
  • schemas/input.schema.json257 B
  • schemas/output.schema.json618 B
  • scripts/main.cjs1.4 KB
  • templates/implementation-template.md184 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.

GitHub Skill

Overview

This skill provides access to the official GitHub MCP server with progressive disclosure for optimal context usage.

Context Savings: ~95% reduction

  • MCP Mode: ~50,000 tokens always loaded (80+ tools)
  • Skill Mode: ~500 tokens metadata + on-demand loading

Requirements

  • Docker installed and running
  • GITHUB_PERSONAL_ACCESS_TOKEN environment variable set

Toolsets

The server provides 80+ tools across 19 toolsets:

ToolsetDescription
actionsWorkflow management, runs, jobs, artifacts
code_securityScanning alerts, code analysis
discussionsForum interactions
gistsCode snippets management
issuesIssue creation, updates, commenting
labelsLabel management and filtering
projectsGitHub Projects board management
pull_requestsPR creation, review, merging
reposCode search, commits, releases, branches
usersUser search and management
orgsOrganization and team management
notificationsNotification management
secret_scanningSecret scanning alerts
contextContext about the user

Quick Reference

Use the gh CLI for GitHub operations:

# Get repository info
gh repo view anthropics/claude-code

# List issues
gh issue list --repo anthropics/claude-code

# Search code
gh search code "language:python MCP"

# Create issue
gh issue create --repo me/myrepo --title "Bug" --body "Description"

# List pull requests
gh pr list --repo anthropics/claude-code

Common Tools (Default Toolsets: 40 tools)

Repository Operations

  • search_repositories - Search for repositories
  • create_repository - Create a new repository
  • fork_repository - Fork a repository
  • list_commits - List repository commits
  • get_commit - Get commit details
  • get_file_contents - Get file contents from a repository
  • create_or_update_file - Create or update a file
  • delete_file - Delete a file
  • push_files - Push multiple files
  • search_code - Search for code across GitHub
  • list_branches - List repository branches
  • create_branch - Create a new branch
  • list_tags - List repository tags
  • get_tag - Get tag details
  • list_releases - List releases
  • get_latest_release - Get latest release
  • get_release_by_tag - Get release by tag

Issue Operations

  • list_issues - List repository issues
  • issue_read - Read issue details
  • issue_write - Create/update issues
  • add_issue_comment - Add a comment to an issue
  • search_issues - Search for issues
  • list_issue_types - List issue types (for organizations)
  • get_label - Get label details
  • sub_issue_write - Manage sub-issues
  • assign_copilot_to_issue - Assign Copilot to an issue

Pull Request Operations

  • list_pull_requests - List repository pull requests
  • pull_request_read - Read PR details
  • create_pull_request - Create a new PR
  • update_pull_request - Update a PR
  • update_pull_request_branch - Update PR branch
  • merge_pull_request - Merge a PR
  • search_pull_requests - Search for pull requests
  • pull_request_review_write - Create/submit PR reviews
  • add_comment_to_pending_review - Add comments to pending review
  • request_copilot_review - Request Copilot review

User & Team Operations

  • get_me - Get current authenticated user
  • search_users - Search for users
  • get_teams - Get organization teams
  • get_team_members - Get team members

Configuration

The skill uses Docker to run the official GitHub MCP server:

  • Image: ghcr.io/github/github-mcp-server
  • Auth: GITHUB_PERSONAL_ACCESS_TOKEN environment variable

Environment Variables

VariableRequiredDescription
GITHUB_PERSONAL_ACCESS_TOKENYesGitHub PAT for authentication
GITHUB_HOSTNoFor GitHub Enterprise (default: github.com)
GITHUB_TOOLSETSNoComma-separated toolsets to enable
GITHUB_READ_ONLYNoSet to 1 for read-only mode

Limiting Toolsets

When using MCP, configure toolsets via environment variables:

# Only repos and issues
GITHUB_TOOLSETS=repos,issues

# Only pull requests and code security
GITHUB_TOOLSETS=pull_requests,code_security

Error Handling

If operations fail:

  1. Verify Docker is running: docker ps
  2. Check GitHub token is set: echo $GITHUB_PERSONAL_ACCESS_TOKEN
  3. Ensure token has required permissions for the operation
  4. Use gh auth status to verify authentication

Related

Memory Protocol (MANDATORY)

Before starting: Read .claude/context/memory/learnings.md

After completing:

  • New pattern -> .claude/context/memory/learnings.md
  • Issue found -> .claude/context/memory/issues.md
  • Decision made -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Ensure accessibility in UI components including semantic HTML, ARIA attributes, keyboard navigation, and WCAG 2.2 AA compliance.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Use when you want to improve response quality through meta-cognitive reasoning. Applies 15+ reasoning methods to reconsider and refine initial outputs.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

N-round opposing-stance debates for trade-off analysis. Assigns pro/con roles to agents, runs structured debate rounds with quality scoring, and produces a moderator synthesis with confidence-rated recommendation. Generalizable to architecture, technology, security, and design decisions.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Force adversarial code review stance that eliminates confirmation bias — reviewer must find issues or re-analyze

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

Creates specialized AI agents on-demand when no existing agent matches a request. Use when the Router cannot find a suitable agent for a task. Enables self-evolution by generating persistent agents.

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

LLM-as-judge evaluation framework with 5-dimension rubric (accuracy, groundedness, coherence, completeness, helpfulness) for scoring AI-generated content quality with weighted composite scores and evidence citations

The English summary is being prepared. Showing the original description.

oimiragieo/agent-studio43Updated Jul 14, 2026

See all skills by oimiragieo

Report a problem with this skill