Agent skill · software engineering · jeremylongshore
maintainx-migration-deep-dive
Execute complete platform migrations to or from MaintainX.
Why this skill is useful
Includes executable scripts for assessing and migrating data to MaintainX that aren't available in public documentation.
What it needs
Requires node installed locally. Requires maintainx account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Migration Deep Dive Current State !node --version 2>/dev/null echo 'N/A' Overview Comprehensive guide for migrating to MaintainX from legacy CMMS systems (Maximo, UpKeep, Fiix), spreadsheets, or custom databases. Prerequisites MaintainX account with API access Access to source system data (CSV export, API, or database) Node.js 18+ Migration Phases Instructions Step 1: Source System Assessment Step 2: Schema Mapping Step 3: ETL Migration Step 4: Validation and Reconciliation Rollback Plan Output Source system assessment report (record counts, data quality issues) Schema mapping configuration (legacy fields to MaintainX fields) ETL migration with rate-limited batch imports Validation report comparing source and target counts Rollback script for emergency reversal Error Handling Issue Cause Solution ------- ------- ---------- 400 Bad Request on import Invalid field value after mapping Fix transform function, re-run failed records 429 during bulk import Too many records too fast Reduce PQueue concurrency to 2 Duplicate records Migration re-run without cleanup Deduplicate by title or external ID Missing relationships Assets migrated after work orders Migrate in order: Locations -> Assets -> Work Orders Resources MaintainX API Reference MaintainX Import Guide csv-parse -- CSV parsing for Node.js Next Steps You have completed the MaintainX skill pack. For additional support, see the MaintainX Help Center. Examples Migrate from Excel spreadsheet: Migrate locations first, then link assets:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-migration-deep-dive