# qa

Runs a conversational bug reporting session, investigates repository terminology in the background, and posts GitHub issues via gh.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 649 installs
- Author: timschoch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/qa/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/qa

## What it does

This skill runs an interactive bug-hunting workflow in your terminal. You describe an issue in plain words, and the assistant asks up to three quick questions about reproduction steps or intermittent behavior. It avoids protracted questioning. Once the problem is clear, it prepares the write-up.

While you talk, a background exploration agent scans project files and `GLOSSARY.md` to pick up domain terminology. It focuses on functional boundaries rather than fixing bugs on the spot. If a defect touches several independent subsystems, the assistant splits it into smaller tickets with clear blocker references to enable parallel work.

The agent submits tickets automatically using `gh issue create` and returns links immediately. File paths and line numbers are intentionally omitted so issues stay valid across future refactors. Without an authenticated `gh` installation in your environment, ticket submission will fail.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill qa -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/qa/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/qa/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill qa -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/qa/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill qa -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/qa/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install timschoch/skilly qa
```

2. **Manually: put the files in place**
- File: `.github/skills/qa/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill qa -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/qa
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/qa/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill qa -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/qa/SKILL.md

## When to use it
- file GitHub issues directly from conversational bug reports
- split complex defects into smaller tickets with dependency tracking
- capture reproduction steps using repository domain terminology

## Example prompts
- Start a QA session for the checkout flow
- Found a bug: clicking reset does not clear the search filters
- Log the remaining glitches we discussed into separate issues

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1200000 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs

## Other versions with the same name
- [qa · garrytan](https://affpapa.org/en/nevibecode/skills/garrytan-qa.md) — 457 installs

From the same set: [timschoch/skilly](https://affpapa.org/en/nevibecode/by/timschoch/skilly.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md