project-manager

Manages GitHub Issues, labels, milestones, and Projects V2 for task tracking workflows.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/kai-kou/gem-hunter --skill project-manager-kai-kou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-manager
Source: https://github.com/kai-kou/gem-hunter/tree/main/.claude/skills/project-manager
Command: npx skills add https://github.com/kai-kou/gem-hunter --skill project-manager-kai-kou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping GitHub project state consistent is tedious: new work requests need to become Issues, statuses must be updated as work progresses, and milestones need to reflect actual completion. This Skill standardizes that entire task-management loop so nothing falls through the cracks. ## Core Features & Use Cases - Issue Creation from Instructions: Converts new work requests into properly labeled Issues (type/status/priority/sp labels), including Epic-style parent Issues with Destination, Not yet specified, and Out of scope sections for large ambiguous work. - Status & Milestone Management: Updates status labels and Projects V2 fields as work moves from in-progress to review to done, and closes milestones when all contained Issues are complete. - Dual Execution Paths: Uses GitHub MCP tools (mcp__github__*) as the primary route in cloud environments and gh CLI commands as the local fallback, with documented constraints for each. - Use Case: A user says "create a task for fixing the search pagination bug and mark it high priority" — the Skill creates a labeled Issue, links it to the right milestone, and sets status:in-progress when work begins. ## Quick Start Ask the assistant to create a GitHub Issue for your next task and update the milestone progress on kai-kou/gem-hunter.

Frequently Asked Questions about project-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub Issue from a new task request?▼

The Skill converts work instructions into Issues using mcp__github__issue_write in cloud environments or gh issue create locally. It applies type, priority, and story-point labels, and links the Issue to a milestone when one is relevant.

How to update GitHub Projects V2 status from the command line?▼

Use gh project field-list and item-list to get field and item IDs, then gh project item-edit with the status field and option IDs. This only works locally since Projects V2 GraphQL is blocked in cloud environments, where status:* Issue labels serve as the substitute.

What is the difference between project-manager and project-sync?▼

project-manager handles active task operations: creating Issues, updating statuses, and managing milestones. project-sync handles passive repository hygiene like resetting stale Issues, resolving orphan PRs, and detecting abandoned branches. Both share the same label taxonomy.

Why do gh commands fail in cloud Claude environments?▼

Cloud environments block repo-scope gh REST and GraphQL calls with 403 errors through an egress proxy, and only a shim exists on PATH. Issue and PR operations must use GitHub MCP tools instead, with gh commands reserved for local execution.

How should large ambiguous tasks be structured as GitHub Issues?▼

Create an Epic Issue with Destination, Not yet specified, and Out of scope sections. Only create child Issues for questions that can already be stated precisely; leave vague areas in Not yet specified until prerequisites clarify them.