# sast-flow-tracer

The sast-flow-tracer skill maps paths from entry points to dangerous operations, following function calls, checks, and data transformations.

- skill · `type=skill` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1298 repo stars
- Author: H-mmer
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/H-mmer/pentest-agents/tree/HEAD/providers/cursor/.cursor/skills/agent-sast-flow-tracer/SKILL.md
- Updated: 2026-06-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sast-flow-tracer

## What it does

sast-flow-tracer takes `entries.json` (where external data enters the code) and `dangers.json` (where potentially vulnerable operations execute), then determines for each pair whether the dangerous operation is reachable from the entry point. It walks the call graph, reads files across the project, expands macros, and records every validation and transformation — casts, assignments, field extractions. Outputs a JSON chain with a preliminary risk rating (hot, warm, cold).

Without Claude Opus, the reasoning depth is insufficient for cross-file tracing, and the skill will miss non-obvious paths. For PHP, it tracks `extract()`, `unserialize()`, magic methods, and Phar wrappers as second-order taint sources.

Runs via `/sast` command after other pipeline agents have populated `entries.json` and `dangers.json`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill sast-flow-tracer -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill sast-flow-tracer -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill sast-flow-tracer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install H-mmer/pentest-agents providers/cursor/.cursor/skills/agent-sast-flow-tracer
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-sast-flow-tracer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill sast-flow-tracer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/H-mmer/pentest-agents --path providers/cursor/.cursor/skills/agent-sast-flow-tracer
```

### Windsurf (Devin Desktop)

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

### 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/H-mmer/pentest-agents/tree/HEAD/providers/cursor/.cursor/skills/agent-sast-flow-tracer/SKILL.md

## When to use it
- map data flow graphs from user input to memory write operations
- identify call chains where validation is missing or incomplete
- track variable transformations through assignments and casts
- recognize implicit entry points via `$_SESSION`, `unserialize()`, and Phar deserialization
- record all bounds and type checks between entry and dangerous operation

## Example prompts
- Map data flows from entry points to dangerous operations in `tcp_input.c`
- Check if `$_POST['id']` reaches the `unserialize()` call in `handlers/user.php`
- Track what validations exist between `pkt->data` and the `memcpy()` call on line 340

## Similar
- [sast-scanning](https://affpapa.org/en/nevibecode/skills/sast-scanning.md) — skill · 415 installs
- [security-scanning-security-sast](https://affpapa.org/en/nevibecode/skills/security-scanning-security-sast.md) — skill · ★ 50109 repo stars
- [security-sast](https://affpapa.org/en/nevibecode/commands/security-sast.md) — command · ★ 42780 repo stars
- [sast-configuration](https://affpapa.org/en/nevibecode/skills/sast-configuration.md) — skill · 10800 installs
- [triage](https://affpapa.org/en/nevibecode/skills/anthropics-triage.md) — skill · 1200 installs
- [sast-sca-security-analyzer](https://affpapa.org/en/nevibecode/agents/sast-sca-security-analyzer.md) — subagent · ★ 41430 repo stars

From the same set: [h-mmer/pentest-agents](https://affpapa.org/en/nevibecode/by/h-mmer/pentest-agents.md) — 43 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
