Worktree UX Pr

Quick Usage (Already Configured)

1) Sync repo and rebase worktrees

scripts/rebase-worktrees.sh ux-improvement-01 ux-improvement-02

Worktrees are expected under ./_worktrees at the enterprise root (override with WORKTREE_BASE).

2) Start UI + headless (optional)

scripts/start-ui.sh
scripts/start-headless.sh

3) Capture evidence

• Use Chrome MCP to open the UI and navigate to the changed surface.
• Take a screenshot and save to /tmp.

4) Upload screenshot and comment on PR

scripts/upload-catbox.sh /tmp/your-screenshot.jpg
scripts/comment-pr.sh 414 "Screenshot: https://files.catbox.moe/xyz.jpg"

What This Skill Does

• Ensures worktrees are rebased on origin/dev and force-pushed when history changes.
• Guides Chrome MCP verification and screenshot capture.
• Provides a simple upload + PR comment workflow for evidence.
• Infers behavior based on available config in .env and falls back to safe defaults.

Related skills

• For creating worktrees and regular commits, use skills/worktree-workflow/SKILL.md.
• For UI setup and verification, use skills/openwork-testability/SKILL.md and skills/openwork-chrome-mcp-testing/SKILL.md.

Scripts

• scripts/rebase-worktrees.sh: Rebase each worktree on origin/dev and force-push.
• scripts/start-ui.sh: Start the OpenWork UI dev server.
• scripts/start-headless.sh: Start headless OpenWork server (optional for remote behavior).
• scripts/upload-catbox.sh: Upload a screenshot and return a public URL.
• scripts/comment-pr.sh: Comment on a PR with a screenshot URL.

Common Gotchas

• If headless fails with a version mismatch, rebuild the server binary via: pnpm --filter openwork-server build:bin
• If Chrome MCP cannot create a session, ensure no conflicting dev servers are running.
• If GitHub comment fails, verify gh auth status and that the repo is correct.

First-Time Setup (If Not Configured)

1. Ensure dependencies are installed (pnpm install).
2. Confirm gh auth status is logged in for GitHub comments.
3. Optional: set overrides in .env.example and copy to .env.

Reference

Follow the official OpenCode skills docs: https://opencode.ai/docs/skills/