issue-management

Track and update issue statuses from an issues/ directory.

1|Updated Nov 4, 2018
One-click install
npx skills add https://github.com/ryanmoran/workspace --skill issue-management-ryanmoran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-management
Source: https://github.com/ryanmoran/workspace/tree/main/skills/issue-management
Command: npx skills add https://github.com/ryanmoran/workspace --skill issue-management-ryanmoran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures disciplined issue handling by providing a structured process to discover, track, and complete one issue at a time, preventing skipped steps and misaligned work.

Core Features & Use Cases

  • Issue Discovery: Always start by reading issues/README.md to understand goals and dependencies.
  • Status Tracking: Use issues/.status.json to monitor progress, current issue, and historical states.
  • Sequential Work: Select the first available issue (pending with satisfied dependencies and no in_progress) and mark it in_progress before starting.
  • Completion Verification: Ensure all acceptance criteria are met, tests pass, and documentation is updated before marking as completed.

Quick Start

Tell the agent to begin work on the next issue by following the Issue Discovery Process:

  • Read issues/README.md
  • Check/create issues/.status.json
  • Determine the next available issue (pending, dependencies satisfied, no in_progress)
  • Update status to in_progress with started_at
  • Complete the issue with verification (tests, lint, documentation)
  • Mark completed and stop

Frequently Asked Questions about issue-management

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

FAQPage Schema
How do I track project issues sequentially and prevent skipping steps?

Sequential issue tracking is done by reading an issues directory, checking a .status.json file, and selecting the first pending issue with satisfied dependencies. The agent marks the issue in_progress, completes the work with verification, and updates the status file before moving to the next issue.

What is the best way to automate issue management and dependency verification?

Automated issue management uses a structured status file to monitor progress and enforce dependency checks before starting work. The system reads issues from a directory, verifies that dependencies are satisfied, and ensures all acceptance criteria and tests pass before marking an issue completed.

How do I manage issue completion criteria with a status.json file?

Issue completion criteria are managed by updating .status.json with structured status values like pending, in_progress, and completed. The file tracks the current issue, historical states, and timestamps, ensuring tests pass and documentation is updated before marking an issue as completed.

Can I use this issue tracking workflow for projects with multiple pending dependencies?

Yes, this workflow applies to projects with multiple issues and formal dependencies. It prevents misaligned work by checking dependency satisfaction in .status.json before selecting an issue, ensuring no pending issue starts until its prerequisites are completed.

Why does my agent skip issue dependencies during project tracking?

Agents skip dependencies when lacking a structured status file to enforce checks. By requiring .status.json with explicit dependency verification and sequential status updates, the workflow guarantees that no issue starts unless all dependencies are completed and no other issue is in_progress.