@easysociable/cli 0.1.21 → 0.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easysociable/cli",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Agent-first CLI for EasySociable: Content Engine, Template, Slideshow, and MCP",
   "type": "module",
   "license": "MIT",

package/skills/easysociable-slideshow/SKILL.md

@@ -21,6 +21,23 @@ Ask only for what only the user knows:
 - their Brand (IP name, handle, avatar) — once, ever;
 - their own material (screenshots, photos) when a page needs it.
 
+## Command output (`--json`)
+
+Read results from these paths; don't guess:
+
+| Command | Result |
+|---|---|
+| `auth status` | `authenticated`, `account.email` (no `data` wrapper) |
+| `brands list` / `brands get` | `data[]` / `data` (`id`, `name`, `handle`, `colors`, `logoUrl`) |
+| `hooks recommend` | `data.cards[]` (`id`, `hook_type`, `status`, `format`) |
+| `formulas recommend` | `data.cards[]` (`id`, `status`, `recipe`, `swipe`), `data.stop` |
+| `formulas get` | `data` (`beats[]`, `looks[].layouts`) |
+| `templates references` | a top-level array (`familyId`, `name`, `roles`, `style`, `requiresImage`) |
+| `templates source` | top level: `familyId`, `canvas`, `studioJson` |
+| `icons search --query <word>` | icon list for the word |
+| `images upload --path …` | `data[]` (`path`, `asset.url`, or `error`); exit 1 if any failed |
+| `slideshows create` | top level: `id`, `studioUrl` |
+
 ## Workflow
 
 ### 0. Login (once per session)
@@ -43,7 +60,7 @@ Ask only for what only the user knows:
   Create it with `easysociable brands create --file brand.json`
   (`{ "name", "handle", "colors", "logoAssetId" }`) using the default palette
   that matches the deck's style (`references/REFERENCES.md`). An avatar: upload
-  it first (step 5's `images upload`) and pass the returned `asset.id` as
+  it first (`images upload --path <file> --json`) and pass `data[0].asset.id` as
   `logoAssetId`; `brands get` then returns its `logoUrl`.
   Skipped → no Brand: header shows the topic, the CTA has no handle, and that
   palette goes in `theme.json` (without a Brand or theme Studio falls back to
@@ -69,6 +86,12 @@ neither.
 - Take image URLs from pages you already opened (`og:image`, images in the
   body) and download them: `curl -sL -o assets/<name>.png <url>`. PNG, JPEG or
   WebP only (convert anything else to PNG), ≤ 20 MB.
+- Launch posts often show the product only in demo videos: pull frames of the
+  real UI straight from the video URL, without downloading the whole file
+  (`ffmpeg -ss <seconds> -i <video url> -frames:v 1 frame.png`; a contact sheet
+  to find the moment: `ffmpeg -i <video url> -vf "fps=1/3,scale=240:-1,tile=6x2"
+  -frames:v 1 sheet.jpg`), then crop to the phone or window. A frame where the key moment is
+  on screen (an approval prompt, a result) beats a generic screen.
 - **Look at every file** before keeping it. Drop it when it is off-topic,
   unreadable at phone size, would need more than 1.25× upscaling to fill its
   area, carries a watermark, or shows a recognisable person who is not the
@@ -168,10 +191,8 @@ Say 'same as this'. Want another look? Say 'different look'."
 - Fill each image area in this order:
   1. The user's own image, when they gave one.
   2. An evidence image from step 2. Upload it
-     (`easysociable images upload --file body.json` with
-     `{ "file": "data:image/png;base64,…", "filename": "x.png" }`; build it with
-     `node -e "const f=process.argv[1],t=f.match(/\.(jpe?g|webp)$/i)?(/webp/i.test(f)?'webp':'jpeg'):'png';console.log(JSON.stringify({file:'data:image/'+t+';base64,'+require('fs').readFileSync(f,'base64'),filename:require('path').basename(f)}))" assets/x.png > body.json`)
-     and use the returned `asset.url` as `src`.
+     (all at once: `easysociable images upload --path assets/a.png assets/b.jpg --json`)
+     and use each returned `data[i].asset.url` as `src`.
      Crop and scale it (`objectFit: 'cover'`, `objectPosition`), never alter
      what it shows. To point at something in it, add a separate element on top
      (a red ellipse border, an underline bar) so the user can move or delete it.

package/skills/easysociable-slideshow/references/REFERENCES.md

@@ -33,7 +33,7 @@ Roles overlap in the catalog, so pass related ones together: `hook,cover` ·
    not need a real one: keep the area's box and fill it from the content with a
    large number or keyword, a short quote with an oversized quote mark, an
    accent-colour block carrying one word, or one icon from
-   `easysociable icons search` on a tinted block. Never a grey placeholder or an
+   `easysociable icons search --query <word>` on a tinted block. Never a grey placeholder or an
    empty box on the cover. If nothing fits, delete the area and give the
    headline its space.
 5. Brand chrome: the header label is the Brand name (or the topic when there is