@vatio-ai/skills 1.25.0 → 1.26.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "vatio",
3
3
  "description": "Vatio skills for Claude Code, Cursor and Codex: add an AI agent to the app you're building with /vatio-init, put it in your web, iOS, Android or Flutter app with /vatio-add-to-app, then improve it daily with /vatio-improve and learn what people ask it with /vatio-analyze.",
4
- "version": "1.25.0",
4
+ "version": "1.26.1",
5
5
  "author": {
6
6
  "name": "Vatio",
7
7
  "url": "https://vatio.ai"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vatio-ai/skills",
3
- "version": "1.25.0",
3
+ "version": "1.26.1",
4
4
  "description": "Vatio skills for Claude Code, Cursor and Codex: add an AI agent to the app you're building with /vatio-init, put it in your web, iOS, Android or Flutter app with /vatio-add-to-app, then improve it daily with /vatio-improve and learn what people ask it with /vatio-analyze.",
5
5
  "keywords": [
6
6
  "vatio",
@@ -63,7 +63,12 @@ Code, offer to send this session to the Vatio team, as the
63
63
  `vatio-share-session` skill says; if `vatio share-session --should-ask` prints
64
64
  `no`, say nothing.
65
65
 
66
- `vatio` is `npx @vatio-ai/cli` when it is not installed globally.
66
+ There are two ways to run the CLI, and the package name appears once in
67
+ either: `vatio ARGS` when it is installed globally, and
68
+ `npx @vatio-ai/cli@latest ARGS` when it is not. Pick one per command and
69
+ leave it whole — `npx @vatio-ai/cli @vatio-ai/cli push` is the commonest way
70
+ to get this wrong, and the CLI reads the second name as the command and
71
+ fails.
67
72
 
68
73
  A command you hand the developer to run themselves, because a permission
69
74
  check refused it or it needs their own credentials, says
@@ -75,8 +75,12 @@ In short:
75
75
  `vatio share-session --should-ask`: if that prints `no`, say nothing.
76
76
 
77
77
  `vatio docs` prints the whole contract (manifest, tools, knowledge, CLI) if
78
- the fix needs more than the digest says. If `vatio` is not installed, use
79
- `npx @vatio-ai/cli` in its place; if it says to log in, run `vatio login`: it
78
+ the fix needs more than the digest says. There are two ways to run the CLI,
79
+ and the package name appears once in either: `vatio ARGS` when it is
80
+ installed globally, and `npx @vatio-ai/cli@latest ARGS` when it is not. Pick
81
+ one per command and leave it whole — `npx @vatio-ai/cli @vatio-ai/cli flags`
82
+ is the commonest way to get this wrong, and the CLI reads the second name as
83
+ the command and fails. If it says to log in, run `vatio login`: it
80
84
  opens the browser on the developer's machine (if it doesn't, give them the
81
85
  link it prints), and they sign in and check the code matches. If it times
82
86
  out, run it again after they have signed in.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: vatio-init
3
- description: The first Vatio skill in a project. Looks at what is already there — a vatio.yml anywhere in the repository, the workspace on the platform, the app's own code — and recommends from it, then either builds a customer-facing AI agent (in the app first, through its web widget or mobile SDK, and on WhatsApp or Instagram when asked) and gets it to the Test page in the Vatio inbox, or gets a developer who joined a project that already has one up to speed. Use when asked to create, set up, start or ship a Vatio agent, a chatbot or a support/sales assistant on Vatio, to get started on or onboard onto a project that uses Vatio, or when the user pastes the prompt from vatio.ai.
3
+ description: The first Vatio skill in a project. Looks at what is already there — a vatio.yml anywhere in the repository, the workspace on the platform, the app's own code — and recommends from it, then either builds a customer-facing AI agent (in the app first, through its web widget or mobile SDK, and on WhatsApp or Instagram when asked) and gets it to Try the agent in the Vatio inbox, or gets a developer who joined a project that already has one up to speed. Use when asked to create, set up, start or ship a Vatio agent, a chatbot or a support/sales assistant on Vatio, to get started on or onboard onto a project that uses Vatio, or when the user pastes the prompt from vatio.ai.
4
4
  ---
5
5
 
6
6
  # Start with Vatio in this project
@@ -46,14 +46,22 @@ you recommend, and ask them to confirm.
46
46
  team when a person should take over: **Human in the loop** in the docs).
