From 12615226e41b8f9a4343031fce7fee3b18ed31e0 Mon Sep 17 00:00:00 2001
From: Gal Shubeli <gal.shubeli@falkordb.com>
Date: Mon, 8 Jun 2026 12:59:26 +0300
Subject: [PATCH] fix: correct FalkorDB cypher.txt import guidance

The no-push 'graphify export falkordb' path advertised
'redis-cli -x GRAPH.QUERY graphify < cypher.txt', but FalkorDB rejects that
with 'query with more than one statement is not supported' - cypher.txt is a
multi-statement Neo4j script. The individual statements ARE valid OpenCypher
(verified by loading them one at a time), only bulk script import is unsupported.

Message + skill docs now say so and point to --push (the verified load path).
---
 graphify/__main__.py                                        | 6 ++++--
 graphify/skills/amp/references/exports.md                   | 2 +-
 graphify/skills/claude/references/exports.md                | 2 +-
 graphify/skills/claw/references/exports.md                  | 2 +-
 graphify/skills/codex/references/exports.md                 | 2 +-
 graphify/skills/copilot/references/exports.md               | 2 +-
 graphify/skills/droid/references/exports.md                 | 2 +-
 graphify/skills/kilo/references/exports.md                  | 2 +-
 graphify/skills/kiro/references/exports.md                  | 2 +-
 graphify/skills/opencode/references/exports.md              | 2 +-
 graphify/skills/pi/references/exports.md                    | 2 +-
 graphify/skills/trae/references/exports.md                  | 2 +-
 graphify/skills/vscode/references/exports.md                | 2 +-
 graphify/skills/windows/references/exports.md               | 2 +-
 .../expected/graphify__skills__amp__references__exports.md  | 2 +-
 .../graphify__skills__claude__references__exports.md        | 2 +-
 .../expected/graphify__skills__claw__references__exports.md | 2 +-
 .../graphify__skills__codex__references__exports.md         | 2 +-
 .../graphify__skills__copilot__references__exports.md       | 2 +-
 .../graphify__skills__droid__references__exports.md         | 2 +-
 .../expected/graphify__skills__kilo__references__exports.md | 2 +-
 .../expected/graphify__skills__kiro__references__exports.md | 2 +-
 .../graphify__skills__opencode__references__exports.md      | 2 +-
 .../expected/graphify__skills__pi__references__exports.md   | 2 +-
 .../expected/graphify__skills__trae__references__exports.md | 2 +-
 .../graphify__skills__vscode__references__exports.md        | 2 +-
 .../graphify__skills__windows__references__exports.md       | 2 +-
 tools/skillgen/fragments/references/shared/exports.md       | 2 +-
 28 files changed, 31 insertions(+), 29 deletions(-)

diff --git a/graphify/__main__.py b/graphify/__main__.py
index bbf88b3..cef0da4 100644
--- a/graphify/__main__.py
+++ b/graphify/__main__.py
@@ -3639,8 +3639,10 @@ def main() -> None:
             else:
                 from graphify.export import to_cypher as _to_cypher
                 _to_cypher(G, str(out_dir / "cypher.txt"))
-                print(f"cypher.txt written - FalkorDB is OpenCypher-compatible; "
-                      f"import with: redis-cli -x GRAPH.QUERY graphify < {out_dir}/cypher.txt")
+                print(f"cypher.txt written ({out_dir}/cypher.txt) - statements are OpenCypher. "
+                      f"FalkorDB's GRAPH.QUERY runs one statement at a time (no bulk script "
+                      f"import), so load a graph with: graphify export falkordb --push "
+                      f"falkordb://localhost:6379")
 
     elif cmd == "benchmark":
         from graphify.benchmark import run_benchmark, print_benchmark
