AGENT SKILL

maintainx-common-errors

Debug and resolve common MaintainX API errors. Use when encountering API errors, authentication issues, or unexpected responses from the MaintainX API. Trigger with phrases like "maintainx error", "maintainx 401", "maintainx api problem", "maintainx not working", "debug maintainx".

适用职业开发工程师
License 许可
MIT
最近更新
2026-03-20
Stars
★ 4
Forks
0

01 前言 Front Matter

name
maintainx-common-errors
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
version
1.0.0
description
Debug and resolve common MaintainX API errors. Use when encountering API errors, authentication issues, or unexpected responses from the MaintainX API. Trigger with phrases like "maintainx error", "maintainx 401", "maintainx api problem", "maintainx not working", "debug maintainx".
allowed-tools
Read, Write, Edit, Bash(curl:*), Grep
compatible-with
claude-code, codex, openclaw

02 资源文件 1

03 SKILL.md 正文

MaintainX Common Errors

Overview

Quick reference guide for diagnosing and resolving common MaintainX API errors.

Prerequisites

  • MaintainX API credentials configured
  • Basic understanding of HTTP status codes
  • Access to API logs

Instructions

Follow these high-level steps to implement maintainx-common-errors:

  1. Review the prerequisites and ensure your environment is configured
  2. Follow the detailed implementation guide for step-by-step code examples
  3. Validate your implementation against the output checklist below

For full implementation details, load: Read(plugins/saas-packs/maintainx-pack/skills/maintainx-common-errors/references/implementation-guide.md)

Output

  • Identified error cause
  • Applied appropriate fix
  • Verified resolution

Error Handling

Issue Solution
401 Unauthorized Verify API key in environment variables
429 Rate Limited Implement exponential backoff, reduce request frequency
500 Server Error Retry with backoff, check MaintainX status page

Resources

Next Steps

For comprehensive debugging, see maintainx-debug-bundle.

Examples

Basic usage: Apply maintainx common errors to a standard project setup with default configuration options.

Advanced scenario: Customize maintainx common errors for production environments with multiple constraints and team-specific requirements.

04 同仓库更多 Skills

micsapp
micsapp/micstec-skills

azure-apim-architecture

Analyzes and explains Azure API Management architecture decisions for enterprise API marketplace implementations using VNet Internal mode, Front Door, hybrid authentication, and multi-environment strategies. Use when discussing APIM component selection, network topology, cost optimization, or comparing alternatives like workspaces vs instances, VNet Internal vs External mode, or Front Door vs Application Gateway.

开发工程师后端与接口
★ 4
micsapp
micsapp/micstec-skills

apiops-deployment

Guides deployment of Azure API Management infrastructure using Infrastructure as Code (Bicep/Terraform), CI/CD pipelines (GitHub Actions/Azure DevOps), and APIOps workflows. Use when deploying APIM, creating pipelines, or implementing dev→test→prod promotion strategies.

开发工程师后端与接口运维与部署
★ 4
micsapp
micsapp/micstec-skills

apim-policy-authoring

Creates production-ready Azure API Management policy XML for authentication (OAuth 2.0, JWT validation, subscription keys), rate limiting, CORS configuration, error handling, and API transformations. Use when implementing API security, access control, or request/response processing logic.

后端与接口
★ 4
micsapp
micsapp/micstec-skills

api-security-review

Reviews Azure API Management configurations for security vulnerabilities, OWASP API Security Top 10 compliance, VNet Internal mode validation, Private Link verification, and Azure Security Benchmark alignment. Use when performing security audits, pre-deployment validation, or compliance reviews.

开发工程师后端与接口
★ 4
micsapp
micsapp/micstec-skills

jira-cli

Interact with Jira from the command line to create, list, view, edit, and transition issues, manage sprints and epics, and perform common Jira workflows. Use when the user asks about Jira tasks, tickets, issues, sprints, or needs to manage project work items.

★ 4
micsapp
micsapp/micstec-skills

calculator

Performs arbitrary-precision arithmetic calculations including addition, subtraction, multiplication, division, and exponents. Use when the user asks to calculate, compute, or evaluate math expressions, or when precise decimal arithmetic is needed to avoid floating-point errors.

★ 4