# Feedback

Report a Codewhale bug or idea as a GitHub issue.

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill feedback -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill feedback -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill feedback -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill feedback -g -a gemini-cli -y`

## Description

Report a Codewhale bug or idea as a GitHub issue. Use when: codewhale bug, feature request, feedback on codewhale, report an issue, or this should work differently.

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

# Feedback

## When to use
The user hit a Codewhale bug or wants Codewhale to do something new, and
wants it reported upstream.

## Setup
Requires the `gh` CLI, authenticated (`gh auth status`). Fail loud when it
is missing, fall back to printing the issue text for manual filing.

## Workflow
1. Reproduce or pin the behavior first: version (`codewhale --version`),
   command, expected vs actual, minimal steps.
2. Draft the issue (title, repro, expected, actual, version) and read it back.
3. File only with explicit approval:
   `gh issue create -R codewhale-hq/Codewhale --title "..." --body "..."`.
4. Report the issue URL back.

## Non-goals
- Do not file without showing the user the exact title and body first.
- Do not file duplicates, search open issues for the same report first.
- Do not include secrets, tokens, or private data in the issue body.