@vention/vention-skills 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "vention-skills",
+  "owner": {
+    "name": "Vention"
+  },
+  "metadata": {
+    "description": "Skills for coding agents that work with Vention machines: MachineLogic applications, machine designs, and fleet diagnostics."
+  },
+  "plugins": [
+    {
+      "name": "vention",
+      "source": {
+        "source": "npm",
+        "package": "@vention/vention-skills"
+      },
+      "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "vention",
+  "version": "0.1.0",
+  "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
+  "author": {
+    "name": "Vention"
+  },
+  "skills": "./skills",
+  "mcpServers": {
+    "vention": {
+      "type": "http",
+      "url": "https://mcp.vention.com/mcp"
+    }
+  }
+}

package/README.md

@@ -0,0 +1,61 @@
+# Vention skills
+
+Version 0.1.0. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
+
+| Skill                       | What it does                                                                                                                         |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `vention-machine-logic`     | Write, validate, and deploy MachineLogic Python applications with the `machine-logic-sdk` and the Vention CLI.                       |
+| `vention-machine-logic-hmi` | Build the custom operator HMI of a MachineLogic application on the Vention component libraries, wired through vention-communication. |
+| `vention-design`            | Create and edit Vention machine designs and design graphs through the Vention MCP server.                                            |
+| `vention-monitoring`        | Diagnose deployed machines from controller state, history, health, and activity data through the Vention MCP server.                 |
+
+## Install
+
+The plugin ships as the npm package `@vention/vention-skills`, listed in the `vention-skills` catalog at
+`https://assets.vention.com/vention-skills/marketplace.json`.
+
+Claude Code needs 2.1.277 or later: earlier versions run a plugin package's install scripts.
+
+The quickest route on any client is the Vention CLI:
+
+```bash
+npm install -g @vention/vention-cli
+vention skills install
+```
+
+| Client          | What `vention skills install` runs                                                                                                                                                                                                                 |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Claude Code     | `claude plugin marketplace add --scope <scope> <catalog URL>`, then `claude plugin install -y --scope <scope> vention@vention-skills`.                                                                                                             |
+| Codex           | Always installs for your user account (Codex has no project scope). Writes a catalog directory under your home directory holding the same npm entry, then runs `codex plugin marketplace add <dir>` and `codex plugin add vention@vention-skills`. |
+| 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.
+
+## Verified installs
+
+Checked by hand against the 0.1.0 package published to a throwaway local registry, before the HMI skill was added.
+
+| Client      | Version                              | Status                                                                                                                                                                       |
+| ----------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Claude Code | 2.1.267                              | unproven: the test machine's managed Claude Code policy only allows listed marketplaces, so it refused the local catalog URL                                                 |
+| Codex       | codex-cli 0.157.1                    | installed and loaded: the npm package landed in `plugins/cache/vention-skills/vention/0.1.0/skills/<skill>/SKILL.md` and all three skills appear in the prompt Codex renders |
+| Cursor      | 3.22.7                               | files installed in `.agents/skills`; client load not checked                                                                                                                 |
+| Copilot     | VS Code 1.114.0, Copilot Chat 0.42.3 | files installed in `.agents/skills`; client load not checked                                                                                                                 |
+| Manual      | npm 11.6.1                           | files installed: `npm pack` plus a copy into `.claude/skills`                                                                                                                |
+
+## Development
+
+Every change goes through the `vention-skills` project in `VentionCo/platform-products` (`projects/machine-code/libs/vention-skills`).
+
+- `npx nx build vention-skills` writes the package to `dist/projects/machine-code/libs/vention-skills/`, stamping the package version into both plugin manifests and every `SKILL.md`. That directory is the npm package root and the plugin root.
+- `npx nx test vention-skills` builds first, then checks the frontmatter, the relative paths each skill mentions, `claude plugin validate --strict`, an install from the built package, and pyright over the examples.
+- `npx nx lint vention-skills` lints the build and test sources.
+
+### Releasing
+
+The first version is published by hand, because npm only accepts a GitHub trusted publisher on a package that already exists. Until that publisher is set up, the project stays out of the `js-publishable` release group and CI neither tags nor publishes it. Once it rejoins the group, `nx release` reads the latest `vention-skills@<version>` tag, works out the next version from the conventional commits since it, tags it, creates a GitHub release, and publishes `dist/{projectRoot}` to npm through the `nx-release-publish` target default.
+
+The version in the committed `package.json` is only a starting point: the release run writes the new one there before building and never commits it.
+
+The marketplace file is served from the Vention CDN, not from npm. The `publish` target uploads the committed `.claude-plugin/marketplace.json` to the `vention-skills` bucket on every master build that touches this project. Watchtower then pins that upload in the devops repo, and a production promotion there makes it live at the URL above.

package/mcp.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "vention": {
+      "type": "streamable-http",
+      "url": "https://mcp.vention.com/mcp"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@vention/vention-skills",
+  "version": "0.1.0",
+  "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    ".claude-plugin",
+    "mcp.json",
+    "plugin.json",
+    "skills",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {}
+}

package/plugin.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "vention",
+  "version": "0.1.0",
+  "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
+  "author": {
+    "name": "Vention"
+  },
+  "homepage": "https://vention.io",
+  "license": "MIT",
+  "keywords": ["vention", "machinelogic", "machine-logic-sdk", "machinemotion", "machinebuilder", "robotics"]
+}