github-issues-operations

AI Agent Operational Guide: GitHub Issues Knowledge Base

Purpose: Comprehensive operational guide for AI coding agents (Claude, Copilot, etc.) to manage engineering knowledge stored in GitHub Issues.

What This Repository IS:

• Complete operational guide for AI agents performing GitHub Issues operations
• Empirically-tested workflows and decision trees (200+ test cases, 88% avg AI effectiveness)
• Tool selection guidance (native gh CLI, extensions, AI models)

What This Repository IS NOT:

• The knowledge base itself (that's in GitHub Issues - the actual issues you create)
• Generic GitHub CLI documentation (see official docs for that)

Repository: https://github.com/terrylica/claude-code-skills-github-issues

---

Quick Links

• 📖 Documentation - Guides, research, and references
• 🔍 Search Guide - Native GitHub CLI search (quick start + complete reference)
• 🤖 AI Agent Guide - Operational guide for AI coding agents
• 🔌 Extensions - GitHub CLI extensions tested and recommended

---

Installation

Two installation methods available based on your needs:

1. Global User-Level (Recommended for Individual Use)

Available across ALL your Claude Code sessions.

/plugin marketplace add terrylica/claude-code-skills-github-issues
/plugin install github-issues-operations@terrylica/claude-code-skills-github-issues

Verification: Run /plugin to confirm github-issues-operations is installed.

2. Project-Local (Recommended for Teams)

Available only in THIS project. Committed to git for team access.

git submodule add https://github.com/terrylica/claude-code-skills-github-issues.git .claude/plugins/github-issues

---

📖 Complete Installation Guide: See INSTALLATION.md for:

• Prerequisites and version requirements
• Detailed installation steps (4 methods with comparison table)
• Verification and testing procedures
• Updates, uninstallation, and lifecycle management
• Troubleshooting common issues
• Team distribution and version pinning

---

🤖 For AI Agents:

This repository documents operations for managing knowledge in GitHub Issues. The actual knowledge base lives in Issues. This is your operational manual.

Quick Start: See AI_AGENT_OPERATIONAL_GUIDE.md for complete tool selection decision trees and workflows.

---

What This Repository Contains

AI Agent Operations Documented

This guide documents 5 categories of operations for AI agents managing knowledge in GitHub Issues:

1. AI-Powered Operations (gh-models) - Issue summarization, auto-labeling, Q&A, documentation generation
2. File Search Operations (gh-grep) - Regex-based file search, multi-repository search
3. Issue Search & Discovery (native gh CLI) - Content search, complex filtering, metadata queries
4. Issue Lifecycle Operations (native gh CLI) - CRUD operations, state management, comments, assignments
5. Label & Milestone Management (native gh CLI) - Label/milestone CRUD, cloning, batch operations

Complete Details: See AI_AGENT_OPERATIONAL_GUIDE.md for full operation reference, tool selection decision trees, and empirically-tested workflows.

---

Getting Started

Prerequisites

Install GitHub CLI extensions - See GITHUB_CLI_EXTENSIONS.md for installation instructions.

Search Your Knowledge Base

# Search issues with native GitHub CLI
gh search issues "authentication" --repo=terrylica/claude-code-skills-github-issues

# Search current repository
gh issue list --search "authentication"

# Filter by metadata
gh search issues --label=bug --state=open --assignee=@me

# Search files with regex (gh-grep extension)
gh grep "Bug.*critical" --owner terrylica --repo knowledgebase

AI-Powered Workflows

# List available AI models
gh models list

# Get AI assistance
gh models run "openai/gpt-4.1" "Summarize this: $(gh issue view 123 --json body --jq .body)"

---

Documentation Structure