@vatio-ai/skills 1.5.0 → 1.7.0

package/.claude-plugin/marketplace.json

@@ -5,7 +5,7 @@
     {
       "name": "vatio",
       "source": "./",
-      "description": "Build a Vatio agent from your coding agent, then fix what supervisors flag and prove it with evals."
+      "description": "Build a Vatio agent from your coding agent, then fix what supervisors report and prove it with evals."
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vatio",
-  "description": "Build a Vatio agent from your coding agent, then fix what supervisors flag and prove it with evals.",
-  "version": "1.5.0",
+  "description": "Build a Vatio agent from your coding agent, then fix what supervisors report and prove it with evals.",
+  "version": "1.7.0",
   "author": { "name": "Vatio", "url": "https://vatio.ai" },
   "homepage": "https://vatio.ai/docs",
   "repository": "https://github.com/vatio-ai/skills",

package/README.md

@@ -5,7 +5,7 @@ Skills for the coding agent working on your [Vatio](https://vatio.ai) agent.
 | Skill | What it does |
 |---|---|
 | `vatio-init` | The first one in a project: looks at what is already there (a `vatio.yml` anywhere in the repository, the app's code) and recommends from it. With no agent yet, builds one: asks the owner what the code does not answer, writes `vatio.yml`, pushes it and hands over a link to try. With one, gets a developer who joined the project up to speed |
-| `vatio-improve` | Works through the replies your supervisors flagged in the inbox: reads `vatio flags`, fixes each cause on a branch, proves it with `vatio eval`, and opens a pull request |
+| `vatio-improve` | Takes every reply your supervisors reported in the inbox in one session: reads `vatio flags`, fixes each cause, `vatio push`, proves it with `vatio eval` (in the background in Claude Code) and publishes with `vatio publish` |
 | `vatio-share-session` | Sends the Claude Code session to the Vatio team when you ask it to, or offers to when the other two finish (send it, not now, or don't ask again), after showing you what goes (images left out, anything that looks like a secret redacted), with your feedback if you want to add some |
 
 The skills are short on purpose. They tell your coding agent when to reach for
@@ -38,6 +38,10 @@ Or in Claude Code, as a plugin:
 /plugin install vatio@vatio
 ```
 
+Claude Code does not update plugins from other people's marketplaces on its own:
+turn it on once in `/plugin` → **Marketplaces** → **vatio** → **Enable
+auto-update**, or run `claude plugin update vatio@vatio`.
+
 Your agent then uses them on its own when you ask it to build, improve or fix
 a Vatio agent, or to send the session to Vatio, or you can call them by name:
 `/vatio-init`, `/vatio-improve` and `/vatio-share-session`, or

package/bin/install.mjs

@@ -4,7 +4,7 @@
 //   .agents/skills/   Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Cline, Amp
 //   .claude/skills/   Claude Code, which does not read .agents/
 // Running it again overwrites the copies with this version's.
-import { cpSync, existsSync, readFileSync, readdirSync, rmSync } from "node:fs";
+import { cpSync, existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -35,6 +35,10 @@ if (!existsSync(root)) {
 }
 
 const source = join(dirname(fileURLToPath(import.meta.url)), "..", "skills");
+// Left next to each copy, so `vatio flags` can tell a project whose copies are
+// older than the published skills (cli/lib/skills-hint.mjs).
+const VERSION_FILE = ".vatio-skills-version";
+const { version } = JSON.parse(readFileSync(join(source, "..", "package.json"), "utf8"));
 // Skills this package used to ship under another name. Left in place, the old
 // copy would answer the same requests as the new one.
 const RENAMED = { "vatio-new": "vatio-init" };
@@ -46,6 +50,7 @@ for (const target of [".agents/skills", ".claude/skills"]) {
   for (const skill of skills) {
     const dest = join(root, target, skill);
     cpSync(join(source, skill), dest, { recursive: true, force: true });
+    writeFileSync(join(dest, VERSION_FILE), `${version}\n`);
     console.log(`  ${relative(process.cwd(), join(dest, "SKILL.md")) || dest}`);
   }
   for (const [old, current] of Object.entries(RENAMED)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vatio-ai/skills",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Agent skills for building and improving a Vatio agent from your coding agent: Claude Code, Codex, Cursor, Gemini CLI, Copilot and any agent that reads SKILL.md",
   "keywords": [
     "vatio",

package/skills/vatio-improve/SKILL.md

@@ -1,44 +1,44 @@
 ---
 name: vatio-improve
-description: Improve a Vatio agent from what its supervisors flagged. Use when asked to improve, fix or debug a Vatio agent, to work through flagged replies or wrong answers in production, or when a GitHub issue labelled vatio-flags arrives. Works in any directory with a vatio.yml.
+description: Improve a Vatio agent from what its supervisors reported. Use when asked to improve, fix or debug a Vatio agent, to work through reported or flagged replies or wrong answers in production, or when the daily Vatio email says there are open reports. Works in any directory with a vatio.yml.
 ---
 
-# Improve a Vatio agent from its flags
+# Improve a Vatio agent from its reports
 
-Supervisors flag wrong replies in the Vatio inbox and write what should have
-happened: a different answer, an action, or a tool the agent should have used
-or does not have. Vatio keeps the instructions for working them on the
-platform, so they are never out of date here. Start by reading them:
+Supervisors report wrong replies in the Vatio inbox and write what it should
+have said: a different answer, an action, or a tool the agent should have
+used or does not have. One session takes every open report. Vatio keeps the
+instructions for working them on the platform, so they are never out of date
+here. Start by reading them:
 
 ```bash
 vatio flags
 ```
 
 Run it from the directory with the workspace's `vatio.yml` (or below it). It
-prints every open flag — the conversation, each tool call with what the
+prints every open report — the conversation, each tool call with what the
 backend answered, and the supervisor's note — with how to work them at the
 top. Follow those instructions; they take precedence over anything below.
 
 In short:
 
-1. Group the flags by cause, and fix each cause where it lives: `vatio.yml`,
-   a knowledge entry, a tool, or the backend a tool calls. `vatio tools --env
-   live` shows each tool's error rate, timeouts and latency across every
-   conversation, and the calls that failed with what the backend answered: a
-   failing tool rarely gets flagged, because the agent apologizes and moves
+1. Group the reports by cause, and fix each cause where it lives:
+   `vatio.yml`, a knowledge entry, a tool, or the developer's backend a tool
+   calls. `vatio tools --env live` shows each tool's error rate, timeouts and
+   latency, and the calls that failed with what the backend answered: a
+   failing tool rarely gets reported, because the agent apologizes and moves
    on. Fix those too.
-2. Work on a git branch. `vatio push` deploys it to the branch's own
-   environment, never to live.
-3. Prove it with `vatio eval`: every flag made on live, or before the first publish, is an eval case, replayed against
-   the branch and judged. The report counts the open flags apart from the
-   regression cases. A fix is done when its flags pass and nothing that
-   passed on live now fails.
-4. Open a pull request with what you changed and the eval result. Name flags
-   by id (`F-7K2QX`), and report the open flags and the
-   regression cases as two counts, never one total. With no GitHub
-   repository connected, `vatio propose --env <branch> --title "…"
-   --summary-file why.md` instead: the workspace's owner accepts it from the
-   inbox, which publishes it. Never `vatio publish` it yourself.
+2. `vatio push`. It updates preview and runs no tests. No branch or
+   environment to set up: preview is the one.
+3. `vatio eval` tests every report against preview. It can take several
+   minutes, so in Claude Code start it with the Bash tool's
+   `run_in_background` and read its report when it finishes. Iterate (fix,
+   push, eval) until the reports pass and nothing that passes on live fails.
+   Name reports by id (`F-7K2QX`).
+4. Show the developer what passes now, and `vatio publish` once they agree:
+   it changes what visitors get. If it is refused, follow its message: it
+   says what to run. Never pass `--force` unless the developer explicitly
+   asks for it.
 5. If the digest, an error or the docs left you guessing, say so:
    `vatio feedback "what you were doing and what was missing"`.
 6. Last, in Claude Code, offer to send this session to the Vatio team, as

package/skills/vatio-init/SKILL.md

@@ -56,7 +56,7 @@ you recommend, and ask them to confirm.
   `vatio.yml` (what it is for, its tools, its knowledge, when it hands off)
   and recommend from what you see:
   - the folder differs from live: say so first, the repository may be behind;
-  - open flags in `vatio flags`: work them with the `vatio-improve` skill;
+  - open reports in `vatio flags`: work them with the `vatio-improve` skill;
   - tool calls failing in `vatio tools`: the fix is in the backend they call;
   - `workspace_forbidden`: they are not in the workspace yet, and the owner
     invites them from **Team** in the console.

package/skills/vatio-share-session/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: vatio-share-session
+allowed-tools: AskUserQuestion
 description: Send this coding session to the Vatio team, so they can see where building or improving a Vatio agent got stuck. Use when the user asks to share, send or report this session (or "the conversation", "what we did") to Vatio, when the Vatio team asked them for it, when Vatio itself got in the way and they want the team to see exactly how, or when vatio-init or vatio-improve finish and say to offer it.
 ---
 
@@ -35,20 +36,27 @@ It is sent in one of two ways: the user asked for it, or you offer it because
 3. Ask whether to send it, once. It is their conversation: never send it on
    your own, even when the task seems to call for it.
 
-   When you are offering it, ask with three answers (in Claude Code, as a
-   multiple-choice question), for example: "Do you want to send this session
+   When you are offering it, ask with the **AskUserQuestion** tool, Claude
+   Code's own question, not in a message. One question, in the user's
+   language, header `Vatio`, for example: "Do you want to send this session
    to the Vatio team, so they can see where Vatio got in the way and improve
-   it?"
-
-   - **Send it**
-   - **Not now**: do nothing more. It will not be offered again for a week.
-   - **Don't ask again**: run
-     `npx @vatio-ai/cli@latest share-session --never`.
-
-   In the same question, suggest they add feedback: what got in the way, what
-   they expected Vatio to do, or anything else they want the team to know.
-   It is optional — the session is what matters, and it goes fine on its own.
-   A no is a fine answer: do not insist.
+   it?", with these options:
+
+   - **Send it** — "The whole conversation, as shown above."
+   - **Send it with a comment** — "You say what got in the way, what you
+     expected, or anything else for the team."
+   - **Not now** — "It won't be offered again for a week."
+   - **Don't ask again** — "It won't be offered again."
+
+   **Send it with a comment**: ask for the comment in one plain message, then
+   send. A comment they type in the question's own text field instead (its
+   "Other" answer, or a note on an option) is their feedback too, unless it
+   says no. **Not now**: do nothing more. **Don't ask again**: run
+   `npx @vatio-ai/cli@latest share-session --never`. A no is a fine answer:
+   do not insist.
+
+   When the user asked for it themselves, just confirm in a message and
+   take any feedback they give.
 
 4. If they say to send it, send it. With their feedback, in their words, as
    they gave it: