CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

backupdrill/supabase-backup

Back up a Supabase project to your own S3, R2 or B2 bucket with the open-source backupdrill CLI, run a restore drill to prove the snapshot restores, and restore into a new project. Includes plain pg_dump and pg_restore notes for Supabase and what the Free plan does and doesn't back up.

Quality

89%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

An unusually actionable, well-sequenced operations runbook: every command is executable as written, credentials handling is careful, and the destructive restore path has real validation checkpoints. Its main defects are a broken bundle reference (assets/scheduled-backup.yml is missing) and version-sensitive changelog details scattered through the main text.

Suggestions

Ship the referenced assets/scheduled-backup.yml file (or change the schedule section to inline a minimal workflow), since the current link points to a file that does not exist in the bundle.

Consolidate version-history notes ("from 2.2.4", "Since 2.10.0", "before 2.9.0") into a short changelog or 'old snapshots' subsection so the main path stays lean and version-stable.

Trim Claude-known explanations such as the Git index-vs-ignore aside in the credentials section, keeping only the operational command and its failure condition.

DimensionReasoningScore

Conciseness

The body is dense and operational — nearly every sentence carries a command, a flag, or a failure mode, and basic concepts are correctly pushed to the reference file. Minor instances of over-explanation could be trimmed (e.g. "An ignore rule doesn't stop Git from committing a file it already tracks"), and time-sensitive version numbers (2.10.1, 2.2.4, 2.10.0, 2.9.0, pg_dump 17 vs 18) are woven through the text rather than quarantined in a changelog/deprecated section, keeping this at 4 rather than 5. Not 3, since the version notes are operationally load-bearing and the padding is truly minor.

4 / 5

Actionability

Every step is a copy-paste-ready executable shell command: the full env-loading subshell with tracing off and inherited-variable scrubbing, `npx -y backupdrill@2.10.1 estimate/backup/drill/restore`, the mktemp report capture, the config check script, and per-error fixes. Commands cover the common cases exactly as the 5 anchor requires.

5 / 5

Workflow Clarity

The workflow is clearly sequenced (credentials check → prerequisites → egress estimate → backup → drill → restore → schedule) with explicit validation: the config-check script runs before the first command, the destructive restore is gated by a dry run, shown results, explicit user confirmation, and `--snapshot <timestamp> --confirm-target <ref>` pinning, and a "When something fails" section gives error-to-fix feedback loops. This matches the 5 anchor's explicit validation and recovery guidance; the destructive-operation cap does not apply because validation is present.

5 / 5

Progressive Disclosure

Sectioning is good and the one-level reference to [references/postgres-backup-basics.md] is well signaled and exists, but the body also links [assets/scheduled-backup.yml] and instructs the user to copy it — and no assets/ directory exists in the bundle, so that workflow step is broken at navigation time. A dangling referenced path is more than the 4 anchor's "minor organization gaps", landing this at 3.

3 / 5

Total

17

/

20

Passed

Description

92%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: one sentence that pairs an explicit 'Use when…' trigger with five concrete capabilities specific to backing up Supabase projects to user-owned buckets. The only weakness is slightly limited synonym coverage of natural user phrasings.

DimensionReasoningScore

Specificity

The description lists five concrete, distinct actions — "back up a Supabase project to their own S3, R2 or B2 bucket", "estimate what those backups add to their Supabase egress bill", "check that a backup actually restores (a restore drill in Docker)", "schedule backups in GitHub Actions", and "restore a backupdrill snapshot into a new Supabase project" — comprehensively covering the tool's capabilities with no gaps, matching the 5 anchor rather than the 4 anchor's "minor gaps in coverage".

5 / 5

Completeness

It opens with an explicit "Use when the user wants to…" trigger clause enumerating five concrete conditions, and the same sentence concretely states what the skill does — clearly answering both what and when, matching the 5 anchor's exemplar. Not 4, because the 'when' is fully explicit with concrete trigger phrases rather than merely present.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "back up", "Supabase", "S3, R2 or B2", "restore", "restore drill", "egress bill", "GitHub Actions", "snapshot" are phrases users would plausibly say. A few natural variants are missing (e.g. "off-site copy", "archive my database", "test my backup"), which fits the 4 anchor rather than the 5 anchor's comprehensive synonym and extension coverage.

4 / 5

Distinctiveness Conflict Risk

"Supabase project", "backupdrill CLI", and "their own S3, R2 or B2 bucket" define a clear niche with distinct triggers and minimal overlap risk with generic Postgres or file skills, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Reviewed

On this page