GitHub Issue Agent (github-issue-agent)

Routing Directive: USE ONLY for durable repository bugs, execution friction (T1-T3), map debt, and architectural improvements. DO NOT USE for temporary intra-session checklists (use task-agent instead).

The github-issue-agent skill provides a safe, standardized interface for querying, searching, creating, commenting on, and validating GitHub Issues stemming from agent execution friction, map debt, bugs, and system improvements.

Dry-Run Default Execution Contract

[!IMPORTANT] Safety First: By default, all issue-modifying operations (issue creation, commenting, label edits) execute in dry-run / payload-generation mode (execute=False). No live mutation occurs unless execute=True is explicitly passed and all safety gates pass.

Before any GitHub issue is created or updated, the request passes through three mandatory security and quality gates:

1. Secret Redaction Gate (redaction_gate.py): Scans titles and bodies for tokens, API keys, private keys, or credentials. Blocks execution if detected.
2. Taxonomy Validation Gate (gh_issue_taxonomy_validate.py): Enforces issue-taxonomy.json constraints. Requires type:*, tier:*, source:*, risk:*, AND location (area:* OR plugin:*).
3. Evidence Quality Body Validation Gate (body_validator.py): Requires standard structured markdown sections (## Summary, ## Observed Behavior, ## Expected Behavior, ## Evidence, ## Impact).