47
47
  3. `vatio diff`, `vatio push`, then try it with `vatio chat`, including a
48
48
  conversation that should hand off.
49
- 4. Give them the link `vatio push` prints after `Try it:` (the inbox's
50
- Test page, with web chat, WhatsApp and Instagram) with what you
49
+ 4. **Keep the replies that came out right.** For each one,
50
+ `vatio test add "what the answer has to say"` right after the
51
+ `vatio chat` that produced it. Three or four is enough to start. This is
52
+ the only thing that makes a later version's mistake visible: `vatio
53
+ test` replays them on every push, and once the workspace is published
54
+ `vatio publish` refuses a version that breaks one. A workspace with no
55
+ tests publishes with nothing checked, which is how a fix for one
56
+ question quietly breaks another.
57
+ 5. Give them the link `vatio push` prints after `Try it:` (the inbox
58
+ with Try the agent open: web chat, WhatsApp and Instagram) with what you
51
59
  tried. Until someone outside their team talks to the agent the
52
- workspace is a draft: live follows every push, so there is nothing to
53
- publish yet and you need not explain preview and live. Once `vatio push`
54
- says live still runs an older version, publish with `vatio publish`
55
- only when they ask.
56
- 5. Once they have tried it, offer to put it in the app (the web widget,
60
+ workspace is a draft: `vatio push` is the deploy, so there is nothing to
61
+ publish yet and you need not explain preview and live. Every push says
62
+ which of the two states the workspace is in; once it says visitors still
63
+ get an older version, publish with `vatio publish` only when they ask.
64
+ 6. Once they have tried it, offer to put it in the app (the web widget,
57
65
  or the iOS, Android or Flutter SDK) with the `vatio-add-to-app` skill.
58
66
  - **A `vatio.yml`: the agent exists.** Never `vatio init` here: it writes a
59
67
  starter agent, and pushing that replaces the real one. Work from the
@@ -99,7 +107,12 @@ that same section.
99
107
  the `vatio-share-session` skill says. It starts with
100
108
  `vatio share-session --should-ask`: if that prints `no`, say nothing.
101
109
 
102
- `vatio` is `npx @vatio-ai/cli` when it is not installed globally. The first
110
+ There are two ways to run the CLI, and the package name appears once in
111
+ either: `vatio ARGS` when it is installed globally, and
112
+ `npx @vatio-ai/cli@latest ARGS` when it is not. Pick one per command and
113
+ leave it whole — `npx @vatio-ai/cli @vatio-ai/cli push` is the commonest way
114
+ to get this wrong, and the CLI reads the second name as the command and
115
+ fails. The first
103
116
  `vatio push` (or `vatio login`) signs the developer in: it opens the browser
104
117
  on their machine (if it doesn't, give them the link it prints). Tell them to
105
118
  sign in with email, Google or GitHub and check that the code on the page
@@ -115,3 +128,10 @@ another (a token into a secrets store), take it with `--json` and chain with
115
128
  empty value. If Claude Code's auto mode refused a `vatio` command and the
116
129
  project's `.claude/settings.json` has no `Bash(vatio *)` rule, also mention
117
130
  **Auto mode** on the docs' Claude Code page.
131
+
132
+ A **secret** is not one of those commands, as long as you do not read it.
133
+ `vatio secrets set KEY --from-env` takes the value from their shell or the
134
+ `.env` beside the `vatio.yml` and sends it without printing it, so run that
135
+ yourself rather than stopping to ask. Ask them only for a value that is not
136
+ there yet, and never echo one back, put one in a file you write, or read a
137
+ `.env` to quote it.