# Send surrealism to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "surrealism",
    "name": "surrealism",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/24601/surrealism",
    "canonicalUrl": "https://clawhub.ai/24601/surrealism",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/surrealism",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=surrealism",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "surrealism",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T05:47:19.662Z",
      "expiresAt": "2026-05-12T05:47:19.662Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=surrealism",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=surrealism",
        "contentDisposition": "attachment; filename=\"surrealism-1.2.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "surrealism"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/surrealism"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/surrealism",
    "downloadUrl": "https://openagent3.xyz/downloads/surrealism",
    "agentUrl": "https://openagent3.xyz/skills/surrealism/agent",
    "manifestUrl": "https://openagent3.xyz/skills/surrealism/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/surrealism/agent.md"
  }
}
```
## Documentation

### Surrealism -- WASM Extensions for SurrealDB

New in SurrealDB 3. Write custom functions in Rust, compile them to WebAssembly
(WASM), and deploy them as native database modules callable from SurrealQL.

### Prerequisites

Rust toolchain (stable) with wasm32-unknown-unknown target
SurrealDB CLI v3.0.0+ (surreal binary with surreal module subcommand)
Familiarity with SurrealQL DEFINE MODULE and DEFINE BUCKET

### Development Workflow

1. Annotate   -- surrealism.toml + #[surrealism] on Rust functions
2. Compile    -- surreal module compile  (produces .wasm binary)
3. Register   -- DEFINE BUCKET + DEFINE MODULE in SurrealQL

### Quick Start

# Create a new Surrealism project
cargo new --lib my_extension
cd my_extension

# Add the WASM target
rustup target add wasm32-unknown-unknown

# Create surrealism.toml (required manifest)
cat > surrealism.toml << 'TOML'
[package]
name = "my_extension"
version = "0.1.0"
TOML

# Write your extension (annotate with #[surrealism])
cat > src/lib.rs << 'RUST'
use surrealism::surrealism;

#[surrealism]
fn greet(name: String) -> String {
    format!("Hello, {}!", name)
}
RUST

# Compile to WASM using SurrealDB CLI
surreal module compile

# Register in SurrealDB
surreal sql --endpoint http://localhost:8000 --user root --pass root --ns test --db test

-- Grant access to the WASM file
DEFINE BUCKET my_bucket;

-- Register the module functions
DEFINE MODULE my_extension FROM 'my_bucket:my_extension.wasm';

-- Use the function in queries
SELECT my_extension::greet('World');

### Use Cases

Custom scalar functions callable from SurrealQL
Fake/mock data generation for testing
Domain-specific logic (language processing, quantitative finance, custom encoding)
Access to niche Rust crate functionality too specific for core SurrealDB
Custom analyzers for full-text search

### Status

Surrealism is actively in development and not yet stable. The API may change
between SurrealDB 3.x releases. File feedback via GitHub issues/PRs on the
surrealdb/surrealdb repository.

### Full Documentation

See the main skill's rule file for complete guidance:

rules/surrealism.md -- project setup, Rust function signatures, WASM compilation, DEFINE MODULE/BUCKET syntax, deployment, testing, and best practices
SurrealDB Extensions Docs -- official documentation
CLI module command -- surreal module reference
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 24601
- Version: 1.2.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T05:47:19.662Z
- Expires at: 2026-05-12T05:47:19.662Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/surrealism)
- [Send to Agent page](https://openagent3.xyz/skills/surrealism/agent)
- [JSON manifest](https://openagent3.xyz/skills/surrealism/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/surrealism/agent.md)
- [Download page](https://openagent3.xyz/downloads/surrealism)