speckit-gh-issue-runner

Finds and ranks GitHub issues labeled for Spec Kit auto workflow, selecting up to three candidates for sequential processing.

Updated May 18, 2026
One-click install
npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-gh-issue-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-gh-issue-runner
Source: https://github.com/KamiJeong/tech-bridge-book/tree/main/.agents/skills/speckit-gh-issue-runner
Command: npx skills add https://github.com/KamiJeong/tech-bridge-book --skill speckit-gh-issue-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you discover, prioritize, and process open GitHub issues that are labeled for the Spec Kit auto workflow, so you can move queue work forward without manually inspecting every issue.

Core Features & Use Cases

  • Issue discovery and filtering: Finds open issues labeled trigger:speckit-auto and removes already completed, blocked, or in-progress items from consideration.
  • Mode-aware intake: Detects whether an issue should run in gated, auto-implement, or auto-pr mode and preserves the required labels and status updates.
  • Sequential workflow handling: Processes up to three issues at a time and hands each selected issue off to speckit-auto and token observability steps.
  • Use Case: A repository maintainer wants to clear a small batch of ready Spec Kit work by selecting the newest queued issues and running them one by one with the right controls.

Quick Start

Ask the assistant to find up to three open GitHub issues labeled for speckit-auto and run the selected issues through the workflow.

Frequently Asked Questions about speckit-gh-issue-runner

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

FAQPage Schema
How do I find and run open GitHub issues labeled for automated workflows?

This Skill discovers and ranks open GitHub issues labeled trigger:speckit-auto, filtering out completed or blocked items, to select up to three runnable candidates for the automated workflow queue.

How does triage mode detection work for Spec Kit auto issue processing?

Triage mode detection for Spec Kit auto processing inspects issue labels to determine whether an item should run in gated, auto-implement, or auto-pr mode, preserving required labels and status updates during workflow handoff.

Do I need the GitHub CLI and jq to process labeled GitHub issues automatically?

Yes, processing labeled GitHub issues automatically requires the GitHub CLI and jq, as this Skill depends on them for repository access, issue label inspection, and JSON parsing.

What is the maximum number of GitHub issues I can process sequentially in one batch?

The maximum number of GitHub issues you can process sequentially in one batch is three, as this Skill selects up to three runnable candidates and hands each selected issue off to the workflow one by one.

What happens to GitHub issues that are already in-progress or blocked during automated triage?

GitHub issues that are already in-progress or blocked are removed from consideration during automated triage, ensuring the workflow only selects ready and runnable queued work items for processing.