CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gui-automation

Use when you need to visually interact with a GUI: test buttons, fill forms, verify visual layouts, fuzz web pages, automate user flows, take screenshots, or perform end-to-end QA on any application. Works on cloud VMs, Docker containers, local machines, and sandboxes. Needs the `cua` CLI (curl -fsSL https://cua.ai/install.sh | sh).

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent, execution-focused skill body: fully executable commands, a Look→Act→Verify loop with explicit re-verification guidance, and proper offloading of full CLI syntax to a one-level-deep reference file. The only weaknesses are mild redundancy (Providers table vs. Setup block; Quick Reference table vs. the reference file) and the reference link being placed only at the end.

Suggestions

Drop the Providers table (or the Setup connect block) — both list the same four `cua do switch` targets verbatim.

Move the `references/command-reference.md` link up near the Quick Reference section header (e.g., "Full argument syntax: see command-reference.md") instead of leaving it only as the last line of the file.

Trim the Quick Reference table to the commands not fully shown in the scenarios, leaving exhaustive argument syntax to the reference file.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no concept explanations Claude already knows — every section is a code block or table. Minor duplication keeps it off score 5: the Providers table repeats the four `cua do switch` variants already shown in Setup, and the Quick Reference table overlaps the separate command-reference.md. Not score 3: there is no unnecessary explanation or padding, only redundant structure.

4 / 5

Actionability

Every example is a copy-paste-ready shell command with concrete coordinates ("cua do click 450 280", "cua do type 'Jane Doe'") covering the common cases: clicking, form filling, file-upload dialogs, zoom for precision, drag-and-drop, and fuzzing. This matches the score-5 anchor (fully executable, covers common cases); not score 4: there are no gaps in executable detail.

5 / 5

Workflow Clarity

The core loop is explicit — "Look → Act → Verify: repeat until done" — with built-in validation (screenshot after every action) and error-recovery feedback: "Re-screenshot after every UI change: coordinates go stale when the screen changes" and "Use `zoom` any time click accuracy is uncertain". This matches the score-5 anchor (clear sequence, explicit validation, feedback loops); not score 4: checkpoints are explicit throughout, not merely implied.

5 / 5

Progressive Disclosure

Good structure: workflow and common scenarios live in SKILL.md while full argument syntax is correctly split into the real, one-level-deep references/command-reference.md, signaled via a clear link. Minor gaps keep it at 4: the link to the reference file appears only at the very bottom (buried after two tables), and the 20-row Quick Reference table partially duplicates the reference file's content — the anchor-4 pattern of "most content appropriately placed; minor organization gaps". Not score 3: the split is appropriate and the reference is clearly signaled, not buried or multi-level.

4 / 5

Total

18

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete action list, explicit "Use when..." trigger, environment scope, and a stated dependency with install command. Its weaknesses are second-person voice ("you need"), which the rubric penalizes, and a few missing natural trigger synonyms.

Suggestions

Rewrite in third person per the rubric (e.g., "Automates visual GUI interaction: testing buttons, filling forms, verifying layouts... Use when the user needs to click, type, or screenshot a real GUI").

Add common natural trigger terms users would say: "click", "scroll", "UI testing", "browser automation", "computer use".

Sharpen distinctiveness by leading with the mechanism (e.g., "drive a real screen via the `cua` CLI") so it cannot be confused with generic web-scraping or screenshot skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "test buttons, fill forms, verify visual layouts, fuzz web pages, automate user flows, take screenshots, or perform end-to-end QA" — which matches the comprehensive score-5 anchor, but it is written in second person ("Use when you need to visually interact with a GUI"), which the rubric penalizes by 1 point on specificity. Not score 3: far more than 1-2 concrete actions are named; not score 5: the second-person voice penalty applies.

4 / 5

Completeness

Explicitly answers both questions: "what" via the concrete action list (test buttons, fill forms, fuzz, screenshots, e2e QA) and "when" via the explicit trigger clause "Use when you need to visually interact with a GUI", plus environment scope ("cloud VMs, Docker containers, local machines, and sandboxes") and the dependency ("Needs the `cua` CLI"). This matches the score-5 anchor's what+when with concrete trigger phrases; not score 4: the "when" is explicit and leading, not merely appended.

5 / 5

Trigger Term Quality

Strong natural phrases users would actually say: "test buttons", "fill forms", "take screenshots", "automate user flows", "end-to-end QA", "fuzz web pages" — good coverage with synonymous phrasings. Not score 5: a few common natural terms are missing, e.g. "click", "scroll", "UI testing", "browser automation"; not score 3: coverage goes well beyond bare domain keywords with multiple synonyms for the core need.

4 / 5

Distinctiveness Conflict Risk

The niche — visual GUI interaction via a specific `cua` CLI on cloud VMs/sandboxes/containers — is mostly distinct with a clear tool identifier. Not score 5: phrases like "take screenshots" and "end-to-end QA" on "any application" carry minor overlap risk with browser-automation or screenshot-oriented skills; not score 3: the coordinate-clicking/screen-automation framing tied to `cua` is far more specific than generic document/file skills.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

trycua/cua

Path

skills/gui-automation/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.