Browser-automated file download with enhanced features. Auto-detects platform (Windows/macOS/Linux, 64/32-bit, ARM/Intel), handles multi-step navigation (homepage to platform-specific pages), captures auto-downloads triggered on page load, and falls back to button clicking when needed. Ideal for complex download flows where curl/wget fail due to client-side rendering, automatic downloads, or multi-page navigation. Features page scrolling for lazy content, extended wait times, and Golang support.
50
55%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/aaronxx/browser-auto-download/SKILL.mdQuality
Discovery
67%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 excels at specificity and distinctiveness, clearly articulating a well-defined niche for browser-automated downloads with platform detection. However, it lacks an explicit 'Use when...' clause and could improve trigger term coverage with more natural user language. The technical depth is strong but slightly over-indexes on implementation details rather than user-facing trigger scenarios.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to download files, installers, or binaries from websites that require JavaScript rendering or multi-page navigation.'
Include more natural user trigger terms such as 'download a file', 'get the installer', 'fetch the latest release', 'download binary', or common file extensions like '.exe', '.dmg', '.tar.gz'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: auto-detects platform, handles multi-step navigation, captures auto-downloads, falls back to button clicking, page scrolling for lazy content, extended wait times. Very detailed about what it does. | 3 / 3 |
Completeness | The 'what' is thoroughly covered with specific capabilities. The 'when' is partially addressed with 'Ideal for complex download flows where curl/wget fail...' but lacks an explicit 'Use when...' clause with clear trigger guidance. This implicit guidance caps the score at 2 per the rubric. | 2 / 3 |
Trigger Term Quality | Includes some relevant terms like 'download', 'browser', 'curl/wget', 'Windows/macOS/Linux', 'ARM/Intel', and 'Golang', but misses common user phrases like 'download a file', 'get the installer', 'fetch binary', or file extensions like '.exe', '.dmg', '.deb'. The term 'browser-automated' is more technical than what users would naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | Very clear niche: browser-automated file downloading with platform detection and multi-step navigation. The specific mention of when curl/wget fail and client-side rendering scenarios makes it highly distinguishable from general browser automation or simple download skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable with concrete, executable examples and clear CLI usage, but it is far too verbose — containing redundant examples, unnecessary ASCII flowcharts, and sections that could be split into separate files. The workflow lacks inline validation checkpoints for what is inherently an unreliable browser automation process, and the monolithic structure hurts discoverability.
Suggestions
Cut content by at least 50%: remove the ASCII flowcharts, consolidate the redundant example sections (Quick Start, Examples, Real-World Examples all overlap), and trim the platform detection table to essential info only.
Split troubleshooting, advanced usage, and real-world examples into separate referenced files (e.g., TROUBLESHOOTING.md, EXAMPLES.md) to improve progressive disclosure.
Add inline validation steps to the workflow, such as checking returncode/stderr after each stage and explicit retry guidance when auto-download or navigation fails.
Remove explanatory text Claude already knows (e.g., 'The script will: 1. Check for auto-downloads...') and trust Claude to understand the three-stage strategy from the code and flags alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is excessively verbose at ~200+ lines. It includes redundant examples (multiple ways to do the same thing), ASCII art flowcharts that add little value, a full troubleshooting section, real-world examples that repeat earlier examples, and explanations Claude doesn't need (like what auto-download means). The platform detection table, output format section, and batch download examples could all be significantly trimmed. | 1 / 3 |
Actionability | The skill provides fully executable CLI commands, Python code examples with concrete arguments, specific flag names (--url, --selector, --no-auto-navigate), JSON output schemas, and pip install commands. Everything is copy-paste ready. | 3 / 3 |
Workflow Clarity | The three-stage strategy is clearly sequenced and the fallback logic is well-explained. However, there are no explicit validation checkpoints or error recovery loops — the troubleshooting section is reactive rather than integrated into the workflow. For a tool that involves browser automation and file downloads (potentially destructive/unreliable operations), inline verification steps are missing. | 2 / 3 |
Progressive Disclosure | Everything is crammed into a single monolithic file with no references to external documentation. The advanced usage, troubleshooting, real-world examples, platform detection table, and output format sections could all be split into separate files. No bundle files are provided, and the content doesn't reference any supporting documents despite being long enough to warrant them. | 1 / 3 |
Total | 7 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
f45fcb5
Table of Contents
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.