tobihagemann/turbo / codex/skills/create-issue
create-issue
VerifiedCreate a GitHub issue with a drafted title and body. Use when the user asks to "create an issue", "file an issue", "open an issue", "report a bug", or "file a feature request".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
SKILL.md
View on GitHub---
name: create-issue
description: "Create a GitHub issue with a drafted title and body. Use when the user asks to \"create an issue\", \"file an issue\", \"open an issue\", \"report a bug\", or \"file a feature request\"."
---
# Create Issue
Draft a focused title and body for a GitHub issue, then file it. Bug reports state reproduction steps and observed versus expected behavior.
## Step 1: Gather Context
Determine what the issue is about from the conversation. When the subject is ambiguous, use `request_user_input` to settle it before drafting.
List the repo's issue templates, read its labels, and search for an existing issue covering the same thing:
```bash
ls .github/ISSUE_TEMPLATE/ 2>/dev/null
gh label list --limit 100
gh issue list --search "<keywords>" --state all
```
When the issue goes to a repository other than the checkout, replace the `ls` with `gh api repos/<owner>/<repo>/contents/.github/ISSUE_TEMPLATE`, read the files it lists through the same API, and pass `--repo <owner>/<repo>` to the label list and the duplicate search.
When the target repository, the checkout included, has no `.github/ISSUE_TEMPLATE` folder of its own, list its owner's `.github` repository with `gh api repos/<owner>/.github/contents/.github/ISSUE_TEMPLATE`, whose files GitHub applies to a repository without that folder.
Treat an empty listing or a 404 as normal. When templates exist, read the one matching the kind of issue, and read `.github/ISSUE_TEMPLATE/config.yml` when present. Follow the template's structure and required sections, and apply the labels and title prefix the template declares. For a YAML issue form, render each field's `attributes.label` as a `###` heading with the answer beneath, matching what the web form produces. When `config.yml` sets `blank_issues_enabled: false`, choose a template rather than filing a blank issue.
When the search surfaces a plausible duplicate, present it and use `request_user_input` to confirm whether to file anyway.
When a bug report rests on reading code alone, with no run having shown the behavior, offer to reproduce it before drafting. Use `request_user_input` with **Reproduce first (Recommended)**, which runs the scenario against the target repository's code and drafts from what it shows, and **Draft as unobserved**, which states in the body that the behavior was derived from code and not observed. When the scenario cannot be run, draft as unobserved.
## Step 2: Run `$github-voice` Skill
Run the `$github-voice` skill to load writing style rules.
## Step 3: Draft Title and Body
Draft the title and body. Output them as chat text so the user can review before anything is filed.
## Step 4: Confirm and Create
Use `request_user_input` for confirmation only. Generate a random tag so the body file is unique across sessions:
```bash
head -c 4 /dev/urandom | xxd -p
```
Write the drafted body to `.turbo/issue/<tag>-body.md` (using the printed tag) with `apply_patch`, then create the issue with `gh issue create --body-file`:
```bash
gh issue create --title "<TITLE>" --body-file .turbo/issue/<tag>-body.md --label "<LABEL>,<LABEL>"
```
Add `--repo <owner>/<repo>` when the issue goes to a repository other than the checkout. Repeat `--label` when the template sets several. Drop `--label` when no existing label fits. Set the issue type with `--type <name>` when a type is asked for or the template declares one; an issue type is a separate feature from a label, so applying a label of the same name leaves the request unmet. Do not set `--assignee` or `--milestone` unless the user explicitly asks.
Then call `update_plan` to mark this step completed and continue with the next step of the active workflow.
## Rules
- Don't reference `.turbo/` content (filenames, acceptance criteria, step numbers, headings) in the title or body. `.turbo/` is gitignored, so these references would be opaque to anyone reading without local copies.
- Create labels only when the user asks.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |