mcpField
G
github

github

github.com/johnlindquistDevelopment2638 installsUpdated 45w ago
Repository

About github

github is a GitHub issue-management skill for people handling issue workflows with the `gh` CLI. It covers creating, filtering, viewing, editing, assigning, and closing issues, and requires loading operation-specific references before running commands.

Key features

  1. 01Create issues from conversation context
  2. 02List and filter issues
  3. 03View issue details and comments
  4. 04Edit titles, bodies, labels, and assignees
  5. 05Assign and close issues

Use cases

  1. 01Turn a reported bug into an issue
  2. 02Triage open issues by state or label
  3. 03Assign issues during sprint planning
  4. 04Close resolved issues with a comment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/johnlindquist/claude --skill github

After installing, type/githubin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

ASSIGN_ISSUE.md
CLOSE_ISSUE.md
CREATE_ISSUE.md
LIST_ISSUES.md
UPDATE_ISSUE.md
VIEW_ISSUE.md

Details

From the project README

GitHub Issues Manager

Complete GitHub issue management using the gh CLI tool. This Skill provides comprehensive capabilities for creating, viewing, updating, and managing GitHub issues.

Capabilities

  1. Create issues - Create new GitHub issues with context from conversations
  2. List issues - View and filter issues by state, labels, assignees
  3. View issues - Display full issue details including comments
  4. Update issues - Modify titles, bodies, labels, and assignees
  5. Close issues - Close issues with optional closing comments
  6. Assign issues - Assign issues to team members

Quick Reference

For detailed instructions on each operation, see:

Common Workflows

Bug reporting workflow
  1. User reports a bug in conversation
  2. Create issue with /create-issue or ask me to create one
  3. Issue is created with context from our discussion
  4. Assign to appropriate team member
  5. Add labels (bug, priority, etc.)
Issue triage workflow
  1. List open issues with filters
  2. View specific issues for details
  3. Update labels and assignments
  4. Close resolved issues with status updates
Sprint planning workflow
  1. List issues by label or milestone
  2. Assign issues to team members
  3. Update priorities and estimates
  4. Track progress through status updates

Critical Instructions

REQUIRED: Before executing ANY GitHub issue operations, you MUST load the relevant reference file(s) using the Read tool. These references contain essential command patterns, parameters, and workflows that are NOT included in this overview.

When the user asks to work with GitHub issues:

  1. Identify the operation they want to perform (create, list, view, update, close, assign)
  2. MANDATORY: Load the relevant reference file(s) using the Read tool BEFORE executing any commands:
    • Creating issues → Read CREATE_ISSUE.md FIRST
    • Listing issues → Read LIST_ISSUES.md FIRST
    • Viewing issues → Read VIEW_ISSUE.md FIRST
    • Updating issues → Read UPDATE_ISSUE.md FIRST
    • Closing issues → Read CLOSE_ISSUE.md FIRST
    • Assigning issues → Read ASSIGN_ISSUE.md FIRST
  3. Execute the gh CLI commands following the exact patterns from the loaded reference
  4. Use temporary files for issue bodies to avoid markdown conflicts (as specified in references)
  5. Confirm actions and display results

DO NOT attempt to execute GitHub issue commands without first loading and reading the relevant reference documentation.

Best Practices

  • Always use --body-file for issue bodies to avoid shell escaping issues
  • Use $$ in temp file names to avoid conflicts (expands to process ID)
  • Format issue bodies with proper markdown structure
  • Include context from conversations when creating issues
  • Clean up temp files after operations
  • Display issue URLs so users can navigate to GitHub

Examples

Create an issue from context
User: "I found a bug where login fails with special characters"
Me: *Creates issue with details from conversation*
List and filter issues
User: "Show me all open bugs assigned to alice"
Me: gh issue list --state open --label bug --assignee alice
Update an issue
User: "Add high-priority label to issue #123"
Me: gh issue edit 123 --add-label "high-priority"
Close with context
User: "Close issue #456, it was fixed in the last PR"
Me: gh issue close 456 --comment "Fixed in PR #789"

Comments

Markdown supported