Find agent skills by outcome

- PowerShell helper path handles timeout

exit code

- Favor small

named functions over large monolithic handlers.

- For retryable failures

include a clear recovery action in UI (for example Retry/Refresh) with proper disabled/loading transitions.

Creative

- Error states must be first-class UI states

not plain text dumps: use a dedicated error container/card/banner that is consistent with the current design system.

- Use CSS variables for tokens: color

spacing

- Build a clear hierarchy: header

control strip

- Distinguish states clearly: idle

- For mutating commands (kill process

delete file

Creative

- If truncation is reported

show partial output status and avoid false-success messaging.

- When path-dependent behavior exists

display active working directory in UI/help text.

Creative

- Every error must be rendered in-design: error UI must follow the widget's visual language (color tokens

typography

- If stdout is empty

return `{}` or `[]` consistently based on expected shape.

- In `parseJson` mode

ensure script returns exactly one JSON payload.

- Prefer allow-list style validation for sensitive parameters (e.g.

command mode

- For user text interpolated into PowerShell single-quoted literals

always escape `'` -> `''`.

- Validate and normalize user inputs (path

hostname

- `setStatus(message

tone)` where `tone` supports at least: `info`

- `runPs(script

parseJson = false

- `await window.HTWind.invoke(powershell.exec

{ script

- Quick edits: palette

refresh cadence

- `pick(obj

camelKey

Coding & Debugging

- One fenced `html` code block containing the full

self-contained single file.

- Keep accessibility semantics aligned with UI language (for example `aria-label`

`title`

- Brief bullets: commands

safety decisions