diff --git a/graphify/skills/amp/references/exports.md b/graphify/skills/amp/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/amp/references/exports.md
+++ b/graphify/skills/amp/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/claude/references/exports.md b/graphify/skills/claude/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/claude/references/exports.md
+++ b/graphify/skills/claude/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/claw/references/exports.md b/graphify/skills/claw/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/claw/references/exports.md
+++ b/graphify/skills/claw/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/codex/references/exports.md b/graphify/skills/codex/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/codex/references/exports.md
+++ b/graphify/skills/codex/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/copilot/references/exports.md b/graphify/skills/copilot/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/copilot/references/exports.md
+++ b/graphify/skills/copilot/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/droid/references/exports.md b/graphify/skills/droid/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/droid/references/exports.md
+++ b/graphify/skills/droid/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/kilo/references/exports.md b/graphify/skills/kilo/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/kilo/references/exports.md
+++ b/graphify/skills/kilo/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/kiro/references/exports.md b/graphify/skills/kiro/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/kiro/references/exports.md
+++ b/graphify/skills/kiro/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/opencode/references/exports.md b/graphify/skills/opencode/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/opencode/references/exports.md
+++ b/graphify/skills/opencode/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/pi/references/exports.md b/graphify/skills/pi/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/pi/references/exports.md
+++ b/graphify/skills/pi/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/trae/references/exports.md b/graphify/skills/trae/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/trae/references/exports.md
+++ b/graphify/skills/trae/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/vscode/references/exports.md b/graphify/skills/vscode/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/vscode/references/exports.md
+++ b/graphify/skills/vscode/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/graphify/skills/windows/references/exports.md b/graphify/skills/windows/references/exports.md
index 5c357d3..1c5d8c0 100644
--- a/graphify/skills/windows/references/exports.md
+++ b/graphify/skills/windows/references/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__amp__references__exports.md b/tools/skillgen/expected/graphify__skills__amp__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__amp__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__amp__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__claude__references__exports.md b/tools/skillgen/expected/graphify__skills__claude__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__claude__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__claude__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__claw__references__exports.md b/tools/skillgen/expected/graphify__skills__claw__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__claw__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__claw__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__codex__references__exports.md b/tools/skillgen/expected/graphify__skills__codex__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__codex__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__codex__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__copilot__references__exports.md b/tools/skillgen/expected/graphify__skills__copilot__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__copilot__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__copilot__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__droid__references__exports.md b/tools/skillgen/expected/graphify__skills__droid__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__droid__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__droid__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__kilo__references__exports.md b/tools/skillgen/expected/graphify__skills__kilo__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__kilo__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__kilo__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__kiro__references__exports.md b/tools/skillgen/expected/graphify__skills__kiro__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__kiro__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__kiro__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__opencode__references__exports.md b/tools/skillgen/expected/graphify__skills__opencode__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__opencode__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__opencode__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__pi__references__exports.md b/tools/skillgen/expected/graphify__skills__pi__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__pi__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__pi__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__trae__references__exports.md b/tools/skillgen/expected/graphify__skills__trae__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__trae__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__trae__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__vscode__references__exports.md b/tools/skillgen/expected/graphify__skills__vscode__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__vscode__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__vscode__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/expected/graphify__skills__windows__references__exports.md b/tools/skillgen/expected/graphify__skills__windows__references__exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/expected/graphify__skills__windows__references__exports.md
+++ b/tools/skillgen/expected/graphify__skills__windows__references__exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb
diff --git a/tools/skillgen/fragments/references/shared/exports.md b/tools/skillgen/fragments/references/shared/exports.md
index 5c357d3..1c5d8c0 100644
--- a/tools/skillgen/fragments/references/shared/exports.md
+++ b/tools/skillgen/fragments/references/shared/exports.md
@@ -30,7 +30,7 @@ Default URI is `bolt://localhost:7687`, default user is `neo4j`. Uses MERGE - sa
 
 ### Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag)
 
-**If `--falkordb`** - generate a Cypher file (FalkorDB is OpenCypher-compatible, so the same `cypher.txt` imports cleanly):
+**If `--falkordb`** - generate a Cypher file. The statements are OpenCypher, but FalkorDB's `GRAPH.QUERY` runs one statement at a time (no bulk script import like Neo4j's `cypher-shell`), so prefer `--falkordb-push` to load a graph. Use this only when you want the portable `cypher.txt` artifact:
 
 ```bash
 graphify export falkordb