Agent skill · software engineering · jeremylongshore

maintainx-hello-world

Create a minimal working MaintainX example - your first work order.

Why this skill is useful

Provides specific API commands and patterns for integrating with the MaintainX platform that the AI wouldn't reliably generate on its own.

What it needs

Requires node installed locally. Requires maintainx account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

MaintainX Hello World Overview Create your first work order using the MaintainX REST API -- the core building block of CMMS operations. Prerequisites Completed maintainx-install-auth setup Valid MAINTAINXAPIKEY environment variable Node.js 18+ or curl Instructions Step 1: Create a Work Order (curl) Expected response: Step 2: Create a Work Order (TypeScript) Step 3: Verify and Clean Up Output Working code file that creates a MaintainX work order via REST API Console output showing the created work order ID, status, and timestamp Verified retrieval of the created work order Error Handling Error Cause Solution ------- ------- ---------- 400 Bad Request Missing required title field Include at least title in the POST body 401 Unauthorized Invalid API key Check MAINTAINXAPIKEY environment variable 403 Forbidden Plan limitations Verify API access on your subscription 422 Unprocessable Invalid enum value Use valid priority (NONE, LOW, MEDIUM, HIGH) Resources MaintainX API Reference Work Orders Help Next Steps Proceed to maintainx-local-dev-loop for development workflow setup. Examples Create a work order tied to an asset: Create a work order from a preventive maintenance template:

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/maintainx-hello-world--b2042f

View the source on GitHub

Browse the @skills marketplace