CtrlK
BlogDocsLog inGet started
Tessl Logo

supabase-database

Supabase database operations including queries, CRUD operations, RLS policies, and PostgreSQL functions. Use when querying tables, managing data, implementing RLS, or writing database functions.

68

Quality

85%

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

76%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 reference whose code examples are executable and comprehensive for common Supabase database tasks. Its weaknesses are duplicated content (Quick Reference table vs Basic Queries, inline filter/RLS detail that already lives in the reference files) and the absence of any error-checking or validation workflow around destructive operations, which caps workflow clarity at 3.

Suggestions

Add an explicit error-handling/validation convention after destructive operations — e.g. a short 'Always check error before proceeding' section with a delete/update example showing the check-then-retry pattern — to lift workflow clarity above the destructive-operation cap.

Remove the 'Quick Reference' table (it duplicates the Basic Queries section) or drop the duplicated Basic Queries snippets and keep only the table, reclaiming tokens.

Trim the inline Filters and RLS sections to one or two examples each and point to references/query-operators.md and references/rls-policies.md for the full operator and policy catalogs, since those files already contain that detail.

DimensionReasoningScore

Conciseness

The body is lean and code-first with essentially zero prose padding — every section is executable snippets with one-line comments — but the 'Quick Reference' table at the top substantially duplicates the 'Basic Queries' section (select/insert/update/delete appear in both). That places it at level 4 (minor instances that could be trimmed) rather than level 5, where every token earns its place.

4 / 5

Actionability

Nearly all examples are complete, executable statements with destructured results and error handling ('const { data, error } = await supabase.from(...)'), covering the common cases: CRUD, filters, ordering, pagination, joins, RLS policies, RPC definition and call, and type generation. The filter-operator fragments (e.g. '.eq('col', 'value')') are API signatures rather than pseudocode, so this is copy-paste ready — the level-5 anchor.

5 / 5

Workflow Clarity

The skill covers destructive database operations (delete, update, RLS policy creation) but includes no validation or error-recovery workflow — snippets destruct 'error' yet nothing instructs checking it before proceeding, and there is no verify-then-retry loop. Per the rubric's explicit cap for destructive/batch/database operations without validation, workflow_clarity cannot exceed 3 even though the material is clearly organized by topic.

3 / 5

Progressive Disclosure

All three referenced bundle files (references/rls-policies.md, query-operators.md, postgres-functions.md) exist, are one level deep, and are clearly signaled in a closing References section with one-line descriptions — good structure. It falls short of level 5 because substantial content duplicated in those files (the Filters section vs query-operators.md, the RLS section vs rls-policies.md) is fully inlined rather than split, and the Quick Reference table adds a third copy of basic CRUD.

4 / 5

Total

16

/

20

Passed

Description

88%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: third-person, concise, with concrete capability enumeration and an explicit 'Use when...' trigger clause. Main gaps are missing natural synonyms ('Postgres', 'SQL', 'row-level security') and slight generic-term overlap with non-Supabase database work.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'queries, CRUD operations, RLS policies, and PostgreSQL functions' — covering the domain comprehensively with no filler, matching the level-5 anchor of multiple specific concrete actions. It does not fit level 4 because coverage is not merely 'minor gaps'; the four named action areas span the skill's whole scope.

5 / 5

Completeness

It explicitly answers both: what — 'Supabase database operations including queries, CRUD operations, RLS policies, and PostgreSQL functions' — and when — 'Use when querying tables, managing data, implementing RLS, or writing database functions'. Both are concrete and explicit, matching the level-5 anchor exactly; level 4 would require a weaker or less specific 'when' clause.

5 / 5

Trigger Term Quality

Trigger phrases 'querying tables, managing data, implementing RLS, or writing database functions' are natural user phrasings, but common variations are missing — no 'Postgres', 'SQL', 'row-level security' spelled out, or 'select/insert/update data'. This matches level 4 (good coverage, a few natural terms missing) rather than level 5, which requires synonyms and variations.

4 / 5

Distinctiveness Conflict Risk

'Supabase' names a clear niche, but 'PostgreSQL functions' and 'querying tables' could also fire on generic Postgres/SQL requests, giving minor overlap risk with closely related database skills — the level-4 anchor. Not level 5: distinctiveness relies on the platform name while the action terms themselves are generic; not level 3: the Supabase/RLS framing is far more specific than 'Works with document files'.

4 / 5

Total

18

/

20

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

Validation for skill structure

No warnings or errors.

Repository
fernandezbaptiste/Skrillz
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.