github-project-skills

GitHub Project Management Agent Skills

Overview

This repository is a collection of specialized Agent Skills and Subagents designed to automate and streamline GitHub workflows by leveraging the GitHub CLI (gh). These skills empower AI agents (like Cursor, Claude Code, or Gemini CLI) to interact deeply with GitHub issues, milestones, labels, and project boards, enabling autonomous project management and triage.

Your browser does not support the video tag.

Key Features

• Zero-Config Authentication: Leverages the GitHub CLI (gh command) for authentication, eliminating the need to manage Personal Access Tokens (PATs).
• Repo-Level Project Config: A single .github/project-config.json file declares the active GitHub project and repository context. After one-time setup, all agent sessions auto-verify silently — no repeated confirmation prompts.
• Triage Automation: Automatically categorize, label, and assign incoming issues based on content analysis.
• Project Synchronization: Keep GitHub Project boards (v2) in sync with repository state, moving items through statuses and updating custom fields.
• Issue Lifecycle Management: Automate common tasks such as creating, closing, locking, and transferring issues across repositories.
• Advanced Discovery: Perform complex searches for issues and pull requests to identify duplicates or related work.
• Balanced Granularity: Skills are consolidated into high-level "Managers" (Issues, Projects) to reduce token consumption and latency while maintaining modularity.

Use Cases

Learn how to leverage this repository for common GitHub workflows:

• Initial Project Config Setup: One-time setup to declare the active project and enable silent auto-verification.
• Automated Issue Triage: Categorize and assign incoming issues automatically using gh-issue-management.
• Project Board Sync: Keep your Project v2 boards in sync with repository state using gh-project-management.
• Sprint Planning: Organize work into milestones and target versions using gh-issue-management and gh-project-management.
• Repo Reorganization: Smoothly transfer issues between repositories using gh-issue-management.

Standards

All skills in this repository comply with the Agent Skills Specification, ensuring consistent naming, metadata extraction, and progressive disclosure patterns.

Agents

• github-project-manager: Technical project manager agent. Use proactively to synchronize repository work with GitHub Project boards.
• github-triage-agent: Expert triage agent. Use proactively to categorize, label, and assign new issues.

Agent Skills

• gh-set-active-project: One-time interactive setup that writes .github/project-config.json to declare the active GitHub project and repository. Run once per repository to enable silent auto-verification for all subsequent sessions.
• gh-issue-management: Comprehensive management of GitHub issues, including sub-issue hierarchies. Use to create, update, close, list, search, view, comment on, and manage parent-child relationships between issues in a single skill.
• gh-project-management: Comprehensive management of GitHub Projects (v2). Use to list projects, view items, add items, update fields, and manage project structure in a single skill.
• gh-verifying-context: Verifies the current GitHub authentication status and repository against .github/project-config.json. Proceeds silently when the environment matches the config; alerts only on mismatch or missing config.
• gh-linking-branches-to-issues: Creates and links a development branch to an issue. Use to start implementation work.

Installation

Claude Code Plugin (Recommended)

This repository is available as a Claude Code plugin. Install it directly from the built-in custom marketplace:

# 1. Add this repository as a custom marketplace
/plugin marketplace add yu-iskw/github-project-skills

# 2. Install the plugin
/plugin install github-project-skills@github-project-skills

# 3. Activate (reload plugins)
/reload-plugins

This installs all 5 agent skills and 2 subagents into Claude Code automatically.