Agent skill · software engineering · jeremylongshore
juicebox-local-dev-loop
Configure Juicebox local dev workflow.
Why this skill is useful
Adds specific mock server setup and testing workflows for Juicebox API integration that the AI wouldn't reliably generate on its own.
What it needs
Requires npm installed locally. Requires juicebox account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Juicebox Local Dev Loop Overview Local development workflow for Juicebox AI-powered people analysis and recruiting API integration. Provides a fast feedback loop with mock profile search results and candidate enrichment data so you can build talent pipeline tools without consuming live API credits. Toggle between mock mode for rapid iteration and sandbox mode for validating against the real Juicebox API. Environment Setup Dev Server Mock Mode Testing Workflow Debug Tips Set search limit to 5 in development to avoid burning API credits Use /v1/usage endpoint to monitor credit consumption before switching off mock mode Juicebox search queries are natural language — test with specific role titles for better results Check profiles[].skills array for null values that can break filtering logic Log the full request payload to verify boolean filters are serialized correctly Error Handling Issue Cause Fix ------- ------- ----- 401 Unauthorized Invalid API key Regenerate at Juicebox dashboard 402 Payment Required Credits exhausted Upgrade plan or wait for monthly reset 400 Bad Request Malformed search query Validate query structure before sending 429 Rate Limited Too many requests per minute Add exponential backoff, use mock mode ECONNREFUSED :3004 Dev server not running Run npm run dev:mock first Prerequisites A local sandbox configured for mock or synthetic data, secret references instead of literal keys, source/destination allowlists, suppression fixtures, and a tested cleanup command. Instructions 1. Start in mock mode and use only synthetic records; do not switch to an integration environment until source authority and owner approval are recorded. 2. Log aggregate diagnostics only, verify suppression and contactsexported=0, and reject requests that contain credentials or contact-level data. 3. Test one canary workflow at a time; halt on scope, policy, quota, or retention drift and restore the known-good configuration. 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/juicebox-local-dev-loop