Agent skill

Button Check

by MigoXLab in MigoXLab/webqa-agent

Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors.

Apache-2.0Auto-check passedTesting & QA

Install Button Check

skills CLI
$ npx skills add MigoXLab/webqa-agent --skill button-check -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MigoXLab/webqa-agent button-check --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MigoXLab/webqa-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/webqa_agent/executor/flash/skills/button-check .claude/skills/button-check && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
button-check
GitHub stars
232
Token cost
~2.2k tokens
SKILL.md length
1,062 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors.

  • Works in 4 steps: Collect Interactive Elements → Baseline → Test Each Element → …
  • Testing & QA work in your project
  • SKILL.md covers When to Use, Phase 1: Collect Interactive…, Phase 2: Baseline and Phase 3: Test Each Element, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Button Check is an agent skill from MigoXLab/webqa-agent. Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors. Always return to the baseline page before testing the next element.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. The repository describes itself as: Autonomous web browser agent that audits performance, functionality & UX for engineers and vibe-coding creators. 网站自主评估测试 Agent,支持 GUI/CLI 一键完成性能、功能使用与交互体验的测试评估. The licence is Apache-2.0.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/button-check”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Collect Interactive Elements
  2. Baseline
  3. Test Each Element
  4. Report Findings

What it can do on your machine

Read from SKILL.md and the folder at commit aa156d4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Button Check loads about 2.2k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 1,062 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MigoXLab/webqa-agent at commit aa156d4, republished under its Apache-2.0 licence (© MigoXLab). 1,062 words, ~2,158 tokens.

