CtrlK
BlogDocsLog inGet started
Tessl Logo

supabase

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).

64

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/supabase/skills/supabase/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-3

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 and its schema-change/troubleshooting workflows are clearly sequenced with validation and feedback loops. The main weaknesses are minor prose padding and a fairly monolithic inline security checklist that could be factored into a reference file.

Suggestions

Extract the 'Security checklist' (principles 6 with its many sub-bullets) into a dedicated reference file and link to it from SKILL.md, keeping only a short pointer and the most critical one-liners inline.

Tighten Principle 3 and the explanatory sentences under bolded checklist headers where the bold header already conveys the rule, to reduce token cost.

Collapse the two-level reference chain by having SKILL.md point directly to the feedback template alongside skill-feedback.md, or inline the small template into skill-feedback.md.

DimensionReasoningScore

Conciseness

The body is dense with Supabase-specific knowledge Claude likely lacks (CLI version requirements, RLS edge cases, deprecated auth.role()), but includes padding such as Principle 3's "Supabase issues are not always solved by retrying the same command, and the answer is not always in the logs..." and rationale restated under already-bolded checklist headers, matching score 2's 'mostly efficient but could be tightened' rather than score 3's 'every token earns its place'.

2 / 3

Actionability

It provides fully executable guidance — concrete commands ("supabase db pull <descriptive-name> --local --yes", "curl -so /dev/null -w %{http_code} https://mcp.supabase.com/mcp"), named MCP tools (execute_sql, get_advisors, search_docs), and copy-paste SQL policy examples contrasting deprecated vs. correct patterns — matching the score-3 'fully executable code/commands; copy-paste ready' anchor.

3 / 3

Workflow Clarity

The schema-change workflow is a clearly sequenced numbered list with explicit validation checkpoints ("Run advisors... Fix any issues", "Verify: supabase migration list --local"), a feedback loop (Principle 3: stop after 2-3 attempts and reconsider), and a checklist for complex processes, matching the score-3 anchor and avoiding the destructive-operation cap since validation is present.

3 / 3

Progressive Disclosure

Section organization is clear and the single reference is well-signaled ("MUST read when the user reports..." → references/skill-feedback.md), but the large inline security checklist is content that could be split into its own reference file, and the reference chain runs two levels deep (SKILL.md → references/skill-feedback.md → assets/feedback-issue-template.md), matching score 2's 'content that should be separate is inline' rather than score 3's 'one-level-deep references'.

2 / 3

Total

10

/

12

Passed

Description

72%Weight 40%Scale 1-3

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 has excellent trigger-term coverage and a clear, distinctive Supabase niche with an explicit 'Use when' clause. Its weakness is that it enumerates triggers and domains rather than stating the concrete actions/capabilities the skill performs, leaving the 'what' only implied.

Suggestions

Lead with one short clause stating the skill's concrete capabilities in active voice (e.g., 'Implements and audits Supabase schemas, auth, and RLS policies'), then keep the trigger list.

Frame a few more enumerated items as actions the skill performs (e.g., 'writes and reviews migrations', 'diagnoses auth/session issues') rather than only as trigger topics.

DimensionReasoningScore

Specificity

Quotes like "schema changes, migrations, security audits" and "login, logout, sessions" name concrete actions, but the description is framed as a trigger/scope enumeration ("Triggers: Supabase products (Database, Auth, Edge Functions...)") rather than a list of concrete actions the skill performs, so it falls short of the score-3 'multiple specific concrete actions' anchor and sits above score 1's 'vague or no actions'.

2 / 3

Completeness

The explicit "Use when doing ANY task involving Supabase. Triggers: ..." clause clearly answers *when*, but *what* the skill does is only implied via the topic enumeration rather than stated as capabilities, so per the 'score only what is explicitly stated' guideline it does not reach the score-3 'clearly answers both what AND when' anchor.

2 / 3

Trigger Term Quality

It gives broad natural coverage users would actually say — "Supabase", "Auth", "RLS", "supabase-js", "@supabase/ssr", "JWT", "cookies", "getSession", "getUser", "migrations" — matching the score-3 'good coverage of natural terms' anchor and exceeding score 2's 'some relevant keywords but missing common variations'.

3 / 3

Distinctiveness Conflict Risk

The "Use when doing ANY task involving Supabase" framing plus Supabase-only products and libraries carve a clear niche unlikely to trigger for unrelated skills, matching the score-3 'clear niche with distinct triggers' anchor.

3 / 3

Total

10

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openai/plugins
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.