Agent skill

App It Windows

by Christian-Katzmann in Christian-Katzmann/app-it

Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup.

MITAuto-check passed

Install App It Windows

skills CLI
$ npx skills add Christian-Katzmann/app-it --skill app-it-windows -a claude-code

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

GitHub CLI
$ gh skill install Christian-Katzmann/app-it app-it-windows --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/Christian-Katzmann/app-it.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/app-it-windows/skills/app-it-windows .claude/skills/app-it-windows && 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
app-it-windows
GitHub stars
216
Token cost
~1.5k tokens
SKILL.md length
579 words
Files
27 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup.

  • Works in 5 steps: Inspect → Decide → Build → …
  • The user asks for app-it-windows
  • SKILL.md covers Non-Negotiables, Reference Map, Templates and Workflow, plus 2 more sections
  • Runs PowerShell scripts from its folder; calls pwsh

What it does

App It Windows is an agent skill from Christian-Katzmann/app-it. Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup. Use when the user asks for app-it-windows, a Windows app, .exe launcher, Start Menu shortcut, Windows package, or desktop icon. CI-guarded but untested on Windows hardware; never claim runtime success without a Windows maintainer.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 29 other files, including reference files (for example `references/generated-files.md`, `references/inspection-and-strategies.md` and `references/maintainer-contract.md`).

It works with macOS. The repository describes itself as: Turn your local web projects into Mac apps you can launch from the Dock, with their own window, name and icon. The licence is MIT.

When your agent uses it

  • The user asks for app-it-windows
  • Start Menu shortcut
  • Windows package

Example prompts

  • “/app-it-windows”

