issue-sherpa
Triage GitHub issues, bug reports, feature requests, and vague tasks into reproducible, scoped engineering work. Use when Codex needs to classify an issue, extract acceptance criteria, propose labels,
SKILL.mdskills/issue-sherpa/SKILL.md
GitHubIssue Sherpa
Turn fuzzy issue text into work a maintainer can trust.
Workflow
- Read the issue, linked discussion, screenshots, logs, and relevant repo docs.
- Classify the request:
bug,feature,docs,maintenance,question, orneeds reproduction. - Extract facts separately from assumptions.
- Build a reproduction or discovery plan for bugs. If a repro is impossible, name the missing artifact.
- Write acceptance criteria as observable outcomes.
- Propose the smallest useful implementation slice and verification command.
Draft Maintainer Reply
When asked to reply, produce a draft unless the user explicitly asks to post it. Include:
- Summary of the issue in one sentence.
- What is known.
- What is needed, if anything.
- Next action and verification.
Triage Checklist
- Environment/version present?
- Expected and actual behavior distinct?
- Reproduction steps concrete?
- Logs or screenshots actionable?
- Duplicates or related issues checked?
- User impact and severity clear?
- Scope small enough for one PR?
Output
Prefer:
Classification:
Impact:
Repro plan:
Acceptance criteria:
Implementation slice:
Verification:
Suggested labels:
Draft reply: