Agent skill

Windows Automation

by vellum-ai in vellum-ai/vellum-assistant

Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor.

MITAuto-check passedProductivity & Automation

Install Windows Automation

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill windows-automation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant windows-automation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/windows-automation .claude/skills/windows-automation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
windows-automation
GitHub stars
1.4k
Token cost
~1.5k tokens
SKILL.md length
486 words
Files
1
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor.

  • Works in 4 steps: A documented CLI or URI scheme → A documented PowerShell module or COM API → Microsoft UI Automation → …
  • Inspecting desktop apps
  • SKILL.md covers Discover and launch apps, Use documented app automation, Consequential actions are… and Inspect native UI, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Windows Automation is an agent skill from vellum-ai/vellum-assistant. Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor. Use for launching or inspecting desktop apps, opening Windows Settings, controlling scriptable Microsoft Office apps, and interacting with native UI when no direct CLI or API is available.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants on Windows

It sits in Productivity & Automation, covering Desktop control and Mobile UI design. It works with PowerShell. The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

When your agent uses it

  • Inspecting desktop apps
  • Opening Windows Settings
  • Controlling scriptable Microsoft Office apps
  • Interacting with native UI when no direct CLI

Example prompts

  • “/windows-automation”

Requirements

  • Compatibility (from SKILL.md): Designed for Vellum personal assistants on Windows

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. A documented CLI or URI scheme
  2. A documented PowerShell module or COM API
  3. Microsoft UI Automation
  4. Keyboard input only when the target and focus are verified

What it can do on your machine

Read from SKILL.md and the folder at commit 33cc983. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are powershell).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants on Windows

    From compatibility in the SKILL.md frontmatter.

Context cost

Windows Automation loads about 1.5k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 486 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 33cc983, republished under its MIT licence (© vellum-ai). 486 words, ~1,532 tokens.

