# Github Issue Workflow

> Create and mark agent-ready GitHub issues for the your-project project (labels, status, template, readiness checks). Use when this capability is needed.

- Skill: `tomevault-io/github-issue-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/github-issue-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/github-issue-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/github-issue-workflow

---


# 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 one `difficulty:*`
- 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:

```markdown
## Target Repository
repo-name

## Description
What needs to be done and why

## Acceptance Criteria
- [ ] Requirement 1
- [ ] Requirement 2
```

## Readiness + lifecycle

- Ready: `agent` label + difficulty label + project status `Ready`
- Blocked: remove `agent`, set status `Blocked`, ask a clear question in comments
- Resume: add `agent` label, unassign yourself, status back to `Ready`

## References

Open these when you need more detail:
- `docs/issue-creation-workflow.md`
- `docs/issue-readiness-protocol.md`
- `docs/creating-agent-issues.md`
- `AGENT_ISSUE_TEMPLATE.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/day-in-the-country-llc) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->