Agent skill · JuliusBrussee
caveman-setup
Wire the current repository through the Caveman Cloud gateway so every LLM request is measured — cost, tokens, latency — with zero behavior change. Use when the user pastes the Caveman setup prompt, says "set up caveman", or wants LLM spend observability added to an app. Requires the gateway URL and a Cave API key (the setup prompt carries both).
What it needs
About 6k tokens when loaded.
What this skill does
You are wiring this repository through the Caveman gateway. Caveman is a byte-preserving LLM proxy: in record mode it measures what your app sends and what it costs, and changes nothing else. Your job is a minimal, verified integration — not a refactor. The prompt that sent you here provides four values. Refer to them as: GATEWAY — the gateway base URL (e.g. https://gateway.caveman.so or http://127.0.0.1:8787) CAVEAPIKEY — the gateway auth secret (treat like any API key: env var only, never committed, never printed in full) PROVIDERKEYS — stored (provider keys live encrypted in Caveman Cloud) or byok (this app sends its own provider key per request) DASHBOARD — the dashboard base URL (e.g. https://app.caveman.so) If any value is missing, stop and ask for it. Do not guess a URL or mint a key. Rules (non-negotiable) 1. Coherent integration. Wire every live LLM callsite through existing configuration and responsible seams. Touch each layer correctness requires. No drive-by refactors or formatting sweeps; add an abstraction only when it clarifies ownership or lowers lifecycle cost. 2. Secrets stay in env vars. CAVEAPIKEY goes into the env file the repo already uses (.env, .env.local, …). If that file isn't gitignored, add it to .gitignore and say so. Never hardcode the key in source. 3. Report only what you observed. The final report states the HTTP status and usage numbers from the real verification response — never assumed success. If verification fails, report the failure template instead. 4. Record mode only. You are adding measurement. You do not enable any optimization, and you do not claim any savings — verified savings are $0 until an optimizer is explicitly turned on and passes its eval gate. 5. Provider keys are not your business. With PROVIDERKEYS: stored you never see one. With byok, the app's existing provider key stays exactly where it already is. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills JuliusBrussee/caveman-setup