atris 2.3.1 → 2.3.4

package/atris/team/{brainstormer.md → brainstormer/MEMBER.md}

@@ -1,6 +1,21 @@
-# brainstormer.md — Idea & Reality Shaper
+---
+name: brainstormer
+role: Idea Shaper
+description: Shape ideas, explore possibilities, adapt to user depth
+version: 1.0.0
+
+skills: []
+
+permissions:
+  can-read: true
+  can-plan: false
+  can-execute: false
+  can-approve: false
+---
+
+# Brainstormer — Idea & Reality Shaper
 
-> **Role:** Shape ideas, explore possibilities, adapt to user depth | **Source:** Inbox items, raw ideas
+> **Source:** Inbox items, raw ideas
 > **Style:** Read `atris/PERSONA.md` for communication style.
 
 ---

package/atris/team/{executor.md → executor/MEMBER.md}

@@ -1,6 +1,21 @@
-# executor.md — Builder (The Trigger)
+---
+name: executor
+role: Builder
+description: Execute from build specs, one step at a time
+version: 1.0.0
+
+skills: []
+
+permissions:
+  can-read: true
+  can-plan: false
+  can-execute: true
+  can-approve: false
+---
+
+# Executor — Builder
 
-> **Role:** Execute from build.md, one step at a time | **Source:** build.md, MAP.md
+> **Source:** build.md, MAP.md
 > **Style:** Read `atris/PERSONA.md` for communication style.
 
 ---

package/atris/team/{launcher.md → launcher/MEMBER.md}

@@ -1,6 +1,22 @@
-# launcher.md — The Closer
+---
+name: launcher
+role: Closer
+description: Document, capture learnings, publish, celebrate
+version: 1.0.0
+
+skills: []
+
+permissions:
+  can-read: true
+  can-plan: false
+  can-execute: false
+  can-approve: false
+  can-ship: true
+---
+
+# Launcher — The Closer
 
-> **Role:** Document, capture learnings, publish, celebrate | **Source:** Completed tasks, validation results
+> **Source:** Completed tasks, validation results
 > **Style:** Read `atris/PERSONA.md` for communication style.
 
 ---

package/atris/team/{navigator.md → navigator/MEMBER.md}

@@ -1,6 +1,21 @@
-# navigator.md — Planner
+---
+name: navigator
+role: Planner
+description: Transform messy human intent into precise execution plans
+version: 1.0.0
+
+skills: []
+
+permissions:
+  can-read: true
+  can-plan: true
+  can-execute: false
+  can-approve: false
+---
+
+# Navigator — Planner
 
-> **Role:** Transform messy human intent into precise execution plans | **Source:** idea.md, MAP.md
+> **Source:** idea.md, MAP.md
 > **Style:** Read `atris/PERSONA.md` for communication style.
 
 ---

package/atris/team/{validator.md → validator/MEMBER.md}

@@ -1,6 +1,22 @@
-# validator.md — Reviewer (The Safety)
+---
+name: validator
+role: Reviewer
+description: Validate execution, run tests, ensure quality before shipping
+version: 1.0.0
+
+skills: []
+
+permissions:
+  can-read: true
+  can-plan: false
+  can-execute: false
+  can-approve: true
+  can-ship: true
+---
+
+# Validator — Reviewer
 
-> **Role:** Validate execution, update docs, ensure quality | **Source:** build.md, MAP.md, code
+> **Source:** build.md, MAP.md, code
 > **Style:** Read `atris/PERSONA.md` for communication style.
 
 ---

package/bin/atris.js

