api-database-surrealdb SKILL.md skillB
api-database-surrealdb from agents-inc/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add agents-inc/skills/api-database-surrealdb@git:20261016.afd0e14Pins git:20261016.afd0e14 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- agents-inc/skills
- Path
src/skills/api-database-surrealdb/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261016.afd0e14, committed Oct 16, 2026
- First version recorded
- Mar 20, 2026
- Size
- 11,828 bytes
- Repository stars
- 26
- License
- MIT
SurrealDB multi-model database - SurrealQL queries, record links, graph relations, live queries, schema definitions, authentication, TypeScript SDK.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# SurrealDB Patterns
> **Quick Guide:** Use the `surrealdb` SDK (v2+) with `new Surreal()` and `connect()`. Model relationships with record links for simple pointers and `RELATE` for graph edges with metadata. Use `SCHEMAFULL` tables in production with `DEFINE FIELD` constraints. Always use parameterized queries (`$variable`) to prevent injection. Record IDs are `table:id` -- they are immutable and first-class values in SurrealQL. Live queries push changes without polling.
---
<critical_requirements>
## CRITICAL: Before Using This Skill
**(You MUST use parameterized queries with `$variables` for ALL user input -- string interpolation in SurrealQL enables injection attacks)**
**(You MUST use `new RecordId("table", "id")` in SDK v2 -- plain `"table:id"` strings are NOT automatically parsed as record IDs)**
**(You MUST call `db.use({ namespace, database })` or pass namespace/database in `connect()` options BEFORE any queries -- queries without a selected namespace/database silently fail or error)**
**(You MUST NOT rely on `SCHEMALESS` tables in production -- use `SCHEMAFULL` with `DEFINE FIELD` to enforce data integrity at the database layer)**
…Read the whole file at its exact version.
How to install
mdr add agents-inc/skills/api-database-surrealdb@sha256:7c0d6a2757cd6379The line at the top of this page pins the label git:20261016.afd0e14, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_p6bpg4nlh7vaiihx)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Mar 20, 2026 and Oct 16, 2026, about one every 105 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261016.afd0e14 latest | 2026-10-16 | afd0e14 | 11,828 B | B | view · diff |
| git:20260328.47861b7 | 2026-03-28 | 47861b7 | 12,104 B | B | view · diff |
| git:20260320.cac8480 | 2026-03-20 | cac8480 | 15,980 B | B | view |
Audit of the latest version
- fail: No link to a raw IP address (matched: http://127.0.0.1:8000)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (11828 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No script tag
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
agents-inc/skills · 26 stars · license MIT · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_p6bpg4nlh7vaiihx GET https://markdownregistry.com/api/v1/resolve?ref=agents-inc/skills/api-database-surrealdb GET https://markdownregistry.com/api/v1/blob/7c0d6a2757cd6379d4610ad36c5d4d2de190ceb616c5032d56452f26e3f14c51
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.