# hunt-oauth

hunt-oauth guides security checks for OAuth, OIDC, SAML, and JWT authentication. Use it when reviewing a sign-in flow or an MCP server.

- 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/pentest-agents-hunt-oauth/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/h-mmer-hunt-oauth

## What it does

The skill focuses on flaws in OAuth 2.0 and 2.1, OpenID Connect, SAML SSO, and JWT handling. It is relevant when an application processes values such as `redirect_uri`, `state`, `code`, `access_token`, or `id_token`, or when you are reviewing federated sign-in.

Its guidance draws on public vulnerability reports and cases checked against NVD. Examples include loose redirect URI validation, PKCE downgrade issues, JWT algorithm confusion, and SAML signature validation flaws. Treat the findings as leads to investigate; a pattern alone does not confirm that a particular project is vulnerable.

For Claude Code, install from the repository with the command below, then check for `~/.claude/skills/pentest-agents-hunt-oauth/SKILL.md`. Install commands are also provided for Cursor, Codex, GitHub Copilot, Gemini CLI, and Windsurf.

## Requirements
- Works with: GitHub, Obsidian

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/pentest-agents-hunt-oauth/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/pentest-agents-hunt-oauth
```

2. **Manually: put the files in place**
- File: `.github/skills/pentest-agents-hunt-oauth/SKILL.md`

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/H-mmer/pentest-agents --path providers/cursor/.cursor/skills/pentest-agents-hunt-oauth
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pentest-agents-hunt-oauth/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/pentest-agents-hunt-oauth/SKILL.md

## When to use it
- inspect OAuth handling of `redirect_uri` and `state`
- find weak PKCE checks in an authorization flow
- review JWT algorithm selection and validation
- check SAML signature verification
- audit OIDC token and claim handling

## Example prompts
- Review this project's OAuth sign-in for unsafe `redirect_uri` handling and missing `state` validation.
- Check JWT validation for algorithm confusion and unsafe handling of `kid`.
- Audit the SAML SSO flow, focusing on signature checks and assertion parsing.

## Similar
- [hunt-auth-bypass](https://affpapa.org/en/nevibecode/skills/hunt-auth-bypass.md) — skill · ★ 16193 repo stars
- [infisical-sso](https://affpapa.org/en/nevibecode/skills/infisical-sso.md) — skill · 237 installs
- [oauth-implementation](https://affpapa.org/en/nevibecode/skills/aj-geddes-oauth-implementation.md) — skill · 560 installs
- [oauth-oidc-implementer](https://affpapa.org/en/nevibecode/skills/oauth-oidc-implementer.md) — skill · 183 installs
- [keycloak-administration](https://affpapa.org/en/nevibecode/skills/keycloak-administration.md) — skill · 336 installs
- [hunt-saml](https://affpapa.org/en/nevibecode/skills/hunt-saml.md) — skill · ★ 16193 repo stars

## Other versions with the same name
- [hunt-oauth · elementalsouls](https://affpapa.org/en/nevibecode/skills/hunt-oauth.md) — ★ 16193 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
