arca-marketing-video 2.20.0 → 2.20.2

package/INSTALL.md

@@ -9,32 +9,40 @@ You don't need to know any commands. You just ask your AI agent (ChatGPT, Claude
 Copy everything between the lines and send it to your agent:
 
 ```
-Please install the Arca marketing skills into this environment.
+Please set up the Arca marketing kit in this environment.
 
+PART A — install the skills (always do this):
 1. Download every folder inside the "skills/" directory of this public GitHub repo:
    https://github.com/aobalitaan/arca-marketing/tree/main/skills
-
-2. Place each of those folders so it sits DIRECTLY inside my agent's skills folder
-   (exactly one level deep — folder name, then SKILL.md inside it). Use the folder for my tool:
-     • Claude / Claude Code  ->  .claude/skills/
-     • Cursor                ->  .cursor/skills/
-     • Codex                 ->  .agents/skills/
+2. Install them into THIS PROJECT (the current working directory) — NOT globally in my home
+   folder. Use the project-scoped skills folder, creating it if it doesn't exist; place each
+   skill folder DIRECTLY inside it (exactly one level deep — folder name, then SKILL.md inside).
+     • Claude / Claude Code  ->  ./.claude/skills/    (in this project — do NOT use ~/.claude/skills)
+     • Cursor                ->  ./.cursor/skills/
+     • Codex                 ->  ./.agents/skills/
    If you are ChatGPT in a sandbox without a skills folder, just keep the files in the
-   working directory and follow each SKILL.md as instructions when I ask.
-
-3. IMPORTANT: also copy the "_arca-marketing-assets" folder into the same skills folder,
-   right next to the skill folders. Every skill reads the brand profile and assets from it.
-
-4. When done, list the skills you installed and tell me to start with "arca-marketing".
+   current working directory and follow each SKILL.md as instructions when I ask.
+3. Also copy the "_arca-marketing-assets" folder into that same project skills folder, right
+   next to the skill folders. Every skill reads the brand profile and assets from it.
+
+PART B — set up the video tools (only needed for the shorts-editor skill; skip if you can't):
+4. If Node.js is available, run:  npx hyperframes@latest doctor
+5. Install anything it reports missing — usually ffmpeg and Google Chrome.
+6. Install the captions tool:  pip install faster-whisper
+7. Run "npx hyperframes@latest doctor" again to confirm it's green.
+
+When done: print the EXACT folder path you installed into (it should be inside this project,
+e.g. ./.claude/skills/ — if it's in my home folder, move it into the project), list the skills,
+say whether the video tools are ready, and tell me to start with "arca-marketing".
 ```
 
-That's it. Then say **"use the arca-marketing skill"** (or "where do I start?") and it walks you through the rest.
+That's it — one paste does everything. Then say **"use the arca-marketing skill"** (or "where do I start?") and it walks you through the rest.
 
 ---
 
 ## What you just installed
 
-Seven folders land in your skills folder:
+Seven folders land in your project's skills folder (`./.claude/skills/` in the current project):
 
 - `arca-marketing` — **start here**; orients you and points to the right skill
 - `brand-builder` — Q&A that writes your brand profile
@@ -48,28 +56,17 @@ Seven folders land in your skills folder:
 
 ---
 
-## Set up the video tools (only if you'll edit videos)
-
-The image skills (`brand-builder`, `design-guide`, `carousel-generator`, `storyboard-prompt`) need nothing extra. The **video editing** skill (`shorts-editor`) renders with **HyperFrames**, which needs a few free tools: Node.js, ffmpeg, Google Chrome, and faster-whisper (for captions).
+## About the video tools (Part B above)
 
-Easiest: ask your agent to set it up. Paste this:
-
-```
-Set up the video tools for the shorts-editor skill in this environment:
-1. Make sure Node.js is installed, then run:  npx hyperframes@latest doctor
-2. Install anything it reports missing — usually ffmpeg and Google Chrome.
-3. Install the captions tool:  pip install faster-whisper
-4. Run "npx hyperframes@latest doctor" again and confirm everything is green.
-Tell me if something can't be installed in this environment.
-```
+The image skills (`brand-builder`, `design-guide`, `carousel-generator`, `storyboard-prompt`) need nothing extra. Only the **video editing** skill (`shorts-editor`) needs **HyperFrames** + a few free tools — Node.js, ffmpeg, Google Chrome, and faster-whisper (for captions). Part B of the paste above sets these up; you don't need a second prompt.
 
-Manual equivalent:
+Manual equivalent, if you'd rather do it yourself:
 - `npx hyperframes@latest doctor` — checks ffmpeg + Chrome and lists what's missing
 - **ffmpeg** — `brew install ffmpeg` (Mac), `sudo apt install ffmpeg` (Linux), or a build from ffmpeg.org (Windows)
 - **Google Chrome** — HyperFrames renders frames with it
 - **faster-whisper** — `pip install faster-whisper` (word-level captions)
 
-> Heads-up: this is the one part that needs a real machine/sandbox that can install ffmpeg + Chrome. If your environment can't, you can still do everything up through generating the clips, then do the final edit on a computer that can.
+> Heads-up: Part B needs a real machine/sandbox that can install ffmpeg + Chrome. If your environment can't, Part A still works — do everything up through generating the clips, then run the final edit on a computer that can.
 
 ---
 
@@ -78,7 +75,7 @@ Manual equivalent:
 - **Skills CLI:** `npx skills add aobalitaan/arca-marketing`
 - **In-chat:** install the `/learn` command, then `/learn @aobalitaan/arca-marketing`
 - **npm (Claude Code):** `npx arca-marketing-video` (copies the skills into `.claude/skills/`)
-- **Manual:** clone the repo and copy the contents of `skills/` into your `.claude/skills/` folder.
+- **Manual:** clone the repo and copy the contents of `skills/` into this project's `./.claude/skills/` folder (not the global `~/.claude/skills/`).
 
 ## First steps after installing
 1. Say **"use arca-marketing"** — it explains the kit.

package/README.md

@@ -12,8 +12,10 @@ The simplest path (great for non-technical users): just ask your AI agent to fet
 - **Skills CLI:** `npx skills add aobalitaan/arca-marketing`
 - **In-chat:** install the `/learn` command, then `/learn @aobalitaan/arca-marketing`
 - **npm (Claude Code):** `npx arca-marketing-video` (copies the skills into `.claude/skills/`; add `--global` for `~/.claude/skills/`)
-- **Manual:** copy the **contents** of `skills/` into your agent's skills folder (`.claude/skills/`, `.cursor/skills/`, or `.agents/skills/`) so each skill folder sits exactly one level deep, and keep `_arca-marketing-assets/` beside them.
+- **Manual:** copy the **contents** of `skills/` into your project's skills folder — `./.claude/skills/` (or `./.cursor/skills/`, `./.agents/skills/`) **in the current project directory**, so each skill folder sits exactly one level deep, and keep `_arca-marketing-assets/` beside them.
 
+> **Install project-scoped, not global.** Put the skills in the project's `./.claude/skills/` (current working directory), not the global `~/.claude/skills/` in your home folder — each project keeps its own brand profile, and the skills' shared-asset paths are resolved per project. (The `npx` installer is project-scoped by default; `--global` is opt-in.)
+>
 > Skills must be exactly one level deep — `.claude/skills/<name>/SKILL.md`. Don't nest them inside an extra folder, or the agent won't discover them. If your skills folder didn't exist before, restart your agent once so it starts watching it.
 
 ## The skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.20.0",
+  "version": "2.20.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/aobalitaan/arca-marketing.git"