From c18ac6a8f65e1e28449096964e91a0bbe6c7304e Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:50:18 +0000 Subject: [PATCH 1/5] feat: restructure .claude skills and add plugin marketplace support - Move SKILL.md to .claude/skills/vlmrun-cli-skill/SKILL.md - Add .claude-plugin/marketplace.json for remote skill installation - Add .claude-plugin/plugin.json with plugin metadata Co-Authored-By: Sudeep Pillai --- .claude-plugin/marketplace.json | 18 +++++++++++++++ .claude-plugin/plugin.json | 22 +++++++++++++++++++ .../{ => skills/vlmrun-cli-skill}/SKILL.md | 0 3 files changed, 40 insertions(+) create mode 100644 .claude-plugin/marketplace.json create mode 100644 .claude-plugin/plugin.json rename .claude/{ => skills/vlmrun-cli-skill}/SKILL.md (100%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..49db3b6 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,18 @@ +{ + "name": "vlmrun-cli-skill", + "owner": { + "name": "VLM Run" + }, + "metadata": { + "description": "Agent Skills for visual AI tasks including image understanding, video processing, document extraction, and multi-modal generation using VLM Run's Orion agent", + "version": "1.0.0" + }, + "plugins": [ + { + "name": "vlmrun-cli-skill", + "source": "./skills/vlmrun-cli-skill", + "skills": "./", + "description": "Use the VLM Run CLI to interact with Orion visual AI agent. Process images, videos, and documents with natural language. Supports image understanding/generation, object detection, OCR, video summarization, document extraction, and visual AI chat." + } + ] +} diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..2d8e0cc --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,22 @@ +{ + "name": "vlmrun-cli-skill", + "description": "Agent Skills for visual AI tasks including image understanding, video processing, document extraction, and multi-modal generation using VLM Run's Orion agent", + "version": "1.0.0", + "author": { + "name": "VLM Run" + }, + "homepage": "https://vlm.run", + "repository": "https://github.com/vlm-run/vlmrun-python-sdk", + "license": "Apache-2.0", + "keywords": [ + "vlmrun", + "visual-ai", + "image-understanding", + "video-processing", + "document-extraction", + "ocr", + "image-generation", + "video-generation", + "multi-modal" + ] +} diff --git a/.claude/SKILL.md b/.claude/skills/vlmrun-cli-skill/SKILL.md similarity index 100% rename from .claude/SKILL.md rename to .claude/skills/vlmrun-cli-skill/SKILL.md From c4b26b2a9a4955a2fc48af4e2918260bfae4b47f Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:52:20 +0000 Subject: [PATCH 2/5] fix: sort JSON keys alphabetically and apply black formatting Co-Authored-By: Sudeep Pillai --- .claude-plugin/marketplace.json | 12 ++++++------ .claude-plugin/plugin.json | 12 ++++++------ vlmrun/cli/_cli/chat.py | 3 ++- 3 files changed, 14 insertions(+), 13 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 49db3b6..0f5c3ff 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,18 +1,18 @@ { - "name": "vlmrun-cli-skill", - "owner": { - "name": "VLM Run" - }, "metadata": { "description": "Agent Skills for visual AI tasks including image understanding, video processing, document extraction, and multi-modal generation using VLM Run's Orion agent", "version": "1.0.0" }, + "name": "vlmrun-cli-skill", + "owner": { + "name": "VLM Run" + }, "plugins": [ { + "description": "Use the VLM Run CLI to interact with Orion visual AI agent. Process images, videos, and documents with natural language. Supports image understanding/generation, object detection, OCR, video summarization, document extraction, and visual AI chat.", "name": "vlmrun-cli-skill", - "source": "./skills/vlmrun-cli-skill", "skills": "./", - "description": "Use the VLM Run CLI to interact with Orion visual AI agent. Process images, videos, and documents with natural language. Supports image understanding/generation, object detection, OCR, video summarization, document extraction, and visual AI chat." + "source": "../.claude/skills/vlmrun-cli-skill" } ] } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 2d8e0cc..48dedfb 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,13 +1,9 @@ { - "name": "vlmrun-cli-skill", - "description": "Agent Skills for visual AI tasks including image understanding, video processing, document extraction, and multi-modal generation using VLM Run's Orion agent", - "version": "1.0.0", "author": { "name": "VLM Run" }, + "description": "Agent Skills for visual AI tasks including image understanding, video processing, document extraction, and multi-modal generation using VLM Run's Orion agent", "homepage": "https://vlm.run", - "repository": "https://github.com/vlm-run/vlmrun-python-sdk", - "license": "Apache-2.0", "keywords": [ "vlmrun", "visual-ai", @@ -18,5 +14,9 @@ "image-generation", "video-generation", "multi-modal" - ] + ], + "license": "Apache-2.0", + "name": "vlmrun-cli-skill", + "repository": "https://github.com/vlm-run/vlmrun-python-sdk", + "version": "1.0.0" } diff --git a/vlmrun/cli/_cli/chat.py b/vlmrun/cli/_cli/chat.py index 4b178b5..026f183 100644 --- a/vlmrun/cli/_cli/chat.py +++ b/vlmrun/cli/_cli/chat.py @@ -499,7 +499,8 @@ def chat( ), skill_dirs: Optional[List[Path]] = typer.Option( None, - "--skill", "-k", + "--skill", + "-k", help=( "Path to a skill directory (must contain SKILL.md). Repeatable. " "The skill is sent inline with the request (no server-side upload). " From 07b6b05050e745f312915b68d0206eab442a4948 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:54:36 +0000 Subject: [PATCH 3/5] docs: add Claude Code plugin marketplace installation instructions to README Co-Authored-By: Sudeep Pillai --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/README.md b/README.md index b923e2d..7830e2c 100644 --- a/README.md +++ b/README.md @@ -136,6 +136,35 @@ vlmrun chat "Analyze this invoice" -i invoice.pdf -k ./accounting-skills/ -k ./i To create a persistent server-side skill, use `vlmrun skills upload ./my-skill/`. +### Claude Code + +Install the VLM Run CLI skill directly in [Claude Code](https://docs.anthropic.com/en/docs/claude-code) via the plugin marketplace: + +1. Register the repository as a plugin marketplace: + +``` +/plugin marketplace add vlm-run/vlmrun-python-sdk +``` + +2. Install the skill: + +``` +/plugin install vlmrun-cli-skill@vlm-run/vlmrun-python-sdk +``` + +3. Set up your environment variables by creating an `.env` file with your API key from [app.vlm.run](https://app.vlm.run): + +```bash +VLMRUN_API_KEY= +VLMRUN_BASE_URL=https://api.vlm.run/v1 +``` + +4. Verify the skill is loaded by asking Claude Code (requires restart): + +``` +What skills are available in the /vlmrun-cli-skill? +``` + ## 🔗 Quick Links * 💬 Need help? Email us at [support@vlm.run](mailto:support@vlm.run) or join our [Discord](https://discord.gg/AMApC2UzVY) From c7d4ad85d059baee5a3967111bb35753b3c480b0 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:58:51 +0000 Subject: [PATCH 4/5] docs: use vlmrun config CLI instead of .env file for setup Co-Authored-By: Sudeep Pillai --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 7830e2c..e59ae7c 100644 --- a/README.md +++ b/README.md @@ -152,11 +152,13 @@ Install the VLM Run CLI skill directly in [Claude Code](https://docs.anthropic.c /plugin install vlmrun-cli-skill@vlm-run/vlmrun-python-sdk ``` -3. Set up your environment variables by creating an `.env` file with your API key from [app.vlm.run](https://app.vlm.run): +3. Configure your API key and base URL using the CLI (get your key from [app.vlm.run](https://app.vlm.run)): ```bash -VLMRUN_API_KEY= -VLMRUN_BASE_URL=https://api.vlm.run/v1 +vlmrun config init +vlmrun config set VLMRUN_API_KEY +vlmrun config set VLMRUN_BASE_URL https://api.vlm.run/v1 +vlmrun config show ``` 4. Verify the skill is loaded by asking Claude Code (requires restart): From 42689bdb567886a2c16c3cfa7b7714fc01f89ced Mon Sep 17 00:00:00 2001 From: Sudeep Pillai Date: Wed, 18 Mar 2026 15:02:38 -0700 Subject: [PATCH 5/5] Update CLI configuration commands in README --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index e59ae7c..c1e4b90 100644 --- a/README.md +++ b/README.md @@ -156,8 +156,7 @@ Install the VLM Run CLI skill directly in [Claude Code](https://docs.anthropic.c ```bash vlmrun config init -vlmrun config set VLMRUN_API_KEY -vlmrun config set VLMRUN_BASE_URL https://api.vlm.run/v1 +vlmrun config set --api-key vlmrun config show ```