alibabacloud-nginx-ingress-to-api-gateway — Claude Code skill
alibabacloud-nginx-ingress-to-api-gateway migrates Kubernetes nginx Ingress to Alibaba Cloud API Gateway. Analyzes YAML locally, classifies annotations, generates Higress config and migration report.
no license 152 installs ★ 300 updated 2026-10-23
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a claude-codeWhat alibabacloud-nginx-ingress-to-api-gateway does
The skill parses nginx.ingress.kubernetes.io/* annotations into three groups: compatible (50 like rewrite-target, enable-cors, canary-weight — kept as-is), ignorable (16 that Envoy handles natively — proxy-connect-timeout, proxy-buffering), unsupported (51 — replaced with Higress built-in plugins, native annotations, or custom WasmPlugin). Produces new YAML with ingressClassName: apig and a deployment checklist.
Runs entirely offline: no cloud APIs, cluster connections, or CLI tools needed. Only YAML input required. Go >= 1.24 and Docker are needed only if analysis determines a custom WasmPlugin is necessary — they are not default dependencies.
Parsing, classification, and generation run in one pass. Parameters like RegionId and OCI registry address use placeholders — you supply actual values at deployment time.
What it helps with
- migrate nginx Ingress to Alibaba Cloud API Gateway
- classify
nginx.ingress.kubernetes.io/*annotations by compatibility - generate Higress Ingress YAML with
ingressClassName: apig - replace unsupported annotations with built-in plugins or WasmPlugin
- produce migration report with deployment checklist
Example prompts for the agent
- Check if
ingress.yamlannotations are compatible with Alibaba Cloud APIG - Migrate all Ingress files from
k8s/manifests/to Higress and create deployment checklist - Which annotations in
production/gateway.yamlare unsupported by APIG and what replaces them
How to install alibabacloud-nginx-ingress-to-api-gateway
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a claude-code2Manually: put the files in place
~/.claude/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/alibabacloud-nginx-ingress-to-api-gateway/
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a codex2Manually: put the files in place
.agents/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a cursor2Manually: put the files in place
.cursor/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aliyun/alibabacloud-aiops-skills skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gateway2Manually: put the files in place
.github/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a gemini-cli2Platform CLI
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/middleware/apigateway/alibabacloud-nginx-ingress-to-api-gatewayManually: put the files in place
.devin/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about alibabacloud-nginx-ingress-to-api-gateway
How to install alibabacloud-nginx-ingress-to-api-gateway in Claude Code?
Run npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-nginx-ingress-to-api-gateway -a claude-code, then open ~/.claude/skills/alibabacloud-nginx-ingress-to-api-gateway/SKILL.md.
What does alibabacloud-nginx-ingress-to-api-gateway do?
Analyzes nginx Ingress locally, classifies annotations by Higress compatibility, generates new YAML with ingressClassName: apig, and produces a migration report with deployment checklist. No cloud APIs or cluster connection needed.
What tools does the skill require?
None by default — YAML parsing runs offline. Go >= 1.24 and Docker are needed only if the skill determines a custom WasmPlugin is required for an unsupported annotation.