@pushrec/skills 0.2.0 → 0.3.2

package/bundled-skills/README.md

@@ -0,0 +1,9 @@
+# Bundled Skills
+
+This directory contains skills bundled with the CLI package.
+These skills are installed automatically during `npx @pushrec/skills setup`.
+
+## pushrec-skills
+
+Universal entry point for all pushREC skill operations.
+Copied to ~/.claude/skills/pushrec-skills/ during setup if not already installed.

package/bundled-skills/pushrec-skills/SKILL.md

@@ -0,0 +1,360 @@
+---
+name: pushrec-skills
+version: 1.0.0
+description: "Universal entry point for all pushREC skill operations. Onboarding, skill discovery, troubleshooting, API key setup, and update guidance. Use when: first time using pushREC skills, need help finding the right skill, skill isn't working, setting up API keys, updating skills, or asking how skills work. Aliases: /onboarding, /start, /get-started, /help, /skills, /pushrec."
+category: meta-tools
+aliases: [onboarding, start, get-started, help, skills, pushrec]
+session_behavior: on-demand
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion]
+---
+
+# pushREC Skills
+
+Universal entry point for all pushREC skill operations. Handles first-time onboarding, skill discovery, troubleshooting, API key setup, and update guidance.
+
+## Capabilities
+
+| Mode | Trigger | What It Does |
+|------|---------|-------------|
+| **Onboarding** | First-time user (no profile.json) | Diagnostic, profiling, CC 101, first win, skill map, unlock guide |
+| **Recommendation** | "Which skill for X?" | Scan loaded skill descriptions, rank matches, explain WHY |
+| **Troubleshooting** | "X not working" | Run diagnostic, decision tree, escalation path |
+| **API Key Setup** | "Set up API keys" | Read prerequisites.yaml, guide step-by-step by level |
+| **Update Guidance** | "Update skills" | CLI commands for update, list, install new |
+| **System Info** | General questions | Explain how skills work, architecture, concepts |
+
+### Paradigm: LLM-Native Recommendations
+
+Claude Code auto-loads ALL installed skill names and descriptions into every session context. You already know what every skill does. No catalog file or recommendation script needed. You ARE the recommendation engine. The only hardcoded data is `references/prerequisites.yaml` (API key requirements cannot be inferred from descriptions).
+
+---
+
+## Intent Detection Protocol
+
+Think step by step. Before responding, determine the user's mode.
+
+### Step 1: Check State Files
+
+```bash
+ls ~/.claude/skills/pushrec-skills/state/profile.json 2>/dev/null
+ls ~/.claude/skills/pushrec-skills/state/progress.json 2>/dev/null
+```
+
+### Step 2: Route Based on State + Input
+
+| State | User Signal | Route To |
+|-------|-------------|----------|
+| No profile.json | Any | First-Time Onboarding |
+| Profile exists, onboarding incomplete | Any | Resume Onboarding (pick up where they left off) |
+| Profile exists | "X not working", error messages | Troubleshooting Protocol |
+| Profile exists | "update", "new skills" | Update Guidance |
+| Profile exists | "API key", "set up Google", credential terms | API Key Setup |
+| Profile exists | Skill-related question | Recommendation Protocol |
+| Profile exists | General system question | System Info (explain concepts) |
+| Any | "reset", "start over" | Delete state/ directory, restart onboarding |
+| Ambiguous | Cannot determine intent | Ask ONE clarifying question |
+
+---
+
+## First-Time Onboarding
+
+Six phases, executed sequentially. Track progress in `state/progress.json`.
+
+### Phase 0: Diagnostic
+
+Run the system readiness check:
+
+```bash
+python3 ~/.claude/skills/pushrec-skills/scripts/diagnostic.py
+```
+
+Parse the JSON output. Present results as a checklist:
+- PASS items: brief confirmation
+- FAIL items (exit code 1): STOP. Guide the user to fix critical prerequisites before continuing.
+- WARN items (exit code 2): note but continue
+
+If Claude Code, Node.js, or npm are missing, provide platform-specific install instructions and STOP. Do not proceed with onboarding until critical prerequisites pass.
+
+Write `state/progress.json` with `diagnostic: {status: "completed"}`.
+
+### Phase 1: Adaptive Profiling
+
+Gather business context to personalize skill recommendations. Use conversational questions, not a rigid form. Write answers to `state/profile.json`.
+
+**Round 1 (always ask -- 3 questions):**
+1. What type of business do you run? (agency, coaching, SaaS, e-commerce, freelance, creator, other)
+2. What is your primary content platform? (LinkedIn, X/Twitter, YouTube, Instagram, email, podcast, blog, other)
+3. What is your biggest challenge right now? (not enough content, low engagement, no leads, poor conversion, time management, scaling, other)
+
+**Round 2 (ask if user seems engaged and responsive -- 3 questions):**
+4. Who is your target audience? (open text)
+5. What is your approximate monthly revenue range? (pre-revenue, <$10K, $10-50K, $50-100K, $100K+)
+6. How much experience do you have with AI tools? (never used, tried a few times, use weekly, use daily)
+
+**Round 3 (ask if terminal comfort or CC experience is NOT obvious from prior answers -- 2 questions):**
+7. How comfortable are you with the terminal/command line? (never used, basic, comfortable, advanced)
+8. How much experience do you have with Claude Code specifically? (never, barely, sometimes, regularly, daily)
+
+**Adaptive rules:**
+- If the user gives short or impatient answers, skip remaining rounds
+- If diagnostic shows many installed skills and API keys, skip Round 3 (infer advanced user)
+- Write profile.json after each round completes (progressive save)
+
+**profile.json schema:** `{"version":"1.0.0", "created_at":"ISO", "business_type":"agency", "content_platform":"linkedin", "biggest_challenge":"not-enough-content", "target_audience":"B2B SaaS founders", "revenue_range":"$50-100K", "ai_experience":"use-daily", "terminal_comfort":"comfortable", "cc_experience":"barely"}`
+
+Write `progress.json` with `profiling: {status: "completed"}`.
+
+### Phase 2: Claude Code 101
+
+**Conditional:** Skip if `cc_experience` is "regularly" or "daily". Mark as `skipped` with reason in progress.json.
+
+Deliver a 60-second overview covering ONLY these basics:
+- Skills are invoked by typing `/skill-name` (for example, `/hormozi`, `/linkedin-copywriting`)
+- Claude Code already sees all your installed skill descriptions -- just describe what you need and it finds the right skill
+- Skills produce real output: copy, strategies, images, automations
+- You can chain skills together in a single conversation
+
+Do NOT cover: hooks, sub-agents, settings files, MCP servers, teams, or advanced orchestration. Those are Level 5 concepts.
+
+Write `progress.json` with `cc101: {status: "completed"}` or `{status: "skipped", reason: "cc_experience=regularly"}`.
+
+### Phase 3: First Win
+
+This is the most important phase. Generate a real, valuable output using ONE skill.
+
+**Protocol:**
+1. Read `state/profile.json`
+2. Consider ALL loaded skill descriptions in your context
+3. Select the single best Level 0 skill (NO API keys required) that matches their profile
+4. Explain your choice: "Based on your profile -- [business_type] focused on [content_platform] with [biggest_challenge] -- I recommend starting with `/[skill-name]` because [specific reason]."
+5. Generate a custom context prompt they can use with that skill. For example: "Try typing: `/linkedin-copywriting` and then describe your business and target audience."
+6. WAIT for the user to try it and confirm before proceeding. Ask: "Go ahead and try it now. Let me know when you're ready to continue."
+
+**Selection criteria:**
+- Must be Level 0 (no API keys required)
+- Must directly address their biggest_challenge or content_platform
+- Prefer specific skills over general ones (e.g., `/linkedin-copywriting` over `/copywriting` for LinkedIn users)
+- Never fabricate skill names -- only recommend skills that exist in your loaded context
+
+Write `progress.json` with `first_win: {status: "completed", skill_recommended: "skill-name"}`.
+
+### Phase 4: Skill Map
+
+Present a personalized overview of available skills organized by level. Show only levels relevant to their profile.
+
+**Structure:**
+- **Level 0 -- Foundation (available now):** Group by category relevant to their profile. Highlight 5-8 most relevant skills with one-line descriptions. Mention total count (80+ skills).
+- **Level 1 -- Google Workspace:** List capabilities unlocked (Gmail, Sheets, Docs, Calendar, Drive, Contacts, Slides). Note: "~15 minutes one-time setup."
+- **Level 2 -- Creative and Data:** List key capabilities (AI image generation, voice synthesis, vision analysis, CRM). Note per-service setup time.
+- **Level 3 -- Communication:** List capabilities (SMS, AI phone agents, web scraping). Note KYC requirements.
+- **Level 4 -- Knowledge Management:** Mention Obsidian vault integration. Only highlight if user shows interest in knowledge management.
+- **Level 5 -- Advanced:** Custom agents, multi-skill workflows, hook automation, custom skill creation. Mention for power users only.
+
+Write `progress.json` with `skill_map: {status: "completed"}`.
+
+### Phase 5: Progressive Unlock
+
+Recommend the NEXT level to unlock based on their profile. One level only -- do not overwhelm.
+
+**Selection logic:**
+- If they work with Google Workspace tools: recommend Level 1
+- If they create visual content: recommend Level 2 (fal-ai, gemini-vision)
+- If they need outreach automation: recommend Level 3 (twilio)
+- Default: recommend Level 1 (broadest utility)
+
+Provide the specific setup steps for that one level. Reference `/pushrec-skills` for future API key setup help.
+
+Write `progress.json` with `unlock_guide: {status: "completed"}` and `completed_at: ISO-8601`.
+
+**progress.json schema:** `{"version":"1.0.0", "started_at":"ISO", "completed_at":null, "phases":{"diagnostic":{"status":"completed"}, "profiling":{"status":"completed"}, "cc101":{"status":"skipped","reason":"cc_experience=regularly"}, "first_win":{"status":"completed","skill_recommended":"linkedin-copywriting"}, "skill_map":{"status":"completed"}, "unlock_guide":{"status":"completed"}}, "current_level":"L0", "skills_invoked":["linkedin-copywriting"], "api_keys_configured":[], "last_session_at":"ISO"}`
+
+---
+
+## Returning User Flow
+
+If `state/profile.json` exists and `state/progress.json` shows incomplete onboarding:
+1. Read progress.json to find the last completed phase
+2. Greet: "Welcome back. You left off at [phase]. Ready to continue?"
+3. Resume from the next incomplete phase
+
+If onboarding is complete, route based on their input signal (see Intent Detection).
+
+If the user returns after a long gap (check `last_session_at`), offer a brief refresher:
+- "It has been a while. Want a quick recap of your skill map, or do you have a specific question?"
+
+Update `last_session_at` in progress.json at every session.
+
+---
+
+## Recommendation Protocol
+
+When a user asks "which skill should I use for X?" or describes a need:
+
+1. **Parse the request** into: domain (marketing, sales, content, automation, research), platform (LinkedIn, YouTube, email), and output type (copy, strategy, image, automation)
+2. **Scan ALL skill descriptions** loaded in your context. You already have them -- do not read registry.json or any catalog file.
+3. **Select top 1-3 matches.** For each match, provide:
+   - Skill name (invocable as `/name`)
+   - WHY it matches their request (one sentence)
+   - API key requirement: "No setup needed" (L0) or "Requires [KEY_NAME]" (L1-L4)
+4. **Rank by specificity:** specific skills beat general ones. Single-purpose skills beat orchestrators unless the user explicitly needs a workflow.
+5. **If uncertain,** read the candidate skill's SKILL.md before recommending to verify fit.
+6. **Never fabricate skill names.** Only recommend skills that exist in your loaded context. If no skill matches, say so honestly.
+
+Example: "For LinkedIn carousel posts, I recommend: 1. `/linkedin-copywriting` -- designed for LinkedIn content with proven copywriting psychology. No setup needed. 2. `/copywriting` -- broader foundations that work across platforms. No setup needed."
+
+---
+
+## Troubleshooting Protocol
+
+When a user reports a problem ("X is not working", errors, unexpected behavior):
+
+### Step 1: Gather Information
+
+Ask: Which skill? What command triggered the error? What error message? (Ask them to paste it.)
+
+### Step 2: Run Diagnostic
+
+```bash
+python3 ~/.claude/skills/pushrec-skills/scripts/diagnostic.py
+```
+
+Check for missing prerequisites, missing API keys, or license issues.
+
+### Step 3: Decision Tree
+
+| Symptom | Likely Cause | Fix |
+|---------|-------------|-----|
+| "command not found: claude" | Claude Code not installed | Install from anthropic.com |
+| "command not found: node" | Node.js not installed | Install from nodejs.org (v20+) |
+| "ENOENT" or file not found | Skill not installed | Run `npx @pushrec/skills install --all` |
+| Authentication/401 errors | Missing or expired API key | Guide through API key setup for that skill |
+| "Permission denied" | File permission issue | `chmod +x` the script, or check directory permissions |
+| Skill produces no output | Skill invocation issue | Verify skill name, try `/skill-name` syntax |
+| Import errors in scripts | Missing Python dependencies | Check skill's requirements, run `pip install` or `uv run --with` |
+| License validation fails | License issue | Run `npx @pushrec/skills auth login` to re-authenticate |
+
+### Step 4: Escalation
+
+If the issue cannot be resolved through troubleshooting:
+1. Suggest posting in the community: **skool.com/pushrec-2909**
+2. Include in their post: skill name, error message, diagnostic output, steps already tried
+3. Mention live Q&A sessions in Skool for real-time help
+
+---
+
+## API Key Setup
+
+When a user asks about setting up API keys or unlocking a specific level:
+
+### Step 1: Identify What They Need
+
+Read `references/prerequisites.yaml` to check requirements for the requested skill or level.
+
+### Step 2: Guide by Level
+
+**Level 1 -- Google OAuth2 (one-time, ~15 minutes):**
+1. Go to Google Cloud Console (console.cloud.google.com)
+2. Create a new project (or use existing)
+3. Enable required APIs: Gmail, Sheets, Docs, Calendar, Drive, Contacts, Slides
+4. Create OAuth 2.0 credentials (Desktop app type)
+5. Download the JSON credentials file
+6. Place it in the location specified by each skill (varies per skill -- check prerequisites.yaml)
+7. Run the skill's authenticate.py script to complete the OAuth consent flow
+
+**Level 2 -- Individual API Keys (~2-5 minutes each):**
+Walk through each service's signup:
+- Provide the setup_url from prerequisites.yaml
+- Tell them which env var to set in `~/.claude/.env`
+- Format: `echo 'KEY_NAME=your-key-here' >> ~/.claude/.env`
+
+**Level 3 -- Service Accounts (~10 minutes each):**
+- Note KYC or billing requirements upfront
+- Guide through account creation and credential setup
+- Warn about usage-based billing where applicable
+
+**Level 4 -- Obsidian:**
+- Download from obsidian.md (free)
+- Create or open a vault
+- Run `/vault-manager` for guided vault setup
+
+After setup, update `progress.json` with new entries in `api_keys_configured`.
+
+---
+
+## Update Guidance
+
+When a user asks about updating skills or finding new ones:
+
+### Update Existing Skills
+```bash
+npx @pushrec/skills update          # Update all installed skills
+npx @pushrec/skills update [name]   # Update a specific skill
+```
+
+### Install New Skills
+```bash
+npx @pushrec/skills install --all   # Install any skills added since last install
+npx @pushrec/skills list            # See all available vs. installed
+```
+
+### Check System Health
+```bash
+python3 ~/.claude/skills/pushrec-skills/scripts/diagnostic.py
+```
+
+Note: `install --all` skips already-installed skills (no duplicates). Running it again after new skills are published picks up the new ones automatically. The `update` command handles version bumps for already-installed skills.
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Correct Behavior |
+|-------------|-----------------|
+| Recommending skills not in loaded context | Only recommend skills you can see in the system context |
+| Hardcoding skill-to-profile mappings | Read profile + scan descriptions dynamically every time |
+| Dumping the full skill catalog | Show only relevant skills, grouped by the user's needs |
+| Skipping the diagnostic on first run | Always run diagnostic.py in Phase 0 |
+| Proceeding after critical failures | STOP and help fix prerequisites before continuing |
+| Recommending L1+ skills without mentioning API key requirements | Always state the setup requirement alongside the recommendation |
+
+### Verification Checklist
+
+Before finishing any response, verify:
+- Think step by step: Did I follow the correct protocol for this mode?
+- Before you finish: Are all skill names I mentioned real skills in my loaded context?
+- If you don't know: Am I certain about API key requirements, or should I check prerequisites.yaml?
+- Did I update state files (profile.json, progress.json) if the user completed a phase?
+- Did I provide clear next steps the user can act on?
+
+---
+
+## Quick Reference
+
+| Need | Command or Action |
+|------|-------------------|
+| Start onboarding | Type `/pushrec-skills` |
+| Find a skill | Describe what you need -- the LLM matches automatically |
+| Set up API keys | Type `/pushrec-skills` and ask about API key setup |
+| Update skills | `npx @pushrec/skills update` |
+| Install new skills | `npx @pushrec/skills install --all` |
+| List all skills | `npx @pushrec/skills list` |
+| Get help | Post in skool.com/pushrec-2909 |
+| Reset onboarding | Type `/pushrec-skills` and say "reset" |
+
+### Prerequisites
+
+- **Claude Code subscription:** Pro ($20/mo) or Max ($100/mo) from anthropic.com
+- **Node.js:** v20 or higher (nodejs.org)
+- **npm:** included with Node.js
+
+### State Files
+
+| File | Purpose |
+|------|---------|
+| `state/profile.json` | Business profile from adaptive profiling |
+| `state/progress.json` | Completed phases, unlocked levels, skills invoked |
+
+### Community
+
+- **Skool:** skool.com/pushrec-2909
+- **Live Q&A:** check Skool for scheduled sessions

