app-growth-design 1.0.0 → 1.0.2

package/README.md

@@ -1,11 +1,14 @@
 # app-growth-design
 
+[![npm](https://img.shields.io/npm/v/app-growth-design)](https://www.npmjs.com/package/app-growth-design)
+[![license](https://img.shields.io/npm/l/app-growth-design)](LICENSE)
+
 A Claude Code skill for the decisions that actually move an app: **onboarding, paywalls, pricing, retention, gamification, growth loops and screen-level craft.**
 
 It is not another "be a helpful product expert" prompt. It is a knowledge base — 5.7 hours of teardowns from [Tim Gabe's YouTube channel](https://www.youtube.com/@TimGabe) compressed into six playbooks where every non-obvious claim carries a `[NN]` marker back to the video it came from, and every case study keeps its numbers.
 
 ```bash
-npx github:bixxter/app-growth-design
+npx app-growth-design
 ```
 
 That's it. Pick user-wide or project-only, restart Claude Code, and the skill loads itself whenever you're working on one of those problems.
@@ -41,18 +44,21 @@ Same for the rest:
 
 ```bash
 # interactive — asks user-wide or project-only
-npx github:bixxter/app-growth-design
+npx app-growth-design
 
 # non-interactive
-npx github:bixxter/app-growth-design --user      # ~/.claude/skills/app-growth-design
-npx github:bixxter/app-growth-design --project   # ./.claude/skills/app-growth-design
-npx github:bixxter/app-growth-design --dir ~/some/skills
+npx app-growth-design --user      # ~/.claude/skills/app-growth-design
+npx app-growth-design --project   # ./.claude/skills/app-growth-design
+npx app-growth-design --dir ~/some/skills
 
 # later
-npx github:bixxter/app-growth-design --force       # update in place
-npx github:bixxter/app-growth-design --uninstall
+npx app-growth-design --force       # update in place
+npx app-growth-design --uninstall
 ```
 
+Straight from the repo works too, if you'd rather skip the registry:
+`npx github:bixxter/app-growth-design`
+
 Node 18+. No dependencies — the installer is one file that copies `skill/` into your skills directory and nothing else.
 
 Prefer to do it by hand? `cp -r skill ~/.claude/skills/app-growth-design`. It works in anything that reads the [Agent Skills](https://code.claude.com/docs/en/skills) format.
@@ -67,34 +73,13 @@ The problem with turning a YouTube channel into agent knowledge is that the naiv
 
 So the pipeline is built around one idea: **the frames are not decoration, they are the missing half of the content.**
 
-```
-30 videos (5.7 h)
-      │
-  1 ──┤ yt-dlp: captions only, 6-wide          → 2.6 MB VTT / 220,498 words
-      │
-  2 ──┤ dedupe rolling captions, regroup       →   49,629 words, ~30s blocks
-      │   into ~30s timestamped blocks             (4.4× smaller, addressable)
-      │
-  3 ──┤ yt-dlp: 480p video, 3-wide             → 510 MB, deleted after stage 4
-      │
-  4 ──┤ ONE AGENT PER VIDEO, in parallel:      →   30 notes / 118,660 words
-      │   read transcript → find the moments        1,161 frames extracted
-      │   where meaning is on screen, not in        476 described in-line
-      │   the audio → ffmpeg those timestamps
-      │   → actually LOOK at the frames →
-      │   write a structured note
-      │      ↓
-      │   second agent re-reads each note against the transcript and
-      │   fixes what's missing — unresolved "this screen", dropped numbers,
-      │   verbatim bloat, vague filler rules
-      │
-  5 ──┤ SIX AGENTS, one per theme, each        →    6 playbooks / 55,241 words
-      │   reading across all 30 notes:              + SKILL.md router (2,378 words)
-      │   merge, resolve contradictions,
-      │   keep every number and product name
-```
+<!-- generated — edit docs/diagrams.mjs and run `node docs/diagrams.mjs`, don't hand-edit the SVG -->
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bixxter/app-growth-design/main/docs/flow-dark.svg">
+  <img alt="Two streams enter: captions, deduped from 220,498 to 49,629 words, and 510 MB of 480p video. Both feed an enrich agent that runs once per video — read the transcript, find where meaning is on screen, cut those frames and look at them, write a structured note — followed by a verify agent. Out come 30 notes, 118,660 words and 1,161 frames, which six theme agents turn into six playbooks and a SKILL.md router." src="https://raw.githubusercontent.com/bixxter/app-growth-design/main/docs/flow-light.svg">
+</picture>
 
-Note what happens to the word count at stage 4: the notes come out **more than twice the size of the speech**. That's the whole point — 1,161 screenshots put back what the captions lost.
+Note what happens to the word count in the middle: the notes come out **more than twice the size of the speech**. That's the whole point — 1,161 screenshots put back what the captions lost.
 
 Three details that turned out to matter more than expected:
 

package/bin/install.mjs

@@ -23,9 +23,9 @@ const red = s => c('31', s)
 const HELP = `
 ${bold('app-growth-design')} — install the skill into Claude Code
 
-  ${cyan('npx github:bixxter/app-growth-design')}            pick a target interactively
-  ${cyan('npx github:bixxter/app-growth-design --user')}     ~/.claude/skills/${SKILL}
-  ${cyan('npx github:bixxter/app-growth-design --project')}  ./.claude/skills/${SKILL}
+  ${cyan('npx app-growth-design')}            pick a target interactively
+  ${cyan('npx app-growth-design --user')}     ~/.claude/skills/${SKILL}
+  ${cyan('npx app-growth-design --project')}  ./.claude/skills/${SKILL}
 
 Options
   --user, --global   install for every project on this machine (default)
@@ -130,7 +130,7 @@ async function main() {
     ${cyan('"design a streak that does not backfire"')}
 
   The skill loads itself when the topic matches. To force it: ${cyan(`/${SKILL}`)}
-  ${dim('Uninstall: npx github:bixxter/app-growth-design --uninstall')}
+  ${dim(`Uninstall: npx ${SKILL} --uninstall`)}
 `)
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app-growth-design",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Claude Code skill: app onboarding, paywalls, pricing, retention, gamification and growth — distilled from 30 Tim Gabe teardowns into six source-marked playbooks.",
   "type": "module",
   "bin": {