issue-management_skill

Overview

This skill provides comprehensive GitHub issue lifecycle management with templates, metadata controls, and context-aware automation. Use it to create, update, label, assign, link, and close issues with consistent structure and optional templates. It complements automatic hooks by offering direct, manual control when you need specific templates or bulk operations.

How this skill works

The skill exposes utilities for rendering structured templates (bug, feature, epic, task) and for creating or editing issues via GitHub CLI patterns. It detects context from branch names, state files, detected work type, and session info to suggest labels and linkages automatically. It also supports searching, bulk creation, adding branch references, and maintaining mapping state files under .claude/logs.

When to use it

• Create issues with predefined templates or custom rendered bodies
• Update labels, assignees, milestones, or the issue body after creation
• Link issues as parent-child or related and add branch references
• Search and filter issues before creating to avoid duplicates
• Create or update multiple issues at once or sync plan files to issues

Best practices

• Use templates for reproducible, reviewable issue content
• Detect and apply work-type labels automatically from titles/descriptions
• Search existing issues first to prevent duplicates
• Link parent/child and related issues to preserve traceability
• Keep .claude/logs state files updated when creating or syncing issues

Example use cases

• Create a bug report using getBugTemplate() and renderTemplate() with repro steps and environment details
• Turn a plan file into an epic issue and save the mapping in plan-issues.json
• Detect work type from a title and add corresponding labels like bug or enhancement
• Bulk-create related tasks for an epic using a small script and consistent labels
• Update an issue with branch info and post progress comments when switching branches