From bb0b626caba1b177a5b296f5d3981c2a40756751 Mon Sep 17 00:00:00 2001
From: Dandan7 <182233217+danshalev7@users.noreply.github.com>
Date: Mon, 23 Mar 2026 18:09:45 +0200
Subject: [PATCH 1/6] Create skills.md for FalkorDB Agent Skill documentation

Added documentation for FalkorDB skills, including usage instructions and examples.
---
 genai-tools/skills.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 genai-tools/skills.md

diff --git a/genai-tools/skills.md b/genai-tools/skills.md
new file mode 100644
index 00000000..b0991276
--- /dev/null
+++ b/genai-tools/skills.md
@@ -0,0 +1,25 @@
+---
+title: "Skills"
+nav_order: 7
+description: "Practical FalkorDB guidance packaged as an Agent Skill. Give your AI coding assistant deep knowledge of FalkorDB -- Cypher queries, user-defined functions, Docker operations, indexing, and more."
+---
+
+# FalkorDB Skills
+
+[FalkorDB Skills](https://github.com/FalkorDB/skills) is an [Agent Skill](https://agentskills.io) that gives your AI coding assistant accurate, up-to-date knowledge of FalkorDB. It covers **27 runnable examples** across three categories:
+
+- **Cypher** (16 skills) -- node/relationship CRUD, MERGE, parameterized queries, EXPLAIN/PROFILE, range/full-text/vector indexes, constraints, and known limitations
+- **UDFs** (5 skills) -- load, call, list, and delete JavaScript user-defined function libraries
+- **Docker Ops** (6 skills) -- run FalkorDB with browser UI, server-only mode, authentication, module config, and Docker Compose
+
+#### Usage
+
+Clone the repo into your project and point your AI assistant at SKILL.md:
+
+```bash
+git clone https://github.com/FalkorDB/skills.git .falkordb-skills
+```
+
+Or download `SKILL.md` directly and load it into any LLM context window.
+
+For more details, see the [full README](https://github.com/FalkorDB/skills).

From fc915d5c9aee36d499060456cead88a66e51f6b7 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 21 Apr 2026 17:52:20 +0300
Subject: [PATCH 2/6] docs(skills): fix heading level, clarify clone target,
 allow 'runnable'

Addresses CodeRabbit review feedback on PR #399:
- Promote 'Usage' from h4 to h2 to keep heading levels sequential
- Use a visible directory name 'falkordb-skills' (and 'repository' wording)
  in the git clone example instead of the hidden '.falkordb-skills'
- Add 'runnable' to .wordlist.txt to satisfy the spellcheck CI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .wordlist.txt         | 1 +
 genai-tools/skills.md | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.wordlist.txt b/.wordlist.txt
index 8786d40f..ab1dd0ab 100644
--- a/.wordlist.txt
+++ b/.wordlist.txt
@@ -293,6 +293,7 @@ replaceRegEx
 rgraph
 rueidis
 runtime
+runnable
 rustis
 sbin
 selectGraph
diff --git a/genai-tools/skills.md b/genai-tools/skills.md
index b0991276..3cbe93ea 100644
--- a/genai-tools/skills.md
+++ b/genai-tools/skills.md
@@ -12,12 +12,12 @@ description: "Practical FalkorDB guidance packaged as an Agent Skill. Give your
 - **UDFs** (5 skills) -- load, call, list, and delete JavaScript user-defined function libraries
 - **Docker Ops** (6 skills) -- run FalkorDB with browser UI, server-only mode, authentication, module config, and Docker Compose
 
-#### Usage
+## Usage
 
-Clone the repo into your project and point your AI assistant at SKILL.md:
+Clone the repository into your project and point your AI assistant at SKILL.md:
 
 ```bash
-git clone https://github.com/FalkorDB/skills.git .falkordb-skills
+git clone https://github.com/FalkorDB/skills.git falkordb-skills
 ```
 
 Or download `SKILL.md` directly and load it into any LLM context window.

From 392f9b4823df22a34643246addef2b75fbdd9cb2 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 21 Apr 2026 18:03:45 +0300
Subject: [PATCH 3/6] Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 genai-tools/skills.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/genai-tools/skills.md b/genai-tools/skills.md
index 3cbe93ea..3b71579e 100644
--- a/genai-tools/skills.md
+++ b/genai-tools/skills.md
@@ -1,5 +1,6 @@
 ---
 title: "Skills"
+parent: "GenAI Tools"
 nav_order: 7
 description: "Practical FalkorDB guidance packaged as an Agent Skill. Give your AI coding assistant deep knowledge of FalkorDB -- Cypher queries, user-defined functions, Docker operations, indexing, and more."
 ---

From 243978cf5ad6c3c624e508f5bdc882096fa12705 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 21 Apr 2026 18:03:59 +0300
Subject: [PATCH 4/6] Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 genai-tools/skills.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/genai-tools/skills.md b/genai-tools/skills.md
index 3b71579e..16b8e3b0 100644
--- a/genai-tools/skills.md
+++ b/genai-tools/skills.md
@@ -1,5 +1,5 @@
 ---
-title: "Skills"
+title: "FalkorDB Skills"
 parent: "GenAI Tools"
 nav_order: 7
 description: "Practical FalkorDB guidance packaged as an Agent Skill. Give your AI coding assistant deep knowledge of FalkorDB -- Cypher queries, user-defined functions, Docker operations, indexing, and more."

From 5e9b7960d8afcd89ac0f2fc173154c75fcdf0b23 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 21 Apr 2026 18:04:08 +0300
Subject: [PATCH 5/6] Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 genai-tools/skills.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/genai-tools/skills.md b/genai-tools/skills.md
index 16b8e3b0..5b2febc1 100644
--- a/genai-tools/skills.md
+++ b/genai-tools/skills.md
@@ -1,7 +1,7 @@
 ---
 title: "FalkorDB Skills"
 parent: "GenAI Tools"
-nav_order: 7
+nav_order: 8
 description: "Practical FalkorDB guidance packaged as an Agent Skill. Give your AI coding assistant deep knowledge of FalkorDB -- Cypher queries, user-defined functions, Docker operations, indexing, and more."
 ---
 

From cdd725cb8d514c4c689c063be2ed5ce2aefb90d6 Mon Sep 17 00:00:00 2001
From: Guy Korland <gkorland@gmail.com>
Date: Tue, 21 Apr 2026 18:04:49 +0300
Subject: [PATCH 6/6] docs(genai-tools): link Skills page from section index

Add a 'Skills' entry to the 'Topics in This Section' list in
genai-tools/index.md so readers can discover the new skills.md
page from the GenAI Tools landing page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 genai-tools/index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/genai-tools/index.md b/genai-tools/index.md
index 9e9295c0..d0ef99b4 100644
--- a/genai-tools/index.md
+++ b/genai-tools/index.md
@@ -27,3 +27,4 @@ FalkorDB provides powerful tools and integrations for building intelligent GenAI
 - [FalkorDB MCP Server](./mcpserver/): Enable AI assistants like Claude to interact with FalkorDB using the Model Context Protocol.
 - [QueryWeaver](./queryweaver.md): Open-source Text2SQL tool that converts plain-English questions into SQL using graph-powered schema understanding.
 - [Code-Graph](./code-graph.md): Visualize codebases as knowledge graphs to analyze dependencies, detect bottlenecks, and query code structure.
+- [Skills](./skills.md): Agent Skill that gives AI coding assistants accurate, runnable knowledge of FalkorDB across Cypher, UDFs, and Docker operations.