← Back to Skills Marketplace
surreal-sync
by
Basit Mustafa
· GitHub ↗
· v1.2.1
· MIT-0
641
Downloads
2
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install surreal-sync
Description
Data migration and synchronization to SurrealDB from MongoDB, PostgreSQL, MySQL, Neo4j, Kafka, and JSONL. Full and incremental CDC sync. Part of the surreal-...
Usage Guidance
This skill appears coherent and focused on data migration to SurrealDB. Before installing or running it: (1) verify the upstream repository (the SKILL.md references github.com/surrealdb/surreal-sync) and prefer official release binaries or pinned commits; (2) avoid putting passwords on the command line where possible — use config files, environment variables, or secret stores to prevent exposure in process lists and logs; (3) run initial syncs in a test environment with limited-permission accounts and review CDC setup steps (wal2json, triggers, Kafka consumer configs) to avoid accidental data or production-impacting operations; (4) because this is instruction-only, the skill will not automatically install code — you or your agent will run the cargo install; confirm you trust the upstream binary source before installation.
Capability Analysis
Type: OpenClaw Skill
Name: surreal-sync
Version: 1.2.1
The skill bundle provides documentation and usage examples for 'surreal-sync', a CLI tool designed for migrating data from various databases (PostgreSQL, MongoDB, Kafka, etc.) to SurrealDB. The instructions in SKILL.md describe standard database migration workflows and installation via 'cargo install'. No evidence of malicious intent, data exfiltration, or prompt injection was found; the tool's requirement for database credentials is consistent with its stated purpose of data synchronization.
Capability Assessment
Purpose & Capability
Name/description (SurrealDB sync from various sources) matches the SKILL.md content: CLI usage, supported sources, CDC modes, and examples are exactly what you'd expect for a migration/sync tool.
Instruction Scope
SKILL.md gives concrete CLI examples and connection-string usage only; it does not instruct the agent to read unrelated system files or secret stores. Note: examples show credentials passed as command-line flags (e.g., --surreal-password), which can expose secrets via process listings or logs — this is a usability/security note rather than a scope mismatch.
Install Mechanism
The skill has no install specification and no code files (instruction-only). It suggests installing a Rust binary via 'cargo install surreal-sync', which is a plausible and proportional install step for a Rust CLI; the skill itself will not download or write code to disk automatically.
Credentials
No required environment variables, no unrelated credentials, and CLI examples require only the typical connection strings/credentials for the source DB and SurrealDB destination — all proportional to the stated purpose.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges or modification of other skills/configs. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install surreal-sync - After installation, invoke the skill by name or use
/surreal-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
surreal-sync v1.2.1
- No code or documentation changes detected in this release.
- Version bump only; functionality remains the same as previous version.
v1.2.0
No changes detected in this release.
- Version 1.2.0 contains no updates or modifications compared to the previous version.
v1.1.1
Sync to v1.1.1: upstream SHA updates, security hardening.
v1.0.6
- Updated metadata version in SKILL.md from "1.0.2" to "1.0.4".
- No changes to functionality or documentation content.
v1.0.3
- Added a comprehensive SKILL.md describing usage, supported sources, quick start examples, and key features.
- Documented full and incremental CDC sync support for MongoDB, PostgreSQL, MySQL, Neo4j, Kafka, and JSONL.
- Included detailed CLI usage patterns and configuration flags.
- Listed main features: automatic schema inference, record ID mapping, relationship extraction, checkpoint tracking, and deduplication.
- Linked to full documentation and upstream repository for further information.
Metadata
Frequently Asked Questions
What is surreal-sync?
Data migration and synchronization to SurrealDB from MongoDB, PostgreSQL, MySQL, Neo4j, Kafka, and JSONL. Full and incremental CDC sync. Part of the surreal-... It is an AI Agent Skill for Claude Code / OpenClaw, with 641 downloads so far.
How do I install surreal-sync?
Run "/install surreal-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is surreal-sync free?
Yes, surreal-sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does surreal-sync support?
surreal-sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created surreal-sync?
It is built and maintained by Basit Mustafa (@24601); the current version is v1.2.1.
More Skills