@@ -219,6 +219,8 @@ function showHelp() {
   console.log('  integrations - Show integration status');
   console.log('');
   console.log('Skills:');
+  console.log('  skill create <name> - Scaffold a new skill (--integration, --system)');
+  console.log('  skill link [--all]  - Symlink skills to ~/.claude/skills/ (system-level)');
   console.log('  skill list          - Show all skills with compliance status');
   console.log('  skill audit [name]  - Validate skill against Anthropic guide');
   console.log('  skill fix [name]    - Auto-fix common compliance issues');
@@ -897,31 +899,22 @@ function initAtris() {
     console.log('✓ Created TASK_CONTEXTS.md placeholder');
   }
 
-  // Copy agent templates from package
-  const navigatorSource = path.join(__dirname, '..', 'atris', 'team', 'navigator.md');
-  const executorSource = path.join(__dirname, '..', 'atris', 'team', 'executor.md');
-  const validatorSource = path.join(__dirname, '..', 'atris', 'team', 'validator.md');
-  const launcherSource = path.join(__dirname, '..', 'atris', 'team', 'launcher.md');
+  // Copy agent templates from package (MEMBER.md directory format)
+  const members = ['navigator', 'executor', 'validator', 'launcher', 'brainstormer'];
+  members.forEach(name => {
+    const sourceFile = path.join(__dirname, '..', 'atris', 'team', name, 'MEMBER.md');
+    const memberDir = path.join(teamDir, name);
+    const targetFile = path.join(memberDir, 'MEMBER.md');
+    const legacyFile = path.join(teamDir, `${name}.md`);
 
-  if (!fs.existsSync(navigatorFile) && fs.existsSync(navigatorSource)) {
-    fs.copyFileSync(navigatorSource, navigatorFile);
-    console.log('✓ Created team/navigator.md');
-  }
-
-  if (!fs.existsSync(executorFile) && fs.existsSync(executorSource)) {
-    fs.copyFileSync(executorSource, executorFile);
-    console.log('✓ Created team/executor.md');
-  }
-
-  if (!fs.existsSync(validatorFile) && fs.existsSync(validatorSource)) {
-    fs.copyFileSync(validatorSource, validatorFile);
-    console.log('✓ Created team/validator.md');
-  }
+    if (fs.existsSync(targetFile) || fs.existsSync(legacyFile)) return;
 
-  if (!fs.existsSync(launcherFile) && fs.existsSync(launcherSource)) {
-    fs.copyFileSync(launcherSource, launcherFile);
-    console.log('✓ Created team/launcher.md');
-  }
+    if (fs.existsSync(sourceFile)) {
+      fs.mkdirSync(memberDir, { recursive: true });
+      fs.copyFileSync(sourceFile, targetFile);
+      console.log(`✓ Created team/${name}/MEMBER.md`);
+    }
+  });
 
   // Copy policies from package
   const antislopSource = path.join(__dirname, '..', 'atris', 'policies', 'ANTISLOP.md');
@@ -987,10 +980,11 @@ function syncAtris() {
     { source: 'atrisDev.md', target: 'atrisDev.md' },
     { source: 'PERSONA.md', target: 'PERSONA.md' },
     { source: 'GETTING_STARTED.md', target: 'GETTING_STARTED.md' },
-    { source: 'atris/team/navigator.md', target: 'team/navigator.md' },
-    { source: 'atris/team/executor.md', target: 'team/executor.md' },
-    { source: 'atris/team/validator.md', target: 'team/validator.md' },
-    { source: 'atris/team/launcher.md', target: 'team/launcher.md' },
+    { source: 'atris/team/navigator/MEMBER.md', target: 'team/navigator/MEMBER.md' },
+    { source: 'atris/team/executor/MEMBER.md', target: 'team/executor/MEMBER.md' },
+    { source: 'atris/team/validator/MEMBER.md', target: 'team/validator/MEMBER.md' },
+    { source: 'atris/team/launcher/MEMBER.md', target: 'team/launcher/MEMBER.md' },
+    { source: 'atris/team/brainstormer/MEMBER.md', target: 'team/brainstormer/MEMBER.md' },
     { source: 'atris/policies/ANTISLOP.md', target: 'policies/ANTISLOP.md' }
   ];
 
@@ -1014,6 +1008,7 @@ function syncAtris() {
       return;
     }
 
+    fs.mkdirSync(path.dirname(targetFile), { recursive: true });
     fs.copyFileSync(sourceFile, targetFile);
     console.log(`✓ Updated ${target}`);
     updated++;

package/commands/init.js

@@ -475,36 +475,23 @@ function initAtris() {
   });
 
 
