supabase-storage

Expert guide for Supabase Storage including bucket management, file operations, URL generation, and RLS policies. Use when working with file uploads/downloads, creating public or private buckets, generating signed URLs, implementing storage RLS policies, handling resumable uploads, image transformations, or any Supabase Storage-related tasks.

Quality

80%

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

Quality

Content

61%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 highly actionable with comprehensive executable examples, but it suffers from monolithic inlining (~720 lines with no reference files or navigation) and noticeable redundancy. Splitting detailed material into bundled reference files and removing duplicated examples would substantially improve it.

Suggestions

Move the exhaustive RLS policy catalog, the full resumable-upload implementations, and the bulk API reference into separate files under references/ and link to them from SKILL.md so the main file stays a concise overview (improves progressive_disclosure).

Remove the 'Complete Setup Example' that duplicates the four RLS policies already shown in section 5, and delete the redundant closing 'Summary' section that recapitulates the table of contents (improves conciseness).

Pick one resumable-upload library as the primary example and relegate the other to a reference file, rather than fully inlining both tus-js-client and Uppy implementations (improves conciseness).

Dimension	Reasoning	Score
Conciseness	The ~720-line body is mostly executable code rather than prose padding, but it is exhaustive and redundant — the 'Complete Setup Example' repeats the four RLS policies already shown individually, two resumable-upload libraries (tus-js-client and Uppy) are both fully inlined, and the closing 'Summary' recap is unnecessary.	3 / 5
Actionability	Provides fully executable, copy-paste-ready snippets in JavaScript, TypeScript, SQL, and TOML covering bucket CRUD, uploads, downloads, URL generation, RLS policies, and image transformations across the common cases.	5 / 5
Workflow Clarity	Content is organized into clearly numbered sections, but it is a reference catalog rather than a sequenced workflow; there are no validation checkpoints, and the security-sensitive RLS setup has no verify/feedback step, capping this dimension.	3 / 5
Progressive Disclosure	No bundle files exist and the entire body is a monolithic inline wall of content — the full API reference, resumable-upload implementations, and RLS policy catalog clearly belong in separate reference files but nothing is split out or linked, matching the anchor for content that should be separate being inlined.	2 / 5
	Total	13 / 20 Passed

Description

100%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, complete, and well-targeted: it names the domain, lists concrete capabilities, and provides an explicit 'Use when...' clause with natural trigger terms. Voice is appropriately third-person with no first/second-person phrasing.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'bucket management, file operations, URL generation, and RLS policies' plus 'file uploads/downloads, creating public or private buckets, generating signed URLs, handling resumable uploads, image transformations' — giving comprehensive coverage of the domain.	5 / 5
Completeness	Explicitly states what ('Expert guide for Supabase Storage including...') and when ('Use when working with file uploads/downloads...') with concrete trigger phrases, matching the anchor for clearly answering both.	5 / 5
Trigger Term Quality	Natural user phrases like 'file uploads/downloads', 'creating public or private buckets', 'generating signed URLs', 'resumable uploads', and 'image transformations' plus a 'Supabase Storage-related tasks' catch-all give comprehensive coverage; no file extensions but none are domain-relevant.	5 / 5
Distinctiveness Conflict Risk	'Supabase Storage' is a clear niche with distinct, domain-specific triggers, so it is unlikely to fire for unrelated skills.	5 / 5
	Total	20 / 20 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
skill_md_line_count	SKILL.md is long (724 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: Raudbjorn/claude
Path: supabase-storage/SKILL.md
Commit: bd02b72

Reviewed: 10 days 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.