stackhawk-api — Claude Code plugin: what it does, how to install
stackhawk-api queries the StackHawk platform through CLI for security reporting and findings analysis. Helps track application risks and monitor changes between vulnerability scans.
MIT ★ 16 updated 2026-10-09
/plugin install stackhawk-api@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialWhat stackhawk-api does
The plugin teaches Claude Code to query the StackHawk platform using the hawk CLI. It collapses multi-step lookups into a single hawk op command with built-in pagination. Output comes back as structured JSON. The agent examines security findings and flags apps that lack recent scans.
You need a StackHawk account and the hawk CLI installed alongside jq. Interactive setups store credentials in ~/.hawk/hawk.properties through hawk init --browser. Headless agents and CI runs fail without HAWK_API_KEY set as an environment variable.
What it helps with
- summarize vulnerability alerts across all organization apps
- inspect findings from the latest scan of a selected service
- detect applications that have not been scanned for 30 days
- compare scans to reveal new, resolved, or modified findings
Example prompts for the agent
- What is my security posture across all apps?
- Show me the findings from the last scan of my payment-api.
- Which apps haven't been scanned in the last 30 days?
How to install stackhawk-api
Plugin marketplace
/plugin install stackhawk-api@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-api
How to install stackhawk-api in Claude Code?
First add the marketplace with /plugin marketplace add anthropics/claude-plugins-official, then install the plugin using /plugin install stackhawk-api@claude-plugins-official.
What does stackhawk-api do?
It queries the StackHawk platform API to report security postures, analyze vulnerabilities across apps, and track changes between scan runs directly in your chat.
What are the prerequisites for using stackhawk-api?
You need a StackHawk account, an API key, and local installations of jq and the hawk CLI. Authenticate interactive sessions with hawk init --browser or export the HAWK_API_KEY environment variable for CI and headless setups.
Source text
api · MIT
# StackHawk API Skill for Claude Security posture reporting and findings analysis powered by the [StackHawk platform API](https://apidocs.stackhawk.com), embedded directly into your Claude agentic workflow. ## What This Does This plugin teaches Claude how to query the StackHawk platform for security reporting. It authenticates, retrieves findings data across your applications and environments, and presents actionable security posture summaries — helping you understand where your risks are, what changed between scans, and which apps need attention. ``` Question → Authenticate → Query API via hawk op → Present Results → Suggest Next Actions ``` The skill uses the combined `hawk` CLI (`hawk op …`) — most operations collapse from a three-call drill-down pipeline into a single `hawk op` command with built-in auth, pagination, and JSON output. ## Prerequisites - A [StackHawk account](https://app.stackhawk.com) (free tier available) - A StackHawk API key — generate one at **Settings → API Keys** - The `hawk` CLI installed and initialized via `hawk init --browser` (stores credentials in `~/.hawk/hawk.properties`) - For any non-interactive session (CI, containers, headless agents): `HAWK_API_KEY` set as an environment variable - `jq` installed (used for JSON processing in recipes) ## Installation ```bash # Add the StackHawk marketplace /plugin marketplace add stackhawk/agent-skills # Install the StackHawk API skill /plugin install stackhawk-api@stackhawk ``` ## Usage Once installed, Claude will use the StackHawk API skill when you ask questions like: > "What's my security posture across all apps?" > "Show me the findings from the last scan of my payment-api" > "Which apps haven't been scanned in the last 30 days?" > "What changed since the last scan of my auth-service?" ## Supported Queries - **Org-wide security posture summaries** — aggregate findings and severity counts across all applications - **Per-app findings deep dives** — drill from application → scan → alerts → individual findings - **Stale app detection** — identify applications that haven't been scanned recently - **Scan comparison** — surface what changed (new, resolved, or modified findings) between scans - **Team and environment management** — view apps by team, environment, or environment type ## Security Note Never hardcode your API key. For interactive local use, `hawk init` stores credentials locally. For any non-interactive session (CI, containers, headless agents), set `HAWK_API_KEY` as a secret — never inline key values in scripts or configs. StackHawk issues this key. The `hawk op` CLI uses it to authenticate with the StackHawk platform API. The plugin does not send the key to documentation or CLI download URLs. ## Resources - [hawk CLI docs](https://docs.stackhawk.com) - [StackHawk API Docs](https://apidocs.stackhawk.com) - [StackHawk Platform](https://app.stackhawk.com) - [StackHawk Support](https://support.stackhawk.com) ## License MIT © [StackHawk](https://www.stackhawk.com)
© StackHawk · MIT · stackhawk/agent-skills