-  const navigatorSource = path.join(__dirname, '..', 'atris', 'team', 'navigator.md');
-  const executorSource = path.join(__dirname, '..', 'atris', 'team', 'executor.md');
-  const validatorSource = path.join(__dirname, '..', 'atris', 'team', 'validator.md');
-  const launcherSource = path.join(__dirname, '..', 'atris', 'team', 'launcher.md');
-  const brainstormerSource = path.join(__dirname, '..', 'atris', 'team', 'brainstormer.md');
-
-  if (!fs.existsSync(navigatorFile) && fs.existsSync(navigatorSource)) {
-    fs.copyFileSync(navigatorSource, navigatorFile);
-    console.log('✓ Created team/navigator.md');
-  }
-
-  if (!fs.existsSync(executorFile) && fs.existsSync(executorSource)) {
-    fs.copyFileSync(executorSource, executorFile);
-    console.log('✓ Created team/executor.md');
-  }
-
-  if (!fs.existsSync(validatorFile) && fs.existsSync(validatorSource)) {
-    fs.copyFileSync(validatorSource, validatorFile);
-    console.log('✓ Created team/validator.md');
-  }
-
-  if (!fs.existsSync(launcherFile) && fs.existsSync(launcherSource)) {
-    fs.copyFileSync(launcherSource, launcherFile);
-    console.log('✓ Created team/launcher.md');
-  }
-
-  if (!fs.existsSync(brainstormerFile) && fs.existsSync(brainstormerSource)) {
-    fs.copyFileSync(brainstormerSource, brainstormerFile);
-    console.log('✓ Created team/brainstormer.md');
-  }
+  // Copy team members (MEMBER.md format — directory per member)
+  const members = ['navigator', 'executor', 'validator', 'launcher', 'brainstormer'];
+  members.forEach(name => {
+    const sourceFile = path.join(__dirname, '..', 'atris', 'team', name, 'MEMBER.md');
+    const targetDir = path.join(teamDir, name);
+    const targetFile = path.join(targetDir, 'MEMBER.md');
+    const legacyFile = path.join(teamDir, `${name}.md`);
+
+    // Skip if already exists (either format)
+    if (fs.existsSync(targetFile) || fs.existsSync(legacyFile)) return;
+
+    if (fs.existsSync(sourceFile)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+      fs.copyFileSync(sourceFile, targetFile);
+      console.log(`✓ Created team/${name}/MEMBER.md`);
+    }
+  });
 
   // Detect project context and generate profile
   const profile = detectProjectContext(process.cwd());

package/commands/skill.js

@@ -470,6 +470,377 @@ function skillFix(name) {
   console.log('');
 }
 
