DATABASES / Turso
Turso Database
Turso's skill for its in-process SQLite-compatible engine: hard constraints first, then decision trees to feature and SDK reference files, plus CLI, SQL and MCP quick references.
“Turso (Limbo) database helper — an in-process SQLite-compatible database written in Rust. … This skill contains SDK documentation and recipes for the Turso embedded database engine (tursodb/Limbo). …”
01 / THE REASONING
Why this made the selection.
- States ten constraints before any code is written: BETA status, single-process file access, no WITHOUT ROWID tables, no VACUUM, UTF-8 only, WAL as the default journal mode with the legacy delete, truncate and persist modes unsupported, full-text search behind a compile-time feature, encryption behind a flag, experimental MVCC, and lower-is-closer vector distance.
- Routes each feature (vector search, full-text search, CDC, MVCC, encryption, remote sync) and each SDK (JavaScript, JavaScript with sync, serverless, WASM, React Native, Rust, Python, Go) to a named file; its file index lists six references/ and seven sdks/ files.
- Tells the agent not to search the web for libsql or @libsql/client because those legacy names surface outdated APIs, and points it to https://docs.turso.tech instead.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/turso-db/SKILL.md
- skills/turso-db/references/sync.md
- README.md
- LICENSE
- The git tree at 34ced52f, which holds two SKILL.md files (turso-db and turso-cloud)
Our findings
- The frontmatter description says the skill replaces @libsql/client and libsql-experimental for Turso use cases and warns against web searches for the legacy names.
- SKILL.md prints SDK package lines, `brew install turso`, and tursodb invocations including `--readonly` and `tursodb your.db --mcp`.
- references/sync.md says opening a synced file outside the sync SDK corrupts sync state permanently, and that sync uploads local contents to Turso Cloud.
- The repository holds two SKILL.md skills, and the README's npx line installs both.
Not established by this review
- Not executed: it was not installed or run.
- No database file was created, no query was run, no MCP server was started and nothing was synced.
- The other reference and SDK files under skills/turso-db, the turso-cloud skill and docs.turso.tech were not read.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The README prints `npx skills add tursodatabase/agent-skills`. It installs both SKILL.md skills in the repository at this revision, turso-db and turso-cloud, not this skill alone.
- The README's manual alternative is `cp -r skills/turso-db ~/.claude/skills/turso-db` (with a matching line for turso-cloud). It copies this skill alone but needs a local checkout of the repository, for which the README prints no command.
- After installing, the README says the skills activate on their own for Turso work and can be invoked with `/turso-db`.
Before you start
- The runtime and package manager for the chosen SDK
- Homebrew, for the `brew install turso` line that SKILL.md labels "Install Turso CLI via Homebrew"
- A Turso Cloud database for the sync paths, whose examples pass a libsql:// URL and an authToken, and for the serverless/edge path, which SKILL.md routes to @tursodatabase/serverless, a fetch()-based driver for Turso Cloud over a remote HTTP connection
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/SKILL.md
Supports: upstreamDescription, homepage, whySelected, bestFor, compatibility, language, limitations[1], limitations[2], limitations[5], limitations[7], access.permissions, install.prerequisites, review.findings
https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/README.md
Supports: install, limitations[6], review.findings
- MIT LICENSE at 34ced52f ↗Checked
https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/LICENSE
Supports: license, limitations[8]
https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/references/sync.md
Supports: limitations[3], limitations[4], access.permissions, install.prerequisites, review.findings