diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml new file mode 100644 index 0000000..ba08839 --- /dev/null +++ b/.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 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4fb0474 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +.venv/ +uv.lock +__pycache__/ diff --git a/README.md b/README.md index e19c34e..086e977 100644 --- a/README.md +++ b/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 +``` + ## Resources - [Agent Skills Specification](https://agentskills.io/specification) diff --git a/memgraph-cpp-query-modules/SKILL.md b/memgraph-cpp-query-modules/SKILL.md index 021071f..b0f06e7 100644 --- a/memgraph-cpp-query-modules/SKILL.md +++ b/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 diff --git a/memgraph-rust-query-modules/SKILL.md b/memgraph-rust-query-modules/SKILL.md index 6deee94..17d4d9c 100644 --- a/memgraph-rust-query-modules/SKILL.md +++ b/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" diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..529731c --- /dev/null +++ b/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", +]