stackhawk-hawkscan

A security-testing workflow that uses HawkScan, a tool for checking running web applications and APIs for vulnerabilities. It scans after code changes, reads the findings, and guides follow-up fixes.

In plain words
What is it for?
Use it to configure and run HawkScan DAST scans, review vulnerabilities, verify fixes, and repeat the scan-and-fix cycle. DAST means testing an application from the outside while it runs.
Why use it?
It helps catch security problems introduced by a feature, bug fix, or refactor instead of treating the work as finished before checking the running application.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/stackhawk/agent-skills/stackhawk-hawkscan
Clone the repo
git clone --depth 1 https://github.com/stackhawk/agent-skills

Made for: Cursor.

Per session 6,655 This file is loaded in full into every session.
When invoked 6,655 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.06655 $0.06655
Opus 5 $0.03327 $0.03327
Sonnet 5 $0.01331 $0.01331
Haiku 4.5 $0.00666 $0.00666

Measured 2d ago against content hash 8f7f98861fd6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

stackhawk-hawkscan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

cursor/.cursor/rules/stackhawk-hawkscan.mdc · 500 lines

How it starts

The opening of the file, as written. The whole thing — 500 lines — stays where its author put it; the contents beside it link to each section on GitHub.

HawkScan Skill

This skill enables Claude to act as the security testing orchestrator in an agentic coding loop. The core workflow is:

Code changes → Start Application/API → Configure HawkScan → Run scan → Parse findings → Generate fix tasks → Repeat


Prerequisites (preflight — run before anything else)

This skill requires hawk v6.0.0 or newer. Verify:

hawk version
hawk config --help >/dev/null 2>&1 || echo "MISSING: hawk config — upgrade hawk to v6.0.0+"
hawk skills status

If hawk is older than 6.0.0 or hawk config --help fails, stop and tell the user to upgrade before proceeding. Do not inline auth recipes from memory — they live in hawk config show and are stale by design when hardcoded.

hawk skills status reports whether the installed StackHawk agent skills are current. If it lists anything out of date, surface the exact upgrade command it prints (e.g. /plugin marketplace update stackhawk && /plugin update hawkscan) and recommend the user update before continuing — a stale skill may be missing fixes for the very issues you'll hit. It's a recommendation, not a hard stop: proceed if the user prefers. (If the subcommand isn't recognized, the installed hawk predates it — skip this check.)

See references/installation.md for upgrade and install instructions.


Companion Skills

The api skill wraps read-only StackHawk platform lookups via the hawk CLI (hawk op …):

Purpose Command
Check if App exists hawk op app list --format json
Check if Env exists hawk op env list --app <NAME|UUID> --format json
Get findings with triage hawk op scan get --app <NAME|UUID> --detail full --format json
List ASM repos hawk op repo list --format json
Link app to ASM repo hawk op repo link --repo-id <ID> --app-id <ID>
Get tech flags hawk op app tech-flags get --app <NAME|UUID> --format json
Disable all tech flags hawk op app tech-flags disable-all --app <NAME|UUID> --yes
Set specific tech flags hawk op app tech-flags set --app <NAME|UUID> Key=true
Triage a finding hawk op scan triage --scan <ID> --hash <HASH> --status false-positive --note ""
Bulk triage from file hawk op scan triage --scan <ID> --from-file triage.yaml
Annotate w/o triage perm hawk op finding note --scan <ID> --hash <HASH> --note "..."
Get scanned URIs hawk op scan uris <scanId> --format json (skip if the subcommand errors)
Get effective scan config hawk op scan config <scanId> (skip if the subcommand errors)

Read the full file on GitHub · 500 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 500 lines · 6,655 tokens per session scan A 8f7f98861fd6

Subscribe to this mod's changes

stackhawk-hawkscan is a cursor rule published in the GitHub repository stackhawk/agent-skills (15 stars, last pushed 11d ago), licensed MIT. It adds 6,655 tokens to every session, about $0.0333 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.