[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M791VCYKMREM279A47A0ZJS6":3,"skill-same:01M791VCYKMREM279A47A0ZJS6":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M791VCYKMREM279A47A0ZJS6","juicebox-common-errors",null,"Diagnose and fix Juicebox API errors.\nTrigger: \"juicebox error\", \"fix juicebox\", \"debug juicebox\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--juicebox-pack--juicebox-common-errors\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: juicebox-common-errors\ndescription: |\n  Diagnose and fix Juicebox API errors.\n  Trigger: \"juicebox error\", \"fix juicebox\", \"debug juicebox\".\nallowed-tools: Read, Grep, Bash(curl:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, recruiting, juicebox]\ncompatible-with: claude-code\n---\n\n# Juicebox Common Errors\n\n## Overview\n\nJuicebox provides AI-powered people search and analysis for recruiting and research workflows. API integrations cover search queries, profile enrichment, dataset operations, and quota management. Common errors include dataset format mismatches when uploading CSVs, analysis timeouts on large candidate pools, and quota exhaustion on free or starter plans. The quota system counts individual profile enrichments separately from search queries, which often surprises new integrators. This reference covers HTTP errors, business logic failures, and recovery strategies for reliable Juicebox integrations.\n\n## Error Reference\n\n| Code | Message | Cause | Fix |\n|------|---------|-------|-----|\n| `400` | `Invalid query format` | Malformed search query or empty filters | Ensure query is non-empty; validate filter field names |\n| `401` | `invalid_api_key` | API key missing or revoked | Verify key at app.juicebox.ai > Settings > API |\n| `403` | `quota_exceeded` | Plan search limit reached | Check quota in dashboard; upgrade plan or wait for reset |\n| `404` | `Profile not found` | Candidate removed or profile unavailable | Re-run search to find updated profile data |\n| `408` | `Analysis timeout` | Complex query exceeded 60s limit | Reduce dataset size or narrow search filters |\n| `413` | `Dataset too large` | Upload exceeds 50MB or 100K row limit | Split dataset into smaller chunks before upload |\n| `422` | `Invalid dataset format` | CSV headers don't match expected schema | Use template from Juicebox docs; required: `name`, `title`, `company` |\n| `429` | `Rate limited` | Exceeded 30 requests\u002Fminute | Check `Retry-After` header; implement exponential backoff |\n\n## Error Handler\n\n```typescript\ninterface JuiceboxError {\n  code: number;\n  message: string;\n  category: \"auth\" | \"rate_limit\" | \"validation\" | \"timeout\";\n}\n\nfunction classifyJuiceboxError(status: number, body: string): JuiceboxError {\n  if (status === 401 || status === 403) {\n    return { code: status, message: body, category: \"auth\" };\n  }\n  if (status === 429) {\n    return { code: 429, message: \"Rate limited\", category: \"rate_limit\" };\n  }\n  if (status === 408) {\n    return { code: 408, message: body, category: \"timeout\" };\n  }\n  return { code: status, message: body, category: \"validation\" };\n}\n```\n\n## Debugging Guide\n\n### Authentication Errors\nJuicebox API keys are passed via `Authorization: Bearer` header. Keys are scoped per workspace. If you receive 401, verify the key has not been rotated at app.juicebox.ai > Settings. A 403 indicates quota exhaustion, not a permissions issue -- check your plan's remaining searches.\n\n### Rate Limit Errors\nThe API enforces 30 requests\u002Fminute per key. Batch profile enrichment calls where possible. Use the `Retry-After` response header to determine wait time. For bulk operations, use the dataset upload endpoint instead of individual search queries.\n\n### Validation Errors\nDataset uploads require CSV format with headers matching the Juicebox schema: `name`, `title`, `company` are required columns. Optional enrichment columns include `email`, `linkedin_url`, and `location`. Files over 50MB or 100K rows are rejected -- split into chunks. Analysis queries that exceed 60 seconds timeout with 408; narrow filters by adding location, title, or company constraints to reduce result set size.\n\n## Error Handling\n\n| Scenario | Pattern | Recovery |\n|----------|---------|----------|\n| Quota exceeded mid-batch | 403 after N successful calls | Track remaining quota via response headers; pause and resume |\n| Dataset upload rejected | Invalid CSV format | Download template, reformat, and retry |\n| Analysis timeout | Large candidate pool | Add location\u002Ftitle\u002Fcompany filters to narrow scope |\n| Profile data stale | 404 on enrichment | Re-run search query to get current profile URLs |\n| Rate limit during bulk search | 429 on sequential calls | Switch to dataset upload for bulk operations |\n\n## Quick Diagnostic\n\n```bash\n# Verify API connectivity and key validity\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -H \"Authorization: Bearer $JUICEBOX_API_KEY\" \\\n  https:\u002F\u002Fapi.juicebox.ai\u002Fv1\u002Fhealth\n```\n\n## Resources\n\n- [Juicebox Documentation](https:\u002F\u002Fdocs.juicebox.work)\n- [Juicebox API Reference](https:\u002F\u002Fapi.juicebox.ai\u002Fdocs)\n\n## Next Steps\n\nSee `juicebox-debug-bundle`.\n","# Juicebox Common Errors\n\n## Overview\n\nJuicebox provides AI-powered people search and analysis for recruiting and research workflows. API integrations cover search queries, profile enrichment, dataset operations, and quota management. Common errors include dataset format mismatches when uploading CSVs, analysis timeouts on large candidate pools, and quota exhaustion on free or starter plans. The quota system counts individual profile enrichments separately from search queries, which often surprises new integrators. This reference covers HTTP errors, business logic failures, and recovery strategies for reliable Juicebox integrations.\n\n## Error Reference\n\n| Code | Message | Cause | Fix |\n|------|---------|-------|-----|\n| `400` | `Invalid query format` | Malformed search query or empty filters | Ensure query is non-empty; validate filter field names |\n| `401` | `invalid_api_key` | API key missing or revoked | Verify key at app.juicebox.ai > Settings > API |\n| `403` | `quota_exceeded` | Plan search limit reached | Check quota in dashboard; upgrade plan or wait for reset |\n| `404` | `Profile not found` | Candidate removed or profile unavailable | Re-run search to find updated profile data |\n| `408` | `Analysis timeout` | Complex query exceeded 60s limit | Reduce dataset size or narrow search filters |\n| `413` | `Dataset too large` | Upload exceeds 50MB or 100K row limit | Split dataset into smaller chunks before upload |\n| `422` | `Invalid dataset format` | CSV headers don't match expected schema | Use template from Juicebox docs; required: `name`, `title`, `company` |\n| `429` | `Rate limited` | Exceeded 30 requests\u002Fminute | Check `Retry-After` header; implement exponential backoff |\n\n## Error Handler\n\n```typescript\ninterface JuiceboxError {\n  code: number;\n  message: string;\n  category: \"auth\" | \"rate_limit\" | \"validation\" | \"timeout\";\n}\n\nfunction classifyJuiceboxError(status: number, body: string): JuiceboxError {\n  if (status === 401 || status === 403) {\n    return { code: status, message: body, category: \"auth\" };\n  }\n  if (status === 429) {\n    return { code: 429, message: \"Rate limited\", category: \"rate_limit\" };\n  }\n  if (status === 408) {\n    return { code: 408, message: body, category: \"timeout\" };\n  }\n  return { code: status, message: body, category: \"validation\" };\n}\n```\n\n## Debugging Guide\n\n### Authentication Errors\nJuicebox API keys are passed via `Authorization: Bearer` header. Keys are scoped per workspace. If you receive 401, verify the key has not been rotated at app.juicebox.ai > Settings. A 403 indicates quota exhaustion, not a permissions issue -- check your plan's remaining searches.\n\n### Rate Limit Errors\nThe API enforces 30 requests\u002Fminute per key. Batch profile enrichment calls where possible. Use the `Retry-After` response header to determine wait time. For bulk operations, use the dataset upload endpoint instead of individual search queries.\n\n### Validation Errors\nDataset uploads require CSV format with headers matching the Juicebox schema: `name`, `title`, `company` are required columns. Optional enrichment columns include `email`, `linkedin_url`, and `location`. Files over 50MB or 100K rows are rejected -- split into chunks. Analysis queries that exceed 60 seconds timeout with 408; narrow filters by adding location, title, or company constraints to reduce result set size.\n\n## Error Handling\n\n| Scenario | Pattern | Recovery |\n|----------|---------|----------|\n| Quota exceeded mid-batch | 403 after N successful calls | Track remaining quota via response headers; pause and resume |\n| Dataset upload rejected | Invalid CSV format | Download template, reformat, and retry |\n| Analysis timeout | Large candidate pool | Add location\u002Ftitle\u002Fcompany filters to narrow scope |\n| Profile data stale | 404 on enrichment | Re-run search query to get current profile URLs |\n| Rate limit during bulk search | 429 on sequential calls | Switch to dataset upload for bulk operations |\n\n## Quick Diagnostic\n\n```bash\n# Verify API connectivity and key validity\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -H \"Authorization: Bearer $JUICEBOX_API_KEY\" \\\n  https:\u002F\u002Fapi.juicebox.ai\u002Fv1\u002Fhealth\n```\n\n## Resources\n\n- [Juicebox Documentation](https:\u002F\u002Fdocs.juicebox.work)\n- [Juicebox API Reference](https:\u002F\u002Fapi.juicebox.ai\u002Fdocs)\n\n## Next Steps\n\nSee `juicebox-debug-bundle`.\n",{"name":5,"tags":24,"author":28,"license":15,"version":29,"description":30,"allowed-tools":31,"compatible-with":32},[25,26,27],"saas","recruiting","juicebox","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Diagnose and fix Juicebox API errors.\nTrigger: \"juicebox error\", \"fix juicebox\", \"debug juicebox\".\n","Read, Grep, Bash(curl:*)","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--juicebox-pack--juicebox-common-errors",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill juicebox-common-errors",{"tool":48,"command":49},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill juicebox-common-errors",{"tool":51,"command":52},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill juicebox-common-errors","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--juicebox-pack--juicebox-common-errors\u002FSKILL.md",true,[],[57,64,71,78,85,93],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]