browser-automation

ether-moon 的头像作者 ether-moon

将模糊的生物体名称解析为精确的NCBI分类ID和科学名称,然后推荐适当的IWC(星际工作委员会)Galaxy工作流进行分析。当用户提供常用名称(如"疟原虫"、"大肠杆菌"、"小鼠")、缩写名称或需要将任何生物体引用转换为API查询的精确科学名称时,使用此技能。此技能通过对话处理消除歧义,通过NCBI分类API验证分类ID,提供ENA FASTQ搜索功能,并且总是推荐现有的IWC工作流,而不是生成自定义脚本或分析步骤。

📖 中文导读:将模糊的生物体名称解析为精确的NCBI分类ID和科学名称,然后推荐适当的IWC(星际工作委员会)Galaxy工作流进行分析。当用户提供常用名称(如"疟原虫"、"大肠杆菌"、"小鼠")、缩写名称或需要将任何生物体引用转换为API查询的精确科学名称时,使用此技能。此技能通过对话处理消除歧义,通过NCBI分类API验证分类ID,提供ENA FASTQ搜索功能,并且总是推荐现有的IWC工作流,而不是生成自定义脚本或分析步骤。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: browser-automation description: Automates browser interactions using Playwright CLI and templates - takes screenshots, generates PDFs, clicks elements, fills forms, monitors console/network. Use when testing web pages, automating browser tasks, or when user mentions screenshots, web testing, form automation, or Playwright

Browser Automation

Overview

Hybrid browser automation using Playwright CLI for simple tasks and templates for complex interactions. Provides efficient automation without MCP server overhead.

When to Use

Use this skill when you need to:

  • Take screenshots or generate PDFs
  • Test web pages or forms
  • Click elements or fill inputs
  • Monitor console logs or network requests
  • Automate browser interactions

Don't use when:

  • Simple HTTP requests suffice (use fetch/curl)
  • Need persistent browser sessions across conversations

Hybrid Approach

CLI-Native (Simple Tasks)

Use Playwright CLI directly for:

  • Screenshot: npx playwright screenshot <url> <filename>
  • PDF: npx playwright pdf <url> <filename>
  • Open browser: npx playwright open <url> (for manual inspection)

Templates (Complex Interactions)

Use templates (16 total) for tasks requiring state management, event handling, or multi-step logic:

User Interactions (6)

  • Click element with wait
  • Fill form field with validation
  • Hover over element
  • Drag and drop
  • Press keyboard key
  • Select dropdown option

Form Handling (2)

  • Fill multiple fields (bulk)
  • Upload file

Page Monitoring (3)

  • Capture accessibility snapshot
  • Get console messages (event listening)
  • Get network requests (event listening)

Advanced (5)

  • Evaluate JavaScript
  • Navigate back with wait
  • Resize browser window
  • Handle dialogs (alert/confirm/prompt)
  • Wait for element with timeout

Quick Start

First time setup:

npm install -g playwright
npx playwright install chromium

CLI Examples (Simple Tasks)

# Screenshot
npx playwright screenshot https://example.com ./tmp/playwright/screenshot.png

# PDF
npx playwright pdf https://example.com ./tmp/playwright/page.pdf

# Open browser for manual inspection
npx playwright open https://example.com

Template Examples (Complex Tasks)

# Click element (requires wait logic)
node $SKILL_DIR/templates/click.js https://example.com "button:has-text('Submit')"

# Fill form (multiple fields)
node $SKILL_DIR/templates/fill-form.js https://example.com '{"input[name=email]":"test@example.com"}'

# Monitor console (event listening)
node $SKILL_DIR/templates/console-messages.js https://example.com

Important Guidelines:

  • Prefer CLI first: Use npx playwright for screenshots, PDFs, and simple evaluation
  • Use templates when needed: Complex interactions, event listening, multi-step logic
  • $SKILL_DIR is automatically set to the skill's absolute path by Claude
  • Never use cd before running commands
  • Never write inline Playwright code with node -e or heredocs

Note: Output files are saved to ./tmp/playwright/ in the current project directory by default.

Documentation

  • Complete usage guide: See reference/TEMPLATES.md
  • Template reference: Each template includes usage instructions in file header