GitHub Issue Workflow
Use this skill when creating or validating agent-ready issues, or when asked to mark issues Ready/Blocked/Done.
Quick checklist
- Issue includes target repo
- Labels:
agent+ exactly onedifficulty:* - Project status:
Ready(when prepared) - Acceptance criteria are clear and testable
Template
Use AGENT_ISSUE_TEMPLATE.md for the canonical format. If you need a minimal inline template:
## Target Repository
repo-name
## Description
What needs to be done and why
## Acceptance Criteria
- [ ] Requirement 1
- [ ] Requirement 2
Readiness + lifecycle
- Ready:
agentlabel + difficulty label + project statusReady - Blocked: remove
agent, set statusBlocked, ask a clear question in comments - Resume: add
agentlabel, unassign yourself, status back toReady
References
Open these when you need more detail:
docs/issue-creation-workflow.mddocs/issue-readiness-protocol.mddocs/creating-agent-issues.mdAGENT_ISSUE_TEMPLATE.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.