Codex issue-writer skill for scoped GitHub issues
Turn a planned item into copy-ready issue Markdown covering scope, dependencies, observable acceptance criteria, and documentation.
中文Install in Codex
A local Codex project with the planned work item, scope, dependencies, and acceptance inputs ready.
- Review `.agents/skills/issue-writer/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.agents/skills/issue-writer/` in your project and save the reviewed file as `.agents/skills/issue-writer/SKILL.md`.
- Start Codex from that project's root, then type `$issue-writer` and select the matching skill.
Example task
Invoke $issue-writer and use this fictional work item to draft an issue for its milestone.
milestone `Archive preview` | issue `show attachment count` | type UX
in scope show a count in the preview | out of scope file export
fixture `3 attachments` should display `3 attachments` | dependency `preview manifest field`
open question `zero attachments label` | update the preview guide when confirmedWhat to check
Keep `preview manifest field` as a dependency and `3 attachments` as the observed acceptance result. Keep export out of scope and flag `zero attachments label` as unresolved.
Original SKILL.md on GitHub · Updated
Frequently asked question
How should I handle an undecided UI detail in the issue?
Use confirmed behavior for acceptance criteria. List undecided copy as an open question and state why it matters.