Agent skill · software engineering · jeremylongshore
maintainx-local-dev-loop
Set up a local development loop for MaintainX integration development.
Why this skill is useful
Provides specific setup instructions and scripts for developing MaintainX integrations that the AI wouldn't generate on its own.
What it needs
Requires node installed locally. 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 Local Dev Loop Overview Set up an efficient local development workflow for building and testing MaintainX integrations with hot reload, mock servers, and automated testing. Prerequisites Completed maintainx-install-auth setup Node.js 18+ installed MAINTAINXAPIKEY environment variable set Instructions Step 1: Initialize TypeScript Project Create tsconfig.json paths: Step 2: Project Structure Step 3: Dev Scripts in package.json Step 4: Write Unit Tests with Mocked API Step 5: Interactive REPL Output TypeScript project configured with tsx watch for hot reload Vitest unit tests with mocked MaintainX API responses Interactive REPL for exploring the API .env.example template for team onboarding Dev/test/build scripts in package.json Error Handling Issue Solution ------- ---------- MAINTAINXAPIKEY undefined Copy .env.example to .env and fill in your key 429 Rate Limited during dev Add delays between calls, use mocks for unit tests TypeScript import errors Ensure moduleResolution: "nodenext" in tsconfig tsx not found Install with npm i -D tsx Resources MaintainX API Reference Vitest Documentation tsx - TypeScript Execute Next Steps For SDK patterns and best practices, see maintainx-sdk-patterns. Examples Docker-based dev environment: Run integration tests against live API:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-local-dev-loop