# security-research

security-research runs a parallel security audit with five agents: three hunt for vulnerabilities, two build PoCs. Useful for a PR, a diff range or a release candidate.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 508 installs · ★ 71048 repo stars
- Author: code-yeongyu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/code-yeongyu/oh-my-openagent/tree/HEAD/packages/skills-loader-core/src/features/builtin-skills/security-research/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/security-research

## What it does

The skill spins up a five-agent team through `team_create`. Three hunters split the work: `surface-hunter` maps entry points and trust boundaries, `auth-data-hunter` covers authorization, data isolation and injection, and `runtime-supply-hunter` looks at the filesystem, subprocesses, dependencies, hooks and MCP. Two PoC engineers, `poc-engineer-a` and `poc-engineer-b`, try to reproduce what the hunters report. The second one also tries to knock findings down.

A run goes through scoping, a hunter pass, a PoC pass, a cross-check among all five agents, and a report. The report opens with a verdict: `PASS`, `PASS WITH FINDINGS` or `BLOCK`. A finding gets no severity unless someone can name an attack path. Destructive exploits against live services are off the table, so proofs run on local fixtures or as static arguments.

It needs `team_*` tools. If they are missing, the skill halts and asks you to set `team_mode.enabled: true` in `.omo/omo.jsonc` and restart opencode. It runs only in the main session. With no target given, it audits the current repository and the branch diff.

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install code-yeongyu/oh-my-openagent packages/skills-loader-core/src/features/builtin-skills/security-research
```

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

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/code-yeongyu/oh-my-openagent --path packages/skills-loader-core/src/features/builtin-skills/security-research
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/security-research/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/code-yeongyu/oh-my-openagent/tree/HEAD/packages/skills-loader-core/src/features/builtin-skills/security-research/SKILL.md

## When to use it
- check a PR or branch diff for exploitable holes before merging
- separate a vulnerability with an attack path from generic hardening advice
- get a small reproducible PoC for a suspected bug
- find authorization bypasses and data leaks between tenants
- review hooks, MCP and archive extraction for path traversal and command injection

## Example prompts
- Run security-research on the diff of my current branch against its base
- Use security-research on the release candidate, no network calls and no destructive tests
- Audit this PR with security-research and give me the verdict first

## Similar
- [sast-sca-security-analyzer](https://affpapa.org/en/nevibecode/agents/sast-sca-security-analyzer.md) — subagent · ★ 41430 repo stars
- [security-auditor](https://affpapa.org/en/nevibecode/agents/security-auditor.md) — subagent · 10718 installs
- [Security Auditor](https://affpapa.org/en/nevibecode/mcp/security-auditor.md) — MCP server · 148 installs
- [engineering-security-engineer](https://affpapa.org/en/nevibecode/skills/engineering-security-engineer.md) — skill · 639 installs
- [security-engineer](https://affpapa.org/en/nevibecode/agents/josstei-security-engineer.md) — subagent · ★ 489 repo stars

From the same set: [code-yeongyu/oh-my-openagent](https://affpapa.org/en/nevibecode/by/code-yeongyu/oh-my-openagent.md) — 7 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
