[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F84CQJA732F94GC4MY2H9R":3,"skill-same:01M6F84CQJA732F94GC4MY2H9R":86},{"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":23,"publishedAt":54,"linkOnly":55,"markdownContent":56,"markdownBody":57,"frontMatter":58,"refName":63,"commitSha":64,"skillDirectory":65,"forksCount":66,"repositoryHtmlUrl":67,"repositoryHomepageUrl":6,"ownerHtmlUrl":68,"ownerBlogUrl":69,"ownerDescription":70,"updatedAt":71,"install":72,"resources":85},"01M6F84CQJA732F94GC4MY2H9R","maintainx-rate-limits",null,"Implement MaintainX API rate limiting, pagination, and backoff patterns.\nUse when handling rate limit errors, implementing retry logic,\nor optimizing API request throughput for MaintainX.\nTrigger with phrases like \"maintainx rate limit\", \"maintainx throttling\",\n\"maintainx 429\", \"maintainx retry\", \"maintainx backoff\", \"maintainx pagination\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-rate-limits\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53],"limits","rate","maintainx rate limits","with","api request","when","request","rate limit","api rate","implementing","limit","errors","429","backoff","retry","implement","throughput","trigger","io","rate limiting","logic","patterns","pagination","api rate limiting","use","edit","write","read","api","throttling","2026-11-10 10:12:30",false,"---\nname: maintainx-rate-limits\ndescription: |\n  Implement MaintainX API rate limiting, pagination, and backoff patterns.\n  Use when handling rate limit errors, implementing retry logic,\n  or optimizing API request throughput for MaintainX.\n  Trigger with phrases like \"maintainx rate limit\", \"maintainx throttling\",\n  \"maintainx 429\", \"maintainx retry\", \"maintainx backoff\", \"maintainx pagination\".\nallowed-tools: Read, Write, Edit\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# MaintainX Rate Limits\n\n## Overview\n\nHandle MaintainX API rate limits gracefully with exponential backoff, pagination, and request queuing.\n\n## Prerequisites\n\n- MaintainX SDK installed\n- Understanding of async\u002Fawait patterns\n- Familiarity with cursor-based pagination\n\n## MaintainX API Limits\n\n| Aspect | Limit | Notes |\n|--------|-------|-------|\n| Requests per minute | Varies by plan | Check your subscription |\n| Page size | 100 max | Default varies by endpoint |\n| Concurrent requests | Recommended: 5 | Avoid parallel bursts |\n\n## Instructions\n\n### Step 1: Exponential Backoff with Jitter\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frate-limit.ts\n\ninterface RetryConfig {\n  maxRetries: number;\n  baseDelayMs: number;\n  maxDelayMs: number;\n  jitterMs: number;\n}\n\nconst defaultConfig: RetryConfig = {\n  maxRetries: 5,\n  baseDelayMs: 1000,\n  maxDelayMs: 60000,\n  jitterMs: 500,\n};\n\nasync function withExponentialBackoff\u003CT>(\n  operation: () => Promise\u003CT>,\n  config: Partial\u003CRetryConfig> = {}\n): Promise\u003CT> {\n  const { maxRetries, baseDelayMs, maxDelayMs, jitterMs } = {\n    ...defaultConfig,\n    ...config,\n  };\n\n  for (let attempt = 0; attempt \u003C= maxRetries; attempt++) {\n    try {\n      return await operation();\n    } catch (error: any) {\n      if (attempt === maxRetries) throw error;\n\n      const status = error.response?.status;\n\n      \u002F\u002F Only retry on rate limits (429) and server errors (5xx)\n      if (status !== 429 && (status \u003C 500 || status >= 600)) {\n        throw error;\n      }\n\n      \u002F\u002F Check for Retry-After header\n      const retryAfter = error.response?.headers?.['retry-after'];\n      let delay: number;\n\n      if (retryAfter) {\n        delay = parseInt(retryAfter) * 1000;\n      } else {\n        \u002F\u002F Exponential backoff with jitter\n        const exponentialDelay = baseDelayMs * Math.pow(2, attempt);\n        const jitter = Math.random() * jitterMs;\n        delay = Math.min(exponentialDelay + jitter, maxDelayMs);\n      }\n\n      console.log(\n        `Rate limited (attempt ${attempt + 1}\u002F${maxRetries}). ` +\n        `Retrying in ${Math.round(delay)}ms...`\n      );\n\n      await new Promise(r => setTimeout(r, delay));\n    }\n  }\n\n  throw new Error('Unreachable');\n}\n\n\u002F\u002F Usage example\nasync function fetchWithRetry(client: MaintainXClient) {\n  return withExponentialBackoff(\n    () => client.getWorkOrders({ limit: 100 }),\n    { maxRetries: 3 }\n  );\n}\n```\n\n### Step 2: Request Queue for Concurrency Control\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frequest-queue.ts\nimport PQueue from 'p-queue';\n\nclass RateLimitedClient {\n  private queue: PQueue;\n  private client: MaintainXClient;\n\n  constructor(client: MaintainXClient, options?: { concurrency?: number; interval?: number }) {\n    this.client = client;\n\n    \u002F\u002F Limit concurrent requests and requests per interval\n    this.queue = new PQueue({\n      concurrency: options?.concurrency || 5,\n      interval: options?.interval || 1000,\n      intervalCap: 10,  \u002F\u002F Max requests per interval\n    });\n  }\n\n  async getWorkOrders(params?: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.getWorkOrders(params))\n    );\n  }\n\n  async getAssets(params?: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.getAssets(params))\n    );\n  }\n\n  async createWorkOrder(data: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.createWorkOrder(data))\n    );\n  }\n\n  \u002F\u002F Get queue stats\n  getQueueStats() {\n    return {\n      pending: this.queue.pending,\n      size: this.queue.size,\n    };\n  }\n\n  \u002F\u002F Wait for all queued requests to complete\n  async drain() {\n    await this.queue.onIdle();\n  }\n}\n\n\u002F\u002F Usage\nconst rateLimitedClient = new RateLimitedClient(client, {\n  concurrency: 5,\n  interval: 1000,\n});\n\n\u002F\u002F These will be queued and rate-limited automatically\nawait Promise.all([\n  rateLimitedClient.getWorkOrders(),\n  rateLimitedClient.getAssets(),\n  rateLimitedClient.getWorkOrders({ status: 'OPEN' }),\n]);\n```\n\n### Step 3: Cursor-Based Pagination\n\n```typescript\n\u002F\u002F src\u002Futils\u002Fpagination.ts\n\ninterface PaginationOptions {\n  limit?: number;\n  maxPages?: number;\n  delayBetweenPages?: number;\n}\n\n\u002F\u002F Generic paginator for any endpoint\nasync function* paginate\u003CT>(\n  fetchPage: (cursor?: string) => Promise\u003C{ items: T[]; nextCursor: string | null }>,\n  options: PaginationOptions = {}\n): AsyncGenerator\u003CT[], void, unknown> {\n  const { limit = 100, maxPages = Infinity, delayBetweenPages = 100 } = options;\n\n  let cursor: string | undefined;\n  let pageCount = 0;\n\n  do {\n    const response = await fetchPage(cursor);\n    yield response.items;\n\n    cursor = response.nextCursor || undefined;\n    pageCount++;\n\n    \u002F\u002F Delay between pages to avoid rate limits\n    if (cursor && delayBetweenPages > 0) {\n      await new Promise(r => setTimeout(r, delayBetweenPages));\n    }\n  } while (cursor && pageCount \u003C maxPages);\n}\n\n\u002F\u002F Work order paginator\nasync function* paginateWorkOrders(\n  client: MaintainXClient,\n  params: any = {},\n  options: PaginationOptions = {}\n): AsyncGenerator\u003CWorkOrder[], void, unknown> {\n  yield* paginate(\n    async (cursor) => {\n      const response = await withExponentialBackoff(() =>\n        client.getWorkOrders({ ...params, cursor, limit: options.limit || 100 })\n      );\n      return {\n        items: response.workOrders,\n        nextCursor: response.nextCursor,\n      };\n    },\n    options\n  );\n}\n\n\u002F\u002F Collect all pages\nasync function getAllWorkOrders(\n  client: MaintainXClient,\n  params?: any,\n  options?: PaginationOptions\n): Promise\u003CWorkOrder[]> {\n  const allWorkOrders: WorkOrder[] = [];\n\n  for await (const batch of paginateWorkOrders(client, params, options)) {\n    allWorkOrders.push(...batch);\n    console.log(`Fetched ${allWorkOrders.length} work orders...`);\n  }\n\n  return allWorkOrders;\n}\n\n\u002F\u002F Usage\nasync function fetchAllOpenWorkOrders(client: MaintainXClient) {\n  const workOrders = await getAllWorkOrders(\n    client,\n    { status: 'OPEN' },\n    {\n      limit: 100,\n      maxPages: 50,  \u002F\u002F Safety limit\n      delayBetweenPages: 200,\n    }\n  );\n\n  console.log(`Total open work orders: ${workOrders.length}`);\n  return workOrders;\n}\n```\n\n### Step 4: Rate Limit Monitor\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frate-monitor.ts\n\nclass RateLimitMonitor {\n  private requestCount = 0;\n  private windowStart = Date.now();\n  private readonly windowMs = 60000;  \u002F\u002F 1 minute window\n  private readonly maxRequests = 60;  \u002F\u002F Adjust based on your plan\n\n  recordRequest() {\n    const now = Date.now();\n\n    \u002F\u002F Reset window if expired\n    if (now - this.windowStart > this.windowMs) {\n      this.requestCount = 0;\n      this.windowStart = now;\n    }\n\n    this.requestCount++;\n  }\n\n  shouldThrottle(): boolean {\n    return this.requestCount >= this.maxRequests * 0.8;  \u002F\u002F 80% threshold\n  }\n\n  getWaitTime(): number {\n    if (!this.shouldThrottle()) return 0;\n\n    const windowEnd = this.windowStart + this.windowMs;\n    return Math.max(0, windowEnd - Date.now());\n  }\n\n  getStats() {\n    return {\n      requestCount: this.requestCount,\n      windowRemaining: Math.max(0, this.windowMs - (Date.now() - this.windowStart)),\n      shouldThrottle: this.shouldThrottle(),\n    };\n  }\n}\n\n\u002F\u002F Integrate with client\nclass MonitoredMaintainXClient {\n  private client: MaintainXClient;\n  private monitor: RateLimitMonitor;\n\n  constructor(apiKey: string) {\n    this.client = new MaintainXClient();\n    this.monitor = new RateLimitMonitor();\n  }\n\n  private async throttledRequest\u003CT>(operation: () => Promise\u003CT>): Promise\u003CT> {\n    \u002F\u002F Pre-check throttling\n    if (this.monitor.shouldThrottle()) {\n      const waitTime = this.monitor.getWaitTime();\n      console.log(`Proactively throttling. Waiting ${waitTime}ms...`);\n      await new Promise(r => setTimeout(r, waitTime));\n    }\n\n    this.monitor.recordRequest();\n    return operation();\n  }\n\n  async getWorkOrders(params?: any) {\n    return this.throttledRequest(() => this.client.getWorkOrders(params));\n  }\n\n  \u002F\u002F Add other methods similarly...\n}\n```\n\n### Step 5: Batch Operations with Rate Limiting\n\n```typescript\n\u002F\u002F src\u002Futils\u002Fbatch.ts\n\ninterface BatchConfig {\n  batchSize: number;\n  delayBetweenBatches: number;\n  maxConcurrent: number;\n}\n\nasync function processBatch\u003CT, R>(\n  items: T[],\n  processor: (item: T) => Promise\u003CR>,\n  config: Partial\u003CBatchConfig> = {}\n): Promise\u003CR[]> {\n  const { batchSize = 10, delayBetweenBatches = 500, maxConcurrent = 5 } = config;\n\n  const results: R[] = [];\n\n  \u002F\u002F Process in batches\n  for (let i = 0; i \u003C items.length; i += batchSize) {\n    const batch = items.slice(i, i + batchSize);\n\n    console.log(`Processing batch ${Math.floor(i \u002F batchSize) + 1}\u002F${Math.ceil(items.length \u002F batchSize)}...`);\n\n    \u002F\u002F Process batch items with limited concurrency\n    const queue = new PQueue({ concurrency: maxConcurrent });\n    const batchPromises = batch.map(item =>\n      queue.add(() => withExponentialBackoff(() => processor(item)))\n    );\n\n    const batchResults = await Promise.all(batchPromises);\n    results.push(...batchResults);\n\n    \u002F\u002F Delay between batches\n    if (i + batchSize \u003C items.length) {\n      await new Promise(r => setTimeout(r, delayBetweenBatches));\n    }\n  }\n\n  return results;\n}\n\n\u002F\u002F Example: Create multiple work orders with rate limiting\nasync function createMultipleWorkOrders(\n  client: MaintainXClient,\n  workOrdersData: Partial\u003CWorkOrder>[]\n): Promise\u003CWorkOrder[]> {\n  return processBatch(\n    workOrdersData,\n    data => client.createWorkOrder(data),\n    {\n      batchSize: 5,\n      delayBetweenBatches: 1000,\n      maxConcurrent: 3,\n    }\n  );\n}\n```\n\n## Output\n\n- Resilient API calls with automatic retry\n- Proper pagination handling\n- Request queuing and throttling\n- Rate limit monitoring\n\n## Error Handling\n\n| Scenario | Strategy |\n|----------|----------|\n| 429 Rate Limited | Exponential backoff with jitter |\n| Retry-After header | Honor the specified wait time |\n| Burst requests | Use request queue |\n| Large data sets | Use pagination with delays |\n\n## Best Practices\n\n1. **Start conservative**: Begin with lower limits and increase gradually\n2. **Use pagination**: Never try to fetch all data in one request\n3. **Add delays**: Include delays between batch operations\n4. **Monitor usage**: Track request counts and adjust\n5. **Handle errors gracefully**: Always implement retry logic\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [p-queue Documentation](https:\u002F\u002Fgithub.com\u002Fsindresorhus\u002Fp-queue)\n- [Rate Limiting Best Practices](https:\u002F\u002Fwww.merge.dev\u002Fblog\u002Fapi-rate-limit-best-practices)\n\n## Next Steps\n\nFor security configuration, see `maintainx-security-basics`.\n","# MaintainX Rate Limits\n\n## Overview\n\nHandle MaintainX API rate limits gracefully with exponential backoff, pagination, and request queuing.\n\n## Prerequisites\n\n- MaintainX SDK installed\n- Understanding of async\u002Fawait patterns\n- Familiarity with cursor-based pagination\n\n## MaintainX API Limits\n\n| Aspect | Limit | Notes |\n|--------|-------|-------|\n| Requests per minute | Varies by plan | Check your subscription |\n| Page size | 100 max | Default varies by endpoint |\n| Concurrent requests | Recommended: 5 | Avoid parallel bursts |\n\n## Instructions\n\n### Step 1: Exponential Backoff with Jitter\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frate-limit.ts\n\ninterface RetryConfig {\n  maxRetries: number;\n  baseDelayMs: number;\n  maxDelayMs: number;\n  jitterMs: number;\n}\n\nconst defaultConfig: RetryConfig = {\n  maxRetries: 5,\n  baseDelayMs: 1000,\n  maxDelayMs: 60000,\n  jitterMs: 500,\n};\n\nasync function withExponentialBackoff\u003CT>(\n  operation: () => Promise\u003CT>,\n  config: Partial\u003CRetryConfig> = {}\n): Promise\u003CT> {\n  const { maxRetries, baseDelayMs, maxDelayMs, jitterMs } = {\n    ...defaultConfig,\n    ...config,\n  };\n\n  for (let attempt = 0; attempt \u003C= maxRetries; attempt++) {\n    try {\n      return await operation();\n    } catch (error: any) {\n      if (attempt === maxRetries) throw error;\n\n      const status = error.response?.status;\n\n      \u002F\u002F Only retry on rate limits (429) and server errors (5xx)\n      if (status !== 429 && (status \u003C 500 || status >= 600)) {\n        throw error;\n      }\n\n      \u002F\u002F Check for Retry-After header\n      const retryAfter = error.response?.headers?.['retry-after'];\n      let delay: number;\n\n      if (retryAfter) {\n        delay = parseInt(retryAfter) * 1000;\n      } else {\n        \u002F\u002F Exponential backoff with jitter\n        const exponentialDelay = baseDelayMs * Math.pow(2, attempt);\n        const jitter = Math.random() * jitterMs;\n        delay = Math.min(exponentialDelay + jitter, maxDelayMs);\n      }\n\n      console.log(\n        `Rate limited (attempt ${attempt + 1}\u002F${maxRetries}). ` +\n        `Retrying in ${Math.round(delay)}ms...`\n      );\n\n      await new Promise(r => setTimeout(r, delay));\n    }\n  }\n\n  throw new Error('Unreachable');\n}\n\n\u002F\u002F Usage example\nasync function fetchWithRetry(client: MaintainXClient) {\n  return withExponentialBackoff(\n    () => client.getWorkOrders({ limit: 100 }),\n    { maxRetries: 3 }\n  );\n}\n```\n\n### Step 2: Request Queue for Concurrency Control\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frequest-queue.ts\nimport PQueue from 'p-queue';\n\nclass RateLimitedClient {\n  private queue: PQueue;\n  private client: MaintainXClient;\n\n  constructor(client: MaintainXClient, options?: { concurrency?: number; interval?: number }) {\n    this.client = client;\n\n    \u002F\u002F Limit concurrent requests and requests per interval\n    this.queue = new PQueue({\n      concurrency: options?.concurrency || 5,\n      interval: options?.interval || 1000,\n      intervalCap: 10,  \u002F\u002F Max requests per interval\n    });\n  }\n\n  async getWorkOrders(params?: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.getWorkOrders(params))\n    );\n  }\n\n  async getAssets(params?: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.getAssets(params))\n    );\n  }\n\n  async createWorkOrder(data: any) {\n    return this.queue.add(() =>\n      withExponentialBackoff(() => this.client.createWorkOrder(data))\n    );\n  }\n\n  \u002F\u002F Get queue stats\n  getQueueStats() {\n    return {\n      pending: this.queue.pending,\n      size: this.queue.size,\n    };\n  }\n\n  \u002F\u002F Wait for all queued requests to complete\n  async drain() {\n    await this.queue.onIdle();\n  }\n}\n\n\u002F\u002F Usage\nconst rateLimitedClient = new RateLimitedClient(client, {\n  concurrency: 5,\n  interval: 1000,\n});\n\n\u002F\u002F These will be queued and rate-limited automatically\nawait Promise.all([\n  rateLimitedClient.getWorkOrders(),\n  rateLimitedClient.getAssets(),\n  rateLimitedClient.getWorkOrders({ status: 'OPEN' }),\n]);\n```\n\n### Step 3: Cursor-Based Pagination\n\n```typescript\n\u002F\u002F src\u002Futils\u002Fpagination.ts\n\ninterface PaginationOptions {\n  limit?: number;\n  maxPages?: number;\n  delayBetweenPages?: number;\n}\n\n\u002F\u002F Generic paginator for any endpoint\nasync function* paginate\u003CT>(\n  fetchPage: (cursor?: string) => Promise\u003C{ items: T[]; nextCursor: string | null }>,\n  options: PaginationOptions = {}\n): AsyncGenerator\u003CT[], void, unknown> {\n  const { limit = 100, maxPages = Infinity, delayBetweenPages = 100 } = options;\n\n  let cursor: string | undefined;\n  let pageCount = 0;\n\n  do {\n    const response = await fetchPage(cursor);\n    yield response.items;\n\n    cursor = response.nextCursor || undefined;\n    pageCount++;\n\n    \u002F\u002F Delay between pages to avoid rate limits\n    if (cursor && delayBetweenPages > 0) {\n      await new Promise(r => setTimeout(r, delayBetweenPages));\n    }\n  } while (cursor && pageCount \u003C maxPages);\n}\n\n\u002F\u002F Work order paginator\nasync function* paginateWorkOrders(\n  client: MaintainXClient,\n  params: any = {},\n  options: PaginationOptions = {}\n): AsyncGenerator\u003CWorkOrder[], void, unknown> {\n  yield* paginate(\n    async (cursor) => {\n      const response = await withExponentialBackoff(() =>\n        client.getWorkOrders({ ...params, cursor, limit: options.limit || 100 })\n      );\n      return {\n        items: response.workOrders,\n        nextCursor: response.nextCursor,\n      };\n    },\n    options\n  );\n}\n\n\u002F\u002F Collect all pages\nasync function getAllWorkOrders(\n  client: MaintainXClient,\n  params?: any,\n  options?: PaginationOptions\n): Promise\u003CWorkOrder[]> {\n  const allWorkOrders: WorkOrder[] = [];\n\n  for await (const batch of paginateWorkOrders(client, params, options)) {\n    allWorkOrders.push(...batch);\n    console.log(`Fetched ${allWorkOrders.length} work orders...`);\n  }\n\n  return allWorkOrders;\n}\n\n\u002F\u002F Usage\nasync function fetchAllOpenWorkOrders(client: MaintainXClient) {\n  const workOrders = await getAllWorkOrders(\n    client,\n    { status: 'OPEN' },\n    {\n      limit: 100,\n      maxPages: 50,  \u002F\u002F Safety limit\n      delayBetweenPages: 200,\n    }\n  );\n\n  console.log(`Total open work orders: ${workOrders.length}`);\n  return workOrders;\n}\n```\n\n### Step 4: Rate Limit Monitor\n\n```typescript\n\u002F\u002F src\u002Futils\u002Frate-monitor.ts\n\nclass RateLimitMonitor {\n  private requestCount = 0;\n  private windowStart = Date.now();\n  private readonly windowMs = 60000;  \u002F\u002F 1 minute window\n  private readonly maxRequests = 60;  \u002F\u002F Adjust based on your plan\n\n  recordRequest() {\n    const now = Date.now();\n\n    \u002F\u002F Reset window if expired\n    if (now - this.windowStart > this.windowMs) {\n      this.requestCount = 0;\n      this.windowStart = now;\n    }\n\n    this.requestCount++;\n  }\n\n  shouldThrottle(): boolean {\n    return this.requestCount >= this.maxRequests * 0.8;  \u002F\u002F 80% threshold\n  }\n\n  getWaitTime(): number {\n    if (!this.shouldThrottle()) return 0;\n\n    const windowEnd = this.windowStart + this.windowMs;\n    return Math.max(0, windowEnd - Date.now());\n  }\n\n  getStats() {\n    return {\n      requestCount: this.requestCount,\n      windowRemaining: Math.max(0, this.windowMs - (Date.now() - this.windowStart)),\n      shouldThrottle: this.shouldThrottle(),\n    };\n  }\n}\n\n\u002F\u002F Integrate with client\nclass MonitoredMaintainXClient {\n  private client: MaintainXClient;\n  private monitor: RateLimitMonitor;\n\n  constructor(apiKey: string) {\n    this.client = new MaintainXClient();\n    this.monitor = new RateLimitMonitor();\n  }\n\n  private async throttledRequest\u003CT>(operation: () => Promise\u003CT>): Promise\u003CT> {\n    \u002F\u002F Pre-check throttling\n    if (this.monitor.shouldThrottle()) {\n      const waitTime = this.monitor.getWaitTime();\n      console.log(`Proactively throttling. Waiting ${waitTime}ms...`);\n      await new Promise(r => setTimeout(r, waitTime));\n    }\n\n    this.monitor.recordRequest();\n    return operation();\n  }\n\n  async getWorkOrders(params?: any) {\n    return this.throttledRequest(() => this.client.getWorkOrders(params));\n  }\n\n  \u002F\u002F Add other methods similarly...\n}\n```\n\n### Step 5: Batch Operations with Rate Limiting\n\n```typescript\n\u002F\u002F src\u002Futils\u002Fbatch.ts\n\ninterface BatchConfig {\n  batchSize: number;\n  delayBetweenBatches: number;\n  maxConcurrent: number;\n}\n\nasync function processBatch\u003CT, R>(\n  items: T[],\n  processor: (item: T) => Promise\u003CR>,\n  config: Partial\u003CBatchConfig> = {}\n): Promise\u003CR[]> {\n  const { batchSize = 10, delayBetweenBatches = 500, maxConcurrent = 5 } = config;\n\n  const results: R[] = [];\n\n  \u002F\u002F Process in batches\n  for (let i = 0; i \u003C items.length; i += batchSize) {\n    const batch = items.slice(i, i + batchSize);\n\n    console.log(`Processing batch ${Math.floor(i \u002F batchSize) + 1}\u002F${Math.ceil(items.length \u002F batchSize)}...`);\n\n    \u002F\u002F Process batch items with limited concurrency\n    const queue = new PQueue({ concurrency: maxConcurrent });\n    const batchPromises = batch.map(item =>\n      queue.add(() => withExponentialBackoff(() => processor(item)))\n    );\n\n    const batchResults = await Promise.all(batchPromises);\n    results.push(...batchResults);\n\n    \u002F\u002F Delay between batches\n    if (i + batchSize \u003C items.length) {\n      await new Promise(r => setTimeout(r, delayBetweenBatches));\n    }\n  }\n\n  return results;\n}\n\n\u002F\u002F Example: Create multiple work orders with rate limiting\nasync function createMultipleWorkOrders(\n  client: MaintainXClient,\n  workOrdersData: Partial\u003CWorkOrder>[]\n): Promise\u003CWorkOrder[]> {\n  return processBatch(\n    workOrdersData,\n    data => client.createWorkOrder(data),\n    {\n      batchSize: 5,\n      delayBetweenBatches: 1000,\n      maxConcurrent: 3,\n    }\n  );\n}\n```\n\n## Output\n\n- Resilient API calls with automatic retry\n- Proper pagination handling\n- Request queuing and throttling\n- Rate limit monitoring\n\n## Error Handling\n\n| Scenario | Strategy |\n|----------|----------|\n| 429 Rate Limited | Exponential backoff with jitter |\n| Retry-After header | Honor the specified wait time |\n| Burst requests | Use request queue |\n| Large data sets | Use pagination with delays |\n\n## Best Practices\n\n1. **Start conservative**: Begin with lower limits and increase gradually\n2. **Use pagination**: Never try to fetch all data in one request\n3. **Add delays**: Include delays between batch operations\n4. **Monitor usage**: Track request counts and adjust\n5. **Handle errors gracefully**: Always implement retry logic\n\n## Resources\n\n- [MaintainX API Documentation](https:\u002F\u002Fmaintainx.dev\u002F)\n- [p-queue Documentation](https:\u002F\u002Fgithub.com\u002Fsindresorhus\u002Fp-queue)\n- [Rate Limiting Best Practices](https:\u002F\u002Fwww.merge.dev\u002Fblog\u002Fapi-rate-limit-best-practices)\n\n## Next Steps\n\nFor security configuration, see `maintainx-security-basics`.\n",{"name":5,"author":59,"license":15,"version":60,"description":61,"allowed-tools":62},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Implement MaintainX API rate limiting, pagination, and backoff patterns.\nUse when handling rate limit errors, implementing retry logic,\nor optimizing API request throughput for MaintainX.\nTrigger with phrases like \"maintainx rate limit\", \"maintainx throttling\",\n\"maintainx 429\", \"maintainx retry\", \"maintainx backoff\", \"maintainx pagination\".\n","Read, Write, Edit","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-rate-limits",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":73,"prompt":83,"zipAvailable":84},[74,77,80],{"tool":75,"command":76},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-rate-limits",{"tool":78,"command":79},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-rate-limits",{"tool":81,"command":82},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill maintainx-rate-limits","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fmaintainx-pack\u002Fskills\u002Fmaintainx-rate-limits\u002FSKILL.md",true,[],[87,120,155,178,204,231],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":100,"publishedAt":119},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[95],{"categoryNo":96,"categoryName":97,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,27,117,118],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","you","fonts","2026-11-11 15:11:14",{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":124,"sourceHtmlUrl":125,"categories":126,"keywords":130,"publishedAt":54},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[127],{"categoryNo":128,"categoryName":129,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000009","前端开发",[131,132,107,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,48,112,148,149,150,151,152,153,154],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","single-file","simple","ui components","multi","for","jsx","suite",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":159,"sourceHtmlUrl":160,"categories":161,"keywords":166,"publishedAt":54},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[162,165],{"categoryNo":163,"categoryName":164,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":128,"categoryName":129,"taxonomyType":98,"taxonomyTypeDesc":99},[167,168,169,135,170,171,132,172,105,173,145,174,175,176,177,27,152],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":182,"sourceHtmlUrl":183,"categories":184,"keywords":185,"publishedAt":54},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[186,187,188,189,190,191,192,193,48,194,195,196,197,198,199,200,27,201,202,203,152,29],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":205,"name":206,"nameZh":6,"description":207,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":208,"sourceHtmlUrl":209,"categories":210,"keywords":214,"publishedAt":54},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[211],{"categoryNo":212,"categoryName":213,"taxonomyType":98,"taxonomyTypeDesc":99},"01JBSEEDCAT000000000000023","Skill与智能体开发",[215,216,217,218,219,220,221,222,223,224,225,226,227,228,27,152,229,29,230],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":232,"name":233,"nameZh":6,"description":234,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":235,"sourceHtmlUrl":236,"categories":237,"keywords":239,"publishedAt":54},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[238],{"categoryNo":212,"categoryName":213,"taxonomyType":98,"taxonomyTypeDesc":99},[233,240,241,242,243,244,245,173,246,247,48,248,249,250,251,152,252],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]