Agent skill · software engineering · jeremylongshore
maintainx-sdk-patterns
Learn MaintainX REST API patterns, pagination, filtering, and client
Why this skill is useful
Provides specific patterns and TypeScript client code for integrating with the MaintainX API, which the AI wouldn't reliably generate on its own.
What it needs
Requires npm installed locally. Requires maintainx account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX SDK Patterns Overview Production-grade patterns for building robust MaintainX API integrations with proper error handling, cursor-based pagination, retry logic, and type safety. Prerequisites Completed maintainx-install-auth setup TypeScript/Node.js familiarity Understanding of REST API principles Instructions Step 1: Type-Safe Client with Generics Step 2: Cursor-Based Pagination MaintainX uses cursor-based pagination. The response includes a cursor field; pass it as a query parameter to get the next page. Step 3: Retry with Exponential Backoff Step 4: Batch Operations Step 5: Fluent Query Builder Output Type-safe MaintainX client with full TypeScript interfaces Cursor-based pagination utility that works across all list endpoints Retry logic with exponential backoff and Retry-After header support Rate-limited batch processor using p-queue Fluent query builder for readable work order filters Error Handling Pattern Use Case --------- ---------- withRetry() Transient errors (429, 5xx) with exponential backoff paginate() Collecting all items from cursor-based endpoints PQueue Controlled concurrency to avoid rate limits WorkOrderQuery Type-safe filtering to prevent invalid API calls Resources MaintainX API Reference p-queue -- Promise queue with concurrency control Next Steps For core workflows, see maintainx-core-workflow-a (Work Orders) and maintainx-core-workflow-b (Assets). Examples Stream large datasets with async iterators:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-sdk-patterns--0b99ca