CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-bundle

Use when a user wants to download or package a collection of existing workspace files, including mixed images, documents, audio, video, code, or archives, or reports that a previously provided file bundle card cannot be used.

Quality

87%

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

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

The body is an unusually tight operational guide: executable code, explicit validation and error-recovery loops, precise limits, and clearly organized sections with no filler or background explanation. Only minor repetition of the no-ZIP-exists and policy caveats keeps it from full token efficiency.

DimensionReasoningScore

Conciseness

The body is dense with tool-specific facts (200-path limit, 256 KiB message cap, soft-delete storage retention, ID-fixed membership) and explains nothing Claude already knows. Minor trimming is possible where the no-ZIP-exists caveat repeats ("The tool does not create, upload, or download an archive itself" / "It does not mean that a ZIP exists" / "no incomplete ZIP is saved") and policy warnings appear twice, which fits anchor 4 rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

A copy-paste-ready tool.call("create_client_side_file_bundle", {...}) snippet with realistic values is provided, along with explicit result handling ("Read result.content and check result.ok"), concrete constraints (160-char title, 200 paths, 256 KiB), enumerated result.data fields, and a per-error recovery playbook. This matches anchor 5: fully executable code with specific guidance covering the common cases.

5 / 5

Workflow Clarity

The sequence is explicit ("First identify the exact files ... Then run") with validation checkpoints (check result.ok; "Report attachment readiness only after the ZIP is created and available") and error-recovery feedback loops ("read the reported path and reason, correct the selection or wait for synchronization, then retry"). The batch-operation cap does not apply because recovery loops are present.

5 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist, none are referenced in the body, and none are needed for this single-purpose skill. The document is organized into tight, well-labeled sections (Create a Card, Attachment Fallback, Parameters and Boundaries, Result and Download Behavior, Errors) with nothing that belongs in a separate file and no nested or buried references.

5 / 5

Total

19

/

20

Passed

Description

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

The description is specific and trigger-rich, explicitly scoping when to use the skill down to a distinctive re-trigger case (a previously provided bundle card failing). Its main limitations are that the 'what' is embedded in the trigger phrasing rather than stated independently, and natural synonyms like 'zip' are missing, leaving every dimension just short of the top anchor.

Suggestions

Add natural trigger synonyms and file extensions users would say, such as 'zip these files', 'bundle', or '.zip', to lift trigger_term_quality from good to comprehensive coverage.

State the capability explicitly alongside the trigger, e.g. 'Creates an in-browser download card that packages selected workspace files into a ZIP. Use when...' so the 'what' is independent of the 'when'.

State scope exclusions to reduce conflict risk with neighboring skills, e.g. 'for multiple existing workspace files, not single files or external URLs (use the download skill for those)'.

DimensionReasoningScore

Specificity

"download or package a collection of existing workspace files" names two concrete actions and "mixed images, documents, audio, video, code, or archives" gives broad type coverage, exceeding anchor 3's not-comprehensive bar. It falls short of anchor 5, whose examples list multiple distinct actions, because the actual mechanism (creating a client-side download card) is not mentioned.

4 / 5

Completeness

The 'when' is explicit and concrete ("Use when a user wants to download or package a collection of existing workspace files ... or reports that a previously provided file bundle card cannot be used"), stronger than anchor 4's example. The 'what' is only fused into the trigger clause rather than asserted as the skill's own action, so anchor 5's clearly separated what-and-with-concrete-triggers is not fully met.

4 / 5

Trigger Term Quality

Natural phrases like "download", "package", "collection of ... files", and "file bundle card" match what users would actually say, giving good coverage above anchor 3. Anchor 5 is not met because common synonyms and extensions such as "zip", "compress", or ".zip" are absent.

4 / 5

Distinctiveness Conflict Risk

Scoping to "a collection of existing workspace files" plus the distinctive card-failure re-trigger makes it mostly distinct from related skills. Minor overlap risk remains with single-file download or external-URL download requests, since no exclusion for those cases is stated.

4 / 5

Total

16

/

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

dtyq/magic

Path

backend/super-magic/agents/skills/file-bundle/SKILL.md

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.