github-issues

Manage GitHub issue boards, stale-issue detection, and idempotent dedupe-then-file issue creation via gh CLI.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Sassy-Dog/sassydog-skills --skill github-issues-sassy-dog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issues
Source: https://github.com/Sassy-Dog/sassydog-skills/tree/main/skills/github-issues
Command: npx skills add https://github.com/Sassy-Dog/sassydog-skills --skill github-issues-sassy-dog

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Teams running GitHub issue backlogs lose track of stale issues, file duplicates from automated signals like Sentry, and drift their label taxonomies across repos. This Skill centralizes board snapshots, backlog reads, stale-issue detection, and gated issue creation into one consistent set of gh + GraphQL operations. ## Core Features & Use Cases - Board and backlog reads: Snapshot a ProjectV2 board grouped by status column, read label-driven backlogs, and pull a fill/drain work queue with parsed touches/depends-on/stack contracts. - Stale-issue detection: Find shipped-but-still-open issues, stub bodies needing scoping, and completed tracking epics, with explicit degraded-run signaling instead of silent empty results. - Dedupe-then-file writes: Create issues idempotently using a body-marker convention with a two-stage search plus recent-scan lookup, preview-then-confirm dry runs, and a burst rail that halts runs filing more than five issues. - Label-state transitions: Claim, release, block, promote, and demote issues against the ready/in-progress/blocked taxonomy, with double-pick guards and claim-residue cleanup. - Use Case: A Sentry escalation needs filing: run the file script with a stable marker in dry-run mode, preview the would-file result, then file once approved — re-runs return the existing issue instead of a duplicate. ## Quick Start Ask the agent to snapshot the project board by status and list any stale or stub issues in this repository.

Frequently Asked Questions about github-issues

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

FAQPage Schema
How do I file a GitHub issue without creating duplicates?

Use the file-or-link-issue.sh script with a stable body marker such as sentry-source: PROJ-123. It checks both the search index and a recent-listing scan for the marker footer, returning the existing issue as already-linked instead of filing a duplicate.

How do I detect stale GitHub issues automatically?

Run stale-issues.sh with REPO set to owner/name. It reports three buckets: shipped-but-still-open issues referenced by merged PRs, stub bodies needing scoping, and tracking epics whose children have all closed.

Does this work with GitHub Projects V2 boards?

Yes, board-snapshot.sh pulls a ProjectV2 board grouped by status column via gh and GraphQL, and the filing script can optionally add new issues to a board column. A PAT needs the project scope for board reads.

Why did my issue search return nothing right after filing?

GitHub's issue search index is asynchronous, so a marker written seconds ago is not yet searchable. The script compensates with a read-after-write-consistent recent-listing scan covering the newest issues, which is why both stages are required.

What are the limitations of the label claim transitions?

The promote command only clears an assignee matching the exact residue shape: assigned to the operator, no in-progress label, issue open, and evidence of a prior claim cycle. Self-assignments by a human are deliberately left alone, since unknown state is never treated as verified.