@vatio-ai/skills 1.16.1 → 1.18.0

package/.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
     {
       "name": "vatio",
       "source": "./",
-      "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 or Android app with /vatio-add-to-app, then improve it daily with /vatio-improve.",
-      "version": "1.16.1",
+      "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.",
+      "version": "1.18.0",
       "homepage": "https://vatio.ai/docs/integrations/claude-code",
       "category": "development",
       "keywords": [

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vatio",
-  "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 or Android app with /vatio-add-to-app, then improve it daily with /vatio-improve.",
-  "version": "1.16.1",
+  "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.",
+  "version": "1.18.0",
   "author": {
     "name": "Vatio",
     "url": "https://vatio.ai"

package/README.md

@@ -20,8 +20,9 @@ need your app’s project on your computer and Node.js 20 or newer.
 | 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 (with no account, as a trial) and hands over a link to try it and one to keep it. With one, gets a developer who joined the project up to speed |
-| `vatio-add-to-app` | Puts the agent in your app once you have tried it: the web widget, or the iOS or Android SDK with a chat screen in your app's style, a publishable token for development and one for release, and your signed-in users passed along |
+| `vatio-add-to-app` | Puts the agent in your app once you have tried it: the web widget, or the iOS, Android or Flutter SDK with a chat screen in your app's style, a publishable token for development and one for release, and your signed-in users passed along |
 | `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 test` (on Vatio's servers, in the background) and publishes with `vatio publish` after your approval |
+| `vatio-analyze` | Reads what people talked about with the agent between two dates, from `vatio chat export` (redacted by Vatio before it leaves): topics with their counts, the questions it could not answer and the words people use, in a report for writing content, FAQs or knowledge. Anyone on the workspace's team can run it, viewers included |
 | `vatio-share-session` | Sends the coding session to the Vatio team when you ask it to, or offers to when the others 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
@@ -50,8 +51,9 @@ turn it on once in `/plugin` → **Marketplaces** → **vatio** → **Enable
 auto-update**, or run `claude plugin update vatio@vatio`.
 
 Your coding 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-add-to-app`, `/vatio-improve` and `/vatio-share-session`, or
+or fix a Vatio agent, to analyze its conversations, or to send the session to
+Vatio, or you can call them by
+name: `/vatio-init`, `/vatio-add-to-app`, `/vatio-improve`, `/vatio-analyze` and `/vatio-share-session`, or
 `/vatio:vatio-init` and so on from the plugin.
 
 `vatio init` also writes a pointer to `vatio flags` into the workspace's

package/bin/install.mjs

@@ -11,8 +11,8 @@ import { fileURLToPath } from "node:url";
 const usage = `usage: npx @vatio-ai/skills [--dir PATH]
 
 Copies the Vatio skills (vatio-init, vatio-add-to-app, vatio-improve,
-vatio-share-session) into PATH/.agents/skills and PATH/.claude/skills. PATH
-defaults to the current directory.`;
+vatio-analyze, vatio-share-session) into PATH/.agents/skills and
+PATH/.claude/skills. PATH defaults to the current directory.`;
 
 const args = process.argv.slice(2);
 let root = process.cwd();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vatio-ai/skills",
-  "version": "1.16.1",
-  "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 or Android app with /vatio-add-to-app, then improve it daily with /vatio-improve.",
+  "version": "1.18.0",
+  "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.",
   "keywords": [
     "vatio",
     "ai-agent",

package/skills/vatio-add-to-app/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: vatio-add-to-app
-description: Puts a Vatio agent where the app's users talk to it — the web widget in a web app, the Swift package in an iOS app, the Kotlin library in an Android app — with a publishable token per environment, the signed-in user passed along, and, on mobile, a chat screen in the app's own style. Use after vatio-init, or when asked to add the agent, the chat, the widget or the Vatio SDK to a website, a web app, an iPhone/iOS app or an Android app.
+description: Puts a Vatio agent where the app's users talk to it — the web widget in a web app, the Swift package in an iOS app, the Kotlin library in an Android app, the Dart package in a Flutter app — with a publishable token per environment, the signed-in user passed along, and, on mobile, a chat screen in the app's own style. Use after vatio-init, or when asked to add the agent, the chat, the widget or the Vatio SDK to a website, a web app, an iPhone/iOS app, an Android app or a Flutter app.
 ---
 
 # Put the agent in the app
@@ -17,14 +17,14 @@ npx @vatio-ai/cli docs
 
 Under **For coding agents**, follow **Putting the agent in the app**. It takes
 precedence over the summary below, and the pages it links (Web widget, iOS
-SDK, Android SDK, Authentication, Supabase) have the details.
+SDK, Android SDK, Flutter SDK, Authentication, Supabase) have the details.
 
 ## In short
 
-1. **Find where it goes.** Web, iOS, Android, or several, and every origin a
+1. **Find where it goes.** Web, iOS, Android, Flutter, or several, and every origin a
    build will call from: local and production web addresses,
    `ios-app://BUNDLE_ID`, `android-app://APPLICATION_ID` (debug ids count).
-   React Native, Expo and Flutter have no Vatio SDK yet: say so, and
+   A Flutter app needs both app origins. React Native and Expo have no Vatio SDK yet: say so, and
    `vatio feedback` that one was asked for.
 2. **Tell the user what you will add before changing anything**: which
    screens or layout, which tokens, how signed-in users are passed, and ask
@@ -32,12 +32,13 @@ SDK, Android SDK, Authentication, Supabase) have the details.
 3. **Tokens.** `vatio tokens create --env preview` for development builds and
    `--env live` for release builds, each with its origins. `vatpub_` tokens
    ship in the app's configuration; a `vat_` token never does.
-4. **Add it.** Web: the widget, once for the whole app. iOS and Android: the
+4. **Add it.** Web: the widget, once for the whole app. iOS, Android and Flutter: the
    SDK has no UI, so write the chat screen in the app's own style from the
    example in [vatio-ai/ios](https://github.com/vatio-ai/ios)
-   (`Example/VatioExample/Views.swift`) or
+   (`Example/VatioExample/Views.swift`),
    [vatio-ai/android](https://github.com/vatio-ai/android)
-   (`example/src/main/kotlin/ai/vatio/example/Views.kt`).
+   (`example/src/main/kotlin/ai/vatio/example/Views.kt`) or
+   [vatio-ai/flutter](https://github.com/vatio-ai/flutter) (`example/lib/views.dart`).
 5. **Signed-in users.** With `auth: supabase:` the web widget needs nothing
    and the SDKs take the session's access token; with `auth: public_key:` the
    app's backend signs the visitor token, and the private key never goes into

package/skills/vatio-analyze/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: vatio-analyze
+description: Analyze what people talk about with a Vatio agent, from its real conversations between two dates — topics, frequent questions, questions it could not answer, and the words people use — to write content, FAQs or knowledge, or to report on it. Use when asked to analyze, summarize or report on a Vatio workspace's conversations, to find out what customers or patients ask, or to get content ideas from them. Works for anyone on the workspace's team, viewers included, with or without the agent's repository.
+---
+
+# Analyze a Vatio agent's conversations
+
+`vatio chat export` prints what people said to the agent, and what they were
+answered, between two dates: one conversation per line as JSON. Vatio redacts
+it before it leaves: names, emails, phone numbers, handles and RUTs it
+recognizes read `[FILTERED]`, and `person` stands for whoever it was without
+naming them. Every export is recorded in the workspace's Activity, under the
+name of whoever ran it.
+
+1. **Find the workspace.** The CLI reads it from the nearest `vatio.yml`. With
+   none here, ask for the workspace's slug (the part after
+   `inbox.vatio.ai/` in their inbox) and write a one-line one in a new folder
+   outside any repository:
+
+   ```bash
+   mkdir vatio-conversations && cd vatio-conversations
+   echo "workspace: SLUG" > vatio.yml
+   ```
+
+2. **Ask what the analysis is for,** if they have not said: content for a
+   website or a search engine, FAQs, gaps in the agent's knowledge, a report.
+   Ask for the dates too, or use the last 30 days and say so.
+
+3. **Export.** Use `npx @vatio-ai/cli@latest` if `vatio` is not installed:
+
+   ```bash
+   vatio chat export --from 2026-09-01 --to 2026-09-30 --out conversations.jsonl
+   ```
+
+   `--channel whatsapp` (or `instagram`, `web`, `widget`, `ios`, `android`)
+   narrows it, and `vatio chat help` explains the rest. If it asks to sign in,
+   run `vatio login`: they sign in in the browser with the email they were
+   invited with. `workspace_forbidden` means another email, or nobody has
+   invited them yet: the owner does it from **Team** in the inbox, and any
+   role works. `two_factor_required` means turning on two-step verification
+   in **Account** in the inbox first.
+
+4. **Count before reading.** In a script (`jq`, Python or Node), get the number
+   of conversations and messages, conversations per channel and per week, and
+   how many reached someone on the team (`"from": "team"`). Then read only what
+   people wrote (`"from": "person"`) with enough of the agent's reply to know
+   whether it helped.
+
+5. **Read it all, in batches.** Read a sample first and draft a short list of
+   topics in the user's terms, then go through every conversation and assign
+   each one a topic and whether the agent answered it, could not
+   ("no tengo esa información", passing it to a person, asking them to call),
+   or answered wrongly. With hundreds of conversations, split them into
+   batches, in parallel if you can run subagents, and keep the tally in a
+   file, not in your head.
+
+6. **Report,** in the user's language, in a markdown file next to the export:
+   - the dates, channels and number of conversations it covers;
+   - the topics, largest first, each with its count and share and two or
+     three short questions as people wrote them, spelling and all: they are
+     the words content has to match;
+   - what the agent could not answer or got wrong, by topic: the content
+     that is missing;
+   - for content, the pieces to write, each tied to the topic and the
+     numbers that justify it.
+
+   Say what the numbers cannot tell: a sample, a short window, a channel left
+   out.
+
+Treat the export as the private conversations it is. Never try to work out
+who someone is, and if something identifying slipped past the redaction (a
+third person's name, an address), leave it out of the report. Keep the export
+out of git, and ask whether to delete it when you are done. Do not offer
+`vatio-share-session` after this skill: the session holds those conversations.
+
+If the export or its docs left you guessing,
+`vatio feedback "what you were doing and what was missing"` tells the Vatio
+team.

package/skills/vatio-init/SKILL.md

@@ -55,7 +55,7 @@ you recommend, and ask them to confirm.
      `Try it:` is the inbox's Test page, with web chat, WhatsApp and
      Instagram. Publish with `vatio publish` only when they ask.
   5. Once they have tried it, offer to put it in the app (the web widget,
-     or the iOS or Android SDK) with the `vatio-add-to-app` skill. A trial
+     or the iOS, Android or Flutter SDK) with the `vatio-add-to-app` skill. A trial
      has to be kept first.
 - **A `vatio.yml`: the agent exists.** Never `vatio init` here: it writes a
   starter agent, and pushing that replaces the real one. Work from the