issues-plan

Create implementation plans from issue titles and comments in .issues/*.toml files.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/glhewett/public-skills --skill issues-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issues-plan
Source: https://github.com/glhewett/public-skills/tree/main/issues-plan
Command: npx skills add https://github.com/glhewett/public-skills --skill issues-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many repository issues contain only a title and scattered comments, leaving contributors unsure how to start work or estimate complexity. This Skill automates the creation of a concise, decision-aware plan and persists it as a comment in the issue file so maintainers and contributors have immediate, reusable guidance.

Core Features & Use Cases

  • Create a structured implementation plan derived from an issue's title and existing comments, including design decisions and estimated complexity.
  • Append a new [[comments]] entry to the issue's TOML file with the agent as author and the current date, and set the issue status to planned.
  • Use case: a maintainer asks the agent to plan work for issue 0001; the agent validates the file exists, summarizes context, produces a plan, updates the issue, and stages the change for commit.

Quick Start

Ask the agent to create a plan for issue 1 and append it as a comment to the corresponding file in the .issues directory.

Frequently Asked Questions about issues-plan

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

FAQPage Schema
How do I create a development plan from issue comments stored in TOML files?

This Skill automates issue planning by reading the title and comments from a TOML file in the .issues directory, generating a structured plan, appending it as a new comment, and setting the status to planned.

How do I automate issue tracking updates with git workflow automation?

You can automate issue tracking by applying this Skill to your .issues/*.toml files. It processes the issue context, appends a dated comment entry from the agent, updates the status to planned, and stages the modified TOML file directly with git add for commit readiness.

What is the best way to generate implementation guidance for repository issues?

The best way to generate implementation guidance is using this Skill to parse issue titles and scattered comments into a structured plan. It persists the plan directly into the issue TOML file as a comment, providing maintainers with immediate, reusable context and estimated complexity.

Does this issue planning workflow require existing TOML issue files?

Yes, this issue planning workflow requires existing TOML issue files. The Skill explicitly verifies that the target issue file exists in the .issues directory before reading its contents and generating a plan, ensuring it only processes valid issue tracking data.

Can I use this to update issue status to planned and stage changes automatically?

Yes, you can update issue status to planned and stage changes automatically. After generating the implementation plan and appending it as a comment to the TOML file, the Skill automatically sets the status to planned and stages the file using git add.

When should I not use automated planning for issue tracking?

You should not use automated planning for issue tracking if your repository does not manage issues using TOML files in a .issues directory. This Skill specifically depends on reading and appending to the [[comments]] entry structure within those files to function correctly.