fix(skills): add help handler to standalone browser/desktop/system

Mirrors the outlook fix so every skill script behaves consistently.
Without this, `.\skills\browser\browser.ps1 help` (etc.) fell through to
the `default` switch case and threw "Unknown action: help" instead of
returning a proper help payload.

Each script now:

- Short-circuits `help`, `""`, and `list-actions` before touching CDP,
  Win32 APIs, or any other side-effect setup.
- Returns the parsed SKILL.md content plus the list of supported actions.
- Records $script:SkillDir once at parse time so the help branch can
  locate SKILL.md from inside the Invoke-*Action function.
- Lists `help` in the "Unknown action" error message for discoverability.

Author: aloth

skills/browser/browser.ps1

@@ -15,6 +15,7 @@ param(
 
 # ─── Standalone bootstrap ───
 $_standalone = (-not $Args_ -or $Args_.Count -eq 0) -and -not (Get-Variable -Name SkillsRoot -Scope Script -ErrorAction SilentlyContinue)
+$script:SkillDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 if ($_standalone) {
     . (Join-Path (Split-Path -Parent (Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path))) "lib\bootstrap.ps1")
     if ($Rest) { $Args_ = Parse-CliArgs -Arguments $Rest } else { $Args_ = @{} }
@@ -77,6 +78,17 @@ function Send-CDP {
 
 # ─── Main logic ───
 function Invoke-BrowserAction {
+    # Help / list-actions do NOT need a CDP connection.
+    if ($Action -eq "help" -or $Action -eq "" -or $Action -eq "list-actions") {
+        $skillMd = Join-Path $script:SkillDir "SKILL.md"
+        $help = if (Test-Path $skillMd) { [string](Get-Content $skillMd -Raw) } else { "" }
+        return @{
+            skill   = "browser"
+            help    = $help
+            actions = @("tabs", "navigate", "screenshot", "content", "html", "evaluate", "click", "type", "new-tab", "close-tab", "scroll", "fill", "wait", "help", "list-actions")
+        }
+    }
+
     switch ($Action) {
         "tabs" {
             $targets = Get-Targets
@@ -183,7 +195,7 @@ function Invoke-BrowserAction {
             return @{ waited = $seconds }
         }
         default {
-            throw "Unknown action: $Action. Use: tabs, navigate, screenshot, content, html, evaluate, click, type, new-tab, close-tab, scroll, fill, wait"
+            throw "Unknown action: $Action. Use: tabs, navigate, screenshot, content, html, evaluate, click, type, new-tab, close-tab, scroll, fill, wait, help"
         }
     }
 }

skills/desktop/desktop.ps1

@@ -15,6 +15,7 @@ param(
 
 # ─── Standalone bootstrap ───
 $_standalone = (-not $Args_ -or $Args_.Count -eq 0) -and -not (Get-Variable -Name SkillsRoot -Scope Script -ErrorAction SilentlyContinue)
+$script:SkillDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 if ($_standalone) {
     . (Join-Path (Split-Path -Parent (Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path))) "lib\bootstrap.ps1")
     if ($Rest) { $Args_ = Parse-CliArgs -Arguments $Rest } else { $Args_ = @{} }
@@ -74,6 +75,17 @@ function Find-Window {
 
 # ─── Main logic ───
 function Invoke-DesktopAction {
+    # Help / list-actions do NOT need any Win32 or graphics setup.
+    if ($Action -eq "help" -or $Action -eq "" -or $Action -eq "list-actions") {
+        $skillMd = Join-Path $script:SkillDir "SKILL.md"
+        $help = if (Test-Path $skillMd) { [string](Get-Content $skillMd -Raw) } else { "" }
+        return @{
+            skill   = "desktop"
+            help    = $help
+            actions = @("screenshot", "windows", "focus", "minimize", "maximize", "keys", "launch", "help", "list-actions")
+        }
+    }
+
     switch ($Action) {
         "screenshot" {
             $outFile = $Args_.'out-file'
@@ -172,7 +184,7 @@ function Invoke-DesktopAction {
             return @{ launched = $Args_.app }
         }
         default {
-            throw "Unknown action: $Action. Use: screenshot, windows, focus, minimize, maximize, keys, launch"
+            throw "Unknown action: $Action. Use: screenshot, windows, focus, minimize, maximize, keys, launch, help"
         }
     }
 }

skills/system/system.ps1

@@ -15,6 +15,7 @@ param(
 
 # ─── Standalone bootstrap ───
 $_standalone = (-not $Args_ -or $Args_.Count -eq 0) -and -not (Get-Variable -Name SkillsRoot -Scope Script -ErrorAction SilentlyContinue)
+$script:SkillDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 if ($_standalone) {
     . (Join-Path (Split-Path -Parent (Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path))) "lib\bootstrap.ps1")
     if ($Rest) { $Args_ = Parse-CliArgs -Arguments $Rest } else { $Args_ = @{} }
@@ -25,6 +26,17 @@ $defaultTimeout = if ($Config.default_timeout) { [int]$Config.default_timeout }
 
 # ─── Main logic ───
 function Invoke-SystemAction {
+    # Help / list-actions do NOT need any system probing.
+    if ($Action -eq "help" -or $Action -eq "" -or $Action -eq "list-actions") {
+        $skillMd = Join-Path $script:SkillDir "SKILL.md"
+        $help = if (Test-Path $skillMd) { [string](Get-Content $skillMd -Raw) } else { "" }
+        return @{
+            skill   = "system"
+            help    = $help
+            actions = @("exec", "info", "processes", "env", "help", "list-actions")
+        }
+    }
+
     switch ($Action) {
         "exec" {
             $command = $Args_.command
@@ -79,7 +91,7 @@ function Invoke-SystemAction {
             return @{ name = $name; value = $val }
         }
         default {
-            throw "Unknown action: $Action. Use: exec, info, processes, env"
+            throw "Unknown action: $Action. Use: exec, info, processes, env, help"
         }
     }
 }