By codecubit
SurrealDB v3 plugin tailored to the Base platform — Schema Builder, pre-commit gates, jsonify/extractId, Mastra SCHEMALESS, EventBus/SurrealLiveAdapter, and real production-incident lessons.
Write correct JavaScript and TypeScript against the SurrealDB SDK v2 (`surrealdb` npm package). Use this skill whenever the user imports from `"surrealdb"`, calls `new Surreal()`, `db.connect`, `db.use`, `db.signin`, `db.signup`, `db.authenticate`, `db.query`, `db.select`, `db.create`, `db.update`, `db.merge`, `db.patch`, `db.delete`, `db.live`, `db.kill`, `db.close`, constructs a `RecordId`/`Table`/`Uuid`, sets up a SurrealDB connection in a Node or browser app, debugs SDK errors like `ResponseError` or `EngineDisconnected`, or migrates from the legacy `surrealdb.js` v1 package. Pair with the `surrealql` skill whenever the user writes the query string. Trigger even when the user does not explicitly name the skill.
Write correct SurrealQL for SurrealDB v3 — queries, schema design, graph edges, permissions, live queries, transactions, full-text and vector search. Use this skill whenever the user is working in a `.surql` file, asks for any SurrealQL statement (SELECT, CREATE, UPDATE, UPSERT, DELETE, INSERT, RELATE, LIVE SELECT, DEFINE, REMOVE, REBUILD, BEGIN/COMMIT), designs a database schema with DEFINE TABLE/FIELD/INDEX/EVENT/FUNCTION/ACCESS/ANALYZER/SEQUENCE, writes row-level permissions using `$auth`, traverses graph relationships with arrow syntax, or debugs query errors. Trigger even when the user does not explicitly name the skill.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Private — Base-platform-specific SurrealDB v3 patterns: Schema Builder, pre-commit gates, jsonify/extractId, Mastra SCHEMALESS, EventBus + SurrealLiveAdapter, and production-incident playbook.
SurrealDB has two sides most users touch:
surrealdb npm package used from Node, browsers, React Native.These are different concerns. This plugin ships a skill for each, plus two slash commands tuned to the Base codebase.
Versions. This plugin targets SurrealDB server v3 and JavaScript SDK v2. If you're on server v1/v2 or the legacy
surrealdb.jspackage, some recipes here won't apply — check the version note in each skill.
No MCP. Earlier versions shipped a
surreal-cliMCP server. It was dropped inv0.3.0because the maintainer's workflow usessurreal sqldirectly via terminal. Skills + commands are the only surface now.
| Component | Name | When it triggers |
|---|---|---|
| Skill | surrealql | Writing/reviewing .surql, schema, DEFINE ..., permissions, live queries, graph edges |
| Skill | surrealdb-js | Code using the surrealdb package — new Surreal(), db.query, RecordId, auth flows |
| Command | /surrealql-review | Review a SurrealQL file or snippet for v3 compatibility, common gotchas, and Base-specific gate violations |
| Command | /surreal-scaffold | Generate a starter schema.surql + SDK client. Two profiles: generic and base |
claude plugin marketplace add codecubit/surrealdb-v3-stack
claude plugin install surrealdb-v3-stack@surrealdb-v3-stack
Clone the repo and install the plugin directory. Make sure the surreal CLI is on your PATH:
curl -sSf https://install.surrealdb.com | sh
surreal --version
# 1. Start a local SurrealDB server (or point at the Base CT)
surreal start --user root --pass root --log info memory
# 2. Export env vars (Base style)
export SURREALDB_URL=http://127.0.0.1:8000
export SURREALDB_USER=root
export SURREALDB_PASS=root
export SURREALDB_NAMESPACE=base
export SURREALDB_DATABASE=base
# 3. In Claude Code, ask for a starter:
# /surreal-scaffold base
Both skills use progressive disclosure. The SKILL.md is short; dense material sits in references/.
skills/surrealql/
references/dml.md — CREATE/SELECT/UPDATE/UPSERT/DELETE/INSERT/RELATE, graph traversal, types, operators.references/schema.md — DEFINE TABLE/FIELD/INDEX/EVENT/FUNCTION/PARAM/SEQUENCE/CONFIG/USER/ANALYZER.references/permissions.md — $auth-based row-level permissions, patterns, caveats.references/advanced.md — live queries, transactions, full-text/vector search, GraphQL.references/auth.md — DEFINE ACCESS types (RECORD / JWT / BEARER), v1→v3 migration.references/modeling.md — decision tree: record links vs graph edges vs embedding, anti-patterns, denormalization.references/migrations.md — safe schema evolution: add/remove/rename fields, backfill pattern, versioning traps.references/cookbook.md — 10 real-world recipes: pagination, full-text search, graph recommendations, transactions, soft delete.references/gotchas.md — 28 gotchas (18 common + 10 from production incidents).references/schema-builder.md — [Base] 3-layer pipeline (CORE_SCHEMA / sub-fields / MIGRATIONS), auto-healing, gates, incidents this pipeline prevents.references/serialization.md — [Base] jsonify / extractId / Jsonify<T> from @/lib/surreal, Server→Client data flow.references/mastra.md — [Base] the 6 SCHEMALESS Mastra tables, NULL vs NONE.references/eventbus.md — [Base] EventBus + SurrealLiveAdapter, platform vs module channels (post-Phase-8), worker dynamic discovery.references/base-gates.md — [Base] the 4 pre-commit gates (check:catalog, check:manifests, check:schema-backfill, check:schema-module-purity).skills/surrealdb-js/
references/api.md — every method on Surreal, every helper class.references/patterns.md — connection lifecycle, auth flows, live-query reconnect, testing, Base's cached-singleton pattern.references/gotchas.md — SDK-specific traps, including SDK v1→v2 silent breakages.UNLICENSED — private, not for distribution.
npx claudepluginhub codecubit/surrealdb-v3-stack --plugin surrealdb-v3-stackSurrealDB v3 and JavaScript SDK v2 expertise for Claude Code — two skills (SurrealQL and the surrealdb npm package), two slash commands for review and scaffolding, and an MCP server that wraps the surreal CLI.
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Complete creative writing suite with 10 specialized agents covering the full writing process: research gathering, character development, story architecture, world-building, dialogue coaching, editing/review, outlining, content strategy, believability auditing, and prose style/voice analysis. Includes genre-specific guides, templates, and quality checklists.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Intelligent draw.io diagramming plugin with AI-powered diagram generation, multi-platform embedding (GitHub, Confluence, Azure DevOps, Notion, Teams, Harness), conditional formatting, live data binding, and MCP server integration for programmatic diagram creation and management.
Comprehensive startup business analysis with market sizing (TAM/SAM/SOM), financial modeling, team planning, and strategic research