Does this work with personal GitHub repositories?

Yes, it automatically detects personal repos and uses fallback labels like type:task and type:bug instead of organization-only Issue Types.

Why does this skill limit labels to only three types?

The methodology argues that categorization labels are overhead that doesn't pay for itself at small scale; it uses only blocked, stale, and pinned for workflow status.

What is 'zombie detection' in this context?

It is an automated process that labels issues as 'stale' after 30 days of inactivity and auto-closes them after 44 days to prevent backlog bloat.

How does this skill handle branch naming?

It mandates the 'issue/{NUMBER}-{short-description}' format, ensuring every branch is lowercase, hyphenated, and explicitly linked to a tracked task.

Issue Workflow

Name: Issue Workflow
Author: marco-machado

bymarco-machado

0•

Collaboration Tools

Standardizes GitHub issue management with opinionated templates, branch naming conventions, and automated stale issue detection.

This skill provides a specialized methodology for managing GitHub issues, optimized for individual developers and small teams who want to minimize administrative overhead. It enforces a specific issue structure covering Problem, Approach, and Acceptance Criteria, mandates a consistent branch naming convention linked to issue numbers, and implements a 'zombie detection' system to auto-close inactive issues. By moving away from complex labeling systems and focusing on actionable work chunks, it helps maintain a clean, high-velocity backlog without the burden of traditional project management tools.

Key Features

01Automates 'zombie issue' detection and auto-closing after 44 days of inactivity

02Implements a lightweight three-label system to minimize categorization overhead

03Enforces a structured Problem/Approach/Acceptance Criteria/Tasks issue template

04Standardizes branch naming using the issue/{number}-{description} format

050 GitHub stars

06Provides a triage framework to prevent backlog inflation and future hoarding

Use Cases

01Automating the cleanup of inactive or low-priority repository issues

02Standardizing how technical tasks are defined and linked to code branches

03Streamlining project management for solo developers and small GitHub teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add marco-machado/code-plugins issue-workflow

For use in Claude.ai and ChatGPT

Download Skill