issue

Automate GitHub issue lifecycle from creation to closure with synchronized local files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/0xxmemo/litellmctl --skill issue-0xxmemo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue
Source: https://github.com/0xxmemo/litellmctl/tree/main/skills/issue
Command: npx skills add https://github.com/0xxmemo/litellmctl --skill issue-0xxmemo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the GitHub issue lifecycle: file new issues from descriptions, seed ISSUE.md and DISCOVERY.md, and guide the team through create, plan, execute, and close flows with consistent structure across the repository.

Core Features & Use Cases

  • Create: file a new GitHub issue from a description, then seed ISSUE.md and DISCOVERY.md.
  • Edit: rewrite the remote issue body and refresh the local ISSUE.md, then re-evaluate DISCOVERY.md.
  • Plan: extend DISCOVERY.md and produce PLAN.md (bootstrapping from an existing issue number).
  • Execute: implement the plan without mutating remote state.
  • Close: push avenue branches and open PRs in dependency order, each with a Closes #N hook so the issue can auto-close on merge.
  • DRY Discovery: DISCOVERY.md and PLAN.md are rewritten in full to reflect the current understanding—never appended as a changelog.

Quick Start

Create a new GitHub issue from a description and seed ISSUE.md and DISCOVERY.md for it.

Frequently Asked Questions about issue

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

FAQPage Schema
How do I automate GitHub issue lifecycle management from creation to closure?

Automate GitHub issue lifecycle management by using subcommands to create, edit, plan, execute, and close issues. The workflow seeds local ISSUE.md and DISCOVERY.md files, rewrites planning documents in full to reflect current understanding, and organizes local state within a dedicated issues directory.

What is the best way to keep DISCOVERY.md and PLAN.md synchronized with GitHub issues?

Keep DISCOVERY.md and PLAN.md synchronized by rewriting them in full during the plan and edit phases to reflect the current project understanding, rather than appending changelog entries, ensuring discovery and planning documents stay aligned with the remote GitHub issue state.

Can I automatically close GitHub issues when merging pull requests?

Automatically close GitHub issues by pushing avenue branches and opening pull requests in dependency order, each containing a Closes #N hook. This ensures the remote GitHub issue auto-closes upon successful pull request merge without manual intervention.

Does this issue workflow tool require external dependencies to manage local state?

No external dependencies are required to manage local state. The tool operates independently, utilizing a single issues/<number>-<slug>/ directory structure to organize local ISSUE.md files, DISCOVERY.md, and PLAN.md without relying on additional components.

How do I implement a GitHub issue plan without mutating remote repository state?

Implement a GitHub issue plan without mutating remote state by using the execute subcommand. This action processes the local PLAN.md and DISCOVERY.md to implement the planned changes locally, leaving the remote GitHub repository untouched until you explicitly close the issue.

When should I rewrite planning documents instead of appending changelogs in issue workflows?

Rewrite planning documents instead of appending changelogs whenever your project understanding evolves during the create, edit, or plan phases. This DRY discovery approach ensures DISCOVERY.md and PLAN.md always represent the current state, preventing outdated historical entries from cluttering your workflow.