@vention/vention-skills 0.5.0 → 0.5.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vention",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/README.md

@@ -1,6 +1,6 @@
 # Vention skills
 
-Version 0.5.0. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
+Version 0.5.2. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
 
 | Skill                       | What it does                                                                                                                         |
 | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
@@ -30,7 +30,7 @@ vention skills install
 | Cursor, Copilot | `npm pack @vention/vention-skills`, then unpacks every skill the package holds into `.agents/skills` under your home directory or the project (per `--scope`), replacing those skills and leaving the rest untouched.                              |
 | Manual          | `npm pack @vention/vention-skills`, then copy `package/skills/<skill>` into your agent's skills directory.                                                                                                                                         |
 
-`vention skills status` lists every Vention skill on disk with its version.
+`vention skills status` lists every Vention skill on disk with its version, next to the latest version on npm. `vention skills update` updates every agent that has the skills: Claude Code through `claude plugin update vention@vention-skills`, Codex by rerunning its install, and Cursor and Copilot by unpacking the package again at the scope they were installed at. The `vention-machine-logic` and `vention-machine-logic-hmi` skills run this check at the start of each session.
 
 ## Verified installs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vention/vention-skills",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "license": "MIT",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "vention",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/skills/vention-design/SKILL.md

@@ -3,7 +3,7 @@ name: vention-design
 description: Create, build and edit Vention machine designs and design graphs for agentic layout. Use when the user wants to start a new design, lay out an automation cell, add or reposition components in a Vention design, generate a machine layout from a description, add or place a floor plan image under a design, list a design's versions, or inspect an existing design graph. Trigger on MachineBuilder designs, design graphs, assembly graphs, extrusions, actuators, robot mounting, cell footprints, floor plans, or a machine-builder URL.
 license: MIT
 metadata:
-  version: "0.5.0"
+  version: "0.5.2"
   author: Vention
 ---
 

package/skills/vention-machine-logic/SKILL.md

@@ -3,7 +3,7 @@ name: vention-machine-logic
 description: Write, edit, validate, and deploy MachineLogic Python applications for Vention machines with the machine-logic-sdk and the Vention CLI. Use when the user wants to program a Vention machine or MachineMotion controller, drive actuators, conveyors, robots, pneumatics, or digital I/O from Python, build a state machine for a cell, debug a failing application from its logs, or pull, push, or link an application with the Vention CLI (vention or vn). Trigger on MachineLogic, machine-logic-sdk, MachineMotion, MachineBuilder applications, or the Vention CLI, including inside a directory that holds .machine-code-app-directory-info.json. Do not use when the user has asked for no program at all and only wants an existing machine, its parts, or its configuration explained back to them in words; a read-only script that prints what the machine reports is still a program.
 license: MIT
 metadata:
-  version: "0.5.0"
+  version: "0.5.2"
   machine-logic-sdk: ">=3.0,<4"
   author: Vention
 ---
@@ -14,6 +14,8 @@ A MachineLogic application is a Python program that drives a Vention machine thr
 
 ## Before you start
 
+Once per session, before any other work, check for a newer version of the Vention skills: run `vention skills status`. If it says a newer version is available, run `vention skills update`, tell the user in one line (for example "Updated the Vention skills from 0.5.0 to 0.5.1."), then re-read this skill and any other Vention skill you use from the paths `vention skills status` now prints, and follow those for the rest of the session, because an agent does not reload a skill that changes on disk. If the check or the update fails (offline, npm unreachable, no `vention` command), say so in one line and carry on with the installed version.
+
 Work only inside a directory the Vention CLI has linked to an application. The marker is `.machine-code-app-directory-info.json` in the directory root.
 
 1. If the marker is missing, ask the user to run `vention pull` (downloads the application and its configuration) or `vention link` (attaches an existing folder) in that directory, or to give you the path of a directory that already has it. Never create the marker or an application layout by hand: `vention push` cannot round-trip a directory the CLI did not link.

package/skills/vention-machine-logic-hmi/SKILL.md

@@ -3,7 +3,7 @@ name: vention-machine-logic-hmi
 description: Build or edit the custom operator HMI of a MachineLogic application, the React touch screen in customui/ that runs in MachineBuilder and on the MachineMotion pendant, wired to the application's Python process through vention-communication. Use when the user asks for an operator screen, a custom HMI or UI, a touch panel, start and stop buttons, live machine state on screen, or recipes an operator picks, for a Vention machine or inside a directory holding .machine-code-app-directory-info.json. Uses @vention/machine-ui, @vention/machine-apps-components and @vention/machine-logic-ui-sdk. Do not use for the no-code HMI Builder, or for the Python motion logic alone (that is vention-machine-logic).
 license: MIT
 metadata:
-  version: "0.5.0"
+  version: "0.5.2"
   author: Vention
 ---
 
@@ -13,6 +13,8 @@ A custom HMI is a React app in `customui/` that an operator uses on a touch scre
 
 ## Before you start
 
+Once per session, before any other work, check for a newer version of the Vention skills: run `vention skills status`. If it says a newer version is available, run `vention skills update`, tell the user in one line (for example "Updated the Vention skills from 0.5.0 to 0.5.1."), then re-read this skill and any other Vention skill you use from the paths `vention skills status` now prints, and follow those for the rest of the session, because an agent does not reload a skill that changes on disk. If the check or the update fails (offline, npm unreachable, no `vention` command), say so in one line and carry on with the installed version.
+
 1. Work only in a directory the Vention CLI has linked: `.machine-code-app-directory-info.json` is in its root. If it is missing, ask the user to run `vention pull` or `vention link` there. Never create the marker by hand.
 2. Read `.vention-design-configuration.json` for device names, character for character, as the `vention-machine-logic` skill says.
 3. If `customui/` is missing, copy `package.json`, `buf.gen.yaml`, `tsconfig.json` and `index.html` from `examples/indexing-station-hmi/customui/`, rename the package, then write `src/`.

package/skills/vention-monitoring/SKILL.md

@@ -3,7 +3,7 @@ name: vention-monitoring
 description: Diagnose deployed Vention machines from controller state, history, health, and activity data. Use when the user reports a machine that is down, faulted, offline, slow, or underperforming, asks why a cycle time regressed, wants to interpret MachineMotion event data or drive and brake status, asks about OEE or uptime, or wants to know which machine in a fleet needs attention. Trigger on a MachineMotion serial number plus any complaint.
 license: MIT
 metadata:
-  version: "0.5.0"
+  version: "0.5.2"
   author: Vention
 ---