# taint-trace

The taint-trace Claude Code skill adjusts a project's static taint-analysis models, then runs its analyzer. It addresses missed data paths, unresolved framework calls, and false positives caused by imprecise models.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 130 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/trailmark/skills/taint-trace/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/taint-trace

## What it does

taint-trace draws on Trailmark graph data to revise how the analyzer represents input sources, risky operations, sanitization, value transfer, and types. It then runs the project's existing analyzer. The skill stores the initial and updated run results, model-change records, and a readable report in `.trailmark/taint-trace/`. The initial run is retained.

Its helper runs through `uv` and gets `trailmark>=0.8.0,<0.9` from a package index; the native analyzer is a separate dependency. The selected engine's capabilities and models are checked before analysis. Analyzer startup can execute project code through autoloaders, plugins, or configuration hooks, and static analysis does not isolate that code.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills plugins/trailmark/skills/taint-trace
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/trailmark/skills/taint-trace
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill taint-trace -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/trailmark/skills/taint-trace/SKILL.md

## When to use it
- Trace external input to a risky operation
- Restore data paths hidden by incomplete models
- Resolve framework calls the analyzer cannot bind
- Reduce false positives caused by imprecise models

## Example prompts
- Analyze data flows in `src` and run `/trailmark:taint-trace-run`.
- Find missed paths from external input to SQL queries in `app`.
- Investigate false positives in `backend` and save a report.

## Similar
- [gitnexus-taint-analysis](https://affpapa.org/en/nevibecode/skills/gitnexus-taint-analysis.md) — skill · 421 installs
- [eastsword-dfyx-code-security-review](https://affpapa.org/en/nevibecode/skills/eastsword-dfyx-code-security-review.md) — skill · 331 installs
- [static-analysis](https://affpapa.org/en/nevibecode/skills/gmh5225-static-analysis.md) — skill · 1 install
- [Lachesis](https://affpapa.org/en/nevibecode/mcp/lachesis.md) — MCP server · ★ 6 repo stars
- [cpg-analysis](https://affpapa.org/en/nevibecode/skills/cpg-analysis.md) — skill · 175 installs
- [callidescope-trace](https://affpapa.org/en/nevibecode/skills/callidescope-trace.md) — skill · 361 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
