Windows API Explorer

Ускорьте разработку десктопных приложений Windows с помощью навыка WinMD API Search. Находите, изучайте и внедряйте API Windows Platform и WinAppSDK непосредственно в Claude Code.

Разработка API ★ 13 GitHub (13 ★)

Windows API Explorer — это специализированный навык для Claude Code, предназначенный для упрощения поиска и использования десктопных Windows API. Индексируя локальные метаданные WinMD из Windows Platform SDK, WinAppSDK и NuGet-пакетов, он позволяет разработчикам искать системные возможности на естественном языке и получать точные технические сигнатуры методов, свойств и событий. Этот навык устраняет необходимость гадать, какой инструмент платформы использовать для задач от базовых файловых операций до продвинутой интеграции AI и сенсоров, обеспечивая точную генерацию кода на основе реальных локальных данных SDK без необходимости постоянного подключения к интернету.

Ключевые особенности

0113 звезд на GitHub

02Поддержка Windows Platform SDK и WinAppSDK/WinUI

03Автоматическое индексирование NuGet-пакетов, специфичных для проекта

04Поиск API по описанию возможностей на естественном языке

05Детальный поиск сигнатур членов и перечислений

06Ранжированные результаты поиска с поддержкой PascalCase и нечеткого сопоставления

Варианты использования

01Поиск правильного Windows API для конкретных аппаратных функций, таких как камера или датчики

02Получение точных сигнатур методов и типов возвращаемых значений для разработки WinUI 3

03Обнаружение доступных элементов управления UI и их свойств в Windows App SDK

name	winmd-api-search
description	Find and explore Windows desktop APIs. Use when building features that need platform capabilities — camera, file access, notifications, UI controls, AI/ML, sensors, networking, etc. Discovers the right API for a task and retrieves full type details (methods, properties, events, enumeration values).
license	Complete terms in LICENSE.txt

WinMD API Search

This skill helps you find the right Windows API for any capability and get its full details. It searches a local cache of all WinMD metadata from:

