From 8a2c3f26c4762edc7219421ae0bb67c0101eb56f Mon Sep 17 00:00:00 2001
From: OpenCode Test <test@opencode.ai>
Date: Thu, 1 Jan 2026 11:56:46 -0800
Subject: [PATCH] Add /help and /status commands
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- /help: Shows available commands and skills with descriptions
- /status: Quick dashboard overview across all domains
  - System health (disk, memory, updates)
  - Kubernetes status (nodes, pods, alerts)
  - Email summary (unread, urgent)
  - Calendar (today's events, next meeting)

Both commands added to component-registry.json with aliases:
- /help: /commands, /skills
- /status: /overview, /dashboard

Updated commands/README.md with new entries.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 commands/README.md            |  2 +
 commands/help.md              | 59 +++++++++++++++++++++++++++++
 commands/status.md            | 70 +++++++++++++++++++++++++++++++++++
 state/component-registry.json | 10 +++++
 4 files changed, 141 insertions(+)
 create mode 100644 commands/help.md
 create mode 100644 commands/status.md

diff --git a/commands/README.md b/commands/README.md
index 451ea5a..14e4ac5 100644
--- a/commands/README.md
+++ b/commands/README.md
@@ -9,6 +9,8 @@ Slash commands for quick actions. User-invoked (type `/command` to trigger).
 | Command | Aliases | Description |
 |---------|---------|-------------|
 | `/pa` | `/assistant`, `/ask` | Personal assistant entrypoint |
+| `/help` | `/commands`, `/skills` | Show available commands and skills |
+| `/status` | `/overview`, `/dashboard` | Quick status across all domains |
 | `/programmer` | | Code development tasks |
 | `/gcal` | `/calendar`, `/cal` | Google Calendar access |
 | `/usage` | `/stats` | View usage statistics |
diff --git a/commands/help.md b/commands/help.md
new file mode 100644
index 0000000..a167753
--- /dev/null
+++ b/commands/help.md
@@ -0,0 +1,59 @@
+---
+name: help
+description: Show available commands and skills
+aliases: [commands, skills]
+---
+
+# /help Command
+
+Show available commands and skills in this Claude Code configuration.
+
+## When Invoked
+
+Display a formatted list of available functionality:
+
+```
+📚 Claude Code Help
+
+═══ Commands ═══
+
+/pa <request>              Personal assistant (natural language)
+/gcal [today|tomorrow|week] Calendar agenda
+/usage [today|week|month]   Usage statistics
+
+/sysadmin:health           System health check
+/sysadmin:update           Package updates
+/sysadmin:autonomy         Set autonomy level
+
+/k8s:cluster-status        Kubernetes health
+/k8s:deploy                Deploy to cluster
+/k8s:diagnose              Troubleshoot issues
+
+/programmer                Code development
+
+═══ Skills (Auto-Invoked) ═══
+
+These activate automatically based on your request:
+
+• gmail      - "check my email", "urgent emails"
+• gcal       - "what's on today", "tomorrow's schedule"
+• k8s        - "cluster status", "pod health"
+• sysadmin   - "system health", "disk space"
+• usage      - "usage stats", "how many sessions"
+
+═══ Tips ═══
+
+• Use /pa for natural language requests
+• Skills trigger automatically - just ask!
+• Run /usage to see session statistics
+```
+
+## Implementation
+
+Read from `state/component-registry.json` and format:
+
+1. List commands with descriptions
+2. List skills with trigger examples
+3. Show tips for using the system
+
+Keep output concise - this should fit in one screen.
diff --git a/commands/status.md b/commands/status.md
new file mode 100644
index 0000000..36d6444
--- /dev/null
+++ b/commands/status.md
@@ -0,0 +1,70 @@
+---
+name: status
+description: Quick status overview across all domains
+aliases: [overview, dashboard]
+---
+
+# /status Command
+
+Show a quick status overview across all managed domains.
+
+## When Invoked
+
+Run quick checks and present a dashboard:
+
+```
+📊 Status Overview
+
+═══ System ═══
+💻 Workstation: Healthy
+   Disk: 45% used | Memory: 68% | Load: 0.5
+   Updates: 3 pending
+
+═══ Kubernetes ═══
+☸️  Cluster: Healthy
+   Nodes: 3/3 Ready | Pods: 42 Running
+   Alerts: 0 firing
+
+═══ Email ═══
+📧 Inbox: 12 unread (3 urgent)
+   Last checked: 2 mins ago
+
+═══ Calendar ═══
+📅 Today: 3 events
+   Next: Team standup in 45 mins
+```
+
+## Implementation
+
+Run these checks in parallel for speed:
+
+### System Check
+```bash
+~/.claude/skills/sysadmin-health/scripts/health-check.sh | head -20
+```
+
+### Kubernetes Check
+```bash
+~/.claude/skills/k8s-quick-status/scripts/quick-status.sh | head -10
+```
+
+### Email Check
+```bash
+~/.claude/skills/gmail/scripts/check_unread.py 1 10
+```
+
+### Calendar Check
+```bash
+~/.claude/skills/gcal/scripts/agenda.py today
+```
+
+## Output Format
+
+- Use emoji indicators for quick scanning
+- Keep each section to 2-3 lines
+- Highlight any issues in red/warning
+- Show "Last checked" for cached data
+
+## Autonomy
+
+Read-only - runs without confirmation.
diff --git a/state/component-registry.json b/state/component-registry.json
index f0a708f..e9c6b0a 100644
--- a/state/component-registry.json
+++ b/state/component-registry.json
@@ -129,6 +129,16 @@
       "description": "Diagnose Kubernetes issues",
       "aliases": [],
       "invokes": "agent:k8s-diagnostician"
+    },
+    "/help": {
+      "description": "Show available commands and skills",
+      "aliases": ["/commands", "/skills"],
+      "invokes": "command:help"
+    },
+    "/status": {
+      "description": "Quick status overview across all domains",
+      "aliases": ["/overview", "/dashboard"],
+      "invokes": "command:status"
     }
   },
   "agents": {