CtrlK
BlogDocsLog inGet started
Tessl Logo

go-rod-master

Comprehensive guide for browser automation and web scraping with go-rod (Chrome DevTools Protocol) including stealth anti-bot-detection patterns.

49

Quality

55%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/go-rod-master/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Scale 1-5

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

This is a highly actionable skill with excellent, executable code examples covering a wide range of go-rod features. However, it suffers from significant verbosity — explaining concepts Claude already knows (CDP, sandboxing, what stealth evasions do internally), listing obvious trigger conditions, and inlining extensive reference material that should be in separate files. The lack of explicit multi-step workflows with validation checkpoints is a notable gap for a skill involving browser automation.

Suggestions

Remove the 'When to Use This Skill' and 'Safety & Risk' sections entirely — Claude can infer when to use browser automation and doesn't need to be told that reading web pages is safe.

Trim the 'How Stealth Works' section to just the usage pattern — Claude doesn't need to know the internal details of WebGL spoofing or plugin array patching to use stealth.MustPage().

Move the 12 implementation guideline sections into a separate reference file (e.g., references/implementation-patterns.md) and keep only the top 3-4 most essential patterns inline.

Add an explicit end-to-end workflow example with validation steps, e.g., 'Scrape a dynamic site: 1. Launch with stealth → 2. Navigate → 3. Verify page loaded (check title/element) → 4. Extract data → 5. Validate extracted data is non-empty → 6. Clean up'.

DimensionReasoningScore

Conciseness

The skill is significantly verbose. The 'When to Use This Skill' section lists 7 bullet points of obvious triggers Claude could infer. The 'Safety & Risk' section explains basic concepts like sandboxing and defer patterns. The 'How Stealth Works' section explains internal implementation details (WebGL spoofing, plugin arrays) that Claude doesn't need to know to use the library. The overview paragraph explains what CDP is and how Rod differs from wrappers — unnecessary context. The entire document is ~400+ lines when it could be ~150-200 lines.

2 / 5

Actionability

Excellent actionability throughout. Every section provides complete, executable Go code examples covering installation, browser lifecycle, stealth usage, network hijacking, concurrent page pools, screenshots, file downloads, JS evaluation, and more. Code is copy-paste ready with proper imports shown and both Must/Error patterns demonstrated.

5 / 5

Workflow Clarity

The skill presents individual features clearly but lacks explicit multi-step workflow sequences with validation checkpoints. There's no 'here's how to build a complete scraper step-by-step' workflow with verification steps. The Best Practices and Common Pitfalls sections provide good guidance but are lists rather than sequenced workflows. For a skill involving browser automation (which can fail in many ways), explicit validate-fix-retry loops would be valuable.

3 / 5

Progressive Disclosure

The skill references an `examples/` directory and `references/api-reference.md`, but no bundle files are provided to verify these exist. The main SKILL.md is monolithic — inlining 12 numbered implementation guideline sections with full code examples that could be split into separate reference files. The documentation references section at the end is good, but the body itself would benefit from moving detailed sections (like network hijacking, concurrent pools, event handling) into separate files.

3 / 5

Total

13

/

20

Passed

Description

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

The description identifies a clear niche (go-rod browser automation with stealth patterns) and includes several useful trigger terms, but lacks a 'Use when...' clause that would help Claude know when to select this skill. It also reads more like a document title ('Comprehensive guide for...') than an actionable skill description with concrete capabilities listed.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to automate browser interactions, scrape websites, or bypass bot detection using Go and go-rod.'

List specific concrete actions such as 'navigate pages, extract DOM elements, handle JavaScript-rendered content, manage cookies/sessions, take screenshots, and bypass CAPTCHAs.'

Rephrase from 'Comprehensive guide for...' to active third-person voice like 'Automates browser interactions and scrapes web content using go-rod...'

DimensionReasoningScore

Specificity

Names the domain (browser automation, web scraping) and mentions a couple of concrete aspects (stealth anti-bot-detection patterns, Chrome DevTools Protocol), but doesn't list specific actions like navigating pages, extracting data, filling forms, taking screenshots, etc.

3 / 5

Completeness

Provides a reasonable 'what' (browser automation and web scraping with go-rod including stealth patterns), but has no 'when' clause at all. The description reads as a label rather than selection guidance. Per rubric, missing 'Use when...' caps completeness at 3, and the 'what' is only moderately clear, placing it at 2.

2 / 5

Trigger Term Quality

Includes good natural keywords like 'browser automation', 'web scraping', 'go-rod', 'Chrome DevTools Protocol', 'stealth', and 'anti-bot-detection'. Missing some common synonyms like 'crawling', 'headless browser', 'puppeteer-like', or 'CDP'.

4 / 5

Distinctiveness Conflict Risk

Specifying 'go-rod' as the specific library and 'Chrome DevTools Protocol' makes this fairly distinct from generic web scraping or browser automation skills. The stealth/anti-bot-detection angle adds further distinction. Minor overlap risk with general web scraping skills remains.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (546 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.