Find agent skills by outcome

- PowerShell helper path handles timeout

exit code

- For retryable failures

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

- Favor small

named functions over large monolithic handlers.

- Distinguish states clearly: idle

- Use CSS variables for tokens: color

spacing

- Build a clear hierarchy: header

control strip

- When path-dependent behavior exists

display active working directory in UI/help text.

- For mutating commands (kill process

delete file

- In `parseJson` mode

ensure script returns exactly one JSON payload.

- If stdout is empty

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

- 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

- `runPs(script

parseJson = false

- `setStatus(message

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

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

{ script

- Quick edits: palette

refresh cadence

- `pick(obj

camelKey

- Brief bullets: commands

safety decisions

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

`title`

Coding & Debugging

- One fenced `html` code block containing the full

self-contained single file.

- If the user asks for a specific language

follow that explicit instruction.

- If external URLs are used (for example fonts/icons)

include graceful fallbacks so the widget still functions as one deliverable HTML file.

- Default rule: if the user does not explicitly specify language

generate visible widget text in the same language as the user's prompt.