feat: add skill-ref validation

.github/workflows/validate.yml

@@ -0,0 +1,30 @@
+name: Validate Skills
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Validate skills
+        run: |
+          for skill in */SKILL.md; do
+            skill_dir=$(dirname "$skill")
+            echo "Validating $skill_dir..."
+            uv run skills-ref validate "$skill_dir"
+          done

.gitignore

@@ -0,0 +1,3 @@
+.venv/
+uv.lock
+__pycache__/

README.md

@@ -39,6 +39,15 @@ skill-name/
     └── REFERENCE.md      # Detailed API reference and examples
 ```
 
+## Validation
+
+Skills are validated against the [Agent Skills specification](https://agentskills.io/specification#validation) using [skills-ref](https://github.com/agentskills/agentskills/tree/main/skills-ref):
+
+```bash
+uv sync
+uv run skills-ref validate <skill-directory>
+```
+
 ## Resources
 
 - [Agent Skills Specification](https://agentskills.io/specification)

memgraph-cpp-query-modules/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: memgraph-cpp-query-modules
 description: Develop custom query modules in C++ for Memgraph graph database. Use when creating high-performance graph algorithms, procedures (ProcedureType::Read/Write), or functions using the mgp.hpp C++ API. Covers compilation, memory management, graph traversal, and module deployment.
-compatibility: Requires Memgraph instance. Quick dev: Clang, CMake Production: memgraph/mgbuild container with toolchain v7. C++20 required.
+compatibility: "Requires Memgraph instance. Quick dev: Clang, CMake Production: memgraph/mgbuild container with toolchain v7. C++20 required."
 metadata:
   version: "0.0.1"
   author: memgraph

memgraph-rust-query-modules/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: memgraph-rust-query-modules
 description: Develop custom query modules in Rust for Memgraph graph database. Use when user asks to create Rust procedures, implement graph algorithms in Rust, build high-performance query modules, or work with the rsmgp-sys Rust API. Covers module structure, compilation with Cargo, graph traversal, vertex/edge operations, and deployment to Memgraph.
-compatibility: Requires Memgraph instance. Build with memgraph/mgbuild container with toolchain v7 (Rust 1.80 pre-installed).
+compatibility: "Requires Memgraph instance. Build with memgraph/mgbuild container with toolchain v7 (Rust 1.80 pre-installed)."
 metadata:
   author: memgraph
   version: "0.0.1"

pyproject.toml

@@ -0,0 +1,10 @@
+[project]
+name = "memgraph-skills"
+version = "0.1.0"
+description = "Memgraph Agent Skills"
+requires-python = ">=3.11"
+
+[tool.uv]
+dev-dependencies = [
+    "skills-ref @ git+https://github.com/agentskills/agentskills.git#subdirectory=skills-ref",
+]