Find agent skills by outcome

- 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.

- Distinguish states clearly: idle

- Build a clear hierarchy: header

control strip

- When path-dependent behavior exists

display active working directory in UI/help text.

- Use CSS variables for tokens: color

spacing

- For mutating commands (kill process

delete file

- If stdout is empty

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

Creative

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

typography

Creative

- If truncation is reported

show partial output status and avoid false-success messaging.

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

command mode

- In parseJson mode

ensure script returns exactly one JSON payload.

- Validate and normalize user inputs (path

hostname

- `setStatus(message

tone) where tone supports at least: info`

- For user text interpolated into PowerShell single-quoted literals

always escape ' -> ''.

Data

- For structured data

return JSON with:

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

{ script

- `runPs(script

parseJson = false

- `pick(obj

camelKey

- Brief bullets: commands

safety decisions

Coding & Debugging

- One fenced html code block containing the full

self-contained single file.

- Quick edits: palette

refresh cadence

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

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

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

title

- If the user asks for a specific language

follow that explicit instruction.