# quality-validation

quality-validation blocks AI agents from claiming a task is finished without running fresh verification commands and checking exit codes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 142 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/quality-validation/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/quality-validation

## What it does

This skill enforces an evidence-first policy for coding assistants. Before declaring any task finished, the model must follow a five-step gate procedure: choose the right command, execute it completely, inspect the output and status code, and confirm actual success. Guesses and assumptions are forbidden.

The rule set maps explicit verification requirements to specific claims. Passing tests require zero reported failures on a fresh run, successful builds require an exit code of zero, and bug fixes require executing the original failure case. When an agent delegates work to a subagent, it cannot trust the report and must inspect the version control diff directly.

Without a fresh terminal run in the active turn, the assistant cannot declare success. The skill ships under a proprietary license from the author.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill quality-validation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill quality-validation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill quality-validation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/quality-validation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill quality-validation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/quality-validation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill quality-validation -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/qodex-ai/ai-agent-skills/tree/HEAD/skills/quality-validation/SKILL.md

## When to use it
- stop premature task completion claims from coding assistants
- require zero-failure test runs before staging commits or PRs
- ensure regression tests fail before fixes are restored
- verify subagent changes by checking repository diffs directly

## Example prompts
- Fix the auth token expiry bug and confirm it with a fresh test run
- Review our requirements checklist and verify every item before committing
- Write a regression test for issue #88 and verify both the red and green stages

## Similar
- [improve-code-quality](https://affpapa.org/en/nevibecode/skills/improve-code-quality.md) — skill · 2700 installs
- [review-hog-validation-criteria](https://affpapa.org/en/nevibecode/skills/review-hog-validation-criteria.md) — skill · 187 installs
- [defense-in-depth-validation](https://affpapa.org/en/nevibecode/skills/defense-in-depth-validation.md) — skill · 437 installs
- [principle-prove-it-works](https://affpapa.org/en/nevibecode/skills/principle-prove-it-works.md) — skill · 10300 installs
- [Quality Assurance](https://affpapa.org/en/nevibecode/skills/quality-assurance.md) — skill · 206 installs
- [quality-auditor](https://affpapa.org/en/nevibecode/skills/quality-auditor.md) — skill · 201 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 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
