CtrlK
BlogDocsLog inGet started
Tessl Logo

host-computer-use-linux

Backend-specific Linux guidance for `computer_use_remote`. Load after `status` or `start_session` reports backend_family `linux`, backend_id `wayland`, or AT-SPI features. Covers AT-SPI structural targeting, Wayland portal caveats, and screenshot verification.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A lean, highly actionable skill body: executable tool-call examples, concrete error codes, and strong verification discipline with feedback loops for a risky GUI-automation domain. Main gaps are mild — the screenshot-verification rule is repeated across sections instead of stated once, and there is no single ordered end-to-end flow.

Suggestions

State the screenshot-as-proof rule once (e.g., in Wayland Notes) and reference it elsewhere instead of restating it three times.

Add one short ordered overview of the full loop (detect features -> snapshot -> target -> act -> screenshot verify) so the sequence doesn't have to be reconstructed from three sections.

Consider moving the GNOME shortcut list and the permission/error-code catalog into a one-level-deep reference file to keep SKILL.md an overview.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of concepts Claude already knows — every line carries a rule, caveat, or concrete parameter (e.g., "Pass `window_id` whenever one is known so unrelated applications cannot consume the node budget"). It sits at 4 rather than 5 because the screenshot-as-proof rule is restated several times ("Use screenshots for proof after every state-changing action", "Treat every shortcut as an attempt. Inspect the fresh screenshot before saying it worked", "an accepted AT-SPI call without active/focused state is not activation proof") and could be consolidated.

4 / 5

Actionability

Two complete, copy-paste-ready `computer_use_remote` JSON tool calls (`ax_snapshot`, `ax_action`) with concrete parameters, an enumerated operation list (`press`/`focus`/`set_value`), concrete error codes (`COMPUTER_USE_WINDOW_REQUIRED`, `COMPUTER_USE_TARGET_NOT_FOCUSED`, `COMPUTER_USE_AX_UNAVAILABLE`), specific shortcuts, and an ordered fallback chain. This covers the common cases fully, matching the top anchor; score 4 would require missing key details, and there are none of consequence.

5 / 5

Workflow Clarity

There is an explicit conditional flow ("prefer the generic background loop from `host-computer-use`: `list_windows` -> `get_window_state` -> `element_action`. If those features are absent, use the AT-SPI snapshot/action flow below") plus snapshot-choose-act-verify feedback loops ("If an action reports ambiguity, take a fresh snapshot and narrow the target") and validation checkpoints ("Continue only when the result says `focus_verified=true`"). It stays at 4 rather than 5 because the end-to-end sequence is distributed across sections rather than presented as one ordered checklist, so a reader must assemble the order themselves.

4 / 5

Progressive Disclosure

No references/, scripts/, or assets/ directories exist, and the single ~95-line body is well-sectioned (AT-SPI Targeting, Wayland Notes, Permissions) with no nested or buried references, so there is no navigation failure. It is a 4 rather than 5 because the GNOME shortcut list and the permission/error-code catalogs are inline reference material that could live in a one-level-deep reference file, and the skill exceeds the under-50-lines simple-skill case.

4 / 5

Total

17

/

20

Passed

Description

87%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 tight, well-scoped description that answers both what and when with concrete backend-feature triggers, matching the rubric's good examples in structure. Trigger terms are precise but lean technical; a couple of natural synonyms would round it out.

Suggestions

Add one or two natural trigger synonyms (e.g., "Linux desktop", "GNOME/Wayland accessibility") so the description matches how a user would phrase the need.

Optionally name the window-list/text-injection capabilities in the coverage list to reduce the minor specificity gap.

DimensionReasoningScore

Specificity

"Covers AT-SPI structural targeting, Wayland portal caveats, and screenshot verification" lists several concrete capability areas for "Backend-specific Linux guidance for `computer_use_remote`", matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because items like window-list integration, text injection, and permission handling are not mentioned, and 'caveats' is a topic rather than an action.

4 / 5

Completeness

Both halves are explicit: the what ("Backend-specific Linux guidance for `computer_use_remote`... Covers AT-SPI structural targeting, Wayland portal caveats, and screenshot verification") and the when ("Load after `status` or `start_session` reports backend_family `linux`, backend_id `wayland`, or AT-SPI features") with concrete trigger conditions. This matches the top anchor exactly; a 4 would require the when to be less explicit than this.

5 / 5

Trigger Term Quality

Strong, relevant keywords: "backend_family `linux`", "backend_id `wayland`", "AT-SPI features", "structural targeting", "screenshot verification" — good coverage with only a few natural terms missing. Not 5 because common variations a user might say ("Linux desktop", "GNOME", "accessibility tree") are absent.

4 / 5

Distinctiveness Conflict Risk

"Backend-specific Linux guidance" scoped to `computer_use_remote` with load conditions keyed on Linux/Wayland/AT-SPI backend reports carves a clear niche with distinct triggers and minimal conflict risk. Neighboring anchor 4 ('minor overlap risk') does not fit because the description explicitly names its parent skill, load timing, and backend family, leaving almost no ambiguity with generic computer-use skills.

5 / 5

Total

18

/

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
agent0ai/agent-zero
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.