Download SKILL.mdSave it as .claude/skills/windows-automation/SKILL.md (or your agent's skills folder).
name
windows-automation
description
Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor. Use for launching or inspecting desktop apps, opening Windows Settings, controlling scriptable Microsoft Office apps, and interacting with native UI when no direct CLI or API is available.
compatibility
Designed for Vellum personal assistants on Windows
metadata.emoji
🪟

Use host_bash for every command in this skill. On Windows, host_bash runs Windows PowerShell with no profile and no interactive prompt. Use PowerShell syntax and Windows paths.

Prefer automation methods in this order:

  1. A documented CLI or URI scheme
  2. A documented PowerShell module or COM API
  3. Microsoft UI Automation
  4. Keyboard input only when the target and focus are verified

Avoid screen coordinates and blind keystrokes. They are fragile and can affect the wrong app. Use computer control only when PowerShell and UI Automation cannot complete the task or the user explicitly requests it.

Discover and launch apps

powershell
# Find Start menu apps
Get-StartApps | Where-Object Name -Like "*Calculator*"

# Inspect running desktop apps
Get-Process | Where-Object MainWindowTitle | Select-Object Id, ProcessName, MainWindowTitle

# Launch an app or a Windows Settings page
Start-Process calc.exe
Start-Process "ms-settings:privacy-microphone"

# Open a folder in File Explorer
Start-Process explorer.exe -ArgumentList "C:\Users\Public\Documents"

Prefer a stable executable, AppUserModelId, URI scheme, process ID, or automation ID over a localized window title.

Use documented app automation

Microsoft Office desktop apps expose COM APIs. Check that the app is installed before relying on one. Keep the COM object alive for the full operation and release it when finished.

powershell
# Create an isolated temporary workbook
$excel = $null
$workbook = $null
$worksheet = $null
$cell = $null
try {
  $excel = New-Object -ComObject Excel.Application
  $excel.Visible = $true
  $workbook = $excel.Workbooks.Add()
  if (-not [string]::IsNullOrEmpty($workbook.Path) -or $workbook.AutoSaveOn) {
    throw "The workbook is not an isolated temporary document."
  }
  $worksheet = $workbook.Worksheets.Item(1)
  $cell = $worksheet.Cells.Item(1, 1)
  $cell.Value2 = "Example"
} finally {
  if ($null -ne $workbook) {
    $workbook.Close($false)
  }
  if ($null -ne $excel) {
    $excel.Quit()
  }
  foreach ($comObject in @($cell, $worksheet, $workbook, $excel)) {
    if ($null -ne $comObject) {
      [System.Runtime.InteropServices.Marshal]::ReleaseComObject($comObject) | Out-Null
    }
  }
}

Close unsaved temporary documents with Close($false), quit the application, and release COM objects in a finally block so cleanup never waits for a save prompt.

Consequential actions are unsupported

Do not use this skill to save, send, delete, or overwrite content. The Windows host executor does not provide an in-process confirmation gate that works for both local and remote assistants.

Treat every existing document, workbook, message, note, calendar item, file, and cloud-backed resource as read-only. AutoSave can persist an edit without an explicit save command. Only edit an isolated temporary document that the automation created during the current task, has no storage path or cloud connection, and has AutoSave definitively disabled. If those conditions cannot be verified, do not edit it.

If the user requests a consequential action, use a dedicated skill or product workflow with its own hard confirmation gate. If none is available, explain the limitation and ask the user to perform that final action manually.

Show full SKILL.md (175 more words)Show less

Inspect native UI

Load the built-in UI Automation assemblies and identify elements by process ID, automation ID, control type, or name.

powershell
Add-Type -AssemblyName UIAutomationClient

$desktop = [System.Windows.Automation.AutomationElement]::RootElement
$windows = $desktop.FindAll(
  [System.Windows.Automation.TreeScope]::Children,
  [System.Windows.Automation.Condition]::TrueCondition
)

$windows | ForEach-Object {
  [pscustomobject]@{
    Name = $_.Current.Name
    ProcessId = $_.Current.ProcessId
    AutomationId = $_.Current.AutomationId
    ControlType = $_.Current.ControlType.ProgrammaticName
  }
}

Once the target window is known, search its descendants with a PropertyCondition and use the supported pattern, such as InvokePattern, ValuePattern, SelectionItemPattern, or TogglePattern. Check TryGetCurrentPattern before invoking a pattern.

Focus and keyboard fallback

If an app exposes no useful automation pattern, verify the process and window before sending keys:

powershell
$process = Get-Process notepad -ErrorAction Stop | Select-Object -First 1
$shell = New-Object -ComObject WScript.Shell
if (-not $shell.AppActivate($process.Id)) {
  throw "Could not activate Notepad"
}

Use keyboard input only after activation succeeds. Never use keyboard input to trigger a consequential action prohibited above.

Troubleshooting

  • An empty UI Automation tree can mean the target runs at a higher integrity level. Do not bypass Windows security boundaries. Ask the user to run both apps at the same privilege level if appropriate.
  • App names, window titles, and control names can be localized. Prefer process IDs and automation IDs.
  • Packaged apps may launch through an AppUserModelId rather than a stable executable. Discover them with Get-StartApps.
  • host_bash is non-interactive. Do not use commands that wait for terminal input or depend on a PowerShell profile.

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/windows-automation of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 33cc983

Compare with similar skills

Windows Automation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Windows Automation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Windows Automation this skillvellum-ai/vellum-assistant1.4k—~1.5kAutomated safety check: PassMIT
Manage Taskboardshengsheng90/DSH-taskboard332—~885Automated safety check: PassApache-2.0
Phone Usepockebot/openpocket847—~1.1kAutomated safety check: PassMIT
Vision SkillsAnionex/agent-vision-toolkit1.2k—~4kAutomated safety check: PassMIT
Mac Computer UseTo3akaRin/mac-computer-use1.1k—~495Automated safety check: PassMIT
Interceptor iOSHacker-Valley-Media/Interceptor522—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Manage Taskboard

    shengsheng90/DSH-taskboard

    Manage work in the native DeepSeek Harness Taskboard with exact task ids and optimistic versions.

    332 GitHub stars~885 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Phone Use

    pockebot/openpocket

    Use OpenPocket MCP tools to inspect or control an Android emulator, physical Android phone, Android TV, or ADB-backed app.

    847 GitHub stars~1.1k tokensUpdated 3 mo ago
    MobileAuto-check passed
  • Vision Skills

    Anionex/agent-vision-toolkit

    Local vision CLIs: glance (describe/ask/OCR an image), ground (locate a target, pixel box), detect (element inventory), trace (image to SVG geometry), crop (cut a pixel box to a file), and…

    1.2k GitHub stars~4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Mac Computer Use

    To3akaRin/mac-computer-use

    操作 macOS 桌面应用,探测窗口和自动化接口、截图、读取或修改辅助功能元素、执行鼠标键盘动作,以及通过 CDP 操作内嵌 Chromium 页面。适用于桌面应用自动化与界面验收;普通网页任务优先使用已有浏览器工具。

    1.1k GitHub stars~495 tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed
  • Interceptor iOS

    Hacker-Valley-Media/Interceptor

    Drive any installed app on an owned, unlocked, Developer-Mode iPhone via interceptor ios : ref-tagged element trees, deterministic coordinate taps (click), reliable text entry (type/keys), scroll…

    522 GitHub stars~1.9k tokensUpdated 8 days ago
    Productivity & AutomationAuto-check passed
  • Cloud Computer Use

    davidondrej/cloudroom-core

    See and control desktop apps on this Cloud sandbox’s virtual Linux screen with cloudroom computer-use: launch GUI apps you build or install, read their UI, click, type, and take screenshots.

    285 GitHub stars~881 tokensUpdated today
    Productivity & AutomationAuto-check: notes

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Auto-check: warnings

Works with

Questions about Windows Automation

What does Windows Automation do?

Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor. Windows Automation is an agent skill from vellum-ai/vellum-assistant. Automate native Windows apps and system interactions with PowerShell, documented COM APIs, and Microsoft UI Automation through the Windows host executor.

When should I use Windows Automation?

Windows Automation fits situations like: inspecting desktop apps; opening Windows Settings; controlling scriptable Microsoft Office apps; interacting with native UI when no direct CLI.

How do I install Windows Automation in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill windows-automation -a claude-code`. Or copy the skill folder (skills/windows-automation in vellum-ai/vellum-assistant) into .claude/skills/windows-automation in your project. Claude Code loads it when a task matches its description.

How do I install Windows Automation in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill windows-automation -a codex`. Or copy the skill folder (skills/windows-automation in vellum-ai/vellum-assistant) into .agents/skills/windows-automation in your project. Codex loads it when a task matches its description.

Can I use Windows Automation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill windows-automation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/windows-automation, .gemini/skills/windows-automation, .github/skills/windows-automation and .opencode/skills/windows-automation in your project.

What does Windows Automation need to run?

SKILL.md names no scripts, command-line tools or credentials: Windows Automation is instructions for the agent only. Compatibility (from SKILL.md): Designed for Vellum personal assistants on Windows.

Does Windows Automation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Windows Automation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Windows Automation use?

Windows Automation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Windows Automation use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Windows Automation?

Skills that share tags, products or a category with Windows Automation: Manage Taskboard (shengsheng90/DSH-taskboard, 332 stars), Phone Use (pockebot/openpocket, 847 stars), Vision Skills (Anionex/agent-vision-toolkit, 1.2k stars) and Mac Computer Use (To3akaRin/mac-computer-use, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Windows Automation?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,408 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.