Back to Kilocode

GitHub Issues

.kilo/skills/gh-issues/SKILL.md

7.2.522.0 KB
Original Source

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:

TemplateWhen 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:

SurfaceProjectURL
VS Code extensionVS Code Extensionhttps://github.com/orgs/Kilo-Org/projects/25
JetBrains pluginJetbrains Pluginhttps://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

After the refresh succeeds, re-run the original gh issue create command. Do not fall back to creating the issue without the project — the board assignment is required.