kwin-desktop-automation

kwin-desktop-automation is a skill for Claude Code from isac322/kwin-mcp. It costs 135 tokens per session (1,882 once invoked), scanned A, original, MIT.

A procedure for controlling Linux desktop applications running in KDE Plasma on Wayland, a Linux display system. It covers launching apps, clicking, typing, screenshots, testing, and kiosk control through a KWin-based server.

In plain words
What is it for?
Use it for end-to-end GUI tests, headless app runs, live KDE desktop automation, kiosk operation, and control of embedded Linux devices that expose accessibility information.
Why use it?
It supplies the session setup and operating rules needed to automate a graphical app reliably, including isolated sessions for tests.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the kwin-mcp plugin — 1 skill shipped together

Good fit Use it for end-to-end GUI tests, headless app runs, live KDE desktop automation, kiosk operation, and control of embedded Linux devices that expose accessibility information.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/isac322/kwin-mcp/kwin-desktop-automation
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add isac322/kwin-mcp --skill kwin-desktop-automation
Clone the repo
git clone --depth 1 https://github.com/isac322/kwin-mcp

Made for: Claude Code.

Or install kwin-mcp, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for kwin-desktop-automation

README.md
[![agentmods](https://agentmods.dev/badge/skills/isac322/kwin-mcp/kwin-desktop-automation/github.svg)](https://agentmods.dev/skills/isac322/kwin-mcp/kwin-desktop-automation)
Your own site
<a href="https://agentmods.dev/skills/isac322/kwin-mcp/kwin-desktop-automation"><img src="https://agentmods.dev/badge/skills/isac322/kwin-mcp/kwin-desktop-automation/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for kwin-desktop-automation

Your own site · 80×15
<a href="https://agentmods.dev/skills/isac322/kwin-mcp/kwin-desktop-automation"><img src="https://agentmods.dev/badge/skills/isac322/kwin-mcp/kwin-desktop-automation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 135 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,882 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00135 $0.01882
Opus 5 $0.00068 $0.00941
Sonnet 5 $0.00027 $0.00376
Haiku 4.5 $0.00014 $0.00188

Measured 10d ago against content hash ecc0de001246, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

kwin-desktop-automation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

integrations/claude-code/skills/kwin-desktop-automation/SKILL.md · 109 lines

How it starts

The opening of the file, as written. The whole thing — 109 lines — stays where its author put it; the contents beside it link to each section on GitHub.

kwin-desktop-automation

Drive Linux KDE Plasma 6 Wayland desktops through the kwin-mcp MCP server. The MCP server provides 30 capabilities; this skill provides the operational discipline to use them efficiently, in the right order, and without falling into platform-specific traps.

When to apply

Activate this skill whenever the user wants to:

  • Launch, click, type, or screenshot any KDE / Qt / GTK / Electron app on Wayland.
  • Run end-to-end GUI tests in a headless / virtual KWin session (CI, regression, reproducibility).
  • Drive a live KDE Plasma session (their actual desktop) or a KWin instance inside a container.
  • Inspect or operate a kiosk / embedded Linux device exposing AT-SPI2.

If no kwin-mcp tools are available, this skill does not apply.

1. Pick the session mode

Every other tool requires a session. Two mutually exclusive modes:

Virtual — session_start Opens an isolated dbus-run-session + kwin_wayland --virtual compositor. Nothing reaches the host display. Use when the user says "test", "headless", "CI", "isolated", or names a specific app to launch fresh.

Useful arguments:

  • app_command="..." — launch the target app inside the session.
  • enable_clipboard=true — required for clipboard_get / clipboard_set and the Unicode-via-clipboard fallback. Off by default because wl-copy can hang on a freshly minted bus.
  • keep_screenshots=true — preserves PNGs in /tmp/kwin-mcp-screenshots-* after session_stop (delete the directory yourself when done).
  • isolate_home=true — temp HOME with isolated XDG dirs; keeps host configuration untouched.

Live — session_connect Attaches to an already-running KWin: the user's real desktop, or a KWin running inside a container / kiosk / embedded device. Use when the user says "my", "current", "this window", "what I'm looking at", "container", "kiosk", or "live". Defaults to $DBUS_SESSION_BUS_ADDRESS and $WAYLAND_DISPLAY; clipboard is always enabled. session_stop only disconnects — it never kills the live KWin or its apps.

Read the full file on GitHub · 109 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 109 lines · 135 tokens per session scan A ecc0de001246

Subscribe to this mod's changes

kwin-desktop-automation is a skill published in the GitHub repository isac322/kwin-mcp (47 stars, last pushed 1mo ago), licensed MIT. It adds 135 tokens to every session and 1,882 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

axstream

Fast deterministic macOS UI automation via replayable macros. Use BEFORE driving any macOS app's UI by hand (clicking/typing via computer-use or screenshots) — if a macro exists, replay finishes the task in seconds with no per-step reasoning; after doing a UI task manually, save it as a macro so the next run is fast.…

milind-soni/axstream · 96 tokens

computer-use

A set of rules for controlling Windows desktop applications through screen observation and simulated mouse and keyboard actions. It also describes how to find and launch installed applications and verify the results.

Plocr/Reasonix-computer-use · 23 tokens

web-navigator

A browser-automation routing guide for web tasks. It directs navigation, page inspection, and actions such as clicking or filling forms to the appropriate browser tool.

Plocr/Reasonix-computer-use · 30 tokens

chrome

Google Chrome heuristics for background-computer-use. Use when the user asks you to navigate, scroll, click links, fill forms, or otherwise drive Chrome without stealing focus. Also applies to Chromium-family browsers (Brave, Edge, Arc) that share the same AppleScript JavaScript execution primitive.

Panchangam18/background-computer-use · 62 tokens

safari

Safari desktop heuristics for background-computer-use. Use when the user asks you to navigate, scroll, click links, switch tabs, or otherwise drive Safari without stealing focus.

Panchangam18/background-computer-use · 38 tokens

record-workflow

Record an automation workflow by performing actions, then replay it later as a playbook. Capture clicks, typing, navigation into reusable sequences. Use when: "record this", "capture steps", "make repeatable", "save automation", "create playbook", "record and replay", "macro", "record workflow".

manushi4/Screenhand · 68 tokens