volcengine-db-supabase

volcengine-db-supabase is a skill for Claude Code, Codex from volcengine/volcengine-skills. It costs 239 tokens per session (7,340 once invoked), scanned A, a copy of byted-supabase, MIT.

An operations guide for Volcengine’s Supabase-based backend platform, which provides databases and other services for applications. It is Volcengine’s version, not the official Supabase product.

In plain words
What is it for?
Use it to create and inspect platform resources, run SQL queries, check REST API access, and verify changes made through Volcengine’s command-line tool.
Why use it?
It helps avoid using the wrong commands or assumptions when managing workspaces, branches, computing resources, permissions, and SQL.

Skill for Claude CodeCodex

Part of the volcengine-database plugin — 1 skill shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/volcengine/volcengine-skills/volcengine-db-supabase
Any agent
npx skills add volcengine/volcengine-skills --skill volcengine-db-supabase
Clone the repo
git clone --depth 1 https://github.com/volcengine/volcengine-skills

Made for: Claude Code, Codex.

Or install volcengine-database, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for volcengine-db-supabase

README.md
[![agentmods](https://agentmods.dev/badge/skills/volcengine/volcengine-skills/volcengine-db-supabase.svg)](https://agentmods.dev/skills/volcengine/volcengine-skills/volcengine-db-supabase)
Your own site
<a href="https://agentmods.dev/skills/volcengine/volcengine-skills/volcengine-db-supabase"><img src="https://agentmods.dev/badge/skills/volcengine/volcengine-skills/volcengine-db-supabase.svg" alt="Measured on agentmods" height="20"></a>
Per session 239 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,340 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 91% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00239 $0.07340
Opus 5 $0.00120 $0.03670
Sonnet 5 $0.00048 $0.01468
Haiku 4.5 $0.00024 $0.00734

Measured 4d ago against content hash 8fbb740658fe, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

volcengine-db-supabase scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/supabase_dataplane.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

91% identical to byted-supabase — 38 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

plugins/volcengine-database/skills/volcengine-db-supabase/SKILL.md · 317 lines

How it starts

The opening of the file, as written. The whole thing — 317 lines — stays where its author put it; the contents beside it link to each section on GitHub.

火山引擎 AI 原生 BaaS 平台 · Supabase 版

本 Skill 用于在对话中充当火山引擎「AI 原生 BaaS 平台 Supabase 版」的智能运维与开发代理

ℹ️ 这是火山引擎自研的 AI 原生 BaaS 平台(Supabase 版),不是官方开源 Supabase。 它在 Supabase 协议/生态之上做了火山引擎的平台化适配,与官方存在差异

  • byted-supabase-cli 操作(不是官方 supabase CLI),通过 火山引擎账号 / AK-SK 鉴权;
  • 资源模型为 workspace(工作区)/ branch(分支)/ compute(算力),并有 endpointscomputes 等火山专有命令;
  • 部分命令、参数与行为与官方 Supabase CLI 不同

👉 操作以本 Skill 文档与 byted-supabase-cli <command> --help 为准,不要套用官方 Supabase CLI 的命令习惯

它会:

  • 识别用户的 Supabase 自然语言需求
  • 直接调用 byted-supabase-cli 命令行工具获取实时结果
  • 基于返回结果做解释、排障和下一步建议

核心原则

本节为通用工作纪律,任何 Supabase 任务都应遵守

1. 平台演进快 —— 先查在线文档/发布记录,不要只信训练数据。 命令、参数、config 项、API 约定会随版本变化。动手前先查火山引擎官方文档与发布记录(见文末在线文档),尤其涉及不确定的命令/参数时;CLI 子命令一律 byted-supabase-cli <command> --help 现查,不要凭记忆猜命令

2. 验证你的工作。 任何变更落地后,再跑一条只读查询确认生效。没有验证的修复=未完成。

3. 从错误中恢复,不要死循环。 同一方法连续失败 2-3 次就停下来换思路:换方法、查文档、更仔细地看报错、必要时查日志。Supabase 类问题不总是靠重试同一条命令解决。

4. 把表暴露给 Data API(REST)。 新建的表不一定自动通过 Data API 暴露。若要让 anon / authenticated 角色经 REST 访问某表,需显式 GRANT

注意:这与 RLS 是两回事 —— Data API 暴露 + 角色授权决定表是否可达;RLS 决定表可达后哪些行可见。当用户反馈"SQL 建的表访问不到",先确认是否已授权这两个角色。对外(anon/authenticated)授权时务必同时启用 RLS。

5. ⛔ 高危红线:projects stop(暂停 workspace)会让客户业务彻底不可用。 暂停后的实例无法靠客户 IO / 访问流量自动唤醒(这与分支休眠的「访问即唤醒」本质不同)——整个 workspace 及其下所有分支停服,REST / Auth / Storage / 直连 DB 全部不可达,必须由人手动 projects start 才能恢复。因此执行 projects stop必须

  1. 向用户明确复述影响并取得二次确认——「这会停掉整个 workspace <ref>,期间客户业务完全不可用、且不会自动恢复,确认吗?」
  2. 核对目标 ref 无误,绝不停错 workspace;
  3. 绝不把它当作「重启 / 休眠 / 省资源」的手段——重启用 branches restart,休眠是平台自动行为,二者都不会导致业务停服。

projects delete 同属不可逆高危操作,同样需先确认。)

6. 暴露 schema 内的表必须启用 RLS。 任何对外暴露的 schema(默认含 public)里的每张表都要 ENABLE ROW LEVEL SECURITY;私有 schema 也建议启用作为纵深防御。启用后,按真实访问模型写策略,不要无脑给每张表套同一个 auth.uid() 模式

7. 安全 checklist。 凡涉及 Auth、RLS、视图、Storage 或用户数据的任务,逐条过一遍下面这些 Supabase 特有的安全陷阱(完整版见 references/security-guide.md):

Read the full file on GitHub · 317 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 317 lines · 239 tokens per session scan A 8fbb740658fe

Subscribe to this mod's changes

volcengine-db-supabase is a skill published in the GitHub repository volcengine/volcengine-skills (19 stars, last pushed 3d ago), licensed MIT. It adds 239 tokens to every session and 7,340 once invoked, about $0.0012 per session on Opus 5. A static security scan graded it A with 0 findings. It is 91% identical to byted-supabase, differing in 38 lines, and is treated as a copy.

Related

Other skills, from other repositories

schema-exploration

Lists tables, describes columns and data types, identifies foreign key relationships, and maps entity relationships in a database. Use when the user asks about database schema, table structure, column types, what tables exist, ERD, foreign keys, or how entities relate.

langchain-ai/deepagents · 57 tokens

debugging

How to debug tursodb using Bytecode comparison, logging, ThreadSanitizer, deterministic simulation, and corruption analysis tools.

tursodatabase/turso · 28 tokens

sdk-design

Doctrine for designing and evolving any SDK Grida ships — TypeScript, Rust, or otherwise. "SDK" here means a surface that crosses a foreign-or-foreign-treated boundary: published packages, separately-versioned consumers, FFI bindings, public-by-design modules. An SDK's job is to refuse; a strict, honest surface…

gridaco/grida · 199 tokens

ha-data-stores

Map of Hope Agent's local data stores and safe read-only query workflow. Use when the user asks where Hope Agent stores data, wants to inspect sessions/messages/memory/logs/background jobs/knowledge indexes/settings, asks the model to query local app data, or debugging requires checking persisted state. Trigger…

shiwenwen/hope-agent · 115 tokens

supabase

Supabase / PostgREST Row-Level-Security playbook — pull the anon (or leaked servicerole) key out of the frontend JS, map tables from the auto-generated OpenAPI spec, test anonymous RLS READ disclosures (PII/secret leaks), and anonymous RLS WRITE abuse (insert/update/delete — e.g. forging…

PentesterFlow/agent · 120 tokens

nornicdb-cypher-queries

Pick fast, predictable Cypher query shapes in NornicDB — point lookups, batch retrieval, pagination, search, traversal, batched UNWIND/MERGE writes, cleanup, multi-tenant isolation. Use when writing or reviewing Cypher whose latency or throughput matters; maps user intent to the executor's hot-path query templates.

orneryd/NornicDB · 79 tokens