Agent skill · marketing growth · jeremylongshore
openrouter-known-pitfalls
Avoid common OpenRouter integration mistakes and gotchas. Use proactively
Why this skill is useful
Provides specific integration patterns and common pitfalls for OpenRouter that the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. Requires openrouter account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
OpenRouter Known Pitfalls Overview A curated list of real-world mistakes developers make when integrating OpenRouter, each with the specific API behavior that causes the problem and the exact fix. These are not theoretical -- they come from production incidents and support requests. Prerequisites An existing (or in-progress) OpenRouter integration to audit against the 10 pitfalls below An OpenRouter API key (sk-or-v1-...) exported as OPENROUTERAPIKEY — see the openrouter-install-auth skill for setup Python 3.8+ with the OpenAI SDK (pip install openai) to run the validation snippets (e.g., the startup check against /api/v1/models) Grep access to the codebase to hunt hardcoded sk-or-v1- keys and scattered model IDs Instructions 1. Audit request format first: every model ID uses the provider/model form (Pitfall 1), and model IDs live in one MODELS config validated against /api/v1/models at startup instead of being scattered through the code (Pitfall 3). 2. Check cost controls: maxtokens is set on every request (Pitfall 2) and no :free models are used in production, where the 50-1000 req/day limits will 429 you (Pitfall 5). 3. Review routing: sensitive-data requests pin provider.order with allowfallbacks: False (Pitfall 4), and response.model is logged on every call to catch unexpected fallbacks (Pitfall 6). 4. Inspect client hygiene: one shared client instance with connection pooling (Pitfall 7) configured with timeout and maxretries (Pitfall 9). 5. Sweep for secrets: grep for hardcoded sk-or-v1- strings and move any hits to env vars or a secrets manager, rotating the exposed keys (Pitfall 8). 6. Verify caching only stores deterministic temperature=0 responses (Pitfall 10). 7. Finish by walking the Quick Checklist (PITFALLCHECKLIST) top to bottom — it condenses all 10 pitfalls into a code-review pass. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/openrouter-known-pitfalls--994636