+// --- Skill Scaffold Template ---
+
+function generateSkillTemplate(name, description) {
+  return `---
+name: ${name}
+description: ${description || `Custom skill for ${name}. Use when user asks about ${name}-related tasks.`}
+version: 1.0.0
+tags:
+  - ${name}
+---
+
+# ${name}
+
+## What This Skill Does
+
+Describe what this skill does in 2-3 sentences.
+
+## Workflows
+
+### "Example trigger phrase"
+
+1. Step one
+2. Step two
+3. Step three
+
+## Rules
+
+- Always confirm before taking destructive actions
+- Never skip the approval gate on sends/deletes
+`;
+}
+
+function generateIntegrationSkillTemplate(name, description) {
+  return `---
+name: ${name}
+description: ${description || `Integration skill for ${name}. Use when user asks about ${name}-related tasks.`}
+version: 1.0.0
+tags:
+  - ${name}
+  - integration
+---
+
+# ${name}
+
+## Bootstrap (ALWAYS Run First)
+
+Before any operation, run this bootstrap to ensure everything is set up:
+
+\`\`\`bash
+#!/bin/bash
+set -e
+
+# 1. Check if logged in to AtrisOS
+if [ ! -f ~/.atris/credentials.json ]; then
+  echo "Not logged in to AtrisOS."
+  echo "Run: atris login"
+  exit 1
+fi
+
+# 2. Extract token
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+
+# 3. Check connection status
+STATUS=$(curl -s "https://api.atris.ai/api/integrations/YOUR_INTEGRATION/status" \\
+  -H "Authorization: Bearer $TOKEN")
+
+echo "$STATUS"
+export ATRIS_TOKEN="$TOKEN"
+\`\`\`
+
+## API Reference
+
+Base: \`https://api.atris.ai/api/integrations/YOUR_INTEGRATION\`
+
+All requests require: \`-H "Authorization: Bearer $TOKEN"\`
+
+### Get Token (after bootstrap)
+\`\`\`bash
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+\`\`\`
+
+### List Items
+\`\`\`bash
+curl -s "https://api.atris.ai/api/integrations/YOUR_INTEGRATION/items" \\
+  -H "Authorization: Bearer $TOKEN"
+\`\`\`
+
+## Workflows
+
+### "Example trigger phrase"
+
+1. Run bootstrap
+2. Call the API
+3. Display results
+4. **Confirm with user before any write action**
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| \`Token expired\` | AtrisOS session expired | Run \`atris login\` |
+| \`401 Unauthorized\` | Invalid/expired token | Run \`atris login\` |
+| \`429 Rate limited\` | Too many requests | Wait 60s, retry |
+
+## Security Model
+
+1. **Local token** (\`~/.atris/credentials.json\`): Stored locally with 600 permissions.
+2. **Integration credentials**: Stored server-side in AtrisOS encrypted vault. Never local.
+3. **HTTPS only**: All API communication encrypted in transit.
+`;
+}
+
+// --- CREATE subcommand ---
+
+function skillCreate(nameArg, ...flags) {
+  if (!nameArg) {
+    console.error('Usage: atris skill create <name> [--integration] [--description="..."] [--system]');
+    console.error('');
+    console.error('Examples:');
+    console.error('  atris skill create daily-standup');
+    console.error('  atris skill create email-outreach --integration');
+    console.error('  atris skill create pallet/bol-processor --integration');
+    console.error('  atris skill create my-skill --system');
+    process.exit(1);
+  }
+
+  const isIntegration = flags.includes('--integration');
+  const isLocal = flags.includes('--local');
+  const descFlag = flags.find(f => f.startsWith('--description='));
+  const description = descFlag ? descFlag.split('=').slice(1).join('=').replace(/^["']|["']$/g, '') : '';
+
+  // Parse name — supports "customer/skill-name" format
+  let skillDir, skillName, customerName;
+  if (nameArg.includes('/')) {
+    const parts = nameArg.split('/');
+    customerName = parts[0];
+    skillName = parts[1];
+    const customersDir = path.join(process.cwd(), 'atris', 'customers', customerName, 'skills');
+    skillDir = path.join(customersDir, skillName);
+  } else {
+    skillName = nameArg;
+    skillDir = path.join(process.cwd(), 'atris', 'skills', skillName);
+  }
+
+  // Check if already exists
+  if (fs.existsSync(skillDir)) {
+    console.error(`✗ Skill "${nameArg}" already exists at ${skillDir}`);
+    process.exit(1);
+  }
+
+  // Generate content
+  const content = isIntegration
+    ? generateIntegrationSkillTemplate(skillName, description)
+    : generateSkillTemplate(skillName, description);
+
+  // Create skill directory and SKILL.md
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content);
+
+  console.log('');
+  if (customerName) {
+    console.log(`✓ Created atris/customers/${customerName}/skills/${skillName}/SKILL.md`);
+  } else {
+    console.log(`✓ Created atris/skills/${skillName}/SKILL.md`);
+  }
+
+  // Symlink to project-level .claude/skills/
+  const projectClaudeSkills = path.join(process.cwd(), '.claude', 'skills');
+  if (fs.existsSync(path.join(process.cwd(), '.claude'))) {
+    fs.mkdirSync(projectClaudeSkills, { recursive: true });
+    const projectLink = path.join(projectClaudeSkills, skillName);
+    if (!fs.existsSync(projectLink)) {
+      try {
+        const relTarget = path.relative(projectClaudeSkills, skillDir);
+        fs.symlinkSync(relTarget, projectLink);
+        console.log(`✓ Linked .claude/skills/${skillName} (project-level)`);
+      } catch (e) {
+        // Copy fallback
+        fs.mkdirSync(projectLink, { recursive: true });
+        fs.copyFileSync(path.join(skillDir, 'SKILL.md'), path.join(projectLink, 'SKILL.md'));
+        console.log(`✓ Copied to .claude/skills/${skillName} (project-level)`);
+      }
+    }
+  }
+
+  // Symlink to all AI tool skill directories (always, unless --local)
+  if (!isLocal) {
+    const home = require('os').homedir();
+    const toolDirs = [
+      { dir: path.join(home, '.claude', 'skills'), label: 'Claude' },
+      { dir: path.join(home, '.codex', 'skills'), label: 'Codex' },
+      { dir: path.join(home, '.cursor', 'skills'), label: 'Cursor' },
+    ];
+
+    const linked = [];
+    for (const { dir, label } of toolDirs) {
+      fs.mkdirSync(dir, { recursive: true });
+      const linkPath = path.join(dir, skillName);
+      if (!fs.existsSync(linkPath)) {
+        try {
+          fs.symlinkSync(skillDir, linkPath);
+          linked.push(label);
+        } catch (e) {
+          // Copy fallback
+          fs.mkdirSync(linkPath, { recursive: true });
+          fs.copyFileSync(path.join(skillDir, 'SKILL.md'), path.join(linkPath, 'SKILL.md'));
+          linked.push(label);
+        }
+      }
+    }
+    if (linked.length > 0) {
+      console.log(`✓ Linked to ${linked.join(', ')} (system-level — all tools)`);
+    }
+  }
+
+  // Summary
+  console.log('');
+  if (isIntegration) {
+    console.log('  Template: integration (bootstrap + API reference + error handling)');
+  } else {
+    console.log('  Template: standard (workflows + rules)');
+  }
+  console.log(`  Edit: ${path.join(skillDir, 'SKILL.md')}`);
+  console.log('');
+}
+
+// --- LINK subcommand (system-level symlink for existing skills) ---
+
+function skillLink(name, ...flags) {
+  const isAll = name === '--all';
+
+  const skillsDir = path.join(process.cwd(), 'atris', 'skills');
+  const allSkills = findAllSkills(skillsDir);
+
+  if (allSkills.length === 0) {
+    console.error('No skills found in atris/skills/.');
+    process.exit(1);
+  }
+
+  const targets = isAll
+    ? allSkills
+    : allSkills.filter(s => s.folder === name || s.leafFolder === name);
+
+  if (targets.length === 0) {
+    console.error(`Skill "${name}" not found. Run "atris skill list".`);
+    process.exit(1);
+  }
+
+  const home = require('os').homedir();
+  const toolDirs = [
+    { dir: path.join(home, '.claude', 'skills'), label: 'Claude' },
+    { dir: path.join(home, '.codex', 'skills'), label: 'Codex' },
+    { dir: path.join(home, '.cursor', 'skills'), label: 'Cursor' },
+  ];
+
+  // Ensure all tool directories exist
+  for (const { dir } of toolDirs) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  let linked = 0;
+  for (const skill of targets) {
+    const srcDir = path.dirname(skill.path);
+    const linkName = skill.leafFolder;
+    const toolsLinked = [];
+
+    for (const { dir, label } of toolDirs) {
+      const linkPath = path.join(dir, linkName);
+
+      if (fs.existsSync(linkPath)) {
+        try {
+          const existing = fs.readlinkSync(linkPath);
+          if (existing === srcDir || path.resolve(linkPath, '..', existing) === srcDir) {
+            continue; // Already linked correctly
+          }
+        } catch (e) {
+          continue; // Not a symlink, skip
+        }
+      }
+
+      try {
+        fs.symlinkSync(srcDir, linkPath);
+        toolsLinked.push(label);
+      } catch (e) {
+        // silent fail per tool
+      }
+    }
+
+    if (toolsLinked.length > 0) {
+      console.log(`✓ ${linkName} → ${toolsLinked.join(', ')}`);
+      linked++;
+    }
+  }
+
+  if (linked === 0) {
+    console.log('All skills already linked at system level.');
+  } else {
+    console.log(`\n${linked} skill(s) linked to ~/.claude/skills/ (available in all tools).`);
+  }
+}
+
+// --- DELETE subcommand ---
+
+function skillDelete(name) {
+  if (!name) {
+    console.error('Usage: atris skill delete <name>');
+    process.exit(1);
+  }
+
+  const home = require('os').homedir();
+  const removed = [];
+
+  // Remove from atris/skills/
+  const skillDir = path.join(process.cwd(), 'atris', 'skills', name);
+  if (fs.existsSync(skillDir)) {
+    fs.rmSync(skillDir, { recursive: true, force: true });
+    removed.push(`atris/skills/${name}`);
+  }
+
+  // Remove from atris/customers/ (check all customers)
+  const customersDir = path.join(process.cwd(), 'atris', 'customers');
+  if (fs.existsSync(customersDir)) {
+    const customers = fs.readdirSync(customersDir);
+    for (const customer of customers) {
+      const custSkillDir = path.join(customersDir, customer, 'skills', name);
+      if (fs.existsSync(custSkillDir)) {
+        fs.rmSync(custSkillDir, { recursive: true, force: true });
+        removed.push(`atris/customers/${customer}/skills/${name}`);
+      }
+    }
+  }
+
+  // Remove symlinks — use unlinkSync for symlinks, rmSync for directories
+  function removeLink(linkPath, label) {
+    try {
+      const stat = fs.lstatSync(linkPath);
+      if (stat.isSymbolicLink()) {
+        fs.unlinkSync(linkPath);
+      } else {
+        fs.rmSync(linkPath, { recursive: true, force: true });
+      }
+      removed.push(label);
+    } catch (e) { /* doesn't exist */ }
+  }
+
+  // Project-level
+  removeLink(path.join(process.cwd(), '.claude', 'skills', name), `.claude/skills/${name}`);
+
+  // System-level — all tool directories
+  const toolDirs = [
+    { dir: path.join(home, '.claude', 'skills', name), label: '~/.claude' },
+    { dir: path.join(home, '.codex', 'skills', name), label: '~/.codex' },
+    { dir: path.join(home, '.cursor', 'skills', name), label: '~/.cursor' },
+  ];
+
+  for (const { dir, label } of toolDirs) {
+    removeLink(dir, `${label}/skills/${name}`);
+  }
+
+  if (removed.length === 0) {
+    console.error(`✗ Skill "${name}" not found anywhere.`);
+    process.exit(1);
+  }
+
+  console.log('');
+  for (const r of removed) {
+    console.log(`✓ Removed ${r}`);
+  }
+  console.log('');
+}
+
 // --- Main Dispatcher ---
 
 function skillCommand(subcommand, ...args) {
@@ -481,15 +852,38 @@ function skillCommand(subcommand, ...args) {
       return skillAudit(args[0] || '--all');
     case 'fix':
       return skillFix(args[0] || '--all');
+    case 'create':
+    case 'new':
+      return skillCreate(args[0], ...args.slice(1));
+    case 'link':
+      return skillLink(args[0] || '--all', ...args.slice(1));
+    case 'delete':
+    case 'rm':
+    case 'remove':
+      return skillDelete(args[0]);
     default:
       console.log('');
       console.log('Usage: atris skill <subcommand> [name]');
       console.log('');
       console.log('Subcommands:');
-      console.log('  list              Show all skills with compliance status');
+      console.log('  create <name>       Scaffold a new skill with SKILL.md template');
+      console.log('  delete <name>       Remove a skill and all its symlinks');
+      console.log('  link [name|--all]   Symlink skills to ~/.claude/skills/ (system-level)');
+      console.log('  list                Show all skills with compliance status');
       console.log('  audit [name|--all]  Validate skill against Anthropic guide');
       console.log('  fix [name|--all]    Auto-fix common compliance issues');
       console.log('');
+      console.log('Create flags:');
+      console.log('  --integration       Use integration template (bootstrap + API)');
+      console.log('  --local             Only link to this project (skip system-level)');
+      console.log('  --description="..."  Set the skill description');
+      console.log('');
+      console.log('Examples:');
+      console.log('  atris skill create daily-standup');
+      console.log('  atris skill create email-outreach --integration');
+      console.log('  atris skill create pallet/bol-processor --integration');
+      console.log('  atris skill link --all');
+      console.log('');
   }
 }
 

package/commands/sync.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
 function syncAtris() {
   const targetDir = path.join(process.cwd(), 'atris');
@@ -59,11 +60,11 @@ function syncAtris() {
     { source: 'PERSONA.md', target: 'PERSONA.md' },
     { source: 'GETTING_STARTED.md', target: 'GETTING_STARTED.md' },
     { source: 'atris/CLAUDE.md', target: 'CLAUDE.md' },
-    { source: 'atris/team/navigator.md', target: 'team/navigator.md' },
-    { source: 'atris/team/executor.md', target: 'team/executor.md' },
-    { source: 'atris/team/validator.md', target: 'team/validator.md' },
-    { source: 'atris/team/launcher.md', target: 'team/launcher.md' },
-    { source: 'atris/team/brainstormer.md', target: 'team/brainstormer.md' },
+    { source: 'atris/team/navigator/MEMBER.md', target: 'team/navigator/MEMBER.md' },
+    { source: 'atris/team/executor/MEMBER.md', target: 'team/executor/MEMBER.md' },
+    { source: 'atris/team/validator/MEMBER.md', target: 'team/validator/MEMBER.md' },
+    { source: 'atris/team/launcher/MEMBER.md', target: 'team/launcher/MEMBER.md' },
+    { source: 'atris/team/brainstormer/MEMBER.md', target: 'team/brainstormer/MEMBER.md' },
     { source: 'atris/policies/ANTISLOP.md', target: 'policies/ANTISLOP.md' }
   ];
 
@@ -87,6 +88,7 @@ function syncAtris() {
       return;
     }
 
+    fs.mkdirSync(path.dirname(targetFile), { recursive: true });
     fs.copyFileSync(sourceFile, targetFile);
     console.log(`✓ Updated ${target}`);
     updated++;
@@ -293,83 +295,114 @@ After displaying the boot output, respond to the user naturally.
 }
 
 /**
- * Lightweight skill-only sync. Compares package skills against project skills
- * and updates any that differ. Called automatically from `atris activate`.
+ * Recursively sync files from src to dest. Returns count of files updated.
+ */
+function syncRecursiveCount(src, dest, label, silent) {
+  let count = 0;
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  const entries = fs.readdirSync(src);
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry);
+    const destPath = path.join(dest, entry);
+
+    if (fs.statSync(srcPath).isDirectory()) {
+      count += syncRecursiveCount(srcPath, destPath, `${label}/${entry}`, silent);
+    } else {
+      const srcContent = fs.readFileSync(srcPath, 'utf8');
+      const destContent = fs.existsSync(destPath) ? fs.readFileSync(destPath, 'utf8') : '';
+      if (srcContent !== destContent) {
+        fs.writeFileSync(destPath, srcContent);
+        if (entry.endsWith('.sh')) {
+          fs.chmodSync(destPath, 0o755);
+        }
+        if (!silent) {
+          console.log(`✓ Updated ${label}/${entry}`);
+        }
+        count++;
+      }
+    }
+  }
+  return count;
+}
+
+/**
+ * Lightweight skill-only sync. Syncs skills from the npm package to:
+ *   1. Global skill dirs (~/.claude/skills/, ~/.codex/skills/) — always, if they exist
+ *   2. Project-level (atris/skills/ + .claude/skills/ symlinks) — if in a project
+ *
+ * Global = baseline truth. Project = optional override.
  * Returns number of files updated (0 = already current).
  */
 function syncSkills({ silent = false } = {}) {
-  const targetDir = path.join(process.cwd(), 'atris');
   const packageSkillsDir = path.join(__dirname, '..', 'atris', 'skills');
-  const userSkillsDir = path.join(targetDir, 'skills');
-  const claudeSkillsBaseDir = path.join(process.cwd(), '.claude', 'skills');
-
-  if (!fs.existsSync(targetDir) || !fs.existsSync(packageSkillsDir)) {
+  if (!fs.existsSync(packageSkillsDir)) {
     return 0;
   }
 
-  if (!fs.existsSync(userSkillsDir)) {
-    fs.mkdirSync(userSkillsDir, { recursive: true });
-  }
-  if (!fs.existsSync(claudeSkillsBaseDir)) {
-    fs.mkdirSync(claudeSkillsBaseDir, { recursive: true });
-  }
-
   let updated = 0;
+  const homeDir = os.homedir();
 
   const skillFolders = fs.readdirSync(packageSkillsDir).filter(f =>
     fs.statSync(path.join(packageSkillsDir, f)).isDirectory()
   );
 
-  for (const skill of skillFolders) {
-    const srcSkillDir = path.join(packageSkillsDir, skill);
-    const destSkillDir = path.join(userSkillsDir, skill);
-    const symlinkPath = path.join(claudeSkillsBaseDir, skill);
+  // --- 1. Global skill directories (sync if they exist) ---
+  const globalSkillDirs = [
+    path.join(homeDir, '.claude', 'skills'),
+    path.join(homeDir, '.codex', 'skills'),
+  ];
 
-    const syncRecursive = (src, dest, skillName, basePath = '') => {
-      if (!fs.existsSync(dest)) {
-        fs.mkdirSync(dest, { recursive: true });
-      }
-      const entries = fs.readdirSync(src);
-      for (const entry of entries) {
-        const srcPath = path.join(src, entry);
-        const destPath = path.join(dest, entry);
-        const relPath = basePath ? `${basePath}/${entry}` : entry;
-
-        if (fs.statSync(srcPath).isDirectory()) {
-          syncRecursive(srcPath, destPath, skillName, relPath);
-        } else {
-          const srcContent = fs.readFileSync(srcPath, 'utf8');
-          const destContent = fs.existsSync(destPath) ? fs.readFileSync(destPath, 'utf8') : '';
-          if (srcContent !== destContent) {
-            fs.writeFileSync(destPath, srcContent);
-            if (entry.endsWith('.sh')) {
-              fs.chmodSync(destPath, 0o755);
-            }
-            if (!silent) {
-              console.log(`✓ Updated atris/skills/${skillName}/${relPath}`);
-            }
-            updated++;
-          }
-        }
+  for (const globalDir of globalSkillDirs) {
+    if (!fs.existsSync(globalDir)) continue;
+    const dirName = path.basename(path.dirname(globalDir)); // .claude or .codex
+
+    for (const skill of skillFolders) {
+      const srcSkillDir = path.join(packageSkillsDir, skill);
+      const destSkillDir = path.join(globalDir, skill);
+
+      if (fs.existsSync(destSkillDir) || fs.existsSync(globalDir)) {
+        updated += syncRecursiveCount(srcSkillDir, destSkillDir, `~/${dirName}/skills/${skill}`, silent);
       }
-    };
+    }
+  }
 
-    syncRecursive(srcSkillDir, destSkillDir, skill);
+  // --- 2. Project-level (only if inside an atris project) ---
+  const targetDir = path.join(process.cwd(), 'atris');
+  if (fs.existsSync(targetDir)) {
+    const userSkillsDir = path.join(targetDir, 'skills');
+    const claudeSkillsBaseDir = path.join(process.cwd(), '.claude', 'skills');
 
-    // Create symlink if doesn't exist
-    if (!fs.existsSync(symlinkPath)) {
-      const relativePath = path.join('..', '..', 'atris', 'skills', skill);
-      try {
-        fs.symlinkSync(relativePath, symlinkPath);
-        if (!silent) {
-          console.log(`✓ Linked .claude/skills/${skill}`);
-        }
-      } catch (e) {
-        // Fallback: copy instead of symlink
-        fs.mkdirSync(symlinkPath, { recursive: true });
-        const skillFile = path.join(destSkillDir, 'SKILL.md');
-        if (fs.existsSync(skillFile)) {
-          fs.copyFileSync(skillFile, path.join(symlinkPath, 'SKILL.md'));
+    if (!fs.existsSync(userSkillsDir)) {
+      fs.mkdirSync(userSkillsDir, { recursive: true });
+    }
+    if (!fs.existsSync(claudeSkillsBaseDir)) {
+      fs.mkdirSync(claudeSkillsBaseDir, { recursive: true });
+    }
+
+    for (const skill of skillFolders) {
+      const srcSkillDir = path.join(packageSkillsDir, skill);
+      const destSkillDir = path.join(userSkillsDir, skill);
+      const symlinkPath = path.join(claudeSkillsBaseDir, skill);
+
+      updated += syncRecursiveCount(srcSkillDir, destSkillDir, `atris/skills/${skill}`, silent);
+
+      // Create symlink if doesn't exist
+      if (!fs.existsSync(symlinkPath)) {
+        const relativePath = path.join('..', '..', 'atris', 'skills', skill);
+        try {
+          fs.symlinkSync(relativePath, symlinkPath);
+          if (!silent) {
+            console.log(`✓ Linked .claude/skills/${skill}`);
+          }
+        } catch (e) {
+          // Fallback: copy instead of symlink
+          fs.mkdirSync(symlinkPath, { recursive: true });
+          const skillFile = path.join(destSkillDir, 'SKILL.md');
+          if (fs.existsSync(skillFile)) {
+            fs.copyFileSync(skillFile, path.join(symlinkPath, 'SKILL.md'));
+          }
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.3.1",
+  "version": "2.3.4",
   "description": "atrisDev (atris dev) - CLI for AI coding agents. Works with Claude Code, Cursor, Windsurf. Make any codebase AI-navigable.",
   "main": "bin/atris.js",
   "bin": {