skills: Instructions file for Claude Code

CLAUDE.md

Instructions for developing and maintaining skills in this repository.

Repository Structure

skills/migration/
  migrate-page/SKILL.md      Cone-only: orchestrates full page migration
  migrate-block/SKILL.md     Scoop: migrates a single block with visual verification
  migrate-header/SKILL.md    Scoop: migrates header/nav with EDS header block pattern
  dismiss-overlays/SKILL.md  Reference: overlay dismissal patterns
docs/specs/                  Design docs and implementation plans

Skills live under a top-level skills/ directory (Anthropic skills convention), with migration/ as a category subdir. Install commands target --path skills/migration. Slicc's upskill flattens the inner skill folders into /workspace/skills/<name>/ at runtime — so internal references like /workspace/skills/migrate-page/scripts/... are unaffected by the source layout.

Slicc Browser Automation Conventions

Skills run inside Slicc and use playwright-cli for browser automation.

Stateless Tab Targeting (since slicc PR #188)

Every playwright-cli command that operates on a tab requires explicit --tab <targetId>. There is no implicit "current tab".

Capture targetId from output:

# tab-new returns a targetId
playwright-cli tab-new https://example.com
# Output: "Created tab <targetId> at https://example.com"
# Capture <targetId> as {sourceTabId}

# open also returns a targetId (and does NOT broadcast/steal focus)
open /shared/my-site/drafts/hero-preview.html
# Output: "... (targetId: <targetId>)"
# Capture <targetId> as {previewTabId}

Use --tab on every command:

playwright-cli eval --tab={sourceTabId} "document.title"
playwright-cli screenshot --tab={previewTabId} --max-width=1440 --filename=out.png
playwright-cli snapshot --tab={previewTabId}
playwright-cli goto --tab={previewTabId} {url}
playwright-cli tab-close --tab={sourceTabId}

Commands without --tab: tab-list (lists all tabs), tab-new (creates a tab).