package/bundled-skills/pushrec-skills/references/prerequisites.yaml

@@ -0,0 +1,375 @@
+# pushREC Skills Prerequisites
+# version: 1.0.0
+#
+# Skills NOT listed here require NO API keys or credentials (Level 0).
+# 80+ skills work immediately after install with zero configuration.
+#
+# Level definitions:
+#   L1: Google OAuth2 - one-time browser consent flow (~15 min total)
+#   L2: API keys - individual service signups (~2-5 min each)
+#   L3: Service accounts - KYC verification or usage-based billing (~10 min each)
+#   L4: Applications - requires desktop app (Obsidian) installed
+
+# ============================================================================
+# LEVEL 1: Google OAuth2
+# One-time setup: Create a Google Cloud project, enable APIs, create OAuth
+# credentials. All Google skills share the same GCP project.
+# ============================================================================
+
+gmail:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (one-time for all Google services)"
+      credentials_path: "~/.gmail-mcp/gcp-oauth.keys.json"
+      notes: "OAuth2 browser consent flow. Tokens stored at ~/.gmail-mcp/credentials.json"
+
+google-sheets:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.claude/.credentials/sheets-client-secret.json"
+      notes: "OAuth2 preferred. Service Account fallback supported."
+
+google-docs:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.claude/.credentials/docs-client-secret.json"
+      notes: "OAuth2 preferred. Service Account fallback supported."
+
+google-calendar:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.calendar-mcp/gcp-oauth.keys.json"
+      notes: "OAuth2 browser consent flow."
+
+google-drive:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.drive-mcp/gcp-oauth.keys.json"
+      notes: "OAuth2 browser consent flow."
+
+google-contacts:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.contacts-mcp/gcp-oauth.keys.json"
+      notes: "Read-only. Shares GCP project with Gmail."
+
+google-slides:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      credentials_path: "~/.claude/.credentials/slides-token.json"
+      notes: "OAuth2 or Service Account (GOOGLE_SERVICE_ACCOUNT_JSON)."
+
+finance-manager:
+  level: 1
+  requires:
+    - env: GOOGLE_OAUTH_CREDENTIALS
+      type: oauth2
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "15 minutes (shared with other Google services)"
+      notes: "Composes gmail + google-sheets + google-docs + ocr-processor. Set up Google OAuth first."
+
+# ============================================================================
+# LEVEL 2: API Keys
+# Individual service signups. Each key takes 2-5 minutes to obtain.
+# ============================================================================
+
+fal-ai:
+  level: 2
+  requires:
+    - env: FAL_KEY
+      type: api_key
+      service: FAL.ai
+      setup_url: https://fal.ai/dashboard/keys
+      setup_time: "2 minutes"
+      notes: "Set in ~/.claude/.env as FAL_KEY=your-key"
+
+ultimate-infographics:
+  level: 2
+  requires:
+    - env: FAL_KEY
+      type: api_key
+      service: FAL.ai
+      setup_url: https://fal.ai/dashboard/keys
+      setup_time: "2 minutes (shared with fal-ai)"
+      notes: "Uses fal-ai for Seedream 4.5 image generation."
+
+elevenlabs:
+  level: 2
+  requires:
+    - env: ELEVENLABS_API_KEY
+      type: api_key
+      service: ElevenLabs
+      setup_url: https://elevenlabs.io/app/settings/api-keys
+      setup_time: "2 minutes"
+      notes: "Set in ~/.claude/.env as ELEVENLABS_API_KEY=sk_xxx"
+
+gemini-vision:
+  level: 2
+  requires:
+    - env: GOOGLE_API_KEY
+      type: api_key
+      service: Google AI Studio
+      setup_url: https://aistudio.google.com/apikey
+      setup_time: "2 minutes"
+      notes: "Shared with ocr-processor. Set in ~/.claude/.env as GOOGLE_API_KEY=AIza..."
+
+ocr-processor:
+  level: 2
+  requires:
+    - env: GOOGLE_API_KEY
+      type: api_key
+      service: Google AI Studio
+      setup_url: https://aistudio.google.com/apikey
+      setup_time: "2 minutes (shared with gemini-vision)"
+      notes: "Primary provider: Gemini. Also supports MISTRAL_API_KEY as alternative."
+
+airtable:
+  level: 2
+  requires:
+    - env: AIRTABLE_API_KEY
+      type: api_key
+      service: Airtable
+      setup_url: https://airtable.com/create/tokens
+      setup_time: "3 minutes"
+      notes: "Personal Access Token (pat prefix). Set as AIRTABLE_API_KEY=patXXX"
+
+crm:
+  level: 2
+  requires:
+    - env: AIRTABLE_API_KEY
+      type: api_key
+      service: Airtable
+      setup_url: https://airtable.com/create/tokens
+      setup_time: "3 minutes (shared with airtable)"
+      notes: "CRM orchestration layer built on Airtable. Same API key."
+
+deploy-vercel:
+  level: 2
+  requires:
+    - env: VERCEL_TOKEN
+      type: api_key
+      service: Vercel
+      setup_url: https://vercel.com/account/tokens
+      setup_time: "2 minutes"
+      notes: "Personal access token. Set in ~/.claude/.env as VERCEL_TOKEN=xxx"
+
+retell-ai:
+  level: 2
+  requires:
+    - env: RETELL_API_KEY
+      type: api_key
+      service: Retell AI
+      setup_url: https://www.retellai.com/dashboard
+      setup_time: "3 minutes"
+      notes: "Set in ~/.claude/.env as RETELL_API_KEY=key_xxx"
+
+exa:
+  level: 2
+  requires:
+    - env: EXA_API_KEY
+      type: api_key
+      service: Exa.ai
+      setup_url: https://dashboard.exa.ai/api-keys
+      setup_time: "2 minutes"
+      notes: "AI-native search API. Set in ~/.claude/.env as EXA_API_KEY=xxx"
+
+gumroad:
+  level: 2
+  requires:
+    - env: GUMROAD_ACCESS_TOKEN
+      type: api_key
+      service: Gumroad
+      setup_url: https://app.gumroad.com/settings/advanced#application-form
+      setup_time: "3 minutes"
+      notes: "OAuth access token. Also supports ~/.gumroad/credentials file."
+
+convex:
+  level: 2
+  requires:
+    - env: CONVEX_DEPLOY_KEY
+      type: api_key
+      service: Convex
+      setup_url: https://dashboard.convex.dev
+      setup_time: "3 minutes"
+      notes: "Deploy key for Convex projects. Set in ~/.claude/.env as CONVEX_DEPLOY_KEY=xxx"
+
+youtube-api:
+  level: 2
+  requires:
+    - env: YOUTUBE_API_KEY
+      type: api_key
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "3 minutes (shared with GCP project)"
+      notes: "YouTube Data API v3. Optional - many operations work without key via yt-dlp."
+
+skool-api:
+  level: 2
+  requires:
+    - env: SKOOL_COOKIES
+      type: cookie_auth
+      service: Skool.com
+      setup_url: https://www.skool.com
+      setup_time: "5 minutes (browser login)"
+      notes: "Cookie-based auth persisted at ~/.skool/cookies.json. No API key - uses browser login."
+
+# ============================================================================
+# LEVEL 3: Service Accounts
+# Require KYC verification, usage-based billing, or special configuration.
+# ============================================================================
+
+twilio:
+  level: 3
+  requires:
+    - env: TWILIO_ACCOUNT_SID
+      type: service_account
+      service: Twilio
+      setup_url: https://console.twilio.com
+      setup_time: "10 minutes"
+    - env: TWILIO_AUTH_TOKEN
+      type: service_account
+      service: Twilio
+      setup_url: https://console.twilio.com
+      setup_time: "included above"
+    - env: TWILIO_PHONE_NUMBER
+      type: service_account
+      service: Twilio
+      setup_url: https://console.twilio.com
+      setup_time: "included above"
+      notes: "Three env vars required. KYC may be needed for full access."
+
+bright-data:
+  level: 3
+  requires:
+    - env: API_TOKEN
+      type: service_account
+      service: Bright Data
+      setup_url: https://brightdata.com/cp/setting
+      setup_time: "10 minutes"
+      notes: "Usage-based billing. Set in ~/.claude/.env as API_TOKEN=xxx"
+
+google-maps:
+  level: 3
+  requires:
+    - env: GOOGLE_MAPS_API_KEY
+      type: api_key
+      service: Google Cloud Console
+      setup_url: https://console.cloud.google.com/apis/credentials
+      setup_time: "5 minutes"
+      notes: "Requires billing enabled on GCP project. Set as GOOGLE_MAPS_API_KEY=AIza..."
+
+weather:
+  level: 3
+  requires:
+    - env: OPENWEATHERMAP_API_KEY
+      type: api_key
+      service: OpenWeatherMap
+      setup_url: https://home.openweathermap.org/api_keys
+      setup_time: "3 minutes"
+      notes: "Free tier available. One Call 3.0 requires paid subscription."
+
+flight-tracker:
+  level: 3
+  requires:
+    - env: AVIATIONSTACK_API_KEY
+      type: api_key
+      service: AviationStack
+      setup_url: https://aviationstack.com/signup/free
+      setup_time: "3 minutes"
+      notes: "Free tier available with limited requests."
+
+claude-gateway:
+  level: 3
+  requires:
+    - env: DISCORD_BOT_TOKEN
+      type: api_key
+      service: Discord
+      setup_url: https://discord.com/developers/applications
+      setup_time: "10 minutes"
+    - env: DISCORD_CHANNEL_ID
+      type: config
+      service: Discord
+      setup_time: "included above"
+    - env: DISCORD_GUILD_ID
+      type: config
+      service: Discord
+      setup_time: "included above"
+      notes: "Three env vars required. Create Discord bot application and invite to server."
+
+voice-agent-v2:
+  level: 3
+  requires:
+    - env: LIVEKIT_API_KEY
+      type: api_key
+      service: LiveKit
+      setup_url: https://cloud.livekit.io
+      setup_time: "5 minutes"
+    - env: LIVEKIT_API_SECRET
+      type: api_key
+      service: LiveKit
+      setup_time: "included above"
+    - env: LIVEKIT_URL
+      type: config
+      service: LiveKit
+      setup_time: "included above"
+      notes: "Three env vars required. LiveKit Cloud or self-hosted."
+
+# ============================================================================
+# LEVEL 4: Applications
+# Requires desktop software installed on the user's machine.
+# ============================================================================
+
+vault-manager:
+  level: 4
+  requires:
+    - env: OBSIDIAN_INSTALLED
+      type: application
+      service: Obsidian
+      setup_url: https://obsidian.md
+      setup_time: "30 minutes (install + vault setup)"
+      notes: "Free app. Requires an Obsidian vault configured with PARA structure."
+
+life-os:
+  level: 4
+  requires:
+    - env: OBSIDIAN_INSTALLED
+      type: application
+      service: Obsidian
+      setup_url: https://obsidian.md
+      setup_time: "30 minutes (install + vault setup)"
+      notes: "Requires vault-manager configured first. Life Operating System orchestrator."

