Implements TUS resumable upload protocol for files >6MB with advisory lock conflict handling.
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that is highly specific, includes a comprehensive 'Use when...' clause with natural trigger terms, and occupies a clearly distinct niche. It uses proper third-person voice and avoids vague language, making it easy for Claude to select this skill precisely when needed.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: configures TUS resumable upload client, handles Postgres Advisory Lock 409 Conflict, enforces tenant-scoped bucket paths, and specifies the 6MB threshold. | 3 / 3 |
Completeness | Clearly answers both 'what' (configures TUS resumable upload client with advisory lock handling and tenant-scoped paths) and 'when' (explicit 'Use when...' clause listing five distinct trigger scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'large file uploads', 'resumable uploads', 'TUS protocol', 'unstable networks', 'files larger than 6MB', 'Supabase Storage'. These are terms a developer would naturally use when facing this problem. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a very specific niche: TUS protocol + Supabase Storage + Postgres Advisory Locks + 6MB threshold. This combination is unlikely to conflict with any other skill. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill that demonstrates strong technical writing for a complex multi-step protocol. It is concise yet thorough, with executable examples, explicit HALT conditions, retry logic with exponential backoff, and a clear verification phase. The progressive disclosure via companion tiles keeps the main document focused while ensuring supporting concerns are addressed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section serves a purpose—no explanations of what TUS is, what Supabase is, or how HTTP works. It assumes Claude's competence and focuses purely on the specific protocol steps and constraints. | 3 / 3 |
Actionability | Provides fully executable curl examples for initialization, chunk upload, and resume operations. Headers, base64 encoding, and specific byte sizes are all spelled out concretely. The HALT conditions are explicit and unambiguous. | 3 / 3 |
Workflow Clarity | Five clearly sequenced phases with explicit validation checkpoints (HALT conditions at phases 1, 2, 4), a feedback loop for network failure recovery (HEAD request to resume), exponential backoff retry logic for 409 conflicts, and a final verification phase. This is exemplary workflow design for a multi-step destructive/network operation. | 3 / 3 |
Progressive Disclosure | References companion tiles (supabase-mcp-verification, storage-path-validation) at the top with clear paths, keeping the main skill focused on the TUS upload workflow. No deeply nested references; everything is one level deep and clearly signaled. | 3 / 3 |
Total | 12 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents