clamper-ai 1.5.0 → 1.5.2

package/README.md

@@ -1,17 +1,20 @@
 # ⚡ Clamper
 
 ```
-   _____ _                _  ___ _   
-  / ____| |              | |/ (_) |  
- | |    | | __ ___      _| ' / _| |_ 
- | |    | |/ _` \ \ /\ / /  < | | __|
- | |____| | (_| |\ V  V /| . \| | |_ 
-  \_____|_|\__,_| \_/\_/ |_|\_\_|\__|
-                                      
+   _____ _                                 
+  / ____| |                                
+ | |    | | __ _ _ __ ___  _ __   ___ _ __ 
+ | |    | |/ _` | '_ ` _ \| '_ \ / _ \ '__|
+ | |____| | (_| | | | | | | |_) |  __/ |   
+  \_____|_|\__,_|_| |_| |_| .__/ \___|_|   
+                           |_|              
   AI Agent Toolkit for OpenClaw
 ```
 
-**Transform your OpenClaw agent into a production-ready AI assistant** with structured memory, curated skills, a real-time dashboard, and workspace scaffolding — in 3 commands.
+**Transform your OpenClaw agent into a production-ready AI assistant** with structured memory, 50+ curated skills, a real-time dashboard, and workspace scaffolding — in 3 commands.
+
+[![npm version](https://img.shields.io/npm/v/clamper-ai.svg)](https://www.npmjs.com/package/clamper-ai)
+[![license](https://img.shields.io/npm/l/clamper-ai.svg)](https://github.com/nosselil/clamper)
 
 ---
 
@@ -29,31 +32,33 @@ That's it. Your workspace is ready.
 
 ## 📦 What You Get
 
-- **🧠 Structured Memory** — Daily notes, knowledge graph, long-term memory (MEMORY.md)
-- **📋 Soul File** — SOUL.md defines your agent's personality and behavior
-- **📚 Skill Templates** — Pre-built skills for common tasks
+- **🧠 Structured Memory** — Three-layer system: daily notes, knowledge graph, and curated long-term memory (MEMORY.md)
+- **📋 Soul File** — SOUL.md defines your agent's personality, tone, and behavior
+- **📚 50+ Curated Skills** — Pre-built skills covering productivity, development, marketing, data analysis, social media, email, and more
 - **📊 Web Dashboard** — Real-time agent monitoring with dark Bloomberg-terminal UI
 - **💬 Live Chat** — Talk to your agent from the dashboard (Pro)
-- **✅ Task Manager** — Read/write tasks/QUEUE.md from the browser
+- **✅ Task Manager** — Read/write tasks/QUEUE.md from the browser (Pro)
+- **🔄 Sync** — Push agent state (memory, skills, metrics) to the cloud dashboard
 - **🔧 Doctor** — Diagnostics to verify your setup is healthy
-- **🔄 Auto-Updates** — Check for new versions and template updates
+- **📝 Activity Logging** — Track what your agent does with `clamper log`
 
 ---
 
 ## 🆓 Free vs Pro
 
-| Feature | Free | Pro |
-|---------|------|-----|
+| Feature | Free | Pro ($10/mo) |
+|---------|------|------------|
 | Workspace scaffolding | ✅ | ✅ |
-| Memory structure | ✅ | ✅ |
-| Skill templates | Basic | Premium |
+| Three-layer memory system | ✅ | ✅ |
+| 40+ curated skills | ✅ | ✅ |
 | Dashboard (read-only) | ✅ | ✅ |
-| Dashboard chat | ❌ | ✅ |
-| Task editing | ❌ | ✅ |
+| Dashboard live chat | ❌ | ✅ |
+| Task editing from dashboard | ❌ | ✅ |
 | File management | ❌ | ✅ |
+| Premium skills (10+) | ❌ | ✅ |
 | Priority support | ❌ | ✅ |
 
-**$10/month** → [Get Pro](https://clamper.tech/get-started)
+→ [Get Pro](https://clamper.tech/get-started)
 
 ---
 
@@ -75,6 +80,23 @@ Check workspace health — memory files, skills, config.
 clamper status
 ```
 
+### `clamper sync`
+Sync agent state to the Clamper cloud dashboard. Requires `CLAMPER_API_KEY`.
+
+```bash
+export CLAMPER_API_KEY="clk_..."
+clamper sync            # Push current state
+clamper sync --quiet    # Silent mode (for cron/heartbeat)
+```
+
+### `clamper log`
+Log agent activity for tracking and analytics.
+
+```bash
+clamper log "Deployed website update"
+clamper log "Fixed auth bug" --tag=bugfix
+```
+
 ### `clamper doctor`
 Run full diagnostics — Node.js version, OpenClaw detection, file permissions.
 
@@ -83,7 +105,7 @@ clamper doctor
 ```
 
 ### `clamper dashboard`
-Launch the web dashboard in your browser.
+Launch the web dashboard locally in your browser.
 
 ```bash
 clamper dashboard              # Default port 8080
@@ -107,32 +129,50 @@ clamper update
 
 ---
 
-## 📸 Screenshots
-
-> _Dashboard screenshots coming soon_
-
----
-
 ## 🏗 Architecture
 
 ```
 your-workspace/
-├── AGENTS.md          # Agent behavior config
-├── SOUL.md            # Personality definition
-├── LEARNINGS.md       # Rules & patterns
-├── MEMORY.md          # Long-term curated memory
+├── AGENTS.md              # Agent behavior & boot protocol
+├── SOUL.md                # Personality & tone definition
+├── LEARNINGS.md           # Rules, patterns & mistake log
+├── MEMORY.md              # Long-term curated memory
+├── HEARTBEAT.md           # Proactive background task config
 ├── memory/
-│   ├── daily/         # Daily conversation logs
-│   └── knowledge/     # Extracted facts & patterns
+│   ├── daily/             # Daily conversation logs
+│   └── knowledge/         # Extracted facts & patterns
 ├── skills/
-│   ├── .clamper/      # Clamper config
-│   └── [skills...]    # Installed skills
+│   └── [50+ skills...]    # Installed skill modules
 └── tasks/
-    └── QUEUE.md       # Task queue
+    └── QUEUE.md           # Task queue (tracks in-progress & done)
 ```
 
 ---
 
+## 🔑 Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CLAMPER_API_KEY` | For sync/dashboard | Your API key from [clamper.tech/dashboard](https://clamper.tech/dashboard) |
+
+---
+
+## 🧩 Included Skills (50+)
+
+Skills cover a wide range of use cases out of the box:
+
+**Productivity** — CEO Advisor, ADHD Assistant, Daily Briefing, Ask a Human
+**Development** — Developer, Code Mentor, CSV Pipeline, Comfy AI
+**Marketing** — Social media posting, Bluesky, SEO, content creation
+**Data** — Data analysis, PDF extraction, Google Sheets integration
+**Creative** — Image generation, video toolkit, SVG drawing, assets from video
+**Utilities** — Catbox upload, weather, system monitoring, email (IMAP/SMTP)
+**Fun** — Tarot readings, D&D 5e, Digimon, 4chan reader
+
+Browse all skills after install with `clamper status`.
+
+---
+
 ## 🔧 Requirements
 
 - **Node.js** ≥ 18
@@ -141,13 +181,12 @@ your-workspace/
 
 ---
 
-## 🤝 Contributing
+## 🔗 Links
 
-1. Fork the repo
-2. Create a feature branch
-3. Make your changes (ESM only, no dependencies)
-4. Test with `clamper doctor`
-5. Submit a PR
+- **Website:** [clamper.tech](https://clamper.tech)
+- **Dashboard:** [clamper.tech/dashboard](https://clamper.tech/dashboard)
+- **OpenClaw:** [openclaw.ai](https://docs.openclaw.ai)
+- **Discord:** [OpenClaw Community](https://discord.com/invite/clawd)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clamper-ai",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Transform your OpenClaw agent into a production-ready AI assistant with memory, skills, and a dashboard",
   "type": "module",
   "bin": {
@@ -22,7 +22,8 @@
   },
   "files": [
     "bin/",
+    "src/",
     "skills/"
   ],
   "dependencies": {}
-}
+}

package/src/cron.mjs

@@ -0,0 +1,30 @@
+import { execSync } from 'child_process';
+import { log, cmdExists } from './utils.mjs';
+
+export function registerCron(workspace) {
+  if (process.platform === 'win32') {
+    log.warn('Cron not available on Windows — set up nightly consolidation manually');
+    return false;
+  }
+
+  const scriptPath = `${workspace}/scripts/nightly-consolidation.sh`;
+  const cronLine = `0 2 * * * CLAMPER_WORKSPACE="${workspace}" bash "${scriptPath}" >> "${workspace}/scripts/consolidation.log" 2>&1`;
+
+  try {
+    let existing = '';
+    try { existing = execSync('crontab -l 2>/dev/null', { encoding: 'utf8' }); } catch { /* empty crontab */ }
+
+    if (existing.includes('nightly-consolidation.sh')) {
+      log.info('Nightly consolidation cron already registered');
+      return true;
+    }
+
+    const updated = existing.trimEnd() + '\n' + cronLine + '\n';
+    execSync(`echo "${updated.replace(/"/g, '\\"')}" | crontab -`, { encoding: 'utf8' });
+    log.ok('Registered nightly consolidation cron (2 AM daily)');
+    return true;
+  } catch (e) {
+    log.warn('Could not register cron job — set up nightly consolidation manually');
+    return false;
+  }
+}

package/src/dashboard.mjs

@@ -0,0 +1,69 @@
+import { createServer } from 'http';
+import { readFileSync, existsSync } from 'fs';
+import { join, extname } from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { c, log } from './utils.mjs';
+
+const MIME = {
+  '.html': 'text/html',
+  '.css': 'text/css',
+  '.js': 'application/javascript',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.svg': 'image/svg+xml',
+};
+
+export function runDashboard(flags) {
+  const port = parseInt(flags.port) || 8080;
+  const thisDir = fileURLToPath(new URL('.', import.meta.url));
+  const dashDir = join(thisDir, '..', 'dashboard');
+
+  if (!existsSync(join(dashDir, 'index.html'))) {
+    log.err('Dashboard files not found. Reinstall Clamper.');
+    process.exit(1);
+  }
+
+  const server = createServer((req, res) => {
+    let filePath = req.url === '/' ? '/index.html' : req.url;
+    filePath = filePath.split('?')[0]; // strip query
+    const full = join(dashDir, filePath);
+
+    if (!existsSync(full)) {
+      res.writeHead(404, { 'Content-Type': 'text/plain' });
+      res.end('Not found');
+      return;
+    }
+
+    const ext = extname(full);
+    const mime = MIME[ext] || 'application/octet-stream';
+    try {
+      const data = readFileSync(full);
+      res.writeHead(200, { 'Content-Type': mime });
+      res.end(data);
+    } catch {
+      res.writeHead(500);
+      res.end('Error');
+    }
+  });
+
+  server.listen(port, '0.0.0.0', () => {
+    const url = `http://localhost:${port}`;
+    console.log(`\n  ${c.green}⚡${c.reset} Dashboard running at ${c.cyan}${url}${c.reset}\n`);
+    console.log(`  ${c.dim}Press Ctrl+C to stop${c.reset}\n`);
+
+    // Open browser (non-blocking — execSync blocks the event loop!)
+    try {
+      const { exec: execNB } = require !== undefined ? require('child_process') : {};
+      const platform = process.platform;
+      const cmd = platform === 'darwin' ? `open ${url}` : platform === 'win32' ? `start ${url}` : `xdg-open ${url} 2>/dev/null || true`;
+      import('child_process').then(cp => cp.exec(cmd));
+    } catch {}
+  });
+
+  process.on('SIGINT', () => {
+    console.log(`\n  ${c.dim}Shutting down...${c.reset}`);
+    server.close();
+    process.exit(0);
+  });
+}

package/src/doctor.mjs

@@ -0,0 +1,69 @@
+import { existsSync, readFileSync, readdirSync, accessSync, constants } from 'fs';
+import { join } from 'path';
+import { c, log, detectWorkspace, cmdExists } from './utils.mjs';
+
+export function runDoctor() {
+  const checks = [];
+  const pass = (name) => checks.push({ name, ok: true });
+  const fail = (name, hint) => checks.push({ name, ok: false, hint });
+
+  // 1. OpenClaw installed
+  cmdExists('openclaw') ? pass('OpenClaw CLI installed') : fail('OpenClaw CLI installed', 'Install: npm i -g openclaw');
+
+  // 2. Workspace
+  const workspace = detectWorkspace();
+  if (workspace && existsSync(workspace)) {
+    pass('Workspace directory exists');
+  } else {
+    fail('Workspace directory exists', 'Set CLAMPER_WORKSPACE env var');
+  }
+
+  if (workspace) {
+    // 3. AGENTS.md
+    existsSync(join(workspace, 'AGENTS.md')) ? pass('AGENTS.md present') : fail('AGENTS.md present', 'Run: clamper init');
+
+    // 4. Config
+    const cfgPath = join(workspace, 'skills', '.clamper', 'config.json');
+    if (existsSync(cfgPath)) {
+      try { JSON.parse(readFileSync(cfgPath, 'utf8')); pass('Config valid'); }
+      catch { fail('Config valid', 'config.json is corrupt — re-run clamper init'); }
+    } else {
+      fail('Config valid', 'Run: clamper init');
+    }
+
+    // 5. Skills
+    const sd = join(workspace, 'skills');
+    if (existsSync(sd)) {
+      const cnt = readdirSync(sd, { withFileTypes: true }).filter(d => d.isDirectory() && !d.name.startsWith('.')).length;
+      cnt > 0 ? pass(`Skills installed (${cnt})`) : fail('Skills installed', 'Run: clamper init');
+    } else {
+      fail('Skills installed', 'Run: clamper init');
+    }
+
+    // 6. Consolidation script
+    const cs = join(workspace, 'scripts/nightly-consolidation.sh');
+    if (existsSync(cs)) {
+      try { accessSync(cs, constants.X_OK); pass('Consolidation script executable'); }
+      catch { fail('Consolidation script executable', `Run: chmod +x ${cs}`); }
+    } else {
+      fail('Consolidation script present', 'Run: clamper init');
+    }
+
+    // 7. Memory dirs
+    existsSync(join(workspace, 'memory/daily')) && existsSync(join(workspace, 'memory/knowledge'))
+      ? pass('Memory directories') : fail('Memory directories', 'Run: clamper init');
+  }
+
+  // 5. API key
+  process.env.CLAMPER_API_KEY ? pass('API key set') : fail('API key set', 'Set CLAMPER_API_KEY env var');
+
+  console.log(`\n${c.bold}${c.cyan}🩺 Clamper Doctor${c.reset}\n`);
+  for (const ch of checks) {
+    const icon = ch.ok ? `${c.green}✔${c.reset}` : `${c.red}✖${c.reset}`;
+    console.log(`  ${icon} ${ch.name}`);
+    if (!ch.ok && ch.hint) console.log(`    ${c.dim}→ ${ch.hint}${c.reset}`);
+  }
+
+  const passed = checks.filter(c => c.ok).length;
+  console.log(`\n  ${passed}/${checks.length} checks passed\n`);
+}

package/src/init.mjs

@@ -0,0 +1,145 @@
+import { createInterface } from 'readline';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { c, log, detectWorkspace, detectTimezone, today } from './utils.mjs';
+import { readApiKey, parseTier, validateKey } from './validate.mjs';
+import { scaffoldWorkspace, backupWorkspace } from './scaffold.mjs';
+import { installSkills } from './skills.mjs';
+
+function ask(rl, question, defaultVal) {
+  return new Promise((resolve) => {
+    rl.question(`${c.cyan}?${c.reset} ${question} ${c.dim}(${defaultVal})${c.reset} `, (answer) => {
+      resolve(answer.trim() || defaultVal);
+    });
+  });
+}
+
+export async function runInit(flags) {
+  const yes = flags.yes || flags.y;
+  const force = flags.force;
+
+  console.log(`\n${c.bold}${c.magenta}🧰 Clamper Init${c.reset}\n`);
+
+  // Step 1: Detect workspace
+  log.step(1, 'Detecting workspace...');
+  let workspace = detectWorkspace();
+
+  const rl = !yes ? createInterface({ input: process.stdin, output: process.stdout }) : null;
+
+  if (!workspace && !yes) {
+    workspace = await ask(rl, 'Workspace path:', join(process.env.HOME || '~', '.openclaw', 'workspace'));
+  }
+  if (!workspace) {
+    workspace = join(process.env.HOME || '/tmp', '.openclaw', 'workspace');
+  }
+  mkdirSync(workspace, { recursive: true });
+  log.ok(`Workspace: ${workspace}`);
+
+  // Step 2: Check existing
+  log.step(2, 'Checking existing files...');
+  if (existsSync(join(workspace, 'AGENTS.md'))) {
+    if (!yes && !force) {
+      const overwrite = await ask(rl, 'Existing workspace detected. Backup & overwrite? (y/n):', 'y');
+      if (overwrite.toLowerCase() !== 'y') {
+        log.info('Aborted.');
+        rl?.close();
+        return;
+      }
+    }
+    const bk = backupWorkspace(workspace);
+    log.ok(`Backed up to ${bk}`);
+  } else {
+    log.ok('Clean workspace');
+  }
+
+  // Step 3: Read API key
+  log.step(3, 'Reading API key...');
+  let apiKey = readApiKey();
+  if (!apiKey) {
+    console.log(`\n  ${c.yellow}An API key is required to use Clamper.${c.reset}`);
+    console.log(`  ${c.dim}Get your free key at: ${c.cyan}https://clamper.tech/get-started${c.reset}\n`);
+    if (!yes) {
+      apiKey = await ask(rl, 'Paste your Clamper API key:', '');
+    }
+    if (!apiKey) {
+      console.log(`\n  ${c.yellow}No API key provided. Continuing with limited free tier.${c.reset}`);
+      console.log(`  ${c.dim}Run ${c.cyan}clamper upgrade --key YOUR_KEY${c.reset}${c.dim} later to activate.${c.reset}\n`);
+    }
+  }
+  const tier = parseTier(apiKey);
+  if (apiKey) {
+    log.ok(`API key found (tier: ${tier})`);
+  } else {
+    log.warn('No API key — limited free tier');
+  }
+
+  // Step 4: Validate
+  log.step(4, 'Validating...');
+  const validation = await validateKey(apiKey);
+  if (!validation.valid && !validation.offline) {
+    log.err(`Validation failed: ${validation.error}`);
+    log.info('Continuing with free tier...');
+  } else if (validation.offline) {
+    log.warn('Offline mode — continuing with key prefix tier');
+  } else {
+    log.ok('API key validated');
+  }
+
+  const effectiveTier = validation.tier || tier;
+
+  // Step 5: Prompts
+  log.step(5, 'Configuration...');
+  const agentName = yes ? 'Atlas' : await ask(rl, 'What should your agent be called?', 'Atlas');
+  const userName = yes ? 'Human' : await ask(rl, "What's your name?", 'Human');
+  const timezone = yes ? detectTimezone() : await ask(rl, 'Your timezone?', detectTimezone());
+
+  rl?.close();
+
+  const vars = { agentName, userName, timezone, tier: effectiveTier, date: today() };
+
+  // Step 6: Scaffold
+  log.step(6, 'Scaffolding workspace...');
+  scaffoldWorkspace(workspace, vars);
+  log.ok('Template files written');
+
+  // Step 7: Skills
+  log.step(7, 'Installing skills...');
+  const skillCount = installSkills(workspace, effectiveTier);
+
+  // Step 8: Config
+  log.step(8, 'Writing config...');
+  const configDir = join(workspace, 'skills', '.clamper');
+  mkdirSync(configDir, { recursive: true });
+  const config = {
+    version: '1.0.0',
+    tier: effectiveTier,
+    apiKey: apiKey || '',
+    installedAt: new Date().toISOString(),
+    agentName,
+    userName,
+    timezone,
+    features: validation.features || {},
+  };
+  writeFileSync(join(configDir, 'config.json'), JSON.stringify(config, null, 2), 'utf8');
+  log.ok('Config saved');
+
+  // Step 9: Success
+  console.log(`
+${c.green}╔══════════════════════════════════════════════╗
+║  🧰 Clamper initialized successfully!       ║
+╠══════════════════════════════════════════════╣
+║                                              ║
+║  Agent: ${(agentName + '                    ').slice(0, 36)}║
+║  Tier: ${(effectiveTier + '                     ').slice(0, 37)}║
+║  Skills: ${(skillCount + ' installed              ').slice(0, 35)}║
+║  Memory: 3-layer system active               ║
+║                                              ║
+║  Next steps:                                 ║
+║  1. openclaw gateway restart                 ║
+║  2. Start chatting — your agent is ready!    ║
+║                                              ║
+║  Run clamper status to check health          ║
+║  Run clamper upgrade to go Pro               ║
+╚══════════════════════════════════════════════╝${c.reset}
+`);
+}

package/src/log-activity.mjs

@@ -0,0 +1,26 @@
+import { existsSync, appendFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { detectWorkspace } from './utils.mjs';
+
+export function logActivity(message) {
+  const workspace = detectWorkspace();
+  if (!workspace) return;
+
+  const logPath = join(workspace, 'logs', 'activity.jsonl');
+  const logDir = dirname(logPath);
+  if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });
+
+  const entry = JSON.stringify({ ts: new Date().toISOString(), msg: message }) + '\n';
+  appendFileSync(logPath, entry);
+}
+
+// CLI usage: clamper log "Did something"
+export function runLog(flags) {
+  const msg = flags._ || process.argv.slice(3).join(' ');
+  if (!msg) {
+    console.log('Usage: clamper log "Your activity message"');
+    process.exit(1);
+  }
+  logActivity(msg);
+  console.log(`  ✔ Logged: ${msg}`);
+}

package/src/scaffold.mjs

@@ -0,0 +1,57 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync, chmodSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(__dirname, '..');
+
+export function replaceVars(text, vars) {
+  return text
+    .replace(/\{\{AGENT_NAME\}\}/g, vars.agentName || 'Atlas')
+    .replace(/\{\{USER_NAME\}\}/g, vars.userName || 'Human')
+    .replace(/\{\{TIMEZONE\}\}/g, vars.timezone || 'UTC')
+    .replace(/\{\{TIER\}\}/g, vars.tier || 'free')
+    .replace(/\{\{DATE\}\}/g, vars.date || new Date().toISOString().slice(0, 10));
+}
+
+const TEMPLATE_FILES = [
+  'AGENTS.md', 'SOUL.md', 'IDENTITY.md', 'USER.md', 'TOOLS.md', 'HEARTBEAT.md',
+  'MEMORY.md', 'LEARNINGS.md', 'PROTOCOL_COST_EFFICIENCY.md', 'SKILLS-INDEX.md',
+  'memory/knowledge/about-me.md', 'tasks/QUEUE.md', 'scripts/nightly-consolidation.sh',
+];
+
+export function scaffoldWorkspace(workspace, vars) {
+  for (const d of ['memory/daily', 'memory/knowledge', 'memory/para', 'tasks', 'scripts', 'skills']) {
+    mkdirSync(join(workspace, d), { recursive: true });
+  }
+
+  for (const f of TEMPLATE_FILES) {
+    const src = join(PKG_ROOT, 'templates', f);
+    const dest = join(workspace, f);
+    mkdirSync(dirname(dest), { recursive: true });
+    const content = readFileSync(src, 'utf8');
+    writeFileSync(dest, replaceVars(content, vars), 'utf8');
+  }
+
+  // Make consolidation script executable
+  const scriptPath = join(workspace, 'scripts/nightly-consolidation.sh');
+  if (existsSync(scriptPath)) {
+    chmodSync(scriptPath, 0o755);
+  }
+}
+
+export function backupWorkspace(workspace) {
+  const backupDir = join(workspace, '.clamper-backup');
+  const ts = new Date().toISOString().replace(/[:.]/g, '-');
+  const dest = join(backupDir, ts);
+  mkdirSync(dest, { recursive: true });
+  for (const f of TEMPLATE_FILES) {
+    const src = join(workspace, f);
+    if (existsSync(src)) {
+      const d = join(dest, f);
+      mkdirSync(dirname(d), { recursive: true });
+      cpSync(src, d);
+    }
+  }
+  return dest;
+}

package/src/skills.mjs

@@ -0,0 +1,52 @@
+import { readdirSync, readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { log, cmdExists } from './utils.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(__dirname, '..');
+const BUNDLED_DIR = join(PKG_ROOT, 'skills');
+
+const PRO_SKILLS = [
+  'reminder', 'data-analyst', 'automation-workflows', 'sales',
+  'security-monitor', 'nano-pdf', 'pdf-to-structured',
+];
+
+export function installSkills(workspace, tier) {
+  const skillsDir = join(workspace, 'skills');
+  mkdirSync(skillsDir, { recursive: true });
+
+  // Install bundled free skills
+  let count = 0;
+  const entries = readdirSync(BUNDLED_DIR, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const srcSkill = join(BUNDLED_DIR, entry.name, 'SKILL.md');
+    if (!existsSync(srcSkill)) continue;
+    const destDir = join(skillsDir, entry.name);
+    mkdirSync(destDir, { recursive: true });
+    const content = readFileSync(srcSkill, 'utf8');
+    writeFileSync(join(destDir, 'SKILL.md'), content, 'utf8');
+    count++;
+  }
+  log.ok(`Installed ${count} free-tier skills`);
+
+  // Pro skills via clawhub
+  if (tier === 'pro') {
+    if (cmdExists('clawhub')) {
+      for (const slug of PRO_SKILLS) {
+        try {
+          execSync(`clawhub install ${slug} --force`, { cwd: workspace, stdio: 'ignore', timeout: 30000 });
+          log.ok(`Installed pro skill: ${slug}`);
+        } catch {
+          log.warn(`Could not install pro skill: ${slug}`);
+        }
+      }
+    } else {
+      log.warn('clawhub CLI not found — skipping pro skill installation. Run: npm i -g clawhub');
+    }
+  }
+
+  return count;
+}