# report-regressions

report-regressions — a skill for Claude Code builds regression reports from saved campaign decisions and links findings to evidence. It runs when a campaign report is created or refreshed.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 670 installs · ★ 8341 repo stars
- Author: trailofbits
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills/tree/HEAD/plugins/regression-hunt/skills/report-regressions/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/report-regressions

## What it does

The skill checks the campaign’s fixed scope against assigned changes and discovered candidates, then produces HTML, Markdown, and JSON reports. It runs `report.py` with `uv run --no-project`, using the campaign directory and `ASSIGNED_DIRECTORY/reports` as the output location.

Inputs include `scope.json`, campaign records, a progress log, sealed stage packages, and registry assignments. The skill checks counts, links, and report coverage, while keeping confirmed findings separate from incomplete fixes and unresolved cases. It does not change decisions or create evidence. Exit code `1` signals changed evidence or an invalid index, and the stage is marked blocked.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill report-regressions -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill report-regressions -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill report-regressions -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills plugins/regression-hunt/skills/report-regressions
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill report-regressions -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/regression-hunt/skills/report-regressions
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill report-regressions -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/trailofbits/skills/tree/HEAD/plugins/regression-hunt/skills/report-regressions/SKILL.md

## When to use it
- generate reports from campaign results
- compare campaign scope with assigned changes and candidates
- separate confirmed findings from unresolved cases
- record validation failures as blockers

## Example prompts
- Create a regression report from the saved campaign decisions.
- Refresh the campaign report and list unresolved cases.
- Check campaign coverage and produce HTML, Markdown, and JSON reports.

## Similar
- [recipe-generate-report-from-sheet](https://affpapa.org/en/nevibecode/skills/recipe-generate-report-from-sheet.md) — skill · 31600 installs
- [training-report](https://affpapa.org/en/nevibecode/skills/training-report.md) — skill · 5100 installs
- [client-report](https://affpapa.org/en/nevibecode/skills/client-report.md) — skill · 1200 installs
- [ads-report](https://affpapa.org/en/nevibecode/skills/ads-report.md) — skill · 915 installs
- [asb-interview-report](https://affpapa.org/en/nevibecode/skills/asb-interview-report.md) — skill · 728 installs
- [status-report-generator](https://affpapa.org/en/nevibecode/skills/status-report-generator.md) — skill · 145 installs

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