[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M754RWD976VMG9235W7239H4":3,"skill-same:01M754RWD976VMG9235W7239H4":49},{"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":29,"commitSha":30,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M754RWD976VMG9235W7239H4","openevidence-common-errors",null,"Diagnose and resolve common OpenEvidence API errors.\nUse when encountering error codes, debugging failed requests,\nor implementing error handling for clinical queries.\nTrigger with phrases like \"openevidence error\", \"openevidence failing\",\n\"fix openevidence\", \"openevidence debug\", \"openevidence 4xx\", \"openevidence 5xx\".","SamuelChien\u002Fmega-skills-collection","SamuelChien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4652114?v=4","01M74KK34WVHA0P5ZYSJRDDFMG","Samuel Chien","01M74KK35FQN1N9VZ9EPTH3P2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fopenevidence-common-errors\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: openevidence-common-errors\ndescription: |\n  Diagnose and resolve common OpenEvidence API errors.\n  Use when encountering error codes, debugging failed requests,\n  or implementing error handling for clinical queries.\n  Trigger with phrases like \"openevidence error\", \"openevidence failing\",\n  \"fix openevidence\", \"openevidence debug\", \"openevidence 4xx\", \"openevidence 5xx\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ncompatible-with: claude-code, codex, openclaw\n---\n# OpenEvidence Common Errors\n\n## Overview\nComprehensive guide to diagnosing and resolving OpenEvidence API errors with healthcare-specific considerations.\n\n## Prerequisites\n- OpenEvidence SDK installed\n- Access to application logs\n- Understanding of HTTP status codes\n\n## Error Code Reference\n\n### Authentication Errors (4xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 401 | Invalid API Key | Key missing, malformed, or revoked | Verify `OPENEVIDENCE_API_KEY` is set correctly |\n| 401 | Organization Not Found | Invalid `orgId` | Check organization ID in dashboard |\n| 401 | BAA Not Signed | Business Associate Agreement required | Contact compliance@openevidence.com |\n| 403 | Forbidden | Insufficient permissions or suspended account | Check account status in dashboard |\n| 403 | IP Not Whitelisted | Request from non-approved IP | Add IP to allowlist in security settings |\n\n### Request Errors (4xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 400 | Invalid Query | Malformed request body | Check request schema |\n| 400 | Query Too Short | Question too brief | Provide more clinical context |\n| 400 | Invalid Specialty | Unknown specialty code | Use valid specialty from enum |\n| 404 | Resource Not Found | Invalid consultId or endpoint | Verify ID and URL |\n| 422 | Unprocessable | Valid JSON but invalid clinical query | Rephrase question |\n| 429 | Rate Limited | Too many requests | Implement backoff, check quotas |\n\n### Server Errors (5xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 500 | Internal Server Error | OpenEvidence backend issue | Retry with backoff, contact support if persists |\n| 502 | Bad Gateway | Upstream service issue | Wait and retry |\n| 503 | Service Unavailable | Maintenance or overload | Check status.openevidence.com |\n| 504 | Gateway Timeout | Request took too long | Simplify query, increase timeout |\n\n## Error Handling Implementation\n\n### Step 1: Custom Error Classes\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferrors.ts\nexport class OpenEvidenceError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly statusCode: number,\n    public readonly retryable: boolean,\n    public readonly originalError?: Error\n  ) {\n    super(message);\n    this.name = 'OpenEvidenceError';\n  }\n\n  static fromApiError(error: any): OpenEvidenceError {\n    const statusCode = error.response?.status || 500;  # HTTP 500 Internal Server Error\n    const message = error.response?.data?.message || error.message;\n    const code = error.response?.data?.code || 'UNKNOWN_ERROR';\n\n    return new OpenEvidenceError(\n      message,\n      code,\n      statusCode,\n      isRetryable(statusCode),\n      error\n    );\n  }\n}\n\nexport class AuthenticationError extends OpenEvidenceError {\n  constructor(message: string, code: string) {\n    super(message, code, 401, false);  # HTTP 401 Unauthorized\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class RateLimitError extends OpenEvidenceError {\n  constructor(\n    message: string,\n    public readonly retryAfter: number,\n    public readonly limit: number,\n    public readonly remaining: number\n  ) {\n    super(message, 'RATE_LIMITED', 429, true);  # HTTP 429 Too Many Requests\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class QueryValidationError extends OpenEvidenceError {\n  constructor(\n    message: string,\n    public readonly validationErrors: string[]\n  ) {\n    super(message, 'VALIDATION_ERROR', 400, false);  # HTTP 400 Bad Request\n    this.name = 'QueryValidationError';\n  }\n}\n\nfunction isRetryable(statusCode: number): boolean {\n  return statusCode === 429 || statusCode >= 500;  # HTTP 429 Too Many Requests\n}\n```\n\n### Step 2: Error Handler Wrapper\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferror-handler.ts\nimport {\n  OpenEvidenceError,\n  AuthenticationError,\n  RateLimitError,\n  QueryValidationError,\n} from '.\u002Ferrors';\n\nexport async function withErrorHandling\u003CT>(\n  operation: () => Promise\u003CT>,\n  context?: { operation?: string; queryId?: string }\n): Promise\u003CT> {\n  try {\n    return await operation();\n  } catch (error: any) {\n    const oeError = classifyError(error);\n\n    \u002F\u002F Log for debugging (without PHI)\n    console.error(`[OpenEvidence Error]`, {\n      code: oeError.code,\n      statusCode: oeError.statusCode,\n      operation: context?.operation,\n      retryable: oeError.retryable,\n    });\n\n    throw oeError;\n  }\n}\n\nfunction classifyError(error: any): OpenEvidenceError {\n  const status = error.response?.status;\n  const data = error.response?.data;\n\n  switch (status) {\n    case 401:  # HTTP 401 Unauthorized\n      return new AuthenticationError(\n        data?.message || 'Authentication failed',\n        data?.code || 'AUTH_FAILED'\n      );\n\n    case 429:  # HTTP 429 Too Many Requests\n      return new RateLimitError(\n        'Rate limit exceeded',\n        parseInt(error.response?.headers?.['retry-after'] || '60'),\n        parseInt(error.response?.headers?.['x-ratelimit-limit'] || '0'),\n        parseInt(error.response?.headers?.['x-ratelimit-remaining'] || '0')\n      );\n\n    case 400:  # HTTP 400 Bad Request\n    case 422:  # HTTP 422 Unprocessable Entity\n      return new QueryValidationError(\n        data?.message || 'Invalid query',\n        data?.errors || []\n      );\n\n    default:\n      return OpenEvidenceError.fromApiError(error);\n  }\n}\n```\n\n### Step 3: Retry Logic with Exponential Backoff\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Fretry.ts\nimport { OpenEvidenceError, RateLimitError } from '.\u002Ferrors';\n\ninterface RetryConfig {\n  maxRetries: number;\n  baseDelayMs: number;\n  maxDelayMs: number;\n  jitterMs: number;\n}\n\nconst DEFAULT_CONFIG: RetryConfig = {\n  maxRetries: 3,\n  baseDelayMs: 1000,  # 1000: 1 second in ms\n  maxDelayMs: 30000,  # 30000: 30 seconds in ms\n  jitterMs: 500,  # HTTP 500 Internal Server Error\n};\n\nexport async function withRetry\u003CT>(\n  operation: () => Promise\u003CT>,\n  config: Partial\u003CRetryConfig> = {}\n): Promise\u003CT> {\n  const cfg = { ...DEFAULT_CONFIG, ...config };\n\n  for (let attempt = 0; attempt \u003C= cfg.maxRetries; attempt++) {\n    try {\n      return await operation();\n    } catch (error) {\n      if (!(error instanceof OpenEvidenceError) || !error.retryable) {\n        throw error;\n      }\n\n      if (attempt === cfg.maxRetries) {\n        throw error;\n      }\n\n      \u002F\u002F Use Retry-After header for rate limits\n      let delay: number;\n      if (error instanceof RateLimitError && error.retryAfter > 0) {\n        delay = error.retryAfter * 1000;  # 1 second in ms\n      } else {\n        delay = Math.min(\n          cfg.baseDelayMs * Math.pow(2, attempt) + Math.random() * cfg.jitterMs,\n          cfg.maxDelayMs\n        );\n      }\n\n      console.log(`Retry ${attempt + 1}\u002F${cfg.maxRetries} after ${delay}ms`);\n      await new Promise(r => setTimeout(r, delay));\n    }\n  }\n\n  throw new Error('Unreachable');\n}\n```\n\n### Step 4: User-Facing Error Messages\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferror-messages.ts\nimport { OpenEvidenceError, RateLimitError, QueryValidationError } from '.\u002Ferrors';\n\nexport function getUserFriendlyMessage(error: OpenEvidenceError): string {\n  switch (error.code) {\n    case 'AUTH_FAILED':\n    case 'INVALID_API_KEY':\n      return 'Unable to connect to medical evidence service. Please contact support.';\n\n    case 'BAA_REQUIRED':\n      return 'Service configuration required. Please contact your administrator.';\n\n    case 'RATE_LIMITED':\n      const rle = error as RateLimitError;\n      return `Service temporarily unavailable. Please try again in ${rle.retryAfter} seconds.`;\n\n    case 'VALIDATION_ERROR':\n      const qve = error as QueryValidationError;\n      return `Please rephrase your clinical question. ${qve.validationErrors.join('. ')}`;\n\n    case 'QUERY_TOO_SHORT':\n      return 'Please provide more details about your clinical question.';\n\n    case 'INVALID_SPECIALTY':\n      return 'Please select a valid medical specialty.';\n\n    case 'SERVICE_UNAVAILABLE':\n      return 'Medical evidence service is temporarily unavailable. Please try again later.';\n\n    default:\n      if (error.statusCode >= 500) {  # HTTP 500 Internal Server Error\n        return 'Medical evidence service is experiencing issues. Please try again later.';\n      }\n      return 'Unable to process your request. Please try again or contact support.';\n  }\n}\n```\n\n## Output\n- Classified errors with appropriate handling\n- Retry logic for transient failures\n- User-friendly error messages\n- Comprehensive error logging (without PHI)\n\n## Diagnostic Commands\n\n### Quick Health Check\n```bash\nset -euo pipefail\n# Check if OpenEvidence is reachable\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -H \"Authorization: Bearer ${OPENEVIDENCE_API_KEY}\" \\\n  https:\u002F\u002Fapi.openevidence.com\u002Fhealth\n\n# Expected: 200\n```\n\n### Check Rate Limit Status\n```bash\nset -euo pipefail\ncurl -s -D - \\\n  -H \"Authorization: Bearer ${OPENEVIDENCE_API_KEY}\" \\\n  https:\u002F\u002Fapi.openevidence.com\u002Fv1\u002Frate-limit \\\n  | grep -i \"x-ratelimit\"\n\n# Headers show current limits\n```\n\n## Error Handling\n| Error Pattern | Detection | Resolution |\n|--------------|-----------|------------|\n| Intermittent 5xx | > 5% error rate | Enable circuit breaker |\n| Persistent 401 | All requests fail | Rotate API key |\n| Spike in 429 | Rate limit headers | Implement request queuing |\n| Timeout errors | P99 > 30s | Check network, simplify queries |\n\n## Examples\n\n### Complete Error-Handled Query\n```typescript\nasync function safeClinicalQuery(question: string) {\n  try {\n    return await withRetry(\n      () => withErrorHandling(\n        () => client.query({ question, context: { specialty: 'internal-medicine', urgency: 'routine' } }),\n        { operation: 'clinical-query' }\n      ),\n      { maxRetries: 3 }\n    );\n  } catch (error) {\n    if (error instanceof OpenEvidenceError) {\n      return {\n        success: false,\n        error: getUserFriendlyMessage(error),\n        code: error.code,\n      };\n    }\n    throw error;\n  }\n}\n```\n\n## Resources\n- [OpenEvidence Status](https:\u002F\u002Fstatus.openevidence.com\u002F)\n- [OpenEvidence Support](mailto:support@openevidence.com)\n\n## Next Steps\nFor comprehensive debugging, see `openevidence-debug-bundle`.\n\n## Instructions\n\n1. Assess the current state of the debugging configuration\n2. Identify the specific requirements and constraints\n3. Apply the recommended patterns from this skill\n4. Validate the changes against expected behavior\n5. Document the configuration for team reference","# OpenEvidence Common Errors\n\n## Overview\nComprehensive guide to diagnosing and resolving OpenEvidence API errors with healthcare-specific considerations.\n\n## Prerequisites\n- OpenEvidence SDK installed\n- Access to application logs\n- Understanding of HTTP status codes\n\n## Error Code Reference\n\n### Authentication Errors (4xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 401 | Invalid API Key | Key missing, malformed, or revoked | Verify `OPENEVIDENCE_API_KEY` is set correctly |\n| 401 | Organization Not Found | Invalid `orgId` | Check organization ID in dashboard |\n| 401 | BAA Not Signed | Business Associate Agreement required | Contact compliance@openevidence.com |\n| 403 | Forbidden | Insufficient permissions or suspended account | Check account status in dashboard |\n| 403 | IP Not Whitelisted | Request from non-approved IP | Add IP to allowlist in security settings |\n\n### Request Errors (4xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 400 | Invalid Query | Malformed request body | Check request schema |\n| 400 | Query Too Short | Question too brief | Provide more clinical context |\n| 400 | Invalid Specialty | Unknown specialty code | Use valid specialty from enum |\n| 404 | Resource Not Found | Invalid consultId or endpoint | Verify ID and URL |\n| 422 | Unprocessable | Valid JSON but invalid clinical query | Rephrase question |\n| 429 | Rate Limited | Too many requests | Implement backoff, check quotas |\n\n### Server Errors (5xx)\n| Code | Error | Cause | Solution |\n|------|-------|-------|----------|\n| 500 | Internal Server Error | OpenEvidence backend issue | Retry with backoff, contact support if persists |\n| 502 | Bad Gateway | Upstream service issue | Wait and retry |\n| 503 | Service Unavailable | Maintenance or overload | Check status.openevidence.com |\n| 504 | Gateway Timeout | Request took too long | Simplify query, increase timeout |\n\n## Error Handling Implementation\n\n### Step 1: Custom Error Classes\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferrors.ts\nexport class OpenEvidenceError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly statusCode: number,\n    public readonly retryable: boolean,\n    public readonly originalError?: Error\n  ) {\n    super(message);\n    this.name = 'OpenEvidenceError';\n  }\n\n  static fromApiError(error: any): OpenEvidenceError {\n    const statusCode = error.response?.status || 500;  # HTTP 500 Internal Server Error\n    const message = error.response?.data?.message || error.message;\n    const code = error.response?.data?.code || 'UNKNOWN_ERROR';\n\n    return new OpenEvidenceError(\n      message,\n      code,\n      statusCode,\n      isRetryable(statusCode),\n      error\n    );\n  }\n}\n\nexport class AuthenticationError extends OpenEvidenceError {\n  constructor(message: string, code: string) {\n    super(message, code, 401, false);  # HTTP 401 Unauthorized\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class RateLimitError extends OpenEvidenceError {\n  constructor(\n    message: string,\n    public readonly retryAfter: number,\n    public readonly limit: number,\n    public readonly remaining: number\n  ) {\n    super(message, 'RATE_LIMITED', 429, true);  # HTTP 429 Too Many Requests\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class QueryValidationError extends OpenEvidenceError {\n  constructor(\n    message: string,\n    public readonly validationErrors: string[]\n  ) {\n    super(message, 'VALIDATION_ERROR', 400, false);  # HTTP 400 Bad Request\n    this.name = 'QueryValidationError';\n  }\n}\n\nfunction isRetryable(statusCode: number): boolean {\n  return statusCode === 429 || statusCode >= 500;  # HTTP 429 Too Many Requests\n}\n```\n\n### Step 2: Error Handler Wrapper\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferror-handler.ts\nimport {\n  OpenEvidenceError,\n  AuthenticationError,\n  RateLimitError,\n  QueryValidationError,\n} from '.\u002Ferrors';\n\nexport async function withErrorHandling\u003CT>(\n  operation: () => Promise\u003CT>,\n  context?: { operation?: string; queryId?: string }\n): Promise\u003CT> {\n  try {\n    return await operation();\n  } catch (error: any) {\n    const oeError = classifyError(error);\n\n    \u002F\u002F Log for debugging (without PHI)\n    console.error(`[OpenEvidence Error]`, {\n      code: oeError.code,\n      statusCode: oeError.statusCode,\n      operation: context?.operation,\n      retryable: oeError.retryable,\n    });\n\n    throw oeError;\n  }\n}\n\nfunction classifyError(error: any): OpenEvidenceError {\n  const status = error.response?.status;\n  const data = error.response?.data;\n\n  switch (status) {\n    case 401:  # HTTP 401 Unauthorized\n      return new AuthenticationError(\n        data?.message || 'Authentication failed',\n        data?.code || 'AUTH_FAILED'\n      );\n\n    case 429:  # HTTP 429 Too Many Requests\n      return new RateLimitError(\n        'Rate limit exceeded',\n        parseInt(error.response?.headers?.['retry-after'] || '60'),\n        parseInt(error.response?.headers?.['x-ratelimit-limit'] || '0'),\n        parseInt(error.response?.headers?.['x-ratelimit-remaining'] || '0')\n      );\n\n    case 400:  # HTTP 400 Bad Request\n    case 422:  # HTTP 422 Unprocessable Entity\n      return new QueryValidationError(\n        data?.message || 'Invalid query',\n        data?.errors || []\n      );\n\n    default:\n      return OpenEvidenceError.fromApiError(error);\n  }\n}\n```\n\n### Step 3: Retry Logic with Exponential Backoff\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Fretry.ts\nimport { OpenEvidenceError, RateLimitError } from '.\u002Ferrors';\n\ninterface RetryConfig {\n  maxRetries: number;\n  baseDelayMs: number;\n  maxDelayMs: number;\n  jitterMs: number;\n}\n\nconst DEFAULT_CONFIG: RetryConfig = {\n  maxRetries: 3,\n  baseDelayMs: 1000,  # 1000: 1 second in ms\n  maxDelayMs: 30000,  # 30000: 30 seconds in ms\n  jitterMs: 500,  # HTTP 500 Internal Server Error\n};\n\nexport async function withRetry\u003CT>(\n  operation: () => Promise\u003CT>,\n  config: Partial\u003CRetryConfig> = {}\n): Promise\u003CT> {\n  const cfg = { ...DEFAULT_CONFIG, ...config };\n\n  for (let attempt = 0; attempt \u003C= cfg.maxRetries; attempt++) {\n    try {\n      return await operation();\n    } catch (error) {\n      if (!(error instanceof OpenEvidenceError) || !error.retryable) {\n        throw error;\n      }\n\n      if (attempt === cfg.maxRetries) {\n        throw error;\n      }\n\n      \u002F\u002F Use Retry-After header for rate limits\n      let delay: number;\n      if (error instanceof RateLimitError && error.retryAfter > 0) {\n        delay = error.retryAfter * 1000;  # 1 second in ms\n      } else {\n        delay = Math.min(\n          cfg.baseDelayMs * Math.pow(2, attempt) + Math.random() * cfg.jitterMs,\n          cfg.maxDelayMs\n        );\n      }\n\n      console.log(`Retry ${attempt + 1}\u002F${cfg.maxRetries} after ${delay}ms`);\n      await new Promise(r => setTimeout(r, delay));\n    }\n  }\n\n  throw new Error('Unreachable');\n}\n```\n\n### Step 4: User-Facing Error Messages\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Ferror-messages.ts\nimport { OpenEvidenceError, RateLimitError, QueryValidationError } from '.\u002Ferrors';\n\nexport function getUserFriendlyMessage(error: OpenEvidenceError): string {\n  switch (error.code) {\n    case 'AUTH_FAILED':\n    case 'INVALID_API_KEY':\n      return 'Unable to connect to medical evidence service. Please contact support.';\n\n    case 'BAA_REQUIRED':\n      return 'Service configuration required. Please contact your administrator.';\n\n    case 'RATE_LIMITED':\n      const rle = error as RateLimitError;\n      return `Service temporarily unavailable. Please try again in ${rle.retryAfter} seconds.`;\n\n    case 'VALIDATION_ERROR':\n      const qve = error as QueryValidationError;\n      return `Please rephrase your clinical question. ${qve.validationErrors.join('. ')}`;\n\n    case 'QUERY_TOO_SHORT':\n      return 'Please provide more details about your clinical question.';\n\n    case 'INVALID_SPECIALTY':\n      return 'Please select a valid medical specialty.';\n\n    case 'SERVICE_UNAVAILABLE':\n      return 'Medical evidence service is temporarily unavailable. Please try again later.';\n\n    default:\n      if (error.statusCode >= 500) {  # HTTP 500 Internal Server Error\n        return 'Medical evidence service is experiencing issues. Please try again later.';\n      }\n      return 'Unable to process your request. Please try again or contact support.';\n  }\n}\n```\n\n## Output\n- Classified errors with appropriate handling\n- Retry logic for transient failures\n- User-friendly error messages\n- Comprehensive error logging (without PHI)\n\n## Diagnostic Commands\n\n### Quick Health Check\n```bash\nset -euo pipefail\n# Check if OpenEvidence is reachable\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -H \"Authorization: Bearer ${OPENEVIDENCE_API_KEY}\" \\\n  https:\u002F\u002Fapi.openevidence.com\u002Fhealth\n\n# Expected: 200\n```\n\n### Check Rate Limit Status\n```bash\nset -euo pipefail\ncurl -s -D - \\\n  -H \"Authorization: Bearer ${OPENEVIDENCE_API_KEY}\" \\\n  https:\u002F\u002Fapi.openevidence.com\u002Fv1\u002Frate-limit \\\n  | grep -i \"x-ratelimit\"\n\n# Headers show current limits\n```\n\n## Error Handling\n| Error Pattern | Detection | Resolution |\n|--------------|-----------|------------|\n| Intermittent 5xx | > 5% error rate | Enable circuit breaker |\n| Persistent 401 | All requests fail | Rotate API key |\n| Spike in 429 | Rate limit headers | Implement request queuing |\n| Timeout errors | P99 > 30s | Check network, simplify queries |\n\n## Examples\n\n### Complete Error-Handled Query\n```typescript\nasync function safeClinicalQuery(question: string) {\n  try {\n    return await withRetry(\n      () => withErrorHandling(\n        () => client.query({ question, context: { specialty: 'internal-medicine', urgency: 'routine' } }),\n        { operation: 'clinical-query' }\n      ),\n      { maxRetries: 3 }\n    );\n  } catch (error) {\n    if (error instanceof OpenEvidenceError) {\n      return {\n        success: false,\n        error: getUserFriendlyMessage(error),\n        code: error.code,\n      };\n    }\n    throw error;\n  }\n}\n```\n\n## Resources\n- [OpenEvidence Status](https:\u002F\u002Fstatus.openevidence.com\u002F)\n- [OpenEvidence Support](mailto:support@openevidence.com)\n\n## Next Steps\nFor comprehensive debugging, see `openevidence-debug-bundle`.\n\n## Instructions\n\n1. Assess the current state of the debugging configuration\n2. Identify the specific requirements and constraints\n3. Apply the recommended patterns from this skill\n4. Validate the changes against expected behavior\n5. Document the configuration for team reference",{"name":5,"author":24,"license":15,"version":25,"description":26,"allowed-tools":27,"compatible-with":28},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Diagnose and resolve common OpenEvidence API errors.\nUse when encountering error codes, debugging failed requests,\nor implementing error handling for clinical queries.\nTrigger with phrases like \"openevidence error\", \"openevidence failing\",\n\"fix openevidence\", \"openevidence debug\", \"openevidence 4xx\", \"openevidence 5xx\".\n","Read, Write, Edit, Grep","claude-code, codex, openclaw","main","c2b1fdccc779e99ac814e55fb69ca8d71215dd0f","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection","https:\u002F\u002Fgithub.com\u002FSamuelChien","http:\u002F\u002Fsamuelchien.com\u002F","2026-05-26 08:27:14",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add SamuelChien\u002Fmega-skills-collection --skill openevidence-common-errors",{"tool":41,"command":42},"bunx","bunx skills add SamuelChien\u002Fmega-skills-collection --skill openevidence-common-errors",{"tool":44,"command":45},"pnpm","pnpm dlx skills add SamuelChien\u002Fmega-skills-collection --skill openevidence-common-errors","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fopenevidence-common-errors\u002FSKILL.md",true,[],[50,57,64,71,78,86],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M76R4WZQZAXGGXMQCA0FZ716","zustand-store-ts","Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state\u002Faction separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-ts\u002FSKILL.md",[],[],{"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},"01M76R4T9KENDH7FENGZQHBW4G","zustand-store-creator","Zustand Store Creator - Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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},"01M76R3YWN84B7SANJ52X799ZE","zero-trust-config-helper","Zero Trust Config Helper - Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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},"01M76R3HNSV2AEYSKHM915GJ58","zapier-integration-helper","Zapier Integration Helper - Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\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":82,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M76R3DJSKAT4FA7DV4BF3GCE","zai-cli","Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP.\nUse when user needs image\u002Fvideo analysis, OCR, UI-to-code conversion, error diagnosis,\nreal-time web search, web page to markdown extraction, or GitHub code exploration.\nTrigger with phrases like \"analyze this image\", \"search the web for\", \"read this page\",\n\"explore this repo\", or \"use zai\". Requires Z_AI_API_KEY.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzai-cli\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M76R2KAM699XE9AJVAWE4H2E","yt-research","Research competitor YouTube channels, niches, and trending topics for your content strategy.\nUse this skill whenever the user says \"research channels\", \"analyze competitors\", \"find trending topics\",\n\"niche analysis\", \"competitive research\", \"what are other creators doing\", \"scrape YouTube channels\",\nor wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fyt-research\u002FSKILL.md",[],[]]