Agent skill · software engineering · jeremylongshore

maintainx-performance-tuning

Optimize MaintainX API integration performance.

Why this skill is useful

Adds multi-level caching and connection pooling scripts that significantly enhance MaintainX API performance beyond standard practices.

What it needs

Requires node, redis 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 Performance Tuning Overview Optimize MaintainX integration performance with caching, connection pooling, efficient pagination, and request deduplication. Prerequisites MaintainX integration working Node.js 18+ Redis (recommended for production caching) Performance baseline measurements Instructions Step 1: Connection Pooling with Keep-Alive Step 2: Multi-Level Caching Step 3: DataLoader for Batch Loading When multiple parts of your app need the same work order, batch and deduplicate: Step 4: Efficient Pagination Step 5: Request Deduplication Performance Benchmarks Optimization Before After Improvement ------------- -------- ------- ------------- Connection pooling 350ms/req 150ms/req 57% faster L1 cache (hot path) 150ms/req < 1ms/req 99% faster DataLoader batching 10 calls 1 call 90% fewer requests Max page size (100) 50 pages 10 pages 5x fewer round trips Request dedup N calls 1 call (N-1) saved Output Connection pooling with keep-alive (reuses TCP connections) Multi-level cache (L1 in-memory + L2 Redis) DataLoader for batching and deduplication of entity fetches Efficient pagination with max page sizes Request deduplication preventing redundant concurrent calls Error Handling Issue Cause Solution ------- ------- ---------- Stale cache data TTL too long Reduce TTL, invalidate on writes Memory growth Unbounded cache Set max size, use LRU eviction DataLoader errors One item in batch fails Handle per-item errors in batch function Connection pool exhaustion Too many concurrent requests Increase maxSockets or add queue Resources MaintainX API Reference DataLoader -- Batching and caching utility Node.js HTTP Agent Next Steps For cost optimization, see maintainx-cost-tuning. Examples Benchmark your API response times:

How to use it

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

@skills jeremylongshore/maintainx-performance-tuning

View the source on GitHub

Browse the @skills marketplace