К основному содержанию
скилл CX Codex

write-script-powershell — скилл Claude Code: обзор и установка

Скилл write-script-powershell для Claude Code задаёт правила создания PowerShell-скриптов в Windmill: локального тестирования, обновления метаданных и безопасного деплоя.

Apache-2.0 1 установок ★ 18 673 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add windmill-labs/windmill --skill write-script-powershell -a claude-code
Открыть на GitHub

Что делает write-script-powershell

Скилл задаёт агенту правила работы с PowerShell в проектах Windmill. Главный принцип — разграничение локального тестирования и релиза на сервер. При проверке локальных правок агент запускает wmill script preview, а не отправляет код в рабочее пространство через деплой, чтобы случайная ошибка не сломала рабочую среду.

Внутри описаны правила синхронизации метаданных. Любое изменение аргументов в блоке param(...) или добавление импортов инвалидирует хеши в wmill-lock.yaml. Скилл требует вызывать wmill generate-metadata для обновления .script.yaml и файлов блокировок, предупреждая пользователя об автоматическом обновлении незафиксированных версий зависимостей.

Конфигурация и учётные данные передаются строго через типизированные ресурсы платформы, а не через переменные окружения. Прямой запуск через wmill script run разрешён только для версий, которые уже развёрнуты на сервере.

Какие задачи решает

  • Написать PowerShell-скрипт с параметрами param(...) для Windmill
  • Протестировать локальный скрипт через wmill script preview без деплоя
  • Обновить схему ввода .script.yaml и хеши с помощью wmill generate-metadata
  • Настроить передачу секретов через типизированные ресурсы платформы

Примеры запросов агенту

  • Напиши PowerShell-скрипт для Windmill с входными параметрами и покажи команду предпросмотра
  • Обнови метаданные и схемы после изменения блока параметров в скрипте
  • Проверь локальные изменения в скрипте через wmill script preview с тестовыми аргументами

Как установить write-script-powershell

1Через Skills CLI (Vercel)

npx skills add windmill-labs/windmill --skill write-script-powershell -a claude-code

2Вручную: положить файлы

~/.claude/skills/write-script-powershell/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/write-script-powershell/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о write-script-powershell

Как установить write-script-powershell в Claude Code?

Выполните команду npx skills add windmill-labs/windmill --skill write-script-powershell -a claude-code.

Что делает скилл write-script-powershell?

Он направляет модель при написании скриптов PowerShell для Windmill, регулирует вызовы CLI и исключает случайный деплой непроверенного кода.

В чём разница между preview и run в Windmill?

Команда wmill script preview запускает локальный файл на диске без развёртывания, тогда как wmill script run выполняет скрипт, уже опубликованный на сервере.

Исходный текст

SKILL.md · Apache-2.0
---
name: write-script-powershell
description: MUST use when writing PowerShell scripts.
---

## CLI Commands

Place scripts in a folder.

After writing, tell the user which command fits what they want to do:

- `wmill script preview <script_path>` — **default when iterating on a local script.** Runs the local file without deploying.
- `wmill script run <path>` — runs the script **already deployed** in the workspace. Use only when the user explicitly wants to test the deployed version, not local edits.
- `wmill generate-metadata` — regenerate the local `.script.yaml` (input schema) and `.lock` (resolved dependencies) for scripts you changed, and refresh their content hashes in `wmill-lock.yaml`. Local files only — **not** a deploy. See "Keep metadata in sync" below.
- Deploy local changes to the workspace — via `git push` or `wmill sync push` depending on how the repo is wired (see the **Deploying** section in `AGENTS.wmill.md`). Only suggest/run a deploy when the user explicitly asks to deploy/publish/push — not when they say "run", "try", or "test".

### Preview vs run — choose by intent, not habit

If the user says "run the script", "try it", "test it", "does it work" while there are **local edits to the script file**, use `script preview`. Do NOT push the script to then `script run` it — pushing is a deploy, and deploying just to test overwrites the workspace version with untested changes.

