Agent skill · software engineering · jeremylongshore
juicebox-sdk-patterns
Apply production Juicebox SDK patterns.
Why this skill is useful
Provides specific patterns and a singleton client implementation for the Juicebox API that the AI wouldn't reliably generate on its own.
What it needs
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 SDK Patterns Overview Production-ready patterns for the Juicebox AI-powered people search API. Juicebox provides REST endpoints for searching professional profiles and enriching candidate data. The API authenticates via JUICEBOXAPIKEY and returns structured profile objects with LinkedIn URLs as natural dedup keys. A singleton client centralizes rate-limit handling across search and enrich endpoints. Singleton Client Error Wrapper Request Builder Response Types Testing Utilities Error Handling Pattern When to Use Example --------- ------------- --------- safeCall wrapper All Juicebox API calls Structured error with operation context Retry on 429 Batch search pipelines 5s backoff before retry LinkedIn dedup Multi-query search Set<string> on linkedinurl prevents duplicates Cursor pagination Search results > 100 Pass cursor from previous response Prerequisites A typed client boundary, secret-manager reference, sandbox workspace, approved source/destination allowlist, and synthetic prospect fixture. Instructions 1. Construct clients from scoped environment configuration and reject unknown workspace, source, or destination before a request is sent. 2. Centralize source-authority, suppression, schema, redaction, and idempotency checks in the client boundary. 3. Model partial/denied responses explicitly; never turn a denied or unverified enrichment into a success or export fallback. 4. Test malformed data, rate limits, source/suppression rejection, and rollback using synthetic fixtures only. Output Produce a client-contract receipt with SDK revision, environment, source/destination policy revisions, fixture result, error classification, aggregate counts, export-count assertion, and rollback behavior. Exclude contacts, enrichment data, and credentials. Examples sdk=v3; env=sandbox; source=synthetic; destination=approved; suppression=pass; malformed=blocked; contactsexported=0; telemetry=aggregate-only is a safe SDK result. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/juicebox-sdk-patterns--a7e468