crabtrap-llm-proxy — Claude Code skill: what it does, how to install
Guides setup of CrabTrap forward proxy to intercept agent HTTP requests, evaluating outbound traffic against static rules and an LLM judge before reaching remote APIs.
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a claude-codeWhat crabtrap-llm-proxy does
CrabTrap runs as an outbound HTTP/HTTPS gateway on port 8080 between autonomous agents and outside web services. It first applies deterministic checks against target URLs using prefix, exact, or glob patterns. When no static rule matches, the request routes to a language model like gpt-4o for security evaluation. Blocked calls immediately return status 403.
Deployment requires Docker Compose with PostgreSQL 16 and CrabTrap images, along with an API key for OpenAI or Anthropic. Inspecting HTTPS traffic fails completely without the custom ca.crt authority file mounted or trusted by the client. An administrative control plane runs separately on port 8081 for user and rule management.
What it helps with
- stop unauthorized SSRF requests to internal subnets
- filter outbound API calls using path prefixes and wildcards
- evaluate questionable request payloads with an LLM judge
- record audit traces and proxy decisions inside PostgreSQL
Example prompts for the agent
- Set up CrabTrap with docker compose and show how to create an agent proxy token.
- Create a static rule in CrabTrap that blocks all DELETE calls to GitHub repositories.
- Configure CrabTrap to evaluate outbound requests with an LLM security policy.
How to install crabtrap-llm-proxy
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a claude-code2Manually: put the files in place
~/.claude/skills/crabtrap-llm-proxy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/crabtrap-llm-proxy/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a codex2Manually: put the files in place
.agents/skills/crabtrap-llm-proxy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a cursor2Manually: put the files in place
.cursor/skills/crabtrap-llm-proxy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills crabtrap-llm-proxy2Manually: put the files in place
.github/skills/crabtrap-llm-proxy/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/crabtrap-llm-proxyManually: put the files in place
.devin/skills/crabtrap-llm-proxy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about crabtrap-llm-proxy
How do I install crabtrap-llm-proxy in Claude Code?
Run npx skills add reason-machines/trending-skills --skill crabtrap-llm-proxy -a claude-code. The skill file installs to ~/.claude/skills/crabtrap-llm-proxy/SKILL.md.
What does crabtrap-llm-proxy do?
It configures a forward proxy that intercepts outbound HTTP traffic from AI agents. Requests face static URL checks and an LLM judge, and all verdicts go to a PostgreSQL audit log.
What dependencies are needed to run CrabTrap?
You need Docker Compose running CrabTrap and PostgreSQL 16, plus an API key for OpenAI or Anthropic. Intercepting HTTPS also requires trusting the generated ca.crt file.