npm - rsc-universal - Versions diffs - 0.1.1 → 0.1.3 - Mend

rsc-universal 0.1.1 → 0.1.3

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.

Files changed (7) hide show

package/README.md +85 -85
package/manifest.json +1 -1
package/package.json +2 -1
package/scripts/lib/domains.js +30 -0
package/scripts/lib/recommend.js +15 -15
package/scripts/lib/ui.js +128 -2
package/scripts/rsc.js +102 -24

package/README.md CHANGED Viewed

@@ -32,9 +32,9 @@ one is the opposite bet:
   invoicing, hiring, GDPR, pitch decks, SEO, a YouTube/TikTok/LinkedIn presence —
   each wired to a `02-DOCS/` knowledge loop that learns from your own results.
 - **Honestly good.** Every skill was built by a research → spec → implement →
-  *adversarial review* pipeline and had to clear an objective rubric (see
-  [The quality bar](#the-quality-bar)). The bar was real: skills that scored 8.0
-  were sent back and fixed, not waved through.
+  *adversarial review* pipeline and had to clear an objective rubric
+  (`scripts/skill-rubric.md`, written *before* any skill existed). The bar was
+  real: skills that scored 8.0 were sent back and fixed, not waved through.
 `skills/<name>/` is the single source of truth. There are no bundles to argue
 over: you start with a tiny floor and grow one piece at a time.
@@ -43,25 +43,19 @@ over: you start with a tiny floor and grow one piece at a time.
 ## Install
-The catalog ships as the `rsc-universal` CLI. Until it's on npm, install from
-source (one minute, once):
 ```bash
-git clone https://github.com/ericrisco/skills.git ~/rsc-skills
-cd ~/rsc-skills && npm install && npm link   # puts `rsc` on your PATH
+npx rsc            # no install step — runs the latest published catalog
 ```
-Then, inside any project of yours:
+Run it inside any project and describe what you want. Working on the catalog
+itself? Clone and link:
 ```bash
-cd ~/my-project
-rsc                # the wizard: describe what you want, it installs what fits
+git clone https://github.com/ericrisco/skills.git ~/rsc-skills
+cd ~/rsc-skills && npm install && npm link
 ```
-> Once published: `npx rsc` with no install step. Prefer no global link? Call it
-> directly: `node ~/rsc-skills/scripts/rsc.js <args>`.
-The first run installs the **floor** — `rsc-suggest` (always-on detector) +
+The first run installs the **floor** — `orient` + `rsc-suggest` (always-on) +
 `harness` + `init` — and, in Claude Code, wires a `SessionStart` hook so your
 assistant proposes new skills on its own from then on.
@@ -71,23 +65,29 @@ assistant proposes new skills on its own from then on.
 ```
 $ rsc
-Hola 👋 ¿Qué quieres hacer?
-> una tienda web con base de datos, y llevar la contabilidad
-He preparado esto para ti:
-   • Tu tienda (rápida y lista para Google)        → nextjs, design, seo-geo
-   • Guardar tus datos de forma fiable             → postgresdb
-   • Cobrar y facturar                             → stripe, invoicing
-   • Llevar las cuentas                            → bookkeeping, finance-ops
-   • Publicarlo online                             → vercel
-¿Lo monto? (sí / no) > sí
-✅ Listo. Abre tu editor y empieza a pedir cosas en tu idioma.
-   💡 Cuando una tarea necesite algo más, te lo propongo yo.
+👋 rsc — the skill catalog for your assistant.
+What do you want to do?          ↑↓ move · enter select
+❯ Base install — the essentials (orient + suggest + harness + init)
+  Base + Spec-Driven Development — specify → plan → implement → ship
+  Pick skills by hand, by area
+  Describe my project and let rsc choose
 ```
-It detects your stack from the repo, maps your words to outcomes, installs the
-matching skills, then suggests what usually comes next.
+Pick **by area** and you get a checkbox list — **↑↓ to move, space to toggle,
+enter to confirm**:
+```
+Languages:                       ↑↓ move · space toggle · a all · enter confirm
+❯ ◉ typescript
+  ◯ python
+  ◉ go
+  ◯ rust
+```
+It auto-detects your IDE and stack, installs only what you chose, then prints the
+exact next steps for **Claude Code / Cursor / Codex / Gemini** — and from there
+keeps proposing the skills a task needs.
 ---
@@ -97,11 +97,11 @@ matching skills, then suggests what usually comes next.
 rsc                                  # plain-language wizard (recommended)
 rsc add fastapi postgresdb           # install specific skills, by name
 rsc add youtube-api remotion-video   # …grow a channel, edit with Remotion
-rsc install --profile minimal        # the floor: suggest + harness + init
+rsc install --profile minimal        # the floor: orient + suggest + harness + init
 rsc install --profile core           # floor + the full SDD workflow
 rsc install --profile full           # everything (all 231)
 rsc install --profile full --without go
-rsc consult "quiero lanzar un saas"  # recommend only, no install
+rsc consult "I want to launch a SaaS"  # recommend only, no install
 rsc registry refresh                 # write .rsc/skill-registry.{json,md}
 rsc list                             # what rsc has installed
 rsc doctor                           # health check (state, hook, counts)
@@ -128,94 +128,94 @@ just asks in plain language.
 ---
-## The quality bar
-This catalog was built to a test that was **written before any skill existed**
-(`scripts/skill-rubric.md`). Each finished skill was scored 0-10 by an
-independent adversarial reviewer across seven weighted dimensions — with
-**freshness & grounding the heaviest (0.25)**: every load-bearing claim had to be
-*current* (2025-2026 versions/APIs) and cited to a dated source. The ship gate
-was **≥ 8.5**; anything below was sent back through a fix loop, not rounded up.
-| | |
-|---|---|
-| **Skills** | 231 (30 core + 201 added) |
-| **Domains** | 21 |
-| **Median family score** | **~9.1 / 10** |
-| **Below the 8.5 gate** | 0 (three were flagged, then remediated to 9.0-9.3) |
-| **Deterministic gates** | eval-lint ✓ · frontmatter+`recommends` validate ✓ · 50/50 unit tests ✓ · every description ≤ 1024 chars ✓ |
-Each skill is **hybrid**: a focused `SKILL.md` (120-400 lines), deep-dive
-`references/`, an `evals/cases.yaml` (≥5 trigger / ≥4 near-miss / ≥1 capability
-scenario), and — for anything with a checkable artifact — an executable
-`scripts/verify.sh`.
----
 ## The catalog
-231 skills, grouped by what you're trying to do. Invoke any installed skill by
-name in your assistant; it fires on its own when a task matches.
+231 skills, grouped by what you're trying to do. Click any skill to read its
+`SKILL.md`. It fires on its own when a task matches.
 ### 🧭 Core & control plane
 The front door and the workspace brain.
-`init` · `harness` · `author-skill` · `suggest` · `sdd-init`
+[init](skills/init/) · [harness](skills/harness/) · [orient](skills/orient/) · [suggest](skills/suggest/) · [author-skill](skills/author-skill/) · [sdd-init](skills/sdd-init/)
 > **harness** is the Karpathy *chaos→knowledge* engine — a `01-TOOLS/` layer (one
 > folder per provider, each with a working `test_connection`) and a `02-DOCS/`
-> self-improving wiki. It governs software *or* a whole company.
+> self-improving wiki. It governs software *or* a whole company. **orient** is the
+> always-on compass that keeps a non-technical human oriented after every step.
 ### 📐 Spec-Driven Development
-Take a fuzzy intent to a shipped, verified change — phase by phase. `rsc install --profile core`.
-`sdd` · `constitution` · `specify` · `clarify` · `plan` · `tasks` · `analyze` · `implement` · `verify` · `review` · `ship` · `debug` · `worktrees` · `parallel`
+Take a fuzzy intent to a shipped, verified change — phase by phase. `npx rsc install --profile core`.
+[sdd](skills/sdd/) · [constitution](skills/constitution/) · [specify](skills/specify/) · [clarify](skills/clarify/) · [plan](skills/plan/) · [tasks](skills/tasks/) · [analyze](skills/analyze/) · [implement](skills/implement/) · [verify](skills/verify/) · [review](skills/review/) · [ship](skills/ship/) · [debug](skills/debug/) · [worktrees](skills/worktrees/) · [parallel](skills/parallel/)
 ### 💼 Run a business
-`finance-ops` · `invoicing` · `bookkeeping` · `pricing` · `sales-pipeline` · `lead-gen` · `cold-outreach` · `proposals` · `contracts` · `customer-support` · `client-onboarding` · `retention` · `hiring` · `people-ops` · `inventory` · `logistics-ops` · `procurement` · `meeting-notes` · `sop-builder` · `project-ops`
+[finance-ops](skills/finance-ops/) · [invoicing](skills/invoicing/) · [bookkeeping](skills/bookkeeping/) · [pricing](skills/pricing/) · [sales-pipeline](skills/sales-pipeline/) · [lead-gen](skills/lead-gen/) · [cold-outreach](skills/cold-outreach/) · [proposals](skills/proposals/) · [contracts](skills/contracts/) · [customer-support](skills/customer-support/) · [client-onboarding](skills/client-onboarding/) · [retention](skills/retention/) · [hiring](skills/hiring/) · [people-ops](skills/people-ops/) · [inventory](skills/inventory/) · [logistics-ops](skills/logistics-ops/) · [procurement](skills/procurement/) · [meeting-notes](skills/meeting-notes/) · [sop-builder](skills/sop-builder/) · [project-ops](skills/project-ops/)
 ### 💸 Raise & model money
-`pitch-deck` · `investor-materials` · `financial-model` · `fundraising` · `unit-economics` · `grants`
+[pitch-deck](skills/pitch-deck/) · [investor-materials](skills/investor-materials/) · [financial-model](skills/financial-model/) · [fundraising](skills/fundraising/) · [unit-economics](skills/unit-economics/) · [grants](skills/grants/)
 ### ⚖️ Legal, privacy & compliance
-`gdpr-privacy` · `terms-conditions` · `compliance` · `data-policy` · `ip-trademark`
+[gdpr-privacy](skills/gdpr-privacy/) · [terms-conditions](skills/terms-conditions/) · [compliance](skills/compliance/) · [data-policy](skills/data-policy/) · [ip-trademark](skills/ip-trademark/)
 ### 📣 Market & brand
-`seo-geo` · `content-engine` · `social-publisher` · `brand-voice` · `brand-identity` · `newsletter` · `landing-copy` · `ads` · `article-writing` · `case-studies` · `video-shorts` · `podcast` · `market-research` · `competitor-watch` · `press-kit` · `community` · `webinar` · `review-management` · `marketing`
-### 🎬 Grow a channel (each with a `02-DOCS` feedback loop)
-- **YouTube** — `youtube-api` · `youtube-strategy` · `youtube-ideation` · `youtube-thumbnails` · `youtube-packaging` · `remotion-video` *(Remotion edits: transitions, Whisper captions, silence removal)*
-- **TikTok / Reels** — `tiktok-api` · `instagram-api` · `shortform-strategy` · `shortform-ideation` · `shortform-packaging` · `shortform-editing`
-- **LinkedIn** — `linkedin-api` · `linkedin-strategy` · `linkedin-content` · `linkedin-carousels` · `linkedin-outreach`
-- **Medium** — `medium-writing` · `medium-publishing` · `medium-strategy`
+[marketing](skills/marketing/) · [seo-geo](skills/seo-geo/) · [content-engine](skills/content-engine/) · [social-publisher](skills/social-publisher/) · [brand-voice](skills/brand-voice/) · [brand-identity](skills/brand-identity/) · [newsletter](skills/newsletter/) · [landing-copy](skills/landing-copy/) · [ads](skills/ads/) · [article-writing](skills/article-writing/) · [case-studies](skills/case-studies/) · [video-shorts](skills/video-shorts/) · [podcast](skills/podcast/) · [market-research](skills/market-research/) · [competitor-watch](skills/competitor-watch/) · [press-kit](skills/press-kit/) · [community](skills/community/) · [webinar](skills/webinar/) · [review-management](skills/review-management/)
+### 🎬 Grow a channel
+Each with a `02-DOCS` feedback loop that learns from your own results. `remotion-video` edits programmatically — transitions, Whisper captions, silence removal.
+[youtube-api](skills/youtube-api/) · [youtube-strategy](skills/youtube-strategy/) · [youtube-ideation](skills/youtube-ideation/) · [youtube-thumbnails](skills/youtube-thumbnails/) · [youtube-packaging](skills/youtube-packaging/) · [remotion-video](skills/remotion-video/) · [tiktok-api](skills/tiktok-api/) · [instagram-api](skills/instagram-api/) · [shortform-strategy](skills/shortform-strategy/) · [shortform-ideation](skills/shortform-ideation/) · [shortform-packaging](skills/shortform-packaging/) · [shortform-editing](skills/shortform-editing/) · [linkedin-api](skills/linkedin-api/) · [linkedin-strategy](skills/linkedin-strategy/) · [linkedin-content](skills/linkedin-content/) · [linkedin-carousels](skills/linkedin-carousels/) · [linkedin-outreach](skills/linkedin-outreach/) · [medium-writing](skills/medium-writing/) · [medium-publishing](skills/medium-publishing/) · [medium-strategy](skills/medium-strategy/)
 ### 🔌 Connect & automate
-`stripe` · `email-connector` · `google-workspace` · `notion-connector` · `whatsapp-telegram` · `automation-flows` · `api-connector-builder` · `webhooks` · `data-scraper` · `spreadsheet-ops` · `calendar-scheduling` · `document-processing` · `e-signature`
+[stripe](skills/stripe/) · [email-connector](skills/email-connector/) · [google-workspace](skills/google-workspace/) · [notion-connector](skills/notion-connector/) · [whatsapp-telegram](skills/whatsapp-telegram/) · [automation-flows](skills/automation-flows/) · [api-connector-builder](skills/api-connector-builder/) · [webhooks](skills/webhooks/) · [data-scraper](skills/data-scraper/) · [spreadsheet-ops](skills/spreadsheet-ops/) · [calendar-scheduling](skills/calendar-scheduling/) · [document-processing](skills/document-processing/) · [e-signature](skills/e-signature/)
 ### 📊 Data & analytics
-`analytics` · `dashboard` · `kpi-framework` · `reporting` · `ab-testing` · `forecasting` · `data-cleaning` · `business-intelligence`
-### 🤖 AI features & infra
-- **Build AI in** — `building-agents` · `rag` · `embeddings-search` · `prompt-engineering` · `llm-pipeline` · `agent-eval` · `chatbot` · `ai-media` · `replicate-images` · `structured-extraction` · `agent-safety` · `cost-tracking`
-- **Run AI on** — `replicate` · `runpod` · `modal` · `huggingface` · `ollama` · `together-fireworks` · `fal`
+[analytics](skills/analytics/) · [dashboard](skills/dashboard/) · [kpi-framework](skills/kpi-framework/) · [reporting](skills/reporting/) · [ab-testing](skills/ab-testing/) · [forecasting](skills/forecasting/) · [data-cleaning](skills/data-cleaning/) · [business-intelligence](skills/business-intelligence/)
+### 🤖 AI — build it in
+[building-agents](skills/building-agents/) · [rag](skills/rag/) · [embeddings-search](skills/embeddings-search/) · [prompt-engineering](skills/prompt-engineering/) · [llm-pipeline](skills/llm-pipeline/) · [agent-eval](skills/agent-eval/) · [chatbot](skills/chatbot/) · [ai-media](skills/ai-media/) · [replicate-images](skills/replicate-images/) · [structured-extraction](skills/structured-extraction/) · [agent-safety](skills/agent-safety/) · [cost-tracking](skills/cost-tracking/)
+### 🛰️ AI — run it on
+[replicate](skills/replicate/) · [runpod](skills/runpod/) · [modal](skills/modal/) · [huggingface](skills/huggingface/) · [ollama](skills/ollama/) · [together-fireworks](skills/together-fireworks/) · [fal](skills/fal/)
 ### 🗣️ Languages
-`typescript` · `python` · `java` · `csharp-dotnet` · `php` · `ruby` · `cpp` · `elixir` · `bash-scripting` · `sql` · `go` *(+ `fastapi` for async Python services)*
+[typescript](skills/typescript/) · [python](skills/python/) · [java](skills/java/) · [csharp-dotnet](skills/csharp-dotnet/) · [php](skills/php/) · [ruby](skills/ruby/) · [cpp](skills/cpp/) · [elixir](skills/elixir/) · [bash-scripting](skills/bash-scripting/) · [sql](skills/sql/) · [go](skills/go/)
 ### 🏗️ Frameworks & app stacks
-`nextjs` · `react` · `react-native` · `vue-nuxt` · `angular` · `svelte` · `astro` · `solid-js` · `htmx` · `nodejs` · `nestjs` · `django` · `laravel` · `rails` · `spring-boot` · `phoenix` · `flutter` · `swift-ios` · `kotlin-android` · `compose-multiplatform` · `expo` · `tauri` · `electron` · `rust` · `wordpress` · `shopify` · `no-code-app` · `chrome-extension` · `api-design`
+[fastapi](skills/fastapi/) · [nextjs](skills/nextjs/) · [react](skills/react/) · [react-native](skills/react-native/) · [vue-nuxt](skills/vue-nuxt/) · [angular](skills/angular/) · [svelte](skills/svelte/) · [astro](skills/astro/) · [solid-js](skills/solid-js/) · [htmx](skills/htmx/) · [nodejs](skills/nodejs/) · [nestjs](skills/nestjs/) · [django](skills/django/) · [laravel](skills/laravel/) · [rails](skills/rails/) · [spring-boot](skills/spring-boot/) · [phoenix](skills/phoenix/) · [flutter](skills/flutter/) · [swift-ios](skills/swift-ios/) · [kotlin-android](skills/kotlin-android/) · [compose-multiplatform](skills/compose-multiplatform/) · [expo](skills/expo/) · [tauri](skills/tauri/) · [electron](skills/electron/) · [rust](skills/rust/) · [wordpress](skills/wordpress/) · [shopify](skills/shopify/) · [no-code-app](skills/no-code-app/) · [chrome-extension](skills/chrome-extension/) · [api-design](skills/api-design/)
 ### 🗄️ Databases & data layer
-`postgresdb` · `mysql` · `mongodb` · `redis` · `supabase` · `neon` · `planetscale` · `sqlite-turso` · `prisma-orm` · `drizzle-orm` · `firebase` · `dynamodb` · `vector-db` · `clickhouse-analytics` · `duckdb` · `db-migrations` · `backups`
-### ☁️ Ship & operate
-- **Platforms** — `vercel` · `netlify` · `cloudflare` · `railway` · `render` · `fly-io` · `coolify` · `hetzner` · `digitalocean` · `aws-essentials` · `gcp-essentials`
-- **DevOps** — `docker` · `github-actions` · `git-workflow` · `domains-dns` · `monitoring` · `email-deliverability` · `scaling` · `deployment`
-- **Quality & security** — `code-review` · `security-scan` · `secure-coding` · `testing-py` · `testing-web` · `testing-go` · `e2e-testing` · `accessibility` · `performance` · `error-handling` · `observability`
+[postgresdb](skills/postgresdb/) · [mysql](skills/mysql/) · [mongodb](skills/mongodb/) · [redis](skills/redis/) · [supabase](skills/supabase/) · [neon](skills/neon/) · [planetscale](skills/planetscale/) · [sqlite-turso](skills/sqlite-turso/) · [prisma-orm](skills/prisma-orm/) · [drizzle-orm](skills/drizzle-orm/) · [firebase](skills/firebase/) · [dynamodb](skills/dynamodb/) · [vector-db](skills/vector-db/) · [clickhouse-analytics](skills/clickhouse-analytics/) · [duckdb](skills/duckdb/) · [db-migrations](skills/db-migrations/) · [backups](skills/backups/)
+### ☁️ Ship & operate — platforms
+[vercel](skills/vercel/) · [netlify](skills/netlify/) · [cloudflare](skills/cloudflare/) · [railway](skills/railway/) · [render](skills/render/) · [fly-io](skills/fly-io/) · [coolify](skills/coolify/) · [hetzner](skills/hetzner/) · [digitalocean](skills/digitalocean/) · [aws-essentials](skills/aws-essentials/) · [gcp-essentials](skills/gcp-essentials/)
+### 🛠️ Ship & operate — devops
+[docker](skills/docker/) · [github-actions](skills/github-actions/) · [git-workflow](skills/git-workflow/) · [domains-dns](skills/domains-dns/) · [monitoring](skills/monitoring/) · [email-deliverability](skills/email-deliverability/) · [scaling](skills/scaling/) · [deployment](skills/deployment/)
+### 🔒 Ship & operate — quality & security
+[code-review](skills/code-review/) · [security-scan](skills/security-scan/) · [secure-coding](skills/secure-coding/) · [testing-py](skills/testing-py/) · [testing-web](skills/testing-web/) · [testing-go](skills/testing-go/) · [e2e-testing](skills/e2e-testing/) · [accessibility](skills/accessibility/) · [performance](skills/performance/) · [error-handling](skills/error-handling/) · [observability](skills/observability/)
 ### 🎨 Design & content craft
-`design` · `presentations` · `course-storytelling` · `course-builder` · `technical-writing` · `translation-l10n`
+[design](skills/design/) · [presentations](skills/presentations/) · [course-storytelling](skills/course-storytelling/) · [course-builder](skills/course-builder/) · [technical-writing](skills/technical-writing/) · [translation-l10n](skills/translation-l10n/)
 ### 🧠 Knowledge & meta
-`knowledge-ops` · `codebase-onboarding` · `research-ops` · `decision-records` · `continuous-learning` · `skill-scout` · `context-budget`
+[knowledge-ops](skills/knowledge-ops/) · [codebase-onboarding](skills/codebase-onboarding/) · [research-ops](skills/research-ops/) · [decision-records](skills/decision-records/) · [continuous-learning](skills/continuous-learning/) · [skill-scout](skills/skill-scout/) · [context-budget](skills/context-budget/)
 ---

package/manifest.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.1",
+  "version": "0.1.3",
   "counts": {
     "skills": 231
   },

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "rsc-universal",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Eric Risco's agent-skills catalog as a granular, self-recommending CLI installer.",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "validate": "node scripts/build-manifest.js --validate",
     "test": "node --test",
     "coverage": "c8 --reporter=text node --test",
+    "version": "npm run manifest && git add manifest.json",
     "prepublishOnly": "npm run manifest && npm run validate"
   },
   "dependencies": {

package/scripts/lib/domains.js ADDED Viewed

@@ -0,0 +1,30 @@
+// domains.js — the catalog grouped by what the user is trying to do.
+// Single source for the CLI's manual picker. Every skill id in the manifest
+// MUST appear in exactly one domain (enforced by tests/domains.test.js) so the
+// catalog grows deliberately, never silently.
+export const DOMAINS = [
+  { title: 'Core & control plane', ids: ['init', 'harness', 'orient', 'suggest', 'author-skill', 'sdd-init'] },
+  { title: 'Spec-Driven Development', ids: ['sdd', 'constitution', 'specify', 'clarify', 'plan', 'tasks', 'analyze', 'implement', 'verify', 'review', 'ship', 'debug', 'worktrees', 'parallel'] },
+  { title: 'Run a business', ids: ['finance-ops', 'invoicing', 'bookkeeping', 'pricing', 'sales-pipeline', 'lead-gen', 'cold-outreach', 'proposals', 'contracts', 'customer-support', 'client-onboarding', 'retention', 'hiring', 'people-ops', 'inventory', 'logistics-ops', 'procurement', 'meeting-notes', 'sop-builder', 'project-ops'] },
+  { title: 'Raise & model money', ids: ['pitch-deck', 'investor-materials', 'financial-model', 'fundraising', 'unit-economics', 'grants'] },
+  { title: 'Legal, privacy & compliance', ids: ['gdpr-privacy', 'terms-conditions', 'compliance', 'data-policy', 'ip-trademark'] },
+  { title: 'Market & brand', ids: ['marketing', 'seo-geo', 'content-engine', 'social-publisher', 'brand-voice', 'brand-identity', 'newsletter', 'landing-copy', 'ads', 'article-writing', 'case-studies', 'video-shorts', 'podcast', 'market-research', 'competitor-watch', 'press-kit', 'community', 'webinar', 'review-management'] },
+  { title: 'Grow a channel (YouTube / TikTok / Reels / LinkedIn / Medium)', ids: ['youtube-api', 'youtube-strategy', 'youtube-ideation', 'youtube-thumbnails', 'youtube-packaging', 'remotion-video', 'tiktok-api', 'instagram-api', 'shortform-strategy', 'shortform-ideation', 'shortform-packaging', 'shortform-editing', 'linkedin-api', 'linkedin-strategy', 'linkedin-content', 'linkedin-carousels', 'linkedin-outreach', 'medium-writing', 'medium-publishing', 'medium-strategy'] },
+  { title: 'Connect & automate', ids: ['stripe', 'email-connector', 'google-workspace', 'notion-connector', 'whatsapp-telegram', 'automation-flows', 'api-connector-builder', 'webhooks', 'data-scraper', 'spreadsheet-ops', 'calendar-scheduling', 'document-processing', 'e-signature'] },
+  { title: 'Data & analytics', ids: ['analytics', 'dashboard', 'kpi-framework', 'reporting', 'ab-testing', 'forecasting', 'data-cleaning', 'business-intelligence'] },
+  { title: 'AI — build it in', ids: ['building-agents', 'rag', 'embeddings-search', 'prompt-engineering', 'llm-pipeline', 'agent-eval', 'chatbot', 'ai-media', 'replicate-images', 'structured-extraction', 'agent-safety', 'cost-tracking'] },
+  { title: 'AI — run it on', ids: ['replicate', 'runpod', 'modal', 'huggingface', 'ollama', 'together-fireworks', 'fal'] },
+  { title: 'Languages', ids: ['typescript', 'python', 'java', 'csharp-dotnet', 'php', 'ruby', 'cpp', 'elixir', 'bash-scripting', 'sql', 'go'] },
+  { title: 'Frameworks & app stacks', ids: ['fastapi', 'nextjs', 'react', 'react-native', 'vue-nuxt', 'angular', 'svelte', 'astro', 'solid-js', 'htmx', 'nodejs', 'nestjs', 'django', 'laravel', 'rails', 'spring-boot', 'phoenix', 'flutter', 'swift-ios', 'kotlin-android', 'compose-multiplatform', 'expo', 'tauri', 'electron', 'rust', 'wordpress', 'shopify', 'no-code-app', 'chrome-extension', 'api-design'] },
+  { title: 'Databases & data layer', ids: ['postgresdb', 'mysql', 'mongodb', 'redis', 'supabase', 'neon', 'planetscale', 'sqlite-turso', 'prisma-orm', 'drizzle-orm', 'firebase', 'dynamodb', 'vector-db', 'clickhouse-analytics', 'duckdb', 'db-migrations', 'backups'] },
+  { title: 'Ship & operate — platforms', ids: ['vercel', 'netlify', 'cloudflare', 'railway', 'render', 'fly-io', 'coolify', 'hetzner', 'digitalocean', 'aws-essentials', 'gcp-essentials'] },
+  { title: 'Ship & operate — devops', ids: ['docker', 'github-actions', 'git-workflow', 'domains-dns', 'monitoring', 'email-deliverability', 'scaling', 'deployment'] },
+  { title: 'Ship & operate — quality & security', ids: ['code-review', 'security-scan', 'secure-coding', 'testing-py', 'testing-web', 'testing-go', 'e2e-testing', 'accessibility', 'performance', 'error-handling', 'observability'] },
+  { title: 'Design & content craft', ids: ['design', 'presentations', 'course-storytelling', 'course-builder', 'technical-writing', 'translation-l10n'] },
+  { title: 'Knowledge & meta', ids: ['knowledge-ops', 'codebase-onboarding', 'research-ops', 'decision-records', 'continuous-learning', 'skill-scout', 'context-budget'] },
+];
+export function allDomainIds() {
+  return DOMAINS.flatMap((d) => d.ids);
+}

package/scripts/lib/recommend.js CHANGED Viewed

@@ -1,21 +1,21 @@
 import { skillById } from './manifest.js';
 const OUTCOMES = {
-  suggest: 'Un asistente que te va proponiendo lo que necesitas',
-  harness: 'Un espacio de trabajo ordenado: conecta y documenta tu empresa',
-  init: 'Arranque guiado de tu proyecto',
-  nextjs: 'Tu web (rápida y lista para Google)',
-  flutter: 'Tu app de móvil',
-  fastapi: 'Tu API / backend en Python',
-  go: 'Tu servicio backend en Go',
-  postgresdb: 'Guardar tus datos de forma fiable',
-  design: 'Que se vea bien y convierta',
-  marketing: 'Textos que venden',
-  presentations: 'Presentaciones con tu marca',
-  'course-storytelling': 'Enseñar de forma que se entienda',
-  'building-agents': 'Un agente de IA propio',
-  'secure-coding': 'Que sea seguro',
-  deployment: 'Publicarlo online',
+  suggest: 'An assistant that proposes what you need as you go',
+  harness: 'A tidy workspace: connect and document your company',
+  init: 'Guided project bootstrap',
+  nextjs: 'Your website (fast, ready for Google)',
+  flutter: 'Your mobile app',
+  fastapi: 'Your API / Python backend',
+  go: 'Your Go backend service',
+  postgresdb: 'Store your data reliably',
+  design: 'Make it look good and convert',
+  marketing: 'Copy that sells',
+  presentations: 'On-brand presentations',
+  'course-storytelling': 'Teach so it actually lands',
+  'building-agents': 'Your own AI agent',
+  'secure-coding': 'Make it secure',
+  deployment: 'Put it online',
 };
 export function hasOutcome(id) {

package/scripts/lib/ui.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { createInterface } from 'node:readline/promises';
+import { createInterface, emitKeypressEvents } from 'node:readline';
 import { stdin, stdout } from 'node:process';
 export async function ask(question) {
@@ -13,5 +13,131 @@ export function say(...lines) {
 }
 export function yes(s) {
-  return /^(s|si|sí|y|yes|ok|vale|dale)/i.test(s.trim());
+  return /^(s|si|sí|y|yes|ok|sure|yeah)/i.test(s.trim());
+}
+// ---------------------------------------------------------------------------
+// Interactive arrow-key / space TUI (zero dependencies).
+// Falls back to a typed-number prompt when there is no interactive TTY
+// (CI, pipes, dumb terminals) so scripts and tests never hang.
+// ---------------------------------------------------------------------------
+function interactive() {
+  return Boolean(stdin.isTTY && stdout.isTTY);
+}
+const C = {
+  dim: (s) => `\x1b[2m${s}\x1b[22m`,
+  bold: (s) => `\x1b[1m${s}\x1b[22m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[39m`,
+  green: (s) => `\x1b[32m${s}\x1b[39m`,
+};
+// Repaint a fixed block of lines in place (cursor ends just below the block).
+function makePainter() {
+  let height = 0;
+  return (lines) => {
+    if (height) stdout.write(`\x1b[${height}A`);
+    stdout.write(lines.map((l) => `\x1b[2K${l}`).join('\n') + '\n');
+    height = lines.length;
+  };
+}
+function captureKeys(onKey) {
+  emitKeypressEvents(stdin);
+  if (stdin.isTTY) stdin.setRawMode(true);
+  stdin.resume();
+  const handler = (str, key) => onKey(str, key || {});
+  stdin.on('keypress', handler);
+  return () => {
+    stdin.off('keypress', handler);
+    if (stdin.isTTY) stdin.setRawMode(false);
+    stdin.pause();
+  };
+}
+// Single choice: ↑↓ to move, Enter to pick. options: [{ key, label }].
+function tuiSelect(question, options) {
+  return new Promise((resolve) => {
+    let i = 0;
+    const paint = makePainter();
+    const render = () => paint([
+      C.bold(question),
+      C.dim('  ↑↓ move · enter select'),
+      ...options.map((o, idx) =>
+        idx === i ? `${C.cyan('❯')} ${C.cyan(o.label)}` : `  ${o.label}`),
+    ]);
+    render();
+    const stop = captureKeys((str, key) => {
+      if (key.name === 'up' || key.name === 'k') { i = (i - 1 + options.length) % options.length; render(); }
+      else if (key.name === 'down' || key.name === 'j') { i = (i + 1) % options.length; render(); }
+      else if (key.name === 'return') { stop(); resolve(options[i].key); }
+      else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) { stop(); stdout.write('\n'); process.exit(130); }
+    });
+  });
+}
+// Multi-select: ↑↓ move, space toggle, a = all, enter confirm. Viewport scrolls.
+function tuiChecklist(title, items) {
+  return new Promise((resolve) => {
+    const VISIBLE = Math.min(items.length, 12);
+    const sel = new Set();
+    let cur = 0; let top = 0;
+    const paint = makePainter();
+    const render = () => {
+      if (cur < top) top = cur;
+      if (cur >= top + VISIBLE) top = cur - VISIBLE + 1;
+      const rows = [];
+      for (let r = top; r < top + VISIBLE; r++) {
+        const it = items[r];
+        const box = sel.has(r) ? C.green('◉') : '◯';
+        const line = `${box} ${it.label}`;
+        rows.push(r === cur ? `${C.cyan('❯')} ${C.cyan(line)}` : `  ${line}`);
+      }
+      const more = items.length > VISIBLE ? C.dim(`  (${cur + 1}/${items.length})`) : '';
+      paint([
+        C.bold(title),
+        C.dim('  ↑↓ move · space toggle · a all · enter confirm') + more,
+        ...rows,
+      ]);
+    };
+    render();
+    const stop = captureKeys((str, key) => {
+      if (key.name === 'up' || key.name === 'k') { cur = (cur - 1 + items.length) % items.length; render(); }
+      else if (key.name === 'down' || key.name === 'j') { cur = (cur + 1) % items.length; render(); }
+      else if (key.name === 'space') { sel.has(cur) ? sel.delete(cur) : sel.add(cur); render(); }
+      else if (str === 'a') { if (sel.size === items.length) sel.clear(); else items.forEach((_, idx) => sel.add(idx)); render(); }
+      else if (key.name === 'return') { stop(); resolve([...sel].sort((x, y) => x - y).map((idx) => items[idx].id)); }
+      else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) { stop(); stdout.write('\n'); process.exit(130); }
+    });
+  });
+}
+// Public: single-choice menu. options: [{ key, label }]. Returns the chosen key.
+export async function select(question, options) {
+  if (interactive()) return tuiSelect(question, options);
+  // Fallback: typed number.
+  say(question);
+  options.forEach((o, i) => say(`  ${i + 1}) ${o.label}`));
+  const a = (await ask('> ')).toLowerCase();
+  const n = parseInt(a, 10);
+  if (n >= 1 && n <= options.length) return options[n - 1].key;
+  const byKey = options.find((o) => o.key.toLowerCase() === a);
+  return byKey ? byKey.key : null;
+}
+// Public: multi-select. items: array of strings or { id, label }. Returns ids.
+export async function pickFrom(title, items) {
+  const norm = items.map((it) => (typeof it === 'string' ? { id: it, label: it } : it));
+  if (interactive()) return tuiChecklist(title, norm);
+  // Fallback: comma-separated numbers.
+  say(`\n${title}`);
+  norm.forEach((it, i) => say(`  ${String(i + 1).padStart(2)}) ${it.label}`));
+  say('   Comma-separated numbers (e.g. 1,3,4), "all", or Enter for none.');
+  const a = (await ask('> ')).trim();
+  if (!a) return [];
+  if (/^(all|todo|todas)$/i.test(a)) return norm.map((it) => it.id);
+  return [...new Set(
+    a.split(',').map((s) => parseInt(s.trim(), 10)).filter((x) => x >= 1 && x <= norm.length).map((x) => norm[x - 1].id),
+  )];
 }

package/scripts/rsc.js CHANGED Viewed

@@ -6,8 +6,9 @@ import { rank } from './consult.js';
 import { expandRecommends, toOutcomes, hasOutcome } from './lib/recommend.js';
 import { applyInstall, listInstalled, uninstall } from './install-apply.js';
 import { doctor } from './doctor.js';
-import { ask, say, yes } from './lib/ui.js';
+import { ask, say, yes, select, pickFrom } from './lib/ui.js';
 import { refreshRegistry, registryStatus } from './lib/registry.js';
+import { DOMAINS } from './lib/domains.js';
 const argv = process.argv.slice(2);
 const cmd = argv[0];
@@ -29,25 +30,102 @@ async function recommendIds(query, { labeledOnly = false } = {}) {
   return out.slice(0, 6);
 }
-async function wizard() {
-  say('Hola 👋 ¿Qué quieres hacer?');
-  const goal = await ask('> ');
+// Pick skills by browsing the domains, accumulating across rounds.
+async function manualSelect() {
+  const chosen = new Set();
+  for (;;) {
+    const opts = DOMAINS.map((d, i) => ({ key: String(i), label: `${d.title} (${d.ids.length})` }));
+    opts.push({ key: 'done', label: chosen.size ? `✅ Finish & install (${chosen.size} chosen)` : 'Finish without choosing anything' });
+    const k = await select('\nWhich area do you want to install skills from?', opts);
+    if (k === 'done' || k === null) break;
+    const d = DOMAINS[parseInt(k, 10)];
+    (await pickFrom(`${d.title}:`, d.ids)).forEach((id) => chosen.add(id));
+    say(`   → ${chosen.size} skills chosen so far.`);
+  }
+  return [...chosen];
+}
+// Describe-your-project flow: rsc reads repo + words and proposes skills.
+async function describeFlow() {
+  const goal = await ask('\nTell me in one sentence what you want to build or run:\n> ');
   const ids = await recommendIds(goal, { labeledOnly: true });
   if (!ids.length) {
-    say('No estoy seguro de qué necesitas. Prueba a describir tu proyecto con más detalle.');
-    return;
+    say("I'm not sure. Try describing it in more detail, or pick by hand (option 3).");
+    return [];
   }
-  say('\nHe preparado esto para ti:');
+  say('\nI recommend installing:');
   for (const o of toOutcomes(ids)) say(`   • ${o.label}`);
-  const ok = yes(await ask('\n¿Lo monto? (sí / no) > '));
-  if (!ok) {
-    say('Sin problema. Cuando quieras: npx rsc');
+  return ids;
+}
+// After installing, remind the user how to actually start — per IDE — and that
+// rsc keeps recommending skills as they work. The harness/SDD *init* runs INSIDE
+// the assistant (with the user present), never blindly from this CLI.
+function printNextSteps(target, ids) {
+  const hasHarness = ids.includes('harness');
+  const hasSdd = ids.includes('sdd') || ids.includes('sdd-init');
+  const openLine = {
+    claude: 'Open **Claude Code** in this project folder.',
+    cursor: 'Open **Cursor** in this project folder.',
+    codex: 'Open **Codex CLI** (it reads AGENTS.md) in this project folder.',
+    gemini: 'Open **Gemini CLI** in this project folder.',
+  }[target] || 'Open your assistant in this project folder.';
+  say('\n────────────────────────────────────────────────────────');
+  say('👉 When you start working (these steps happen in your assistant, not here):');
+  let n = 1;
+  say(`   ${n++}. ${openLine}`);
+  if (hasHarness) {
+    say(`   ${n++}. Set up the second brain — tell it:`);
+    say('        "set up the harness for this project"');
+    say('      → creates 01-TOOLS/ (connections) + 02-DOCS/ (wiki) + CLAUDE.md/AGENTS.md.');
+  }
+  if (hasSdd) {
+    say(`   ${n++}. For a new feature, tell it:`);
+    say('        "sdd-init"   then   "I want <your idea>"');
+    say('      → walks you specify → plan → tasks → implement → verify → ship.');
+  }
+  say(`   ${n++}. From there, work in your own words. orient + suggest stay always-on:`);
+  say('      they keep you oriented after each step and propose the missing skill (you confirm, it installs).');
+  say('\n   Add something by hand anytime:    npx rsc add <skill>');
+  say('   Browse the catalog / get picks:   npx rsc consult "whatever you need"');
+  say('────────────────────────────────────────────────────────');
+}
+async function wizard() {
+  const m = loadManifest();
+  say('👋 rsc — the skill catalog for your assistant (Claude Code · Cursor · Codex · Gemini).');
+  const choice = await select('\nWhat do you want to do?', [
+    { key: 'base', label: 'Base install — the essentials (orient + suggest + harness + init)' },
+    { key: 'sdd', label: 'Base + Spec-Driven Development — the specify → plan → implement → ship flow' },
+    { key: 'manual', label: 'Pick skills by hand, by area' },
+    { key: 'describe', label: 'Describe my project and let rsc choose' },
+  ]);
+  let ids = [];
+  if (choice === 'base') ids = skillsForProfile(m, 'minimal');
+  else if (choice === 'sdd') ids = skillsForProfile(m, 'core');
+  else if (choice === 'manual') ids = await manualSelect();
+  else if (choice === 'describe') ids = await describeFlow();
+  else { say("Didn't catch that. Run again: npx rsc"); return; }
+  // The floor is always installed: the compass + the detector.
+  ids = [...new Set(['orient', 'suggest', ...ids])];
+  if (ids.length <= 2 && choice !== 'base') {
+    say('\nNo skills were chosen. Anytime: npx rsc');
     return;
   }
   const target = detectTarget();
-  await applyInstall({ skillIds: [...new Set(['suggest', ...ids])], target });
-  say('\n✅ Listo. Abre tu editor y empieza a pedir cosas en tu idioma.');
-  say('   💡 Para añadir más cuando lo necesites, vuelve a escribir: npx rsc');
+  say(`\nI'll install ${ids.length} skills into ${target}:`);
+  say('   ' + ids.join(', '));
+  if (!yes(await ask('\nInstall it? (yes / no) > '))) {
+    say('No problem. Anytime: npx rsc');
+    return;
+  }
+  await applyInstall({ skillIds: ids, target });
+  say(`\n✅ Installed ${ids.length} skills into ${target}.`);
+  printNextSteps(target, ids);
 }
 async function main() {
@@ -56,49 +134,49 @@ async function main() {
     case undefined:
       return wizard();
     case 'add':
-      await applyInstall({ skillIds: [...new Set(['suggest', ...argv.slice(1)])], target });
-      return void say(`✅ Instalado: ${argv.slice(1).join(', ')}`);
+      await applyInstall({ skillIds: [...new Set(['orient', 'suggest', ...argv.slice(1)])], target });
+      return void say(`✅ Installed: ${argv.slice(1).join(', ')}`);
     case 'install': {
       const profile = flag('profile') || 'minimal';
       const without = argv.filter((a, i) => argv[i - 1] === '--without');
       let ids = skillsForProfile(loadManifest(), profile);
-      ids = [...new Set(['suggest', ...ids])].filter((id) => !without.includes(id));
+      ids = [...new Set(['orient', 'suggest', ...ids])].filter((id) => !without.includes(id));
       await applyInstall({ skillIds: ids, target });
-      return void say(`✅ Perfil '${profile}' instalado en ${target} (${ids.length} skills)`);
+      return void say(`✅ Profile '${profile}' installed into ${target} (${ids.length} skills)`);
     }
     case 'consult': {
       const ids = await recommendIds(argv.slice(1).join(' '));
-      if (!ids.length) return void say('(sin recomendaciones)');
+      if (!ids.length) return void say('(no recommendations)');
       for (const o of toOutcomes(ids)) say(`${o.id}\t${o.label}`);
       return;
     }
     case 'list':
-      return void say(listInstalled({ target }).join('\n') || '(nada instalado)');
+      return void say(listInstalled({ target }).join('\n') || '(nothing installed)');
     case 'doctor':
       return void say(JSON.stringify(doctor({ target }), null, 2));
     case 'registry': {
       const sub = argv[1];
       if (sub === 'refresh') {
         const registry = refreshRegistry({ target });
-        say(`✅ Registry actualizado: .rsc/skill-registry.md (${registry.counts.skills} skills)`);
+        say(`✅ Registry updated: .rsc/skill-registry.md (${registry.counts.skills} skills)`);
         return;
       }
       if (sub === 'status') {
         say(JSON.stringify(registryStatus(), null, 2));
         return;
       }
-      say('Usa: npx rsc registry refresh | registry status');
+      say('Use: npx rsc registry refresh | registry status');
       return;
     }
     case 'uninstall': {
       const dry = argv.includes('--dry-run');
       const ids = argv.slice(1).filter((a) => !a.startsWith('--'));
       const removed = await uninstall({ skillIds: ids, target, dryRun: dry });
-      return void say((dry ? 'Se borraría:\n' : 'Borrado:\n') + (removed.join('\n') || '(nada)'));
+      return void say((dry ? 'Would remove:\n' : 'Removed:\n') + (removed.join('\n') || '(nothing)'));
     }
     default:
-      say(`rsc: comando desconocido '${cmd}'.`);
-      say('Usa: npx rsc | add <id...> | install --profile <p> | consult "<texto>" | list | registry refresh | doctor | uninstall <id>');
+      say(`rsc: unknown command '${cmd}'.`);
+      say('Use: npx rsc | add <id...> | install --profile <p> | consult "<text>" | list | registry refresh | doctor | uninstall <id>');
   }
 }