Issue Writer

An agent skill for drafting evidence-based GitHub issues from findings, bugs, security reviews, regressions, feature requests, and technical debt.

Use it when an investigation needs to become an actionable issue with the right structure for the issue type. The skill separates security, bug/regression, epic/technical debt, and feature-request issue shapes so evidence, impact, recommendations, and acceptance criteria stay appropriate to the work.

When To Use

• Drafting or polishing GitHub issues.
• Converting review, debug, or security findings into issues.
• Creating a security hardening epic or child issue plan.
• Checking whether an issue has enough evidence, reproduction detail, impact, recommendations, and acceptance criteria.

When Not To Use

• General code review without an issue-writing task.
• Security audits or threat modeling before findings exist.
• Long-form project documentation that is not intended to become an issue.

Installation

Clone this repository into your agent's skills directory. For Codex, use:

git clone https://github.com/xiluoduyu/issue-writer.git ~/.codex/skills/issue-writer

Then invoke it by name:

Use $issue-writer to turn these findings into a structured GitHub issue with evidence, impact, recommendations, and acceptance criteria.

License

MIT