# Gh Issues

Use when creating, triaging, or commenting on GitHub issues for the Kilo VS Code...

- Repository: https://github.com/Kilo-Org/kilocode (27829 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Kilo-Org/kilocode --skill gh-issues -g -a claude-code -y`
Codex: `npx skills add Kilo-Org/kilocode --skill gh-issues -g -a codex -y`
Cursor: `npx skills add Kilo-Org/kilocode --skill gh-issues -g -a cursor -y`
Gemini CLI: `npx skills add Kilo-Org/kilocode --skill gh-issues -g -a gemini-cli -y`

## Description

Use when creating, triaging, or commenting on GitHub issues for the Kilo VS Code extension or JetBrains plugin via `gh`. Covers issue templates, project board assignment, title conventions, and required `gh` scopes.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GitHub Issues

Use this skill whenever you create or manage a GitHub issue with `gh` for either the VS Code extension or the JetBrains plugin.

## Templates

The repo defines issue templates in `.github/ISSUE_TEMPLATE/`. Pick the matching template instead of opening a blank issue:

| Template | When to use |
|---|---|
| `Bug report` (`bug-report.yml`) | Reproducible defects with steps, expected, and actual behavior |
| `Feature Request` (`feature-request.yml`) | New capabilities, enhancements, or behavior changes |
| `Question` (`question.yml`) | Usage or design questions that aren't obviously bugs or feature requests |

Pass the template title to `gh issue create --template`.

## Title Conventions

- Use a plain, descriptive title that reads cleanly as a standalone sentence.
- Do not add platform-specific prefixes such as `[JetBrains]`, `[Jetbrains]`, `[JB]`, `[VS Code]`, `[VSCode]`, or similar. Routing happens through project boards, not the title.

## Project Boards

Every new issue must land on the correct project board:

| Surface | Project | URL |
|---|---|---|
| VS Code extension | `VS Code Extension` | https://github.com/orgs/Kilo-Org/projects/25 |
| JetBrains plugin | `Jetbrains Plugin` | https://github.com/orgs/Kilo-Org/projects/39 |

Pass the project title to `gh issue create --project`.

## Recipes

Create a VS Code extension bug report and add it to the board:

```bash
gh issue create \
  --template "Bug report" \
  --project "VS Code Extension" \
  --title "Sidebar chat fails to render after reload" \
  --body "..."
```

Create a JetBrains feature request:

```bash
gh issue create \
  --template "Feature Request" \
  --project "Jetbrains Plugin" \
  --title "Support Kotlin Multiplatform target detection" \
  --body "..."
```

## Scope Errors

If `gh` reports a missing scope when assigning a project, refresh the auth token and retry:

```bash
gh auth refresh -s project
```

The rest: https://github.com/Kilo-Org/kilocode/blob/HEAD/.kilo/skills/gh-issues/SKILL.md
