How does the skill decide between gh CLI and MCP?

It uses a hierarchy that prefers the gh CLI for standard operations like PRs and issues if installed, falling back to the GitHub MCP Server for complex searches or when the CLI is unavailable.

Does this skill help with GitHub authentication?

Yes, it includes verification patterns to check your 'gh' auth status and provides the specific commands needed to log in or set up environment variables if they are missing.

When should I use the MCP server instead of the CLI?

Use the MCP server for complex search queries across multiple repositories, bulk data retrieval, or lower-level API access that the gh CLI does not natively support.

What permissions are required for the GitHub MCP integration?

It requires a GITHUB_PERSONAL_ACCESS_TOKEN with 'repo', 'read:org', and 'read:user' scopes configured in your environment.

Can I use this with my existing repository PR templates?

This skill is designed to prioritize a specific minimalist 'Problem/Solution' format and will instruct Claude to ignore standard PR templates to ensure consistency and brevity.

GitHub Workflow Optimizer

Name: GitHub Workflow Optimizer
Author: racurry

byracurry

0•

Developer Tools

Streamlines GitHub interactions by intelligently selecting between GitHub CLI and MCP tools while enforcing standardized pull request formats.

This skill provides a robust decision framework for GitHub operations, prioritizing the official GitHub CLI (gh) for standard tasks like PR management and issue tracking while seamlessly falling back to GitHub MCP servers for complex cross-repository queries or bulk data retrieval. It ensures consistency across development environments by enforcing a specific, minimalist 'Problem/Solution' pull request format, automating environment checks, and providing clear guidance for authentication and tool installation. By removing boilerplate and emoji-heavy templates, it helps developers maintain a professional and terse communication style directly from Claude Code.

Key Features

010 GitHub stars

02Enforced 'Problem/Solution' pull request description formatting with multi-problem support

03Streamlined environment variable configuration for GitHub PAT access

04Intelligent tool selection hierarchy between gh CLI and GitHub MCP Server

05Automated GitHub CLI availability and authentication status checks

06Detailed fallback logic for complex GraphQL or bulk API operations

Use Cases

01Automating the selection of the most efficient tool for repository management and issue tracking

02Generating clean, standardized pull requests that skip repository-level boilerplate

03Troubleshooting and configuring GitHub environment access within Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add racurry/neat-little-package github-workflow

For use in Claude.ai and ChatGPT

Download Skill