supabase-cli

Supabase CLI commands for local development, migrations, project management, and deployment. Use when working with Supabase CLI, starting local dev, managing migrations, or deploying changes.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/supabase-cli/SKILL.md

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.

A well-organized, highly actionable CLI reference with clean structure and working reference links. Its weaknesses are the absence of validation checkpoints around destructive database/project operations (capping workflow clarity at 3) and some duplication between the quick-reference table and detail sections.

Suggestions

Add a numbered end-to-end workflow (init → link → start → migration new → db reset → db push) so the typical development sequence is explicit rather than implied by section order.

Add validation steps before destructive operations: use 'supabase db push --dry-run' as a mandatory pre-push check, and note that 'db reset', 'migration down', 'stop --no-backup', and 'projects delete' destroy data and should be preceded by 'migration list' or status checks.

Move lower-frequency sections (Backup & Restore, Database Inspection, Project Management) into the existing references/ bundle or trim the Quick Reference table to non-duplicated entries to reduce token cost.

Dimension	Reasoning	Score
Conciseness	The body is command-dense and avoids explaining concepts Claude already knows; the Quick Reference table duplicates commands restated in later sections ('supabase migration new <name>', 'supabase db push', 'supabase gen types typescript --local') and a few one-line glosses ('Shows local vs remote migration status') could be trimmed, matching 'minor instances of over-explanation'.	4 / 5
Actionability	Every section gives fully executable, copy-paste-ready commands with realistic flags and placeholders (e.g. 'supabase db push --dry-run', 'supabase functions serve --env-file .env --no-verify-jwt', the multi-file psql restore), covering the common cases from install through deploy and backup.	5 / 5
Workflow Clarity	Section order implies a sequence (setup → local dev → migrations → deploy) and 'supabase db push --dry-run' offers a preview, but destructive and batch operations ('supabase db reset', 'supabase migration down --count 1', 'supabase stop --no-backup', 'supabase projects delete') lack validation/verification steps, so the rubric's cap of 3 for destructive operations without validation applies; it is above 2 because the sequence and commands themselves are clear.	3 / 5
Progressive Disclosure	The body is well-sectioned with a clearly signaled References section linking three real one-level-deep files ('references/local-development.md', 'references/migrations.md', 'references/config-toml.md'), but sizable inline material (Backup & Restore, Database Inspection, Project Management) could be split into reference files, leaving minor organization gaps.	4 / 5
	Total	16 / 20 Passed

Description

78%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 that explicitly states both what the skill covers and when to use it, with a distinctive niche marker. Its main weakness is category-level capability phrasing and a few missing natural trigger variations. It also correctly uses third-person voice.

Dimension	Reasoning	Score
Specificity	Names the domain ('Supabase CLI commands') plus four concrete task areas ('local development, migrations, project management, and deployment'), matching the 'several specific actions; minor gaps' anchor; it falls short of 5 because capabilities are stated at category level and omit covered areas like type generation and edge functions.	4 / 5
Completeness	Both 'what' ('Supabase CLI commands for local development, migrations, project management, and deployment') and 'when' ('Use when working with Supabase CLI, starting local dev, managing migrations, or deploying changes') are explicitly present; it is below 5 because the 'what' is category-level rather than enumerated concrete actions.	4 / 5
Trigger Term Quality	'Use when working with Supabase CLI, starting local dev, managing migrations, or deploying changes' gives good natural-keyword coverage, but misses common variations users would say such as 'supabase start', 'generate types', 'edge functions', or database schema work, so it does not reach the comprehensive synonym coverage of 5.	4 / 5
Distinctiveness Conflict Risk	'Supabase' is a clear niche marker with distinct triggers ('working with Supabase CLI', 'managing migrations' in the Supabase context), giving minimal overlap risk with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: fernandezbaptiste/Skrillz
Path: skills/supabase-cli/SKILL.md
Commit: 93ed392

Reviewed: 14 hours 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.