Agent skill · software engineering · jeremylongshore
juicebox-upgrade-migration
Plan Juicebox SDK upgrades.
Why this skill is useful
Adds executable migration scripts and a comprehensive checklist for upgrading the Juicebox SDK, which are not available in public documentation.
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 Upgrade & Migration Overview Juicebox is an AI-powered people search and analysis platform used for recruiting and market research. The API provides endpoints for dataset management, people searches, and AI-generated analyses. Tracking API versions is essential because Juicebox evolves its search query syntax, dataset schema, and analysis output format — upgrading without testing can break saved search filters, corrupt dataset imports, and change the structure of AI-generated candidate profiles that downstream systems consume. Version Detection Migration Checklist [ ] Review Juicebox changelog for API breaking changes [ ] Audit codebase for hardcoded dataset field names [ ] Verify search query syntax — filter operators may have changed [ ] Check analysis output format for new or renamed fields [ ] Update dataset import schema if column mapping changed [ ] Test people search result structure (profile fields, enrichment data) [ ] Validate pagination — cursor-based vs. offset may have changed [ ] Update SDK version in package.json and verify type compatibility [ ] Check webhook payloads for analysis completion events [ ] Run integration tests with sample dataset to verify search quality Schema Migration Rollback Strategy Error Handling Migration Issue Symptom Fix ---------------- --------- ----- Search filter syntax changed 400 Bad Request with invalid filter operator Update filter syntax to new query DSL format Dataset schema mismatch Import succeeds but columns mapped incorrectly Re-map dataset columns using /datasets/schema endpoint Profile field restructured Code crashes accessing result.name (now result.profile.fullname) Update all property access paths to new nested structure Analysis format changed AI analysis output missing expected sections Update parser for new structured analysis response Rate limit reduced 429 Too Many Requests on previously working batch sizes Reduce batch size and implement request queuing Prerequisites An approved change record, …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/juicebox-upgrade-migration--1a16ca