скилл

aks-known-issues — скилл для Claude Code: что делает и как установить

Q: Как установить aks-known-issues в Claude Code?

Выполните в Claude Code по очереди две команды: сначала `/plugin marketplace add microsoft/skills`, а затем `/plugin install aks-skills@skills`.

Находит решения сбоев Azure Kubernetes Service по точным сигнатурам ошибок. Срабатывает при конкретных отказах виртуальных машин, дисков и сетевых расширений.

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓

/plugin marketplace add microsoft/skills
/plugin install aks-skills@skills

Открыть на GitHub

Что делает aks-known-issues

Скилл ищет задокументированные исправления для сбоев AKS в каталоге ошибок Microsoft. Он распознаёт чёткие сигнатуры: отказы VMCannotFitEphemeralOSDisk, несовместимость NodePoolMcVersionIncompatible, нехватку мощностей ZonalAllocationFailed, а также проблемы с расширениями vmssCSE вроде VMExtensionError_OutboundConnFail или VMExtensionError_K8SAPIServerConnFail.

Для запуска скилла требуется полная сигнатура со всеми квалификаторами, включая размер инстанса, регион или зону. Подстроки и голые числовые коды скилл отбрасывает. Ошибки превышения лимитов квот здесь не обрабатываются: их положено направлять в aks-troubleshooting. Для работы серверы MCP не требуются, агент применяет интерфейс командной строки Azure или доступные инструменты чтения.

Перед любым изменением ресурсов скилл обязан запросить явное одобрение пользователя. Без точного совпадения сигнатуры из каталога диагностика не запустится.

Какие задачи решает

подобрать решение при ошибке VMCannotFitEphemeralOSDisk во время создания пула узлов
устранить сбой подключения к API-серверу при ошибках VMExtensionError_K8SAPIServerConnFail
найти официальные шаги исправления для ZonalAllocationFailed с нехваткой ёмкости зоны
разобрать отказ развёртывания OverconstrainedAllocationRequest с заданными ограничениями

Примеры запросов агенту

При создании пула узлов в AKS возникла ошибка VMCannotFitEphemeralOSDisk. Как её исправить?
Кластер AKS вернул ошибку VMExtensionError_K8SAPIServerConnFail при инициализации узлов vmssCSE. Найди причину и шаги решения.
Развёртывание упало с ZonalAllocationFailed из-за недостатка ресурсов в зоне 1. Что рекомендует документация Microsoft?

Как установить aks-known-issues

1Через маркетплейс плагинов

/plugin marketplace add microsoft/skills

/plugin install aks-skills@skills

Команда ставит плагин aks-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add microsoft/skills --skill aks-known-issues -a claude-code

3Вручную: положить файлы

~/.claude/skills/aks-known-issues/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/aks-known-issues/

Вручную: положить файлы

.agents/skills/aks-known-issues/SKILL.md

Для всех проектов — ~/.agents/skills/

Вручную: положить файлы

.cursor/skills/aks-known-issues/SKILL.md

Cursor читает и .agents/skills/, и .claude/skills/

1GitHub CLI

gh skill install microsoft/skills aks-known-issues

2Вручную: положить файлы

.github/skills/aks-known-issues/SKILL.md

Командой платформы

gemini skills install https://github.com/microsoft/skills --path .github/plugins/aks-skills/skills/aks-known-issues

Вручную: положить файлы

.devin/skills/aks-known-issues/SKILL.md

Старый путь .windsurf/skills/ тоже читается

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о aks-known-issues

Как установить aks-known-issues в Claude Code?

Выполните в Claude Code по очереди две команды: сначала /plugin marketplace add microsoft/skills, а затем /plugin install aks-skills@skills.

Что делает скилл aks-known-issues?

Он сопоставляет конкретную ошибку развёртывания или работы AKS с базой задокументированных неполадок. В ответе скилл выдаёт причину сбоя, проверенные шаги исправления, ссылку на Microsoft Learn и команды для безопасной проверки.

Почему скилл не реагирует на ошибки квот?

В каталоге скилла нет записей для превышения квот подписки. Инциденты с лимитами ресурсов и общие симптомы без точной сигнатуры нужно передавать скиллу aks-troubleshooting.

Исходный текст

SKILL.md · MIT

---
name: aks-known-issues
license: MIT
metadata:
  author: Microsoft
  version: "1.2.1"
description: "Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-capacity message. Never use for quota errors, code-only or bare wrappers, generic symptoms, incomplete signatures, or failures outside AKS; use aks-troubleshooting or azure-diagnostics."
---

# AKS Known Issues

## Quick Reference

| Property | Value |
|---|---|
| Best for | Exact signature plus AKS operation |
| Output | Cause, fix, and Learn citation |

Use the [catalog](references/error-code-map.md).

## When to Use This Skill

Named catalog signatures only. Generic AKS → `aks-troubleshooting`; non-AKS →
no AKS skill.

If every qualifier for a catalog row is not present, do not use this skill.
This catalog has no quota-error rows; route AKS quota incidents to
`aks-troubleshooting`.

## MCP Tools

None required. Use advertised read-only Azure tools or CLI queries.

## Workflow

1. Capture exact code, nested message, operation, and AKS resource.
2. Require every qualifier; codes are not substrings.
3. Give cause, fix, citation, and read-only verification.
4. State what ran; require explicit approval before every mutation.

## Error Handling

| Input | Response |
|---|---|
| Bare wrapper/number | Request nested signature and CSE context |
| Generic AKS | `aks-troubleshooting` |
| Non-AKS | No AKS skill |

Из того же набора242

Весь набор →