package/bundled-skills/pushrec-skills/scripts/diagnostic.py

@@ -0,0 +1,232 @@
+#!/usr/bin/env python3
+"""pushREC Skills diagnostic: checks system readiness for Claude Code skills.
+
+Standalone Python 3.8+, zero external dependencies.
+Output: JSON to stdout (parseable by Claude Code).
+Exit codes: 0 = all good, 1 = missing critical prereqs, 2 = warnings only.
+"""
+
+import json
+import os
+import platform
+import subprocess
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+VERSION = "1.0.0"
+SKILLS_DIR = Path.home() / ".claude" / "skills"
+CONFIG_PATH = Path.home() / ".pushrec" / "config.json"
+ENV_PATH = Path.home() / ".claude" / ".env"
+
+KNOWN_KEY_PREFIXES = [
+    "ELEVENLABS_API_KEY",
+    "OPENAI_API_KEY",
+    "ANTHROPIC_API_KEY",
+    "FAL_KEY",
+    "GOOGLE_API_KEY",
+    "GOOGLE_MAPS_API_KEY",
+    "YOUTUBE_API_KEY",
+    "RAPIDAPI_KEY",
+    "TWILIO_ACCOUNT_SID",
+    "TWILIO_AUTH_TOKEN",
+    "RETELL_API_KEY",
+    "API_TOKEN",
+    "AIRTABLE_API_KEY",
+    "VERCEL_TOKEN",
+    "OPENWEATHERMAP_API_KEY",
+    "AVIATIONSTACK_API_KEY",
+    "DISCORD_BOT_TOKEN",
+    "MISTRAL_API_KEY",
+]
+
+
+def run_command(args):
+    """Run a shell command and return (success, stdout_stripped)."""
+    try:
+        result = subprocess.run(
+            args,
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        return result.returncode == 0, result.stdout.strip()
+    except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
+        return False, ""
+
+
+def parse_version(version_string):
+    """Extract numeric version tuple from a version string like 'v22.1.0' or '2.1.45'."""
+    cleaned = version_string.lstrip("v").strip()
+    parts = []
+    for segment in cleaned.split("."):
+        digits = ""
+        for char in segment:
+            if char.isdigit():
+                digits += char
+            else:
+                break
+        if digits:
+            parts.append(int(digits))
+    return tuple(parts) if parts else (0,)
+
+
+def version_gte(current, minimum):
+    """Check if current version >= minimum version."""
+    current_tuple = parse_version(current)
+    minimum_tuple = parse_version(minimum)
+    return current_tuple >= minimum_tuple
+
+
+def check_claude_code():
+    """Check Claude Code installation and version."""
+    success, output = run_command(["claude", "--version"])
+    if not success:
+        return {"status": "fail", "version": None, "minimum": "2.1.0"}
+    version = output.strip()
+    if version_gte(version, "2.1.0"):
+        return {"status": "pass", "version": version, "minimum": "2.1.0"}
+    return {"status": "fail", "version": version, "minimum": "2.1.0"}
+
+
+def check_node():
+    """Check Node.js installation and version."""
+    success, output = run_command(["node", "--version"])
+    if not success:
+        return {"status": "fail", "version": None, "minimum": "20.0.0"}
+    version = output.strip()
+    if version_gte(version, "20.0.0"):
+        return {"status": "pass", "version": version, "minimum": "20.0.0"}
+    return {"status": "fail", "version": version, "minimum": "20.0.0"}
+
+
+def check_npm():
+    """Check npm installation."""
+    success, output = run_command(["npm", "--version"])
+    if not success:
+        return {"status": "fail", "version": None}
+    return {"status": "pass", "version": output.strip()}
+
+
+def check_skills_installed():
+    """Count installed skills by looking for SKILL.md files."""
+    if not SKILLS_DIR.is_dir():
+        return {"status": "fail", "count": 0}
+    count = 0
+    for child in SKILLS_DIR.iterdir():
+        if child.is_dir() and (child / "SKILL.md").is_file():
+            count += 1
+    if count == 0:
+        return {"status": "fail", "count": 0}
+    return {"status": "pass", "count": count}
+
+
+def check_license():
+    """Check pushREC license status via config.json."""
+    if not CONFIG_PATH.is_file():
+        return {"status": "fail", "installed_skills": 0}
+    try:
+        with open(CONFIG_PATH, "r") as f:
+            config = json.load(f)
+        installed = config.get("installedSkills", {})
+        count = len(installed) if isinstance(installed, dict) else 0
+        if count > 0:
+            return {"status": "pass", "installed_skills": count}
+        return {"status": "fail", "installed_skills": 0}
+    except (json.JSONDecodeError, OSError):
+        return {"status": "fail", "installed_skills": 0}
+
+
+def check_api_keys():
+    """Detect configured API keys from ~/.claude/.env."""
+    detected = []
+    if not ENV_PATH.is_file():
+        return {"status": "info", "detected": 0, "keys": []}
+    try:
+        with open(ENV_PATH, "r") as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith("#"):
+                    continue
+                for prefix in KNOWN_KEY_PREFIXES:
+                    if line.startswith(prefix + "="):
+                        value = line.split("=", 1)[1].strip().strip('"').strip("'")
+                        if value:
+                            detected.append(prefix)
+                        break
+    except OSError:
+        pass
+    return {"status": "info", "detected": len(detected), "keys": detected}
+
+
+def check_obsidian():
+    """Check if Obsidian is installed (platform-specific)."""
+    system = platform.system()
+    if system == "Darwin":
+        installed = Path("/Applications/Obsidian.app").exists()
+    elif system == "Linux":
+        success, _ = run_command(["which", "obsidian"])
+        installed = success
+    elif system == "Windows":
+        success, _ = run_command(["where", "obsidian"])
+        installed = success
+    else:
+        installed = False
+    return {"status": "info", "installed": installed}
+
+
+def main():
+    if os.environ.get("CLAUDE_HEADLESS"):
+        sys.exit(0)
+
+    checks = {
+        "claude_code": check_claude_code(),
+        "node": check_node(),
+        "npm": check_npm(),
+        "skills_installed": check_skills_installed(),
+        "license": check_license(),
+        "api_keys": check_api_keys(),
+        "obsidian": check_obsidian(),
+    }
+
+    critical_failures = []
+    warnings = []
+
+    if checks["claude_code"]["status"] == "fail":
+        critical_failures.append("Claude Code")
+    if checks["node"]["status"] == "fail":
+        critical_failures.append("Node.js v20+")
+    if checks["npm"]["status"] == "fail":
+        critical_failures.append("npm")
+    if checks["skills_installed"]["status"] == "fail":
+        warnings.append("No skills installed")
+    if checks["license"]["status"] == "fail":
+        warnings.append("No active license")
+
+    if critical_failures:
+        exit_code = 1
+        summary = f"Missing critical prerequisites: {', '.join(critical_failures)}."
+    elif warnings:
+        exit_code = 2
+        summary = f"Warnings: {', '.join(warnings)}."
+    else:
+        skills_count = checks["skills_installed"].get("count", 0)
+        api_count = checks["api_keys"].get("detected", 0)
+        summary = f"All systems ready. {skills_count} skills installed, {api_count} API keys detected."
+        exit_code = 0
+
+    report = {
+        "version": VERSION,
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "platform": platform.system().lower(),
+        "checks": checks,
+        "exit_code": exit_code,
+        "summary": summary,
+    }
+
+    print(json.dumps(report, indent=2))
+    sys.exit(exit_code)
+
+
+if __name__ == "__main__":
+    main()

package/dist/index.js

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_commander10 = require("commander");
+var import_commander11 = require("commander");
 
 // src/commands/auth.ts
 var import_commander = require("commander");
@@ -949,6 +949,16 @@ function uninstallSkill(name) {
 function isSkillInstalled(name) {
   return (0, import_fs5.existsSync)((0, import_path5.join)(SKILLS_DIR, name, "SKILL.md"));
 }
+function getBundledSkillPath(name) {
+  return (0, import_path5.join)(__dirname, "..", "bundled-skills", name);
+}
+function copyBundledSkill(name) {
+  const sourcePath = getBundledSkillPath(name);
+  if (!(0, import_fs5.existsSync)(sourcePath)) return;
+  const targetPath = (0, import_path5.join)(SKILLS_DIR, name);
+  if ((0, import_fs5.existsSync)((0, import_path5.join)(targetPath, "SKILL.md"))) return;
+  (0, import_fs5.cpSync)(sourcePath, targetPath, { recursive: true });
+}
 
 // src/commands/install.ts
 async function ensureLicense(forFreeSkill) {
@@ -1768,6 +1778,10 @@ function setupCommand() {
         failed++;
       }
     }
+    try {
+      copyBundledSkill("pushrec-skills");
+    } catch {
+    }
     const skipped = catalog.items.length - toInstall.length;
     if (opts.json) {
       console.log(JSON.stringify({
@@ -1780,23 +1794,257 @@ function setupCommand() {
       }));
     } else {
       console.log("");
-      console.log(import_chalk4.default.green.bold("Setup complete!"));
-      console.log(`  ${import_chalk4.default.green("+")} ${installed} skills installed`);
-      if (skipped > 0) console.log(`  ${import_chalk4.default.dim("-")} ${skipped} already installed`);
-      if (failed > 0) console.log(`  ${import_chalk4.default.red("x")} ${failed} failed`);
+      console.log(import_chalk4.default.green("  Setup complete!"));
+      console.log(`    ${import_chalk4.default.green("+")} ${installed} skills installed`);
+      if (skipped > 0) console.log(`    ${import_chalk4.default.dim("-")} ${skipped} already installed`);
+      if (failed > 0) console.log(`    ${import_chalk4.default.red("x")} ${failed} failed`);
       console.log("");
-      console.log("Your skills are ready. Use " + import_chalk4.default.cyan("/<skill-name>") + " in your next Claude Code session.");
-      console.log("Run " + import_chalk4.default.cyan("pushrec-skills health --full") + " to verify everything works.");
+      console.log(`  ${import_chalk4.default.bold("NEXT STEP:")} Open Claude Code and type ${import_chalk4.default.cyan("/pushrec-skills")}`);
+      console.log("");
+      console.log("  Quick reference:");
+      console.log(`    ${import_chalk4.default.cyan("/pushrec-skills")}       \u2014 Your guided setup (start here)`);
+      console.log(`    ${import_chalk4.default.cyan("/hormozi")}              \u2014 Business strategy frameworks`);
+      console.log(`    ${import_chalk4.default.cyan("/linkedin-copywriting")} \u2014 LinkedIn content creation`);
+      console.log(`    ${import_chalk4.default.cyan("/copywriting")}          \u2014 Master copywriting foundations`);
+      console.log("");
+      console.log(`  Community: ${import_chalk4.default.underline("skool.com/pushrec-2909")}`);
+      console.log(`  Full catalog: ${import_chalk4.default.dim("npx @pushrec/skills list")}`);
+    }
+  });
+  return cmd;
+}
+
+// src/commands/dashboard.ts
+var import_commander10 = require("commander");
+var import_http = require("http");
+var import_fs6 = require("fs");
+var import_path6 = require("path");
+var import_os5 = require("os");
+var import_child_process4 = require("child_process");
+var DEFAULT_PORT = 5174;
+var DATA_SOURCES = {
+  "/api/config": "~/.pushrec/config.json",
+  "/api/profile": "~/.claude/skills/pushrec-skills/state/profile.json",
+  "/api/progress": "~/.claude/skills/pushrec-skills/state/progress.json",
+  "/api/catalog": "~/.claude/skills/pushrec-skills/state/catalog.json",
+  "/api/diagnostic": "~/.claude/skills/pushrec-skills/state/diagnostic.json",
+  "/api/teams": "~/.claude/skills/pushrec-skills/state/teams.json",
+  "/api/tasks": "~/.claude/skills/pushrec-skills/state/tasks.json"
+};
+var YAML_SOURCES = {
+  "/api/prerequisites": "~/.claude/skills/pushrec-skills/references/prerequisites.yaml"
+};
+function expandPath(filepath) {
+  if (filepath.startsWith("~/")) {
+    return (0, import_path6.join)((0, import_os5.homedir)(), filepath.slice(2));
+  }
+  return filepath;
+}
+function serveJson(res, data) {
+  res.setHeader("Content-Type", "application/json");
+  res.setHeader("Cache-Control", "no-cache");
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.end(data);
+}
+function serveError(res, status, message) {
+  res.statusCode = status;
+  res.setHeader("Content-Type", "application/json");
+  res.end(JSON.stringify({ error: message }));
+}
+function parseYaml(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return { raw };
+  }
+}
+function handleApiRequest(req, res) {
+  const url = req.url ?? "";
+  if (url === "/api/mtime") {
+    const mtimes = {};
+    for (const [endpoint, filepath] of Object.entries(DATA_SOURCES)) {
+      try {
+        mtimes[endpoint] = (0, import_fs6.statSync)(expandPath(filepath)).mtimeMs;
+      } catch {
+        mtimes[endpoint] = 0;
+      }
+    }
+    for (const [endpoint, filepath] of Object.entries(YAML_SOURCES)) {
+      try {
+        mtimes[endpoint] = (0, import_fs6.statSync)(expandPath(filepath)).mtimeMs;
+      } catch {
+        mtimes[endpoint] = 0;
+      }
+    }
+    serveJson(res, JSON.stringify(mtimes));
+    return true;
+  }
+  if (url in DATA_SOURCES) {
+    const filepath = DATA_SOURCES[url];
+    const resolved = expandPath(filepath);
+    try {
+      const data = (0, import_fs6.readFileSync)(resolved, "utf-8");
+      serveJson(res, data);
+    } catch {
+      serveError(res, 500, `Failed to read ${filepath}`);
+    }
+    return true;
+  }
+  if (url in YAML_SOURCES) {
+    const filepath = YAML_SOURCES[url];
+    const resolved = expandPath(filepath);
+    try {
+      const raw = (0, import_fs6.readFileSync)(resolved, "utf-8");
+      const data = parseYaml(raw);
+      serveJson(res, JSON.stringify(data));
+    } catch {
+      serveError(res, 500, `Failed to read ${filepath}`);
     }
+    return true;
+  }
+  return false;
+}
+function findDistDirectory() {
+  const candidates = [
+    (0, import_path6.join)((0, import_os5.homedir)(), ".claude", "skills", "generative-ui", "dist"),
+    (0, import_path6.join)((0, import_os5.homedir)(), ".cache", "genui-dashboard", "dist")
+  ];
+  for (const candidate of candidates) {
+    if ((0, import_fs6.existsSync)((0, import_path6.join)(candidate, "index.html"))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function serveStatic(distDir, req, res) {
+  let urlPath = (req.url ?? "/").split("?")[0];
+  if (urlPath === "/") urlPath = "/index.html";
+  const filePath = (0, import_path6.join)(distDir, urlPath);
+  if (!filePath.startsWith(distDir)) {
+    serveError(res, 403, "Forbidden");
+    return;
+  }
+  try {
+    const content = (0, import_fs6.readFileSync)(filePath);
+    const ext = filePath.split(".").pop() ?? "";
+    const mimeTypes = {
+      html: "text/html",
+      js: "application/javascript",
+      css: "text/css",
+      json: "application/json",
+      png: "image/png",
+      svg: "image/svg+xml",
+      ico: "image/x-icon",
+      woff2: "font/woff2",
+      woff: "font/woff"
+    };
+    res.setHeader("Content-Type", mimeTypes[ext] ?? "application/octet-stream");
+    res.end(content);
+  } catch {
+    try {
+      const indexContent = (0, import_fs6.readFileSync)((0, import_path6.join)(distDir, "index.html"));
+      res.setHeader("Content-Type", "text/html");
+      res.end(indexContent);
+    } catch {
+      serveError(res, 404, "Not found");
+    }
+  }
+}
+function openBrowser(url) {
+  const platform4 = process.platform;
+  const command = platform4 === "darwin" ? `open "${url}"` : platform4 === "win32" ? `start "${url}"` : `xdg-open "${url}"`;
+  (0, import_child_process4.exec)(command, () => {
   });
+}
+function dashboardCommand() {
+  const cmd = new import_commander10.Command("dashboard").description("Launch the Generative UI dashboard").option("--port <port>", "Server port", String(DEFAULT_PORT)).option("--dev", "Start in dev mode with Vite HMR").option("--no-open", "Skip opening browser").action(
+    async (opts) => {
+      const port = parseInt(opts.port, 10);
+      if (isNaN(port) || port < 1024 || port > 65535) {
+        console.error(
+          `ERROR: Port must be between 1024 and 65535, got "${opts.port}".`
+        );
+        process.exit(1);
+      }
+      if (opts.dev) {
+        console.log("Dev mode is not yet supported via CLI.");
+        console.log(
+          "Use the Vite dev server directly: cd dashboard && npm run dev"
+        );
+        process.exit(0);
+      }
+      const distDir = findDistDirectory();
+      if (!distDir) {
+        console.error("ERROR: No built dashboard found.");
+        console.error(
+          "  Build the dashboard first, or use --dev mode."
+        );
+        console.error(
+          "  Expected: ~/.claude/skills/generative-ui/dist/index.html"
+        );
+        process.exit(1);
+      }
+      const server = (0, import_http.createServer)((req, res) => {
+        if (req.url?.startsWith("/api/")) {
+          const handled = handleApiRequest(req, res);
+          if (handled) return;
+        }
+        serveStatic(distDir, req, res);
+      });
+      server.listen(port, () => {
+        const url = `http://localhost:${port}`;
+        console.log(`Dashboard running at ${url}`);
+        console.log(`  Serving: ${distDir}`);
+        console.log(`  Press Ctrl+C to stop`);
+        console.log();
+        if (opts.open !== false) {
+          openBrowser(url);
+        }
+      });
+      server.on("error", (err) => {
+        if (err.code === "EADDRINUSE") {
+          console.error(`ERROR: Port ${port} is already in use.`);
+          console.error(`  Run: lsof -i :${port} -t | xargs kill`);
+        } else {
+          console.error(`ERROR: ${err.message}`);
+        }
+        process.exit(1);
+      });
+      const shutdown = () => {
+        console.log("\nShutting down dashboard...");
+        server.close(() => {
+          process.exit(0);
+        });
+        setTimeout(() => process.exit(0), 3e3);
+      };
+      process.on("SIGINT", shutdown);
+      process.on("SIGTERM", shutdown);
+    }
+  );
   return cmd;
 }
 
+// src/version.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+function getCliVersion() {
+  try {
+    const packageJsonPath = (0, import_node_path.join)(__dirname, "..", "package.json");
+    const raw = (0, import_node_fs.readFileSync)(packageJsonPath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version === "string" && parsed.version.length > 0) {
+      return parsed.version;
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
+
 // src/index.ts
-var program = new import_commander10.Command();
+var program = new import_commander11.Command();
 program.name("pushrec-skills").description(
   "Install, update, and manage premium Claude Code skills from Pushrec"
-).version("0.2.0");
+).version(getCliVersion());
 program.addCommand(authCommand());
 program.addCommand(installCommand());
 program.addCommand(updateCommand());
@@ -1806,6 +2054,7 @@ program.addCommand(infoCommand());
 program.addCommand(createUninstallCommand());
 program.addCommand(healthCommand());
 program.addCommand(setupCommand());
+program.addCommand(dashboardCommand());
 program.parseAsync().catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushrec/skills",
-  "version": "0.2.0",
+  "version": "0.3.2",
   "description": "Install, update, and manage premium Claude Code skills from Pushrec",
   "license": "UNLICENSED",
   "bin": {
@@ -11,6 +11,7 @@
   },
   "files": [
     "dist",
+    "bundled-skills",
     "README.md"
   ],
   "scripts": {