Requirements

  • PowerShell

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Inspect
  2. Decide
  3. Build
  4. Verify
  5. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 9ad064e. 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

    Ships script files (PowerShell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • pwsh

    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.

Context cost

App It Windows loads about 1.5k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 579 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

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 Christian-Katzmann/app-it at commit 9ad064e, republished under its MIT licence (© Christian-Katzmann). 579 words, ~1,480 tokens.

Download SKILL.mdSave it as .claude/skills/app-it-windows/SKILL.md (or your agent's skills folder). This skill also uses 26 other files; get the full folder from GitHub.
name
app-it-windows
description
Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup. Use when the user asks for app-it-windows, a Windows app, .exe launcher, Start Menu shortcut, Windows package, or desktop icon. CI-guarded but untested on Windows hardware; never claim runtime success without a Windows maintainer.

app-it-windows - Make a project launchable on Windows (beta)

Windows beta: scaffolded, untested on real hardware, maintainer wanted.

The macOS app-it lane is proven. This Windows sibling mirrors the contract with Windows primitives, but every runtime behavior that needs a real Windows desktop must be marked deferred: this needs a Windows maintainer - see docs/WINDOWS.md.

Non-Negotiables

  1. Run templates/inspect.ps1 first and read the output before editing.
  2. Trust disk over docs. Verify project type, scripts, ports, and desktop signals from files.
  3. Build everything a Mac or CI can build; never claim Windows runtime behavior works unless it was verified on real Windows hardware.
  4. Prefer the WPF + WebView2 host. Edge --app= is a fallback, not the default.
  5. Keep Windows visibly beta in every report and user-facing summary.
  6. Copy shipped templates and customize through scripts\app-it.config.json. Do not re-derive launcher patterns.
  7. Verify build/lint/config checks, then list hardware-only checks as deferred.

Reference Map

Open only what the inspection or chosen path needs:

  • references/maintainer-contract.md - what a Mac can produce, what must be deferred, and the exact Windows-maintainer phrase.
  • references/inspection-and-strategies.md - project inspection, toolchain probes, strategy tree, W-Native, W-Edge, W-Static, W-Multi, B, and D.
  • references/generated-files.md - template roster, allowed target files, config JSON, package scripts, and Start Menu destination.
  • references/wrapper-host.md - WebView2 host, lifecycle, Job Object ownership, single-instance behavior, and wrapper argument contract.
  • references/verification.md - buildable checks, Windows-only checks, and deferred rows.
  • references/report-template.md - exact beta report format.

Templates

Templates live next to this file in templates/. Copy them into the target project and keep their contracts intact:

text
templates/
  wrapper-windows/
  desktop-build.ps1
  desktop-install.ps1
  desktop-quit.ps1
  inspect.ps1
  run-template.ps1
  run-template-edge.ps1
  desktop-icons.ps1
  placeholder-icon-gen.ps1
  PSScriptAnalyzerSettings.psd1
  app-it.config.example.json

The comments inside templates encode Windows traps: PATH augmentation, WebView2/.NET prerequisites, free-port probing, Job Object ownership, Start Menu shortcuts, SmartScreen, and icon-cache behavior. Read the matching reference before changing launcher internals.

Workflow

1. Inspect

Run the bundled probe from the target project root:

powershell
pwsh -File path\to\plugins\app-it-windows\skills\app-it-windows\templates\inspect.ps1

Read references/inspection-and-strategies.md before deciding project shape, ports, existing desktop tooling, names, icons, or strategy.

2. Decide

For each user-facing app:

text
Existing Electron/Tauri/NW.js Windows target?
  yes -> Strategy B
  no  -> native desktop requirement beyond web shell?
           yes -> Strategy D
           no  -> .NET 8 buildable and WebView2 expected?
                    no  -> W-Edge fallback
                    yes -> static built bundle, no server?
                             yes -> W-Static
                             no  -> cohabiting frontend + backend?
                                      yes -> W-Multi
                                      no  -> W-Native (default)

WebView2 is Chromium, so File System Access and other Chromium APIs are reasons to prefer the WPF host, not reasons for a polyfill.

Show full SKILL.md (243 more words)Show less
3. Build

Touch as little project surface as possible. Copy the selected templates, write scripts\app-it.config.json, add desktop:* package scripts, and generate the .ico/published output when tooling is present.

Read references/generated-files.md before editing scripts/config/docs, and references/wrapper-host.md before changing the host or PowerShell lifecycle.

4. Verify

On macOS, only claim buildable evidence: .NET publish when available, PowerShell lint when available, manifest/config parse, and placeholder icon round-trip in Windows CI. Everything involving a real window, Taskbar identity, tray Quit, Start Menu icon cache, SmartScreen, DPI, or Job Object tree reaping stays deferred with the maintainer phrase.

Read references/verification.md before reporting results.

5. Report

Use references/report-template.md inline and in docs\desktop-launcher.app-it-report.md. Keep beta wording visible, separate build/lint evidence from runtime unknowns, and append decision history.

Stage files only when the local convention or user request asks for it. Do not commit unless asked.

Quick Defaults

  • Install destination: %APPDATA%\Microsoft\Windows\Start Menu\Programs\app-it\.
  • Runtime state: %LOCALAPPDATA%\app-it\<slug>\.
  • Bundle ID/key prefix: com.user.<slug>.
  • Default strategy: W-Native when .NET 8 can build and WebView2 is expected.
  • Fallback: W-Edge only when host prerequisites are unavailable.
  • Icon sizes: 16, 32, 48, 64, 128, 256.
  • First-run signing stance: unsigned; SmartScreen click-through documented.

Stop Signs

Stop and mark deferred or blocked when only Windows hardware can decide, when the required build toolchain is missing and no fallback fits, when a port cannot be made env-driven, when a template needed for the selected strategy is absent, or when the requested claim would imply real Windows runtime verification that has not happened.

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

Files

SKILL.md and 26 other files (references) in plugins/app-it-windows/skills/app-it-windows of Christian-Katzmann/app-it.

  • SKILL.md
  • references/generated-files.md
  • references/inspection-and-strategies.md
  • references/maintainer-contract.md
  • references/report-template.md
  • references/verification.md
  • references/wrapper-host.md
  • templates/PSScriptAnalyzerSettings.psd1
  • templates/app-it.config.example.json
  • templates/desktop-build.ps1
  • templates/desktop-icons.ps1
  • templates/desktop-install.ps1
  • templates/desktop-quit.ps1
  • templates/inspect.ps1
  • templates/placeholder-icon-gen.ps1
  • templates/run-template-edge.ps1
  • templates/run-template.ps1
  • templates/wrapper-windows/.gitignore
  • … and 9 more

Open the folder on GitHubat commit 9ad064e

Compare with similar skills

App It Windows 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.

App It Windows compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
App It Windows this skillChristian-Katzmann/app-it216—~1.5kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80511 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca89k1 repos~584Automated safety check: PassApache-2.0

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    805 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    89k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from Christian-Katzmann/app-it

  • App It

    Christian-Katzmann/app-it

    Turn a local project or a hosted web app (including a published Claude Artifact URL) into a macOS Dock-launchable .app.

    216 GitHub stars~2.4k tokensUpdated 9 days ago
    Auto-check passed
  • App It Static

    Christian-Katzmann/app-it

    Turn a finished or buildable web app into a macOS Dock-launchable .app that serves built output instead of a dev server.

    216 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed

Works with

Questions about App It Windows

What does App It Windows do?

Create Windows beta desktop launchers for local web projects: WPF + WebView2 .exe, Start Menu shortcut, .ico, warm server, quit cleanup. App It Windows is an agent skill from Christian-Katzmann/app-it.ico, warm server, quit cleanup.

When should I use App It Windows?

App It Windows fits situations like: the user asks for app-it-windows; start Menu shortcut; windows package.

How do I install App It Windows in Claude Code?

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

How do I install App It Windows in Codex?

Run `npx skills add Christian-Katzmann/app-it --skill app-it-windows -a codex`. Or copy the skill folder (plugins/app-it-windows/skills/app-it-windows in Christian-Katzmann/app-it) into .agents/skills/app-it-windows in your project. Codex loads it when a task matches its description.

Can I use App It Windows 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 Christian-Katzmann/app-it --skill app-it-windows -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/app-it-windows, .gemini/skills/app-it-windows, .github/skills/app-it-windows and .opencode/skills/app-it-windows in your project.

What does App It Windows need to run?

Going by SKILL.md and its folder, App It Windows needs PowerShell for the scripts in its folder and the command-line tools its instructions call (pwsh). Our summary lists: PowerShell.

Does App It Windows 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 App It Windows 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 App It Windows use?

App It Windows 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 App It Windows use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to App It Windows?

Skills that share tags, products or a category with App It Windows: Site Architecture (AvdLee/RocketSimApp, 805 stars), Engine Whats New (flutter/flutter, 179k stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains App It Windows?

Christian-Katzmann (a GitHub user) maintains it in Christian-Katzmann/app-it, which has 216 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 30, 2026.

Source: Christian-Katzmann/app-it on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.