CtrlK
BlogDocsLog inGet started
Tessl Logo

browser

Web browser automation with AI-optimized snapshots for claude-flow agents

54

2.52x
Quality

43%

Does it follow best practices?

Impact

57%

2.52x

Average score across 3 eval scenarios

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/browser/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%

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

This is a solid reference-style skill with excellent actionability — commands are concrete and examples are complete. The main weaknesses are the lack of error handling/validation guidance for a fragile domain like browser automation, and the monolithic structure that packs a lot of content into one file. Some sections (Hooks, Memory Integration) add bulk without clear value for the core browser automation task.

Suggestions

Add error handling guidance: what to do when elements aren't found, clicks fail, or waits time out (e.g., 're-snapshot and retry', 'check if page loaded correctly')

Move the detailed command reference tables and integration sections into separate bundle files (e.g., COMMANDS.md, INTEGRATION.md) and link from the main skill

Remove or significantly trim the Hooks section and Memory Integration section — these are tangential to browser automation and could be referenced elsewhere

DimensionReasoningScore

Conciseness

The skill is mostly efficient with good use of tables and code blocks, but includes some unnecessary sections (Hooks, Memory Integration) that feel like padding. The tips section restates things already implied by the workflow. The intro line about '93% context reduction' is marketing-style fluff.

2 / 3

Actionability

Commands are concrete, copy-paste ready, and cover the full range of operations. Examples show complete workflows (login, form submission, data extraction) with specific commands rather than pseudocode.

3 / 3

Workflow Clarity

The core workflow shows a clear 4-step sequence, and examples demonstrate multi-step flows. However, there are no validation checkpoints or error handling guidance — no mention of what to do when a click fails, an element isn't found, or a wait times out. For browser automation (which is inherently fragile), missing error recovery caps this at 2.

2 / 3

Progressive Disclosure

Content is well-organized with clear section headers and tables, but everything is inline in a single file that's quite long. The detailed command reference tables, multiple examples, and integration sections could be split into separate files. No bundle files are provided to offload content to.

2 / 3

Total

9

/

12

Passed

Description

22%

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

The description is too vague and jargon-heavy, failing to list concrete actions the skill performs or specify when Claude should select it. It relies on abstract terms like 'AI-optimized snapshots' without explaining what that means in practice. Adding specific capabilities and a 'Use when...' clause would significantly improve skill selection accuracy.

Suggestions

Add specific concrete actions such as 'Navigate web pages, click elements, fill forms, extract page content, take screenshots' to replace the vague 'web browser automation'.

Add an explicit 'Use when...' clause with natural trigger terms like 'Use when the user asks to automate a browser, scrape a website, interact with web pages, or navigate URLs'.

Replace jargon like 'AI-optimized snapshots for claude-flow agents' with plain language explaining what the feature actually does, e.g., 'captures accessible page snapshots for automated analysis'.

DimensionReasoningScore

Specificity

The description says 'web browser automation' which is a broad domain reference, and 'AI-optimized snapshots' is vague jargon. No concrete actions like 'click buttons', 'fill forms', 'scrape data', or 'navigate pages' are listed.

1 / 3

Completeness

The 'what' is vaguely stated as 'web browser automation with AI-optimized snapshots' but lacks specifics. There is no 'when' clause or explicit trigger guidance at all, which per the rubric should cap completeness at 2, and the weak 'what' brings it to 1.

1 / 3

Trigger Term Quality

'Web browser automation' and 'snapshots' are somewhat relevant keywords, but common user terms like 'scrape', 'navigate', 'click', 'web page', 'URL', 'selenium', 'puppeteer', or 'browse' are missing. 'claude-flow agents' is internal jargon unlikely to be used by users.

2 / 3

Distinctiveness Conflict Risk

'Web browser automation' narrows the domain somewhat, and 'AI-optimized snapshots for claude-flow agents' adds some specificity to the tooling context. However, it could still overlap with general web scraping or testing automation skills.

2 / 3

Total

6

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
ruvnet/ruv-FANN
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.