stackhawk-hawkscan — Claude Code plugin: DAST scans
stackhawk-hawkscan is a Claude Code plugin that configures HawkScan, scans apps, and turns findings into prioritized fix tasks. It checks APIs and web apps during development or in CI.
MIT ★ 16 updated 2026-10-09
/plugin install stackhawk-hawkscan@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialWhat stackhawk-hawkscan does
The plugin builds or adjusts stackhawk.yml around your app’s stack and authentication setup, validates the configuration, then runs HawkScan through the hawk CLI or Docker. Claude can interpret scan results, prioritize fixes, and scan again after code changes. Supported targets include REST/OpenAPI, GraphQL, gRPC, SOAP, and standard web apps; authentication options include bearer tokens, OAuth2, and form login.
You need a StackHawk account, an API key, and either hawk or Docker. For interactive use, hawk init --browser stores credentials locally; set HAWK_API_KEY for CI and other non-interactive sessions. Keep the key out of stackhawk.yml: the CLI or HawkScan image uses it to authenticate with StackHawk and upload scan results.
What it helps with
- configure
stackhawk.ymlfor an app and its auth flow - run a DAST scan with the CLI or Docker
- turn HawkScan findings into prioritized fix tasks
- rerun a scan after code changes
- set up security scans for CI/CD
Example prompts for the agent
- Set up HawkScan for my REST API and run a scan.
- Help me debug the authentication failure in HawkScan.
- Turn these scan results into prioritized fix tasks.
How to install stackhawk-hawkscan
Plugin marketplace
/plugin install stackhawk-hawkscan@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about stackhawk-hawkscan
How do I install stackhawk-hawkscan in Claude Code?
Add the marketplace with /plugin marketplace add anthropics/claude-plugins-official, then install the plugin with /plugin install stackhawk-hawkscan@claude-plugins-official.
What does stackhawk-hawkscan do?
It configures and runs HawkScan, interprets DAST findings, and prepares prioritized repair tasks. It can run another scan after fixes are made.
What do I need to run HawkScan?
You need a StackHawk account, an API key, and either the hawk CLI or Docker. Run hawk init --browser for interactive use, or provide HAWK_API_KEY as a secret in CI.
Source text
hawkscan · MIT
# HawkScan Skill for Claude Dynamic application and API security testing (DAST) powered by [StackHawk HawkScan](https://www.stackhawk.com), embedded directly into your Claude agentic workflow. ## What This Does This plugin teaches Claude how to act as the security testing orchestrator in an agentic coding loop: ``` Code changes → Configure HawkScan → Run scan → Parse findings → Generate fix tasks → Repeat ``` Claude will automatically: - Generate or tune `stackhawk.yml` configuration based on your app's stack and auth pattern - Run HawkScan via CLI (`hawk`) or Docker - Validate config before burning a full scan run - Parse scan findings and produce prioritized, actionable fix tasks - Re-run scans after fixes to confirm remediation ## Prerequisites - A [StackHawk account](https://app.stackhawk.com) (free tier available) - A StackHawk API key — generate one at **Settings → API Keys** - HawkScan CLI (`hawk`) or Docker installed - `hawk init --browser` run to store credentials locally (interactive use); or `HAWK_API_KEY` set for any non-interactive session (CI, containers, headless agents) ## Installation ```bash # Add the StackHawk marketplace /plugin marketplace add stackhawk/agent-skills # Install the HawkScan skill /plugin install hawkscan@stackhawk ``` ## Usage Once installed, Claude will automatically use the HawkScan skill when you: - Ask it to scan your app for security issues - Reference `stackhawk.yml`, `hawkscan`, or DAST - Ask it to set up security testing in your project or CI pipeline - Have it fix code — it will proactively suggest running a scan You can also trigger it explicitly: > "Set up HawkScan for my Express API and run a scan" > "My HawkScan auth is failing, help me debug it" > "Turn these scan findings into fix tasks" ## Supported Configurations - **App types**: REST/OpenAPI, GraphQL, gRPC, SOAP, standard web apps - **Auth patterns**: Bearer token, form login, cookie, OAuth2/external IdP, custom scripts - **Runtimes**: `hawk` CLI, Docker (`stackhawk/hawkscan`) - **Environments**: Local dev, CI/CD (GitHub Actions, GitLab, etc.) ## Security Note Never hardcode credentials in `stackhawk.yml`. For interactive local use, `hawk init` stores your API key in `~/.hawk/hawk.properties`. For any non-interactive session (CI, containers, headless agents), set `HAWK_API_KEY` as a secret — never inline key values in config files or scripts. StackHawk issues this key. The `hawk` CLI or official HawkScan image uses it to authenticate with the StackHawk platform and upload scan results. The key is not sent to the application being scanned or to the CLI download and documentation sites. ## Resources - [HawkScan Docs](https://docs.stackhawk.com/hawkscan/) - [StackHawk CLI Reference](https://docs.stackhawk.com/stackhawk-cli/) - [Auth Configuration Examples](https://github.com/kaakaww/hawkscan-examples) - [StackHawk Support](https://support.stackhawk.com) ## License MIT © [StackHawk](https://www.stackhawk.com)
© StackHawk · MIT · stackhawk/agent-skills