From 2544df1c4adaa47ea0bb83797877a85283b0e970 Mon Sep 17 00:00:00 2001 From: Zaki Manian Date: Sun, 22 Feb 2026 00:49:35 -0800 Subject: [PATCH] feat: add web UI test skill for Chrome extension (#302) * feat: add web UI test skill for Chrome extension testing Add a SKILL.md checklist for manually testing the IronClaw web gateway UI using the Claude for Chrome browser extension. Covers connection, chat, skills tab (search, install by search, install by URL, remove), and smoke tests for other tabs. Co-Authored-By: Claude Opus 4.6 * fix: use placeholder token and correct cleanup path per review - Replace hardcoded test123 token with placeholder - Fix cleanup path: ~/.ironclaw/installed_skills/ (not skills/) Co-Authored-By: Claude Opus 4.6 --------- Co-authored-by: Claude Opus 4.6 --- CLAUDE.md | 4 ++ skills/web-ui-test/SKILL.md | 106 ++++++++++++++++++++++++++++++++++++ 2 files changed, 110 insertions(+) create mode 100644 skills/web-ui-test/SKILL.md diff --git a/CLAUDE.md b/CLAUDE.md index b56cbd5b..11f2effc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -572,6 +572,10 @@ Four built-in tools for managing skills at runtime: - `/skills/` -- Per-workspace skills (trusted) - `~/.ironclaw/installed_skills/` -- Registry-installed skills (installed trust) +### Testing Skills + +- `skills/web-ui-test/` -- Manual test checklist for the web gateway UI via Claude for Chrome extension. Covers connection, chat, skills search/install/remove, and other tabs. + Skills configuration: see Configuration section above. ## Docker Sandbox diff --git a/skills/web-ui-test/SKILL.md b/skills/web-ui-test/SKILL.md new file mode 100644 index 00000000..4ebde0e5 --- /dev/null +++ b/skills/web-ui-test/SKILL.md @@ -0,0 +1,106 @@ +--- +name: web-ui-test +version: 0.1.0 +description: Test the IronClaw web UI using the Claude for Chrome browser extension. +activation: + keywords: + - test web ui + - test the ui + - browser test + - chrome test + - test skills tab + - test chat + - web gateway test + patterns: + - "test.*web.*ui" + - "test.*browser" + - "chrome.*extension.*test" +--- + +# Web UI Testing with Claude for Chrome + +Use this skill when manually testing the IronClaw web gateway UI via the Claude for Chrome browser extension. + +## Prerequisites + +- IronClaw must be running with `GATEWAY_ENABLED=true` +- Note the gateway URL (default: `http://127.0.0.1:3000/`) and auth token +- The Claude for Chrome extension must be installed and connected + +## Starting the Server + +```bash +CLI_ENABLED=false GATEWAY_AUTH_TOKEN= cargo run +``` + +Wait for "Agent ironclaw ready and listening" in the logs before proceeding. + +## Test Checklist + +### 1. Connection + +- Navigate to `http://127.0.0.1:3000/?token=` +- Verify "Connected" indicator in the top-right corner +- Verify all tabs are visible: Chat, Memory, Jobs, Routines, Extensions, Skills + +### 2. Chat Tab + +- Send a simple message (e.g., "Hello, what tools do you have?") +- Verify the LLM responds without errors +- If you see "Invalid schema for function" errors, the tool schema fix (PR #301) may not be merged yet + +### 3. Skills Tab + +- Click the Skills tab +- Verify "No skills installed" or a list of installed skills (no "Skills system not enabled" error) +- Search for "markdown" in the ClawHub search box +- Verify results appear with: name, version, description, relevance score, "updated X ago" +- Verify skill names are clickable links to clawhub.ai +- If search returns empty with a yellow warning banner, the registry may be unreachable + +### 4. Skill Install (from search) + +- Search for a skill (e.g., "markdown") +- Click "Install" on a result +- Confirm the install dialog +- Verify success toast appears +- Verify the skill appears in "Installed Skills" section + +### 5. Skill Install (by URL) + +- Scroll to "Install Skill by URL" +- Enter a skill name and a ClawHub download URL: + - Name: `markdown-viewer` + - URL: `https://wry-manatee-359.convex.site/api/v1/download?slug=markdown-viewer` +- Click Install +- Verify success toast and skill appears in installed list + +### 6. Skill Remove + +- Find an installed skill +- Click "Remove" +- Confirm removal +- Verify the skill disappears from the installed list + +### 7. Other Tabs (smoke test) + +- **Memory**: Should show the memory filesystem (may be empty) +- **Jobs**: Should show job list (may be empty) +- **Routines**: Should show routine list +- **Extensions**: Should show extension list with install options + +## Cleanup + +After testing, remove any test-installed skills: + +```bash +rm -rf ~/.ironclaw/installed_skills/ +``` + +Stop the server with Ctrl+C or by killing the process. + +## Known Issues + +- ClawHub registry at `clawhub.ai` is behind Vercel which blocks non-browser TLS fingerprints; the backend uses `wry-manatee-359.convex.site` directly +- Skill downloads are ZIP archives containing SKILL.md, not raw text +- The `confirm()` dialog for install may block browser automation; override with `window.confirm = () => true` in the console first