CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

r2-upload

Upload files to Cloudflare R2, AWS S3, or any S3-compatible storage (like MinIO) and generate secure, time-limited presigned download links with configurable expiration, typically set to 5 minutes. Use when the user needs to upload a file to cloud storage and get a shareable link, or mentions R2, S3, presigned URLs, temporary links, or file uploads with expiration.

Quality

83%

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

68%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 actionable and reasonably lean, with copy-paste build/register commands and concrete configuration examples. Weaknesses are workflow-shaped: setup ordering is scattered, there is no verification step after registration, and the destructive delete tool ships without caution or validation guidance.

Suggestions

Reorder so Setup (build → register → onboard) comes before the Configuration reference section, and add a verification step such as checking `claude mcp list` or performing a test upload before relying on the server.

Add a short example r2_upload invocation with its expected response (presigned URL format) and a caution line for r2_delete (e.g., confirm the key before deleting) to satisfy validation for the destructive operation.

Drop or shrink the redundant Features section (it repeats the description and Tools) and consider moving the Cloudflare R2 / AWS S3 setup walkthroughs into a references/ file to slim the main body.

DimensionReasoningScore

Conciseness

The body is dominated by lean, load-bearing content (config YAML, copy-paste setup commands, tool list), but the "## Features" bullet list duplicates information already in the description and Tools section. It is efficient with only minor trimming opportunities, fitting anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete, executable guidance throughout: `cd "${CLAUDE_SKILL_DIR}" && npm install && npm run build`, `claude mcp add r2-upload -- node "${CLAUDE_SKILL_DIR}/dist/index.js"`, and a complete R2 config example. It stops short of anchor 5 because there is no example tool invocation or expected output shape showing how a call and response actually look.

4 / 5

Workflow Clarity

A sequence exists (build → register → run onboard → configure) but it is scattered, with the Configuration section appearing before Setup, and there are no verification checkpoints (e.g., confirming the MCP server registered or testing an upload). The skill also exposes the destructive `r2_delete` tool with no validation guidance, which caps workflow clarity at 3 per the rubric's destructive/batch-operations rule.

3 / 5

Progressive Disclosure

This is a single-file skill (no references/, scripts/, or assets/ exist) with clear section headers and content that is mostly well-placed for its size. The detailed Cloudflare R2 and AWS S3 setup walkthroughs (~40 lines) are borderline reference material that could live in a separate file, which keeps it at 'good structure, minor organization gaps' rather than anchor 5.

4 / 5

Total

15

/

20

Passed

Description

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

A strong description: concrete capabilities, explicit and well-phrased 'Use when...' triggers covering natural synonyms, and a clear niche. The only improvements are acknowledging secondary capabilities (list/delete) and tightening the broad 'file uploads' trigger to reduce overlap with generic upload skills.

DimensionReasoningScore

Specificity

"Upload files to Cloudflare R2, AWS S3, or any S3-compatible storage (like MinIO) and generate secure, time-limited presigned download links with configurable expiration" names two concrete actions with specific providers and parameters. It falls short of 5 because actual capabilities like listing (r2_list) and deleting (r2_delete) objects are not mentioned.

4 / 5

Completeness

It clearly answers 'what' (upload to R2/S3/MinIO and generate presigned links) and explicitly answers 'when' with "Use when the user needs to upload a file to cloud storage and get a shareable link, or mentions R2, S3, presigned URLs, temporary links, or file uploads with expiration". Both halves with concrete trigger phrases match the top anchor.

5 / 5

Trigger Term Quality

"R2, S3, presigned URLs, temporary links, or file uploads with expiration" plus "upload a file to cloud storage and get a shareable link" covers the natural phrases, product names, and synonyms a user would say. No meaningful natural trigger terms are missing for this domain, so it matches the comprehensive anchor rather than anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The R2/S3/presigned-URL niche is distinct, but the generic "file uploads" trigger has minor overlap risk with other upload or file-sharing skills. It fits 'mostly distinct; minor overlap risk' better than the minimal-conflict anchor 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

zebbern/claude-code-guide

Path

skills/r2-upload/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.