download-file

Download files in Chrome on Windows and macOS. Handles triggering downloads, detecting and resolving popups, verifying completion, and locating files.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./apps/desktop/bundled-skills/download-file/SKILL.md

Quality

Content

77%

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

The body is highly actionable and clearly sequenced with strong validation and recovery loops, but it is a monolithic single file with some redundancy between the popup-handling steps and the later Error Messages / Security Rules sections. Splitting the reference tables out and de-duplicating would lift the weaker dimensions.

Suggestions

Move the detailed popup (5a–5d) and error-message tables into a references/POPUPS.md file, keeping SKILL.md as a lean overview with one-level-deep links, to improve progressive disclosure.

De-duplicate the Security Rules and Error Messages sections against STEP 2 and STEP 5 — either reference those steps or consolidate — to tighten conciseness.

Resolve the slight STEP 6 inconsistency (mentions both a deprecated download shelf on Windows and the macOS download bubble) with a single current observation method to avoid confusion.

Dimension	Reasoning	Score
Conciseness	The body avoids explaining concepts Claude already knows and leans on terse tables, but the 'Error Messages to Surface' table restates STEP 5 popup handling and the 'Security Rules' section restates STEP 2 — content that could be tightened.	2 / 3
Actionability	Concrete chrome://settings/downloads and chrome://downloads URLs, exact default paths, exact popup-text → action mappings, polling intervals, and copy-paste-ready message templates make the guidance fully executable.	3 / 3
Workflow Clarity	Eight clearly sequenced steps include explicit validation (STEP 7's ✅ filename/status/path checklist) and a STEP 8 feedback loop (re-check, search history, retry, fallback), matching the level-3 anchor.	3 / 3
Progressive Disclosure	Sections are well-organized with no nested references, but the ~200-line file is monolithic and keeps sizable reference-like material (the 5a–5d popup tables and error-message table) inline rather than split into a one-level-deep reference file.	2 / 3
	Total	10 / 12 Passed

Description

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 is specific and distinctive, cleanly stating the skill's Chrome-download niche and concrete actions. Its weakness is the missing explicit "when to use" trigger guidance and limited natural-term coverage, which cap completeness and trigger-term quality at 2.

Suggestions

Add a 'Use when the user asks to download, save, or export a file, report, installer, or attachment from a webpage' clause to satisfy the completeness 'when' requirement and lift that dimension to 3.

Broaden trigger terms to include the natural variations users say — 'save a file', 'export', 'attachment', 'installer' — alongside 'download' to improve trigger-term coverage.

Keep the third-person voice and concrete action list as-is; they are already strong.

Dimension	Reasoning	Score
Specificity	"Handles triggering downloads, detecting and resolving popups, verifying completion, and locating files" lists four distinct concrete actions rather than vague abstractions, matching the level-3 anchor.	3 / 3
Completeness	The description clearly answers "what" (Chrome downloads with popup/verification/locating), but there is no "Use when..." clause or equivalent explicit trigger guidance, which the guidelines cap at 2.	2 / 3
Trigger Term Quality	"Download files" and "downloads" are natural user terms, but coverage stops there — common variations a user would actually say ("save a file", "export", "attachment", "installer") are absent, so it is not the broad level-3 coverage.	2 / 3
Distinctiveness Conflict Risk	"Download files in Chrome on Windows and macOS" scoped to browser downloads with popup-handling and completion verification carves a clear niche unlikely to conflict with unrelated skills.	3 / 3
	Total	10 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: accomplish-ai/coworker
Path: apps/desktop/bundled-skills/download-file/SKILL.md
Commit: 2cf74d0

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.