How do I install the Github Issue Backlog Agent skill?

Run npx skillmds@latest add richfrem/github-issue-backlog-agent in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github Issue Backlog Agent safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github Issue Backlog Agent?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github Issue Backlog Agent free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github Issue Backlog Agent?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github Issue Backlog Agent by richfrem

Name: Github Issue Backlog Agent
Rating: 4.666666666666667 (3 reviews)
Author: richfrem

Github Issue Backlog Agent

Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).

richfrem a017e5b 5 files · 6.4 KB Updated Sep 10, 2026

File contents

GitHub Issue Backlog Agent (`github-issue-backlog-agent`)

Routing Directive: USE ONLY when promoting ephemeral single-session local tasks (tasks/*.md) into durable tracked GitHub Issues. DO NOT USE for managing local kanban boards (use task-agent instead) or directly creating/searching issues from execution friction (use github-issue-agent instead).

The github-issue-backlog-agent skill bridges local task scratch items into durable GitHub Issues. It parses local task markdown files, constructs evidence-backed markdown bodies conforming to repository taxonomy guidelines, and invokes gh_issue_create.py in dry-run or live mode.

Safety & Security Contracts

Dry-Run Execution Default (execute=False): By default, calling task_to_issue_bridge.py outputs a structured JSON payload detailing the issue title, body, and labels without creating a live GitHub issue. Live creation requires --execute.
Taxonomy Enforcement: Every escalated issue is validated against issue-taxonomy.json rules (type:*, tier:*, source:*, risk:*, and area:*/plugin:*).
Secret Redaction: Both title and body undergo secret scanning via redaction_gate.py prior to payload generation or issue submission.

Usage catalog

Promote Task Scratch Item to GitHub Issue

Helper Script: plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py

CLI Usage:

# Dry-run payload preview:
python3 plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py \
  --task-path tasks/backlog/0042-fix-deadlock.md \
  --labels "area:dev-utils,tier:2-structural"

# Live issue creation:
python3 plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py \
  --task-path tasks/backlog/0042-fix-deadlock.md \
  --labels "area:dev-utils,tier:2-structural" \
  --execute

Python API Interface

from pathlib import Path
from plugins.dev_utils.skills.github_issue_backlog_agent.scripts.task_to_issue_bridge import promote_task_to_issue

result = promote_task_to_issue(
    task_path=Path("tasks/backlog/0042-fix-deadlock.md"),
    extra_labels=["area:dev-utils", "tier:2-structural"],
    execute=False,  # Dry-run default
)

---name: github-issue-backlog-agentdescription: Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).---# GitHub Issue Backlog Agent (`github-issue-backlog-agent`)> **Routing Directive:** USE ONLY when promoting ephemeral single-session local tasks (`tasks/*.md`) into durable tracked GitHub Issues. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly creating/searching issues from execution friction (use `github-issue-agent` instead).The `github-issue-backlog-agent` skill bridges local task scratch items into durable GitHub Issues. It parses local task markdown files, constructs evidence-backed markdown bodies conforming to repository taxonomy guidelines, and invokes `gh_issue_create.py` in dry-run or live mode.---## Safety & Security Contracts1. **Dry-Run Execution Default (`execute=False`):** By default, calling `task_to_issue_bridge.py` outputs a structured JSON payload detailing the issue title, body, and labels without creating a live GitHub issue. Live creation requires `--execute`.2. **Taxonomy Enforcement:** Every escalated issue is validated against `issue-taxonomy.json` rules (`type:*`, `tier:*`, `source:*`, `risk:*`, and `area:*`/`plugin:*`).3. **Secret Redaction:** Both title and body undergo secret scanning via `redaction_gate.py` prior to payload generation or issue submission.---## Usage catalog### Promote Task Scratch Item to GitHub Issue- **Helper Script:** `plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py`- **CLI Usage:** ```bash # Dry-run payload preview: python3 plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py \ --task-path tasks/backlog/0042-fix-deadlock.md \ --labels "area:dev-utils,tier:2-structural" # Live issue creation: python3 plugins/dev-utils/skills/github-issue-backlog-agent/scripts/task_to_issue_bridge.py \ --task-path tasks/backlog/0042-fix-deadlock.md \ --labels "area:dev-utils,tier:2-structural" \ --execute ```---## Python API Interface```pythonfrom pathlib import Pathfrom plugins.dev_utils.skills.github_issue_backlog_agent.scripts.task_to_issue_bridge import promote_task_to_issueresult = promote_task_to_issue( task_path=Path("tasks/backlog/0042-fix-deadlock.md"), extra_labels=["area:dev-utils", "tier:2-structural"], execute=False, # Dry-run default)```

Frequently asked questions