Only use `script run` when:
- The user explicitly says "run the deployed version" / "run what's on the server".
- There is no local script being edited (you're just invoking an existing script).

Only use `sync push` when:
- The user explicitly asks to deploy, publish, push, or ship.
- The preview has already validated the change and the user wants it in the workspace.

### Keep metadata in sync after editing

`wmill-lock.yaml` tracks a content hash for each item. Editing a script's content — most importantly **adding or removing an import** or **changing `main`'s arguments** — invalidates that hash and leaves the `.lock`, the `.script.yaml` input schema, and the hash row out of date. Run `wmill generate-metadata` (scoped to what you touched) after such edits so the resolved lock, the auto-generated args UI (driven by `.script.yaml`), and `wmill-lock.yaml` all match the code. Leaving them stale produces spurious diffs in git-sync and CI.

This only writes local files (it is **not** a deploy), but it re-resolves dependencies, so it can bump unpinned versions (the same as deploying from the UI; expected, not a bug). So by default offer it and run it once the user agrees, rather than running it silently after every edit — unless the project's `AGENTS.md` opts into running metadata automatically (see the "Keeping metadata in sync" preference there). Either way YOU run the command, not the user. After running it, diff the regenerated `.lock` / `.script.lock` files and tell the user which dependency versions changed (e.g. `requests 2.31.0 → 2.32.0`), so they can catch an unwanted bump before deploying — even under `Metadata: auto`, since it's information, not a confirmation gate. Pin versions in code to keep them fixed.

With no path argument, `generate-metadata` regenerates only the items whose content hash drifted — not everything. Imports propagate: editing a script that others import marks every importer stale too, so a one-line change to a shared module can regenerate many locks (by design — their locks must reflect the imported code). If it touches more than you expect, run `wmill generate-metadata --dry-run` — it lists each stale item with a reason (`content changed` or `depends on <path>`) without changing anything — then narrow with a path argument (`wmill generate-metadata f/foo`) or `--strict-folder-boundaries`.

If the on-disk `.lock` and `.script.yaml` are already correct and only `wmill-lock.yaml` needs its hashes refreshed (hash drift, or bootstrapping missing entries), use `wmill generate-metadata rehash` — it re-records hashes from disk with no backend round-trip and no dependency changes.

### After writing — offer to test, don't wait passively

If the user hasn't already told you to run/test/preview the script, offer it as a one-sentence next step (e.g. "Want me to run `wmill script preview` with sample args?"). Do not present a multi-option menu.

If the user already asked to test/run/try the script in their original request, skip the offer and just execute `wmill script preview <path> -d '<args>'` directly — pick plausible args from the script's declared parameters. The shape varies by language: `main(...)` for code languages, the SQL dialect's own placeholder syntax (`$1` for PostgreSQL, `?` for MySQL/Snowflake, `@P1` for MSSQL, `@name` for BigQuery, etc.), positional `$1`, `$2`, … for Bash, `param(...)` for PowerShell.

`wmill script preview` does not deploy, but it still executes script code and may cause side effects; run it yourself when the user asked to test/preview (or after confirming that execution is intended). `wmill generate-metadata` does not deploy either — it only writes local files (locks, schemas, hashes) — but offer it before running (or run automatically if the project's `AGENTS.md` opts in), per "Keep metadata in sync" above. Deploying to the workspace (`git push` or `wmill sync push` depending on how the repo is wired — see the **Deploying** section) is the only step that mutates remote state — do it only when the user explicitly asks to deploy/publish/push.

For a **visual** open-the-script-in-the-dev-page preview (rather than `script preview`'s run-and-print-result), use the `preview` skill.

Use `wmill resource-type list --schema` to discover available resource types.

# Windmill Script Writing Guide

## General Principles

- A script's inputs are its parameters. Credentials and configuration come in as resource-typed parameters, never hard-coded or read from the environment; the language section below shows how that language declares parameters
- When no resource type exists for a service, still take its connection as one resource-typed parameter, of a custom type holding the connection fields (base URL, account identifiers, credentials), its secret in a variable the resource references. A custom type is named `c_<name>`, which keeps it apart from a hub type synced later: the parameter takes `RT.C<Name>` in TypeScript, a `c_<name>` TypedDict in Python. A plain string parameter or a variable read inside the code only when the user asks for it: the resource keeps a connection's fields together, lets whoever runs the script pick an existing connection, and keeps the secret out of the arguments a run records. If the instance is reported as not having synced the Windmill Hub's resource types, mention that a superadmin can sync them, since the hub has types for most services. Otherwise, or when the user prefers it to syncing, propose the resource type and ask before creating it
- A Windmill Hub script takes a resource type the hub publishes, so on an instance that has not synced the hub's types that type is missing: say so, and that a superadmin can sync them, before asking for a resource of it. Hub scripts often declare the type inline (`type Stripe = { token: string }`), which is still the `stripe` resource type; in code you write, name it the way the language section shows (`RT.Stripe` in TypeScript) rather than copying the inline declaration
- Before relying on a resource type, a hub script's included, run `wmill resource-type list`: it shows whether the workspace has the type, and warns when the instance has not synced the hub's types
- Libraries are installed automatically - do not show installation instructions
- In a language with an entrypoint function (TypeScript, Python, Go, Rust, PHP, R, …), name it `main` (`Main` in C#) and do not call it; in TypeScript it must be async. SQL, GraphQL, Bash, PowerShell and Ansible scripts have no `main`: their language section shows how they take arguments
- Where the language has a Windmill client (`wmill`), use it to interact with the platform
- A script's input schema may carry a top-level `prompt_for_ai` string: its author's instructions to an AI choosing the inputs. Follow it when you pick arguments to run that script, and keep it when you rewrite the schema

## Return Values

- A script can return any JSON-serializable value; a SQL script returns the rows its query produces
- Return values become available to subsequent flow steps via `results.step_id`

## Preprocessor Scripts

Preprocessor scripts process raw trigger data from various sources (webhook, custom HTTP route, SQS, WebSocket, Kafka, NATS, MQTT, AMQP, Postgres, GCP Pub/Sub, Azure, or email) before passing it to the flow. This separates the trigger logic from the flow logic and keeps the auto-generated UI clean.

A preprocessor is written in TypeScript or Python: its function is named `preprocessor` instead of `main`, and it receives a single parameter called `event` (the language section gives its type).

The returned object determines the parameter values passed to the flow.
e.g., `{ b: 1, a: 2 }` calls the flow with `a = 2` and `b = 1`, assuming the flow has two inputs called `a` and `b`.

# PowerShell

## Structure

Arguments are obtained by calling the `param` function on the first line:

```powershell
param($Name, $Count = 0, [int]$Age)

# Your code here
Write-Output "Processing $Name, count: $Count, age: $Age"

# Return object
@{
    name = $Name
    count = $Count
    age = $Age
}
```

## Parameter Types

You can specify types for parameters:

```powershell
param(
    [string]$Name,
    [int]$Count = 0,
    [bool]$Enabled = $true,
    [array]$Items
)

@{
    name = $Name
    count = $Count
    enabled = $Enabled
    items = $Items
}
```

## Return Values

Return values by outputting them at the end of the script:

```powershell
param($Input)

$result = @{
    processed = $true
    data = $Input
    timestamp = Get-Date -Format "o"
}

$result
```

© windmill-labs · Apache-2.0 · windmill-labs/windmill

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
powershell-windows davila7 Скилл powershell-windows определяет правила надёжных скриптов PowerShell под Windows: обязательные скобки для командлетов, отказ от Unicode и глубину JSON. Спасает от типичных синтаксических ошибок. CX Codex +1 169установок powershell-7-expert VoltAgent Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-module-architect VoltAgent Community Субагент powershell-module-architect для Claude Code проектирует и перерабатывает модули PowerShell. Он подключается к задачам по профилям, упаковке кода и совместимости между версиями. CX Codex 183установок analyzing-powershell-script-block-logging mahipal Скилл analyzing-powershell-script-block-logging разбирает журналы PowerShell Script Block Logging из EVTX и находит обфусцированные команды, Base64-полезные нагрузки и попытки обхода AMSI. CX Codex +1 313установок script-generator transilienceai Скилл script-generator генерирует готовые скрипты на Python, Bash и PowerShell с проверкой синтаксиса и защитой от зависания. Сам код агент никогда не запускает. CX Codex +1 176установок bash-script-generator akin-ozer Скилл bash-script-generator для Claude Code создаёт Bash- и shell-скрипты, автоматизацию и CLI-утилиты. Он подключается к задачам по написанию скрипта или переносу ручных команд в автоматизацию. CX Codex +1 742установок

Из того же набора8

Windmill Запускает скрипты, потоки и управляет расписаниями в платформе Windmill. CX Codex +1 ★ 18 673звёзд репо write-script-mssql Скилл write-script-mssql для Claude Code включается при написании запросов для MS SQL Server. Он задаёт агенту инструкции для этой задачи. CX Codex +1 ★ 18 673звёзд репо write-script-bun Скилл write-script-bun для агента: пишет TypeScript-скрипты Windmill на Bun и держит под рукой нужную команду wmill — preview, run или деплой. CX Codex +1 ★ 18 673звёзд репо write-script-deno Скилл write-script-deno помогает писать скрипты на TypeScript для среды Deno в Windmill и безопасно тестировать их через wmill script preview без случайных деплоев. CX Codex +1 ★ 18 673звёзд репо write-script-bunnative Скилл write-script-bunnative помогает писать скрипты Bun Native для Windmill и напоминает о маркере //native, нужном для запуска на native worker. CX Codex +1 ★ 18 673звёзд репо write-script-postgresql Скилл write-script-postgresql для Claude Code ведёт написание SQL-скриптов под PostgreSQL в Windmill и указывает команду для проверки файла или деплоя. CX Codex +1 ★ 18 673звёзд репо write-script-snowflake Скилл write-script-snowflake помогает писать SQL-скрипты Snowflake в Windmill, тестировать их локально через CLI и управлять ресурсными параметрами подключений. CX Codex +1 ★ 18 673звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой