azure-search-nav — скилл для Claude Code: что делает и как установить
Генерирует прямые ссылки на нужные разделы и меню портала Azure для ресурсов AKS, Kubernetes и Compute по текстовому описанию задачи.
/plugin marketplace add microsoft/skills
/plugin install aks-skills@skillsЧто делает azure-search-nav
Скилл принимает ссылку на ресурс в портале или его ARM-идентификатор вместе с поисковым запросом на обычном языке. Внутри запускается PowerShell-скрипт references/Invoke-PortalSearchNav.ps1, который обращается к семантическому API aks-search-direct-mid. В ответ пользователь получает готовую ссылку вида https://portal.azure.com, ведущую прямо на нужную страницу или лезвие (blade).
Для работы требуется модуль PowerShell Az.Accounts. Авторизация проходит через браузер с помощью Connect-AzAccount, а для терминалов без графического интерфейса предусмотрен параметр -UseDeviceAuthentication. Без установленного модуля Az.Accounts скрипт завершится ошибкой.
Скилл работает только с типами ресурсов из Microsoft.ContainerService, Microsoft.Kubernetes и Microsoft.Compute, перечисленными в references/resource-types.json. Если передать неподдерживаемый провайдер, ссылка создана не будет.
Какие задачи решает
- найти нужный пункт меню или лезвие в портале Azure по текстовому запросу
- сгенерировать прямую ссылку на вкладку настроек кластера AKS по его ARM ID
- получить URL страницы для ресурсов
Microsoft.Computeили Arc-enabled Kubernetes - войти в учётную запись Azure в консоли через код устройства
Примеры запросов агенту
- Найди в портале Azure, где настроить автомасштабирование для кластера
my-aks-cluster, вот ссылка на ресурс. - Собери прямую ссылку на вкладку сети для виртуальной машины с ARM ID
/subscriptions/.../virtualMachines/vm1. - Где в Azure portal посмотреть журналы для этого ресурса Arc Kubernetes?
Как установить azure-search-nav
1Через маркетплейс плагинов
/plugin marketplace add microsoft/skills/plugin install aks-skills@skillsКоманда ставит плагин aks-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/skills --skill azure-search-nav -a claude-code3Вручную: положить файлы
~/.claude/skills/azure-search-nav/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/azure-search-nav/
Вручную: положить файлы
.agents/skills/azure-search-nav/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/azure-search-nav/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/skills azure-search-nav2Вручную: положить файлы
.github/skills/azure-search-nav/SKILL.mdКомандой платформы
gemini skills install https://github.com/microsoft/skills --path .github/plugins/aks-skills/skills/azure-search-navВручную: положить файлы
.devin/skills/azure-search-nav/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о azure-search-nav
Как установить azure-search-nav в Claude Code?
Выполните команду /plugin marketplace add microsoft/skills, а затем установите плагин с помощью /plugin install aks-skills@skills.
Что делает azure-search-nav?
Скилл принимает ARM ID или URL ресурса вместе с текстовым описанием задачи и возвращает прямую ссылку на нужный экран портала Azure через семантический поиск aks-search-direct-mid.
Что делать, если авторизация в Azure завершается ошибкой в терминале без GUI?
При работе в консоли без графического интерфейса скрипт нужно перезапустить с флагом -UseDeviceAuthentication, чтобы авторизоваться по одноразовому коду устройства.
Исходный текст
SKILL.md · MIT
--- name: azure-search-nav description: "Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft.Compute resources using the aks-search-direct-mid semantic search API. WHEN: 'find where in the Azure portal to do something', 'search the portal for an operation', 'construct a portal link from a search query and a resource'." license: MIT metadata: author: Microsoft version: "1.0.1" --- # Azure Portal Search Link Builder ## Quick Reference | Item | Value | |------|-------| | Script | [`references/Invoke-PortalSearchNav.ps1`](references/Invoke-PortalSearchNav.ps1) | | Resource map | [`references/resource-types.json`](references/resource-types.json) | | Prerequisite | `Az.Accounts` PowerShell module | | Auth | Interactive Microsoft sign-in (`Connect-AzAccount`), or device-code with `-UseDeviceAuthentication` | ## When to Use This Skill - User asks to find where in the Azure portal to perform an operation on a supported Container Service, Arc-enabled Kubernetes, or Compute resource. - User wants a portal deep link for a specific blade/menu item. - User provides a resource URL or ARM resource ID and a natural-language search query. ## Workflow 1. Collect **resource link** (portal URL or bare ARM resource ID) and **search query** from the user. 2. Run `references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'`. 3. The script signs in (browser by default; pass `-UseDeviceAuthentication` in headless/CLI environments), calls the search API, and prints portal deep links always rooted at `https://portal.azure.com`. See [references/README.md](references/README.md) for full parameter reference and API details. ## Error Handling | Error | Cause | Fix | |-------|-------|-----| | Resource type not enabled | `armProvider` not in `references/resource-types.json` | Confirm the type is in the enabled-provider list | | 401 from API | Invalid token, or wrong tenant selected | Re-run and select the account with access to the target subscription's tenant | | Empty results | No matching navigation item for the query | Try a different search term | | `Az.Accounts` not found | Module not installed | `Install-Module Az.Accounts -Scope CurrentUser` | | Browser sign-in fails (no window handle) | Headless/CLI environment | Re-run with `-UseDeviceAuthentication` |
© Microsoft · MIT · microsoft/skills
