github-issue-plan

Manage GitHub issue-based agent plans with living comments and session logs.

Updated Jun 4, 2021
One-click install
npx skills add https://github.com/indigoviolet/dotfiles --skill github-issue-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue-plan
Source: https://github.com/indigoviolet/dotfiles/tree/main/.pi/agent/skills/github-issue-plan
Command: npx skills add https://github.com/indigoviolet/dotfiles --skill github-issue-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of managing agent plans by anchoring them to GitHub issues, ensuring all work is tracked, documented, and easily retrievable.

Core Features & Use Cases

  • Issue-Based Planning: Every agent session is tied to a GitHub issue, with the plan residing in a dedicated comment.
  • Automated Discovery & Creation: Automatically finds existing issues or helps create new ones based on user input.
  • Living Plan Management: Maintains a dynamic "living plan" comment that is updated throughout the session.
  • Session Logging: Posts append-only session logs for a chronological history of completed tasks, decisions, and learnings.
  • ZenHub Integration: Facilitates moving issues to "In Progress" via ZenHub when implementation begins.
  • Use Case: When starting a new feature development, use this Skill to create or find the relevant GitHub issue, establish a plan in a comment, and update it as you code. At the end of the session, post a log of what was accomplished.

Quick Start

Use the github-issue-plan skill to find or create a GitHub issue for the current task and start a new plan.

Frequently Asked Questions about github-issue-plan

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

FAQPage Schema
How do I manage AI agent plans directly on GitHub issues?

You can anchor AI agent plans to GitHub issues by using this Skill to establish a living plan comment. It automatically discovers existing issues or creates new ones to track session work.

How do I log session history on GitHub issues?

You can log session history by posting append-only comments to the GitHub issue. This provides a chronological record of completed tasks, decisions, and learnings for future reference.

Do I need the gh CLI to manage GitHub issue plans?

Yes, the gh CLI is required to interact with GitHub issues and comments. You must have it installed and authenticated to establish or resume plans.

Can I move GitHub issues to In Progress using ZenHub?

Yes, this Skill facilitates moving issues to the In Progress pipeline in ZenHub when implementation begins. Full ZenHub functionality requires access to the ZenHub API.

What is the best way to tie feature development to GitHub issues?

The best way is to use this Skill to find or create a relevant GitHub issue and establish a plan comment. It dynamically updates the plan as you code and posts a final session log of accomplishments.