# Footgun Scan (agent skill)

> Footgun Scan is an agent skill (a SKILL.md file) from maxrave-dev/kotlin-footguns. Scan a Kotlin or Compose Multiplatform diff for known footgun shapes and open the matching trap to confirm each hit. It works with Claude Code, Codex, Cursor and GitHub Copilot and has 1,004 GitHub stars.

Scan a Kotlin or Compose Multiplatform diff for known footgun shapes and open the matching trap to confirm each hit. Use before committing, when reviewing a Kotlin change, or to audit a codebase. scripts/scan.py matches 32 patterns against the lines a change adds. Each pattern is tied to one trap file in the kotlin-footguns area skills. It finds shapes, not bugs: every hit needs the trap's judgment before it becomes a finding.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/maxrave-dev/kotlin-footguns |
| Skill path | skills/footgun-scan/SKILL.md |
| Skill name | footgun-scan |
| GitHub stars | 1,004 |
| Installs on skills.sh | not listed |
| License | GPL-3.0 |
| Skills in repo | 1 |
| Plugin marketplace | maxrave |
| Official | no |
| Works with | Claude Code, Codex, Cursor, GitHub Copilot |
| Category | Security |
| Last commit | Sep 25, 2026 |

## When it triggers

- Use before committing, when reviewing a Kotlin change, or to audit a codebase.

## Add this skill

### Claude Code

```sh
/plugin marketplace add maxrave-dev/kotlin-footguns
/plugin install kotlin-footguns@maxrave
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/maxrave-dev/kotlin-footguns.git
cp -r kotlin-footguns/skills/footgun-scan .agents/skills/footgun-scan   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/maxrave-dev/kotlin-footguns.git
cp -r kotlin-footguns/skills/footgun-scan .cursor/skills/footgun-scan   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/maxrave-dev-footgun-scan
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.