From 62d82d05eba1a46532f45398be3a3e06b0e54d3e Mon Sep 17 00:00:00 2001 From: Jax Liu Date: Sat, 4 Apr 2026 23:46:30 +0800 Subject: [PATCH 1/2] chore(skills): bump wren-generate-mdl and wren-usage to v2.0, add version check Add version check sections to the new skills/ SKILL.md files and fix archive skills to point to skills/versions.json instead of skills-archive/versions.json. Co-Authored-By: Claude Opus 4.6 (1M context) --- skills-archive/wren-generate-mdl/SKILL.md | 2 +- skills-archive/wren-usage/SKILL.md | 2 +- skills/index.json | 4 ++-- skills/versions.json | 4 ++-- skills/wren-generate-mdl/SKILL.md | 18 +++++++++++++++++- skills/wren-usage/SKILL.md | 18 +++++++++++++++++- 6 files changed, 40 insertions(+), 8 deletions(-) diff --git a/skills-archive/wren-generate-mdl/SKILL.md b/skills-archive/wren-generate-mdl/SKILL.md index dda1c32b3..f8b011d14 100644 --- a/skills-archive/wren-generate-mdl/SKILL.md +++ b/skills-archive/wren-generate-mdl/SKILL.md @@ -12,7 +12,7 @@ metadata: ## Version check -Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills-archive/versions.json`. +Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills/versions.json`. Compare the `wren-generate-mdl` key with this skill's version (from the frontmatter above). If the remote version is newer, notify the user before proceeding: diff --git a/skills-archive/wren-usage/SKILL.md b/skills-archive/wren-usage/SKILL.md index 3c255317f..4b25573a8 100644 --- a/skills-archive/wren-usage/SKILL.md +++ b/skills-archive/wren-usage/SKILL.md @@ -11,7 +11,7 @@ metadata: ## Version check -Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills-archive/versions.json`. +Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills/versions.json`. Compare the `wren-usage` key with this skill's version (from the frontmatter above). If the remote version is newer, notify the user before proceeding: diff --git a/skills/index.json b/skills/index.json index 86257e20e..d71ce321e 100644 --- a/skills/index.json +++ b/skills/index.json @@ -7,7 +7,7 @@ "skills": [ { "name": "wren-generate-mdl", - "version": "1.0", + "version": "2.0", "description": "Generate a Wren MDL project by exploring a database with available tools (SQLAlchemy, database drivers, MCP connectors, or raw SQL). Guides agents through schema discovery, type normalization, and MDL YAML generation using the wren CLI.", "tags": [ "wren", @@ -26,7 +26,7 @@ }, { "name": "wren-usage", - "version": "1.0", + "version": "2.0", "description": "Wren Engine CLI workflow guide for AI agents. Answer data questions end-to-end using the wren CLI: gather schema context, recall past queries, write SQL through the MDL semantic layer, execute, and learn from confirmed results.", "tags": [ "wren", diff --git a/skills/versions.json b/skills/versions.json index da444f079..59521cfcc 100644 --- a/skills/versions.json +++ b/skills/versions.json @@ -1,4 +1,4 @@ { - "wren-generate-mdl": "1.0", - "wren-usage": "1.0" + "wren-generate-mdl": "2.0", + "wren-usage": "2.0" } diff --git a/skills/wren-generate-mdl/SKILL.md b/skills/wren-generate-mdl/SKILL.md index 32fff3173..ec699709d 100644 --- a/skills/wren-generate-mdl/SKILL.md +++ b/skills/wren-generate-mdl/SKILL.md @@ -4,11 +4,27 @@ description: "Generate a Wren MDL project by exploring a database with available license: Apache-2.0 metadata: author: wren-engine - version: "1.0" + version: "2.0" --- # Generate Wren MDL — CLI Agent Workflow +## Version check + +Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills/versions.json`. +Compare the `wren-generate-mdl` key with this skill's version (from the frontmatter above). +If the remote version is newer, notify the user before proceeding: + +> A newer version of the **wren-generate-mdl** skill is available. +> Update with: +> ``` +> npx skills add Canner/wren-engine --skill wren-generate-mdl --agent claude-code +> ``` + +Then continue with the workflow below regardless of update status. + +--- + Builds an MDL project by discovering database schema and converting it into Wren's YAML project format. The agent uses whatever database tools are available in its environment for introspection; the wren CLI handles diff --git a/skills/wren-usage/SKILL.md b/skills/wren-usage/SKILL.md index bb86997cb..d5e1f512a 100644 --- a/skills/wren-usage/SKILL.md +++ b/skills/wren-usage/SKILL.md @@ -4,11 +4,27 @@ description: "Wren Engine CLI workflow guide for AI agents. Answer data question license: Apache-2.0 metadata: author: wren-engine - version: "1.0" + version: "2.0" --- # Wren Engine CLI — Agent Workflow Guide +## Version check + +Silently fetch `https://raw.githubusercontent.com/Canner/wren-engine/main/skills/versions.json`. +Compare the `wren-usage` key with this skill's version (from the frontmatter above). +If the remote version is newer, notify the user before proceeding: + +> A newer version of the **wren-usage** skill is available. +> Update with: +> ``` +> npx skills add Canner/wren-engine --skill wren-usage --agent claude-code +> ``` + +Then continue with the workflow below regardless of update status. + +--- + The `wren` CLI queries databases through an MDL (Model Definition Language) semantic layer. You write SQL against model names, not raw tables. The engine translates to the target dialect. Two files drive everything (auto-discovered from `~/.wren/`): From 559d77f70c8226de12a51baae3ceea7f924054af Mon Sep 17 00:00:00 2001 From: Jax Liu Date: Sat, 4 Apr 2026 23:48:39 +0800 Subject: [PATCH 2/2] chore(skills-archive): bump wren-generate-mdl to 1.5, wren-usage to 1.3 Co-Authored-By: Claude Opus 4.6 (1M context) --- skills-archive/index.json | 4 ++-- skills-archive/versions.json | 4 ++-- skills-archive/wren-generate-mdl/SKILL.md | 2 +- skills-archive/wren-usage/SKILL.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/skills-archive/index.json b/skills-archive/index.json index 5b60731f6..c2e255f5d 100644 --- a/skills-archive/index.json +++ b/skills-archive/index.json @@ -20,7 +20,7 @@ }, { "name": "wren-generate-mdl", - "version": "1.4", + "version": "1.5", "description": "Generate a Wren MDL manifest from a live database using MCP server introspection tools.", "tags": [ "wren", @@ -114,7 +114,7 @@ }, { "name": "wren-usage", - "version": "1.2", + "version": "1.3", "description": "Wren Engine — semantic SQL engine for AI agents. Query 22+ data sources through a modeling layer. Main entry point for setup, SQL, MDL generation, and MCP server operations.", "tags": [ "wren", diff --git a/skills-archive/versions.json b/skills-archive/versions.json index 67b174e04..350401dda 100644 --- a/skills-archive/versions.json +++ b/skills-archive/versions.json @@ -1,10 +1,10 @@ { - "wren-generate-mdl": "1.4", + "wren-generate-mdl": "1.5", "wren-connection-info": "1.5", "wren-project": "1.5", "wren-sql": "1.0", "wren-mcp-setup": "1.4", "wren-quickstart": "1.3", "wren-http-api": "1.0", - "wren-usage": "1.2" + "wren-usage": "1.3" } diff --git a/skills-archive/wren-generate-mdl/SKILL.md b/skills-archive/wren-generate-mdl/SKILL.md index f8b011d14..838c80d55 100644 --- a/skills-archive/wren-generate-mdl/SKILL.md +++ b/skills-archive/wren-generate-mdl/SKILL.md @@ -5,7 +5,7 @@ compatibility: Requires a running ibis-server (default port 8000). No local data license: Apache-2.0 metadata: author: wren-engine - version: "1.4" + version: "1.5" --- # Generate Wren MDL diff --git a/skills-archive/wren-usage/SKILL.md b/skills-archive/wren-usage/SKILL.md index 4b25573a8..70c108c5c 100644 --- a/skills-archive/wren-usage/SKILL.md +++ b/skills-archive/wren-usage/SKILL.md @@ -4,7 +4,7 @@ description: "Wren Engine — semantic SQL engine for AI agents. Query 22+ data license: Apache-2.0 metadata: author: wren-engine - version: "1.2" + version: "1.3" --- # Wren Engine — Usage Guide