Windows Platform SDK — all Windows.* WinRT APIs (always available, no restore needed)
WinAppSDK / WinUI — bundled as a baseline in the cache generator (always available, no restore needed)
NuGet packages — any additional packages in restored projects that contain .winmd files
Project-output WinMD — class libraries (C++/WinRT, C#) that produce .winmd as build output

Even on a fresh clone with no restore or build, you still get full Platform SDK + WinAppSDK coverage.

When to Use This Skill

User wants to build a feature and you need to find which API provides that capability
User asks "how do I do X?" where X involves a platform feature (camera, files, notifications, sensors, AI, etc.)
You need the exact methods, properties, events, or enumeration values of a type before writing code
You're unsure which control, class, or interface to use for a UI or system task

Prerequisites

.NET SDK 8.0 or later — required to build the cache generator. Install from dotnet.microsoft.com if not available.

Cache Setup (Required Before First Use)

All query and search commands read from a local JSON cache. You must generate the cache before running any queries.

# All projects in the repo (recommended for first run)
.\.github\skills\winmd-api-search\scripts\Update-WinMdCache.ps1

# Single project
.\.github\skills\winmd-api-search\scripts\Update-WinMdCache.ps1 -ProjectDir <project-folder>

No project restore or build is needed for baseline coverage (Platform SDK + WinAppSDK). For additional NuGet packages, the project needs dotnet restore (which generates project.assets.json) or a packages.config file.

Cache is stored at Generated Files\winmd-cache\, deduplicated per-package+version.

What gets indexed

Source	When available
Windows Platform SDK	Always (reads from local SDK install)
WinAppSDK (latest)	Always (bundled as baseline in cache generator)
WinAppSDK Runtime	When installed on the system (detected via `Get-AppxPackage`)
Project NuGet packages	After `dotnet restore` or with `packages.config`
Project-output `.winmd`	After project build (class libraries that produce WinMD)

Note: This cache directory should be in .gitignore — it's generated, not source.

How to Use

Pick the path that matches the situation:

Discover — "I don't know which API to use"

The user describes a capability in their own words. You need to find the right API.

0. Ensure the cache exists

If the cache hasn't been generated yet, run Update-WinMdCache.ps1 first — see Cache Setup above.

1. Translate user language → search keywords

Map the user's daily language to programming terms. Try multiple variations:

User says	Search keywords to try (in order)
"take a picture"	`camera`, `capture`, `photo`, `MediaCapture`
"load from disk"	`file open`, `picker`, `FileOpen`, `StorageFile`
"describe what's in it"	`image description`, `Vision`, `Recognition`
"show a popup"	`dialog`, `flyout`, `popup`, `ContentDialog`
"drag and drop"	`drag`, `drop`, `DragDrop`
"save settings"	`settings`, `ApplicationData`, `LocalSettings`

Start with simple everyday words. If results are weak or irrelevant, try the more technical variation.

2. Run searches

.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action search -Query "<keyword>"

This returns ranked namespaces with top matching types and the JSON file path.

If results have low scores (below 60) or are irrelevant, fall back to searching online documentation:

Use web search to find the right API on Microsoft Learn, for example:
- site:learn.microsoft.com/uwp/api <capability keywords> for Windows.* APIs
- site:learn.microsoft.com/windows/windows-app-sdk/api/winrt <capability keywords> for Microsoft.* WinAppSDK APIs
Read the documentation pages to identify which type matches the user's requirement.
Once you know the type name, come back and use -Action members or -Action enums to get the exact local signatures.

3. Read the JSON to choose the right API

Read the file at the path(s) from the top results. The JSON has all types in that namespace — full members, signatures, parameters, return types, enumeration values.

Read and decide which types and members fit the user's requirement.

4. Look up official documentation for context

The cache contains only signatures — no descriptions or usage guidance. For explanations, examples, and remarks, look up the type on Microsoft Learn:

Namespace prefix	Documentation base URL
`Windows.*`	`https://learn.microsoft.com/uwp/api/{fully.qualified.typename}`
`Microsoft.*` (WinAppSDK)	`https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/{fully.qualified.typename}`

For example, Microsoft.UI.Xaml.Controls.NavigationView maps to: https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.navigationview

5. Use the API knowledge to answer or write code

Lookup — "I know the API, show me the details"

You already know (or suspect) the type or namespace name. Go direct:

# Get all members of a known type
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action members -TypeName "Microsoft.UI.Xaml.Controls.NavigationView"

# Get enum values
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action enums -TypeName "Microsoft.UI.Xaml.Visibility"

# List all types in a namespace
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action types -Namespace "Microsoft.UI.Xaml.Controls"

# Browse namespaces
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action namespaces -Filter "Microsoft.UI"

If you need full detail beyond what -Action members shows, use -Action search to get the JSON file path, then read the JSON file directly.

Other Commands

# List cached projects
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action projects

# List packages for a project
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action packages

# Show stats
.\.github\skills\winmd-api-search\scripts\Invoke-WinMdQuery.ps1 -Action stats

If only one project is cached, -Project is auto-selected. If multiple projects exist, add -Project <name> (use -Action projects to see available names). In scan mode, manifest names include a short hash suffix to avoid collisions; you can pass the base project name without the suffix if it's unambiguous.

Search Scoring

The search ranks type names and member names against your query:

Score	Match type	Example
100	Exact name	`Button` → `Button`
80	Starts with	`Navigation` → `NavigationView`
60	Contains	`Dialog` → `ContentDialog`
50	PascalCase initials	`ASB` → `AutoSuggestBox`
40	Multi-keyword AND	`navigation item` → `NavigationViewItem`
20	Fuzzy character match	`NavVw` → `NavigationView`

Results are grouped by namespace. Higher-scored namespaces appear first.

Troubleshooting

Issue	Fix
"Cache not found"	Run `Update-WinMdCache.ps1`
"Multiple projects cached"	Add `-Project <name>`
"Namespace not found"	Use `-Action namespaces` to list available ones
"Type not found"	Use fully qualified name (e.g., `Microsoft.UI.Xaml.Controls.Button`)
Stale after NuGet update	Re-run `Update-WinMdCache.ps1`
Cache in git history	Add `Generated Files/` to `.gitignore`

References

Windows Platform SDK API reference — documentation for Windows.* namespaces
Windows App SDK API reference — documentation for Microsoft.* WinAppSDK namespaces

Что это

Windows API Explorer — это skill для быстрого поиска и анализа Windows API (WinRT / WinMD) прямо внутри редактора, без ручного лазания по документации и без необходимости собирать проект. Он идеально подходит, когда вы пишете код под Windows (десктопные приложения на C++/WinRT, C# с WinUI, UWP, WinAppSDK) и хотите точно знать, какой тип, метод или свойство использовать для конкретной задачи — камера, файлы, уведомления, UI-элементы, сенсоры, AI/ML, сеть и т.д.

Skill не обращается к Microsoft Learn в реальном времени, а работает с локальным кешем метаданных (winmd-файлы), в котором уже есть:

Все Windows.* API (Platform SDK) и Microsoft.* WinAppSDK — всегда, без восстановления проекта.
WinUI — всегда, без восстановления.
Дополнительные NuGet-пакеты и собственные WinMD из сборки проекта (после dotnet restore / сборки).

Это значит, что даже на свежем клоне репозитория вы сразу получаете полную информацию о десятках тысяч типов.

Как работает

Skill предоставляет два основных сценария через PowerShell-скрипты в репозитории:

1. Поиск («Не знаю, какой API использовать»)

Пользователь описывает нужную возможность своими словами — skill переводит это в ключевые слова для поиска и запускает: - Invoke-WinMdQuery.ps1 -Action search -Query "<keyword>" Он возвращает ранжированные неймспейсы с наиболее подходящими типами, а также путь к JSON-файлу этого неймспейса.

Пример: пользователь хочет «сделать фото» — skill пробует ключевые слова camera, capture, photo, MediaCapture.

Затем skill читает этот JSON (все члены типа, сигнатуры, параметры, перечисления) и выбирает подходящий API. Если результаты поиска по локальному кешу плохие (score <60 или нерелевантные), рекомендуется переключиться на веб-поиск по Microsoft Learn (skill подсказывает URL-шаблоны для Windows.* и Microsoft.*). После того как тип найден, возвращаются к локальному кешу для получения точных сигнатур.

2. Прямой запрос («Я знаю тип, покажи детали»)

Если имя типа уже известно (частично или полностью), можно сразу запросить его структуру: - -Action members — все члены (методы, свойства, события, поля) - -Action enums — значения перечисления - -Action types — список типов в неймспейсе - -Action namespaces — просмотр всех неймспейсов по фильтру - -Action projects / -Action packages / -Action stats — служебные запросы

Важные детали перед первым использованием

Перед любыми запросами нужно сгенерировать кеш запуском скрипта:

./.github/skills/winmd-api-search/scripts/Update-WinMdCache.ps1
# или для одного проекта:
./.github/skills/winmd-api-search/scripts/Update-WinMdCache.ps1 -ProjectDir <папка_проекта>

Скрипт читает локально установленные SDK (Platform SDK, WinAppSDK), а также project.assets.json после dotnet restore для NuGet-пакетов. Кеш сохраняется в Generated Files\winmd-cache\, дедублицируется по пакет+версия. Эту папку нужно добавить в .gitignore.

Поиск использует скоринг по вхождению ключевых слов в имена типов и членов (100 — точное совпадение, 80 — начинается с, 60 — содержит, 50 — инициалы PascalCase, 40 — AND-логика, 20 — fuzzy).

Когда использовать

Вы пишете десктопный код под Windows (C++/WinRT, C#, WinUI, UWP, WinAppSDK) и не можете вспомнить точное имя API.
Нужно быстро проверить сигнатуру метода или свойства, не открывая браузер.
Вы сомневаетесь, какой элемент управления (например, NavigationView vs TabView) подходит для задачи.
Нужно узнать все значения перечисления (например, Visibility или FlyoutPlacementMode).
Вы работаете в репозитории, где уже есть dependent проекты, и хотите индексировать их собственные WinMD-типы.

Важно знать

Кеш содержит только сигнатуры (имена, параметры, типы), без описаний и примеров. Для полного понимания API всегда нужно обращаться к Microsoft Learn по URL-шаблону: https://learn.microsoft.com/uwp/api/{полное.имя.типа} для Windows.* или https://learn.microsoft.com/windows/windows-app-sdk/api/winrt/{полное.имя.типа} для Microsoft.*.
При нескольких закешированных проектах нужно указывать -Project <имя>. Список доступных проектов даёт -Action projects.
Если после обновления NuGet-пакетов кеш устарел — просто перезапустите Update-WinMdCache.ps1.
Для работы скриптов требуется .NET SDK 8.0 или новее (установка с dotnet.microsoft.com).
Skill явно рекомендует в случае неудачного поиска (низких скорингов) использовать веб-поиск с конструкцией site:learn.microsoft.com/uwp/api <ключевые_слова>, чтобы найти нужный тип, а затем вернуться к локальному запросу -Action members для получения точной сигнатуры.

Install with one command.

npx skillfish add hidorakai002/ai-workspace-archive winmd-api-search

Источник: https://mcpmarket.com/tools/skills/windows-api-explorer