Agent skill · software engineering · jeremylongshore
maintainx-multi-env-setup
Configure multiple MaintainX environments (dev, staging, production).
Why this skill is useful
Provides specific environment configuration patterns and secret management integration for MaintainX that the AI wouldn't reliably 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 Multi-Environment Setup Overview Configure and manage multiple MaintainX environments for development, staging, and production with proper secret management and client isolation. Prerequisites Separate MaintainX accounts or organizations for each environment Secret management solution (environment variables, GCP Secret Manager, or AWS SSM) Node.js 18+ Instructions Step 1: Environment Configuration Step 2: Client Factory Step 3: Environment Files Step 4: GCP Secret Manager Integration Step 5: Validation Script Output Environment-specific configuration with type-safe config loader Client factory producing isolated clients per environment .env. files with .gitignore protection GCP Secret Manager integration for production secrets Validation script to verify all environment credentials Error Handling Issue Cause Solution ------- ------- ---------- Missing API key Environment variable not set Check .env. file for target environment Wrong environment data Using prod key in dev Verify MAINTAINXENV is set correctly Secret Manager 403 Missing IAM permissions Grant secretmanager.secretAccessor role Config mismatch after deploy Old secrets cached Clear client cache, reload secrets Resources MaintainX API Reference 12-Factor App: Config GCP Secret Manager Next Steps For observability setup, see maintainx-observability. Examples GitHub Actions with per-environment secrets:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-multi-env-setup