# gstack QA: Test and Fix (qa)

> Tests a site, API or CLI, then fixes the bugs it finds in severity order, each with a regression test and its own commit.

- Category: [Testing & Debugging](https://www.myskills.tools/en/categories/testing-debugging/)
- Source: Community · Garry Tan
- Repository: https://github.com/garrytan/gstack/tree/main/qa (commit ed10791 · v2.0.0)
- SKILL.md: https://github.com/garrytan/gstack/blob/main/qa/SKILL.md
- Install command: `npx skills add garrytan/gstack --skill qa`
- License: MIT
- Compatible with: Claude Code, Codex, Cursor, Copilot
- Permissions: read-repo ✓, write-files ✓, shell ✓, network ✓
- Status: Scan passed
- A rule scan cannot catch every risk. Read this skill's SKILL.md and check its permissions before installing.
- ⚠ Runs git commit for each verified fix, and asks you to commit or stash existing changes if the tree is dirty.

## Core rule

Reproduce each defect in a regression test before repairing it, and commit only verified fixes.

## Execution Phases

1. **Setup** — Parse target, tier and mode; if the tree is dirty, let the user choose commit, stash or abort; create the report directory.
2. **Baseline QA** — Run exploratory probes on the target, keep browser and functional results separate, and report baseline findings before fixing.
3. **Triage** — Sort issues by severity, apply the selected tier, and mark lower-tier or unfixable issues as deferred.
4. **Fix loop** — Reproduce, write the regression test, make a minimal fix, re-test and commit each one; stop after two reverts, with a hard cap of 50 fixes.
5. **Final QA and report** — Re-run affected checks, compute the health score, write the QA report, and update TODOS.md.

## Permissions (summarised from SKILL.md)

| Capability | Needed | Details |
|---|---|---|
| File writes | Required | Edits responsible source files, adds regression tests and writes QA reports; never modifies CI config or weakens existing tests. |
| Command execution | Required | Runs git, test commands, browser and functional probes, and gstack scripts. |
| Network outbound | Required | May access the target URL under test and use WebSearch. |

## SKILL.md frontmatter (YAML)

```yaml
---
name: qa
preamble-tier: 4
version: 2.0.0
description: Test the site, API or CLI and fix the bugs it finds. (gstack)
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - AskUserQuestion
  - WebSearch
triggers:
  - qa test this
  - find bugs on site
  - test the site
---
```

Home: https://www.myskills.tools/en/ · URL: https://www.myskills.tools/en/skills/qa/