Agent skill · software engineering · jeremylongshore
maintainx-core-workflow-a
Execute MaintainX primary workflow: Work Order lifecycle management.
Why this skill is useful
Provides specific API commands and workflows for managing work orders in MaintainX that the AI wouldn't reliably generate on its own.
What it needs
Requires maintainx account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Core Workflow A: Work Order Lifecycle Overview Master the complete work order lifecycle in MaintainX -- from creation through completion. Work orders are the core unit of maintenance operations. Prerequisites Completed maintainx-install-auth setup MAINTAINXAPIKEY environment variable configured MaintainX account with work order permissions Status Transition Flow Instructions Step 1: Create a Work Order Step 2: Update Status Through Lifecycle Step 3: Query Work Orders Step 4: Add Comments and Attachments Step 5: Assign to Teams Output Work orders created with full metadata (title, description, priority, assignees, asset, location) Status transitions executed through the complete lifecycle Paginated query results for filtering work orders Comments and files attached to work orders Error Handling Error Cause Solution ------- ------- ---------- 400 Bad Request Missing title field Include at least title in POST body 404 Not Found Invalid asset/location/user ID Verify referenced IDs exist via GET endpoints 403 Forbidden Insufficient permissions Check user role has work order write access 422 Invalid transition Invalid status change (e.g., CLOSED to OPEN) Follow the status transition flow above Resources MaintainX API Reference Work Orders Help Complete a Work Order Next Steps For asset and location management, see maintainx-core-workflow-b. Examples Bulk-create preventive maintenance work orders: Filter work orders by date range:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-core-workflow-a--9e9f47