Download SKILL.mdSave it as .claude/skills/button-check/SKILL.md (or your agent's skills folder).
name
button-check
description
Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors. Always return to the baseline page before testing the next element.
when_to_use
When the task requires comprehensive UI regression testing or validating all clickable/input elements work correctly.

Button Check Skill

Systematically test every interactive element on the page:

  • Clickables (button / link / tab / checkbox / radio / switch / menuitem) — click and verify
  • Inputs (textbox / searchbox / combobox / slider) — fill with sample data and verify

After each test, return to the baseline page so the next element is tested from the same starting state.

Important: Before each tool call, output a short one-line description of what you are about to do (e.g. "Filling the search box with 'hello'"). This helps generate readable step-by-step reports.

When to Use

  • Task mentions "遍历所有按钮/链接/输入", "comprehensive UI testing", or "regression testing"
  • You need to verify no broken links / dead buttons / unresponsive inputs exist
  • Smoke testing a page before a release

Skip for single-element tests — use click or fill directly instead.

Phase 1: Collect Interactive Elements

Call take_snapshot to get the accessibility tree. Group elements into two buckets by role:

Clickable bucket — driven by click:

  • button, link, tab
  • checkbox, radio, switch
  • menuitem

Input bucket — driven by fill (or type_text / press_key for keyboard-only widgets):

  • textbox, searchbox
  • combobox (treat as click-to-open if no editable affordance is visible, then fill if a textbox appears)
  • slider (fill with a numeric mid-range value)

Each element has a uid (e.g. uid=1_5), a role, and a label. Record {uid, role, label, bucket} for every element.

Cap at 50 elements total. If more exist, prioritize:

  1. Inputs (form fields) — these often gate downstream behavior
  2. button and link (core interactive)
  3. tab, menuitem (navigation)
  4. Other ARIA roles

Snapshot misses some elements? Icon-only buttons without ARIA attributes are invisible to take_snapshot. Mention in the report instead of erroring.

Phase 2: Baseline

Record the baseline state before testing:

  • Call take_screenshot with fullPage: true to capture the entire page
  • Note the current URL — this is the baseline URL you MUST return to after every test that navigates away

Phase 3: Test Each Element

CRITICAL RULE: One element per turn. Do NOT batch multiple click / fill calls in a single turn. Each element must follow the full cycle below before moving to the next. Batching loses the ability to attribute errors to specific elements.

For each element in the list:

3a. Drive the Element (one element per turn)

Pick the action by bucket:

Clickable bucket — call exactly these together in one turn:

  1. click with includeSnapshot: true — clicks the element and returns the post-click snapshot
  2. take_screenshot with fullPage: true
json
// Tool 1: click
{ "uid": "<element_uid>", "includeSnapshot": true }
// Tool 2: take_screenshot (same turn)
{ "fullPage": true }

Input bucket — call exactly these together in one turn:

  1. fill with a representative sample value (see below)
  2. take_screenshot with fullPage: true
json
// Tool 1: fill
{ "uid": "<element_uid>", "value": "<sample>" }
// Tool 2: take_screenshot (same turn)
{ "fullPage": true }

Pick the <sample> value by label / placeholder / role context:

  • Generic textbox / searchbox → 测试输入 (or any short Chinese/English string that obviously isn't real data)
  • Email-looking field (label/placeholder contains "邮箱" / "email" / "@") → test@example.com
  • Number-looking field (label contains "金额" / "数量" / "phone" / slider) → 123
  • Password field (type=password or label "密码" / "password") → Test1234!
  • combobox with no visible textbox → use click first to open the popup, then in the next turn click an option uid

For widgets that don't accept fill (custom rich editors, contenteditable blocks, sliders with no value attr), fall back to type_text after focusing via click.

The fullPage: true parameter is required — default viewport-only screenshots miss changes below the fold (form validation errors, expanded sections, content loaded at the bottom).

3b. Verify (same turn as 3a, or next turn)

Check for errors using:

  • list_console_messages — new JS errors since last check
  • list_network_requests — failed requests (4xx/5xx)

These are read-only and can be batched with the screenshot in 3a.

3c. Evaluate Result

Pass criteria: No new JS errors, no failed network requests, the page responds as expected:

  • For clicks: new page / modal opens / tab switched / state toggled
  • For fills: input value visible in snapshot, no validation error toast appears unexpectedly

Fail criteria: JS error appears, network request returns 4xx/5xx, page crashes, validation message says the input is invalid for a sample that should be accepted.

Show full SKILL.md (430 more words)Show less
3d. ⚠️ Return to Baseline (MANDATORY before testing the next element)

After every element test, compare the current URL to the baseline URL recorded in Phase 2.

If the URL changed (clicked a link, form submission redirected, etc.), restore the baseline before continuing — otherwise subsequent uids belong to a different page and you'll click the wrong things:

  1. Try browser back first — navigate_page with type: "back". This preserves session state and the back-stack.
  2. Verify by checking the snapshot's URL or calling take_snapshot. If still not on the baseline URL, go to step 3.
  3. Force navigate — navigate_page with url: "<baseline_url>". This is the fallback for SPAs that swallow the back action.
  4. Refresh uids — call take_snapshot after returning. The element ids from the original snapshot are now stale; you need fresh ones to keep iterating.

If the URL did NOT change (in-page modal opened, input filled, tab switched, etc.):

  • For modals / popovers — close them via press_key with key: "Escape" or click the dismiss button
  • For inputs — clear the value with fill setting value: "" so the next test starts from a clean field
  • Then proceed to the next element WITHOUT re-running take_snapshot (uids are still valid)

If you can't return after 2 attempts, stop testing the rest of the list and record:

⚠️ Lost baseline at element <uid> "<label>"; remaining N elements skipped because navigation could not be restored.

Then jump to Phase 4.

Phase 4: Report Findings

After all elements are tested (or the lost-baseline abort triggered), compile results:

遍历测试完成:共检测 N 个交互元素 (M 个点击 / K 个输入),X 个正常,Y 个发现问题,Z 个跳过。

发现的问题:
● 网络请求失败 (2 个):
  - Button "提交" (uid=1_12) — POST /api/submit 返回 500
  - Link "下载报告" (uid=1_25) — GET /report.pdf 返回 404
● JS 控制台报错 (1 个):
  - Button "删除" (uid=1_8) — TypeError: cannot read property 'id' of undefined
● 输入校验异常 (1 个):
  - Textbox "邮箱" (uid=1_30) — 接受非邮箱字符串而未提示
● 跳过 (1 个):
  - Combobox "城市" (uid=1_15) — 弹层未出现,无可选项

Include a final take_screenshot with fullPage: true in your closing message.

Set overall status:

  • failed if any element caused JS errors / 4xx-5xx / lost-baseline abort
  • warning if elements were skipped (not visible, popup didn't open, lost baseline mid-run)
  • passed if all elements tested without issues

Tips

  • One action per turn: Never batch two clicks, two fills, or a click+fill. Each element needs its own action → screenshot → verify cycle.
  • Always fullPage screenshots: take_screenshot(fullPage: true) after every action — viewport-only screenshots miss off-screen changes.
  • Batch read-only tools: list_console_messages + list_network_requests + take_screenshot can run in the same turn.
  • Refresh snapshot only after navigation: If the URL didn't change, the original uids are still valid — skip the extra take_snapshot to save tokens.
  • Skip hidden elements: If an element's uid disappears from the post-navigation snapshot, mark as skipped and move on.
  • Don't retest: Each element is tested once. Don't loop back on failures — record and continue.
  • External links: For <a href> pointing to external domains, verify the href value from the snapshot rather than navigating away.
  • File uploads: If you encounter a file-upload control during traversal, skip it — file upload is out of scope for this skill (use cdp_upload_file directly if a separate task requires it).

© MigoXLab, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in webqa_agent/executor/flash/skills/button-check of MigoXLab/webqa-agent.

Open the folder on GitHubat commit aa156d4

Compare with similar skills

Button Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Button Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Button Check this skillMigoXLab/webqa-agent232—~2.2kAutomated safety check: PassApache-2.0
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k31 repos~2.1kAutomated safety check: PassApache-2.0
TDDfossasia/eventyay-interpretation1.6k28 repos~1.1kAutomated safety check: PassApache-2.0
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 31 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    fossasia/eventyay-interpretation

    Test-driven development. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 28 repos~1.1k tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    380 GitHub starsUsed in 8 repos~2.9k tokens
    Testing & QAAuto-check passed

More from MigoXLab/webqa-agent

  • UI Audit

    MigoXLab/webqa-agent

    UI audit for hierarchy, accessibility, and UX. An agent skill from MigoXLab/webqa-agent.

    232 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Nuclei Scan

    MigoXLab/webqa-agent

    Run a Nuclei security scan against the target URL and report findings by severity.

    232 GitHub stars~846 tokensUpdated 3 mo ago
    Auto-check passed
  • Plan

    MigoXLab/webqa-agent

    Decompose a task into steps with completion checkpoints. An agent skill from MigoXLab/webqa-agent.

    232 GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed
  • Recovery

    MigoXLab/webqa-agent

    Structured error recovery for failed or ineffective browser actions.

    232 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Webqa

    MigoXLab/webqa-agent

    Use WebQA to test websites, web pages, URLs, login flows, search flows, forms, navigation, and core user journeys with an AI browser QA agent.

    232 GitHub stars~394 tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Button Check

What does Button Check do?

Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors. Button Check is an agent skill from MigoXLab/webqa-agent. Traverse all interactive elements on the page — click clickables, fill inputs — and verify no errors.

When should I use Button Check?

Button Check fits situations like: testing & QA work in your project.

How do I install Button Check in Claude Code?

Run `npx skills add MigoXLab/webqa-agent --skill button-check -a claude-code`. Or copy the skill folder (webqa_agent/executor/flash/skills/button-check in MigoXLab/webqa-agent) into .claude/skills/button-check in your project. Claude Code loads it when a task matches its description.

How do I install Button Check in Codex?

Run `npx skills add MigoXLab/webqa-agent --skill button-check -a codex`. Or copy the skill folder (webqa_agent/executor/flash/skills/button-check in MigoXLab/webqa-agent) into .agents/skills/button-check in your project. Codex loads it when a task matches its description.

Can I use Button Check in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MigoXLab/webqa-agent --skill button-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/button-check, .gemini/skills/button-check, .github/skills/button-check and .opencode/skills/button-check in your project.

What does Button Check need to run?

SKILL.md names no scripts, command-line tools or credentials: Button Check is instructions for the agent only.

Does Button Check access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Button Check safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Button Check use?

Button Check is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Button Check use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Button Check?

Skills that share tags, products or a category with Button Check: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (fossasia/eventyay-interpretation, 1.6k stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Button Check?

MigoXLab (a GitHub organization) maintains it in MigoXLab/webqa-agent, which has 232 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on July 2, 2026.

Source: MigoXLab/webqa-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.