@wowok/skills 1.1.0 → 1.1.2

package/README.md

@@ -17,7 +17,7 @@ Each skill is a `SKILL.md` file with YAML frontmatter. Claude Code discovers the
 ```
 npm install -g @wowok/skills
        │
-       └── postinstall ──→ Copies 6 SKILL.md to ~/.claude/skills/wowok-*/
+       └── postinstall ──→ Copies 7 SKILL.md to ~/.claude/skills/wowok-*/
                             AI discovers them on next session ✅
 ```
 
@@ -26,7 +26,7 @@ npm install -g @wowok/skills
 | Mode | Skills | Behavior |
 |------|--------|----------|
 | **Always** | `wowok-tools`, `wowok-safety` | Metadata always in prompt (~100 tokens each). AI auto-loads full content when needed. |
-| **On-demand** | `wowok-build`, `wowok-guard`, `wowok-machine`, `wowok-order` | AI matches description to task. Only loaded when relevant. |
+| **On-demand** | `wowok-provider`, `wowok-arbitrator`, `wowok-order`, `wowok-messenger`, `wowok-guard`, `wowok-machine` | AI matches description to task. Only loaded when relevant. |
 
 ## Quick Start
 
@@ -53,7 +53,7 @@ See [WoWok Agent](https://github.com/wowok-ai/agent) for more details.
 npm install -g @wowok/skills
 ```
 
-This automatically installs all 6 skills to `~/.claude/skills/`. They will be available in your next Claude Code session.
+This automatically installs all 8 skills to `~/.claude/skills/`. They will be available in your next Claude Code session.
 
 ### 3. Install (Project — Team Sharing)
 
@@ -81,7 +81,7 @@ npm install -g @wowok/skills
 
 ```bash
 wowok-skills list
-wowok-skills get wowok-build
+wowok-skills get wowok-provider
 ```
 
 ### Update
@@ -118,19 +118,21 @@ wowok-skills uninit
 import { getSkills, getSkillByName } from '@wowok/skills';
 
 const skills = getSkills();
-const buildSkill = getSkillByName('wowok-build');
+const providerSkill = getSkillByName('wowok-provider');
 ```
 
 ## Available Skills
 
-| Skill | Purpose | Loading |
-|-------|---------|---------|
-| `wowok-build` | Complex system building (Service + Machine + Guard + Allocation + Reward) | On-demand |
-| `wowok-guard` | Guard design mastery (programmable trust rules) | On-demand |
-| `wowok-tools` | MCP tool usage mastery (13 tools, schema references) | Always |
-| `wowok-safety` | Safety protocol (dry-run → confirm → execute) | Always |
-| `wowok-machine` | Machine workflow design (state machines, progress tracking) | On-demand |
-| `wowok-order` | Order lifecycle management (payment, allocation, arbitration) | On-demand |
+| Skill | Purpose | Role | Loading |
+|-------|---------|------|---------|
+| `wowok-provider` | Service provider guide (create Service, Machine, Allocators, handle orders) | Service Provider (Merchant) | On-demand |
+| `wowok-arbitrator` | Arbitration service guide (create Arbitration, handle disputes, voting) | Arbitrator | On-demand |
+| `wowok-order` | Order lifecycle management (place orders, track progress, arbitration) | Customer | On-demand |
+| `wowok-messenger` | Encrypted messaging (E2E communication, WTS evidence, conversation management) | All Roles | On-demand |
+| `wowok-guard` | Guard design mastery (programmable trust rules) | All Roles | On-demand |
+| `wowok-machine` | Machine workflow design (state machines, progress tracking) | Service Provider | On-demand |
+| `wowok-tools` | MCP tool usage mastery (13 tools, schema references) | All Roles | Always |
+| `wowok-safety` | Safety protocol (dry-run → confirm → execute) | All Roles | Always |
 
 ## Related Projects
 
@@ -147,10 +149,4 @@ npm run watch
 
 ## License
 
-Apache-2.0
-
-## Links
-
-- GitHub: [https://github.com/wowok-ai/skills](https://github.com/wowok-ai/skills)
-- npm: [https://www.npmjs.com/package/@wowok/skills](https://www.npmjs.com/package/@wowok/skills)
-- X: [https://x.com/Wowok_Ai](https://x.com/Wowok_Ai)
+MIT

package/dist/cli.js

@@ -37,14 +37,36 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const skills_1 = require("./skills");
+/**
+ * Skill directory names (must match folder names in package)
+ * Ordered by role for clarity:
+ * - Customer: wowok-order
+ * - Provider: wowok-provider, wowok-machine
+ * - Arbitrator: wowok-arbitrator
+ * - Shared: wowok-guard, wowok-tools, wowok-safety
+ */
 const SKILL_DIRS = [
-    'wowok-build',
+    // Customer
+    'wowok-order',
+    // Provider
+    'wowok-provider',
+    'wowok-machine',
+    // Arbitrator
+    'wowok-arbitrator',
+    // Shared
     'wowok-guard',
     'wowok-tools',
     'wowok-safety',
-    'wowok-machine',
-    'wowok-order',
 ];
+/**
+ * Role display names for CLI output
+ */
+const ROLE_DISPLAY = {
+    customer: '👤 Customer',
+    provider: '🏪 Provider',
+    arbitrator: '⚖️  Arbitrator',
+    shared: '🛠️  Shared'
+};
 function getPackageRoot() {
     return path.resolve(__dirname, '..');
 }
@@ -121,15 +143,86 @@ function cmdUninit() {
         console.log(`[wowok-skills] Done — ${count} skills removed from ${targetDir}`);
     }
 }
+function cmdList() {
+    console.log('Available WoWok Skills (organized by role):\n');
+    const roleSkills = (0, skills_1.getRoleSkills)();
+    for (const roleGroup of roleSkills) {
+        console.log(`${ROLE_DISPLAY[roleGroup.role]}`);
+        console.log(`  ${roleGroup.description}`);
+        for (const skill of roleGroup.skills) {
+            const loading = skill.loading === 'always' ? '[always]' : '[on-demand]';
+            console.log(`    • ${skill.name} ${loading}`);
+            console.log(`      ${skill.description}`);
+        }
+        console.log('');
+    }
+}
+function cmdGet(name) {
+    const skill = (0, skills_1.getSkillByName)(name);
+    if (skill) {
+        console.log(`Name: ${skill.name}`);
+        console.log(`Role: ${ROLE_DISPLAY[skill.role]}`);
+        console.log(`Loading: ${skill.loading}`);
+        console.log(`Version: ${skill.version}`);
+        console.log(`Description: ${skill.description}`);
+        if (skill.related && skill.related.length > 0) {
+            console.log(`Related: ${skill.related.join(', ')}`);
+        }
+    }
+    else {
+        console.error(`Skill not found: ${name}`);
+        process.exit(1);
+    }
+}
+function cmdRecommend(intent) {
+    const recommended = (0, skills_1.recommendSkills)(intent);
+    console.log(`Recommended skills for: "${intent}"\n`);
+    // Group by role
+    const byRole = {};
+    for (const skill of recommended) {
+        if (!byRole[skill.role])
+            byRole[skill.role] = [];
+        byRole[skill.role].push(skill);
+    }
+    for (const [role, skills] of Object.entries(byRole)) {
+        console.log(`${ROLE_DISPLAY[role]}:`);
+        for (const skill of skills) {
+            console.log(`  • ${skill.name}`);
+        }
+        console.log('');
+    }
+}
+function cmdRole(role) {
+    if (!['customer', 'provider', 'arbitrator', 'shared'].includes(role)) {
+        console.error(`Invalid role: ${role}`);
+        console.error('Valid roles: customer, provider, arbitrator, shared');
+        process.exit(1);
+    }
+    const skills = (0, skills_1.getSkillsByRole)(role);
+    console.log(`${ROLE_DISPLAY[role]} Skills:\n`);
+    for (const skill of skills) {
+        const loading = skill.loading === 'always' ? '[always]' : '[on-demand]';
+        console.log(`  • ${skill.name} ${loading}`);
+        console.log(`    ${skill.description}`);
+    }
+}
 function printUsage() {
     console.log('WoWok Skills CLI');
-    console.log('Usage: wowok-skills <command>');
+    console.log('Usage: wowok-skills <command> [args]');
     console.log('');
     console.log('Commands:');
-    console.log('  list              List all available skills');
-    console.log('  get <name>        Show skill details');
-    console.log('  init              Install skills to current project (.claude/skills/)');
-    console.log('  uninit            Remove skills from current project');
+    console.log('  list                    List all available skills (by role)');
+    console.log('  get <name>              Show skill details');
+    console.log('  role <role>             List skills for a role (customer|provider|arbitrator|shared)');
+    console.log('  recommend <intent>      Recommend skills based on user intent');
+    console.log('  init                    Install skills to current project (.claude/skills/)');
+    console.log('  uninit                  Remove skills from current project');
+    console.log('');
+    console.log('Examples:');
+    console.log('  wowok-skills list');
+    console.log('  wowok-skills get wowok-provider');
+    console.log('  wowok-skills role provider');
+    console.log('  wowok-skills recommend "create a service"');
 }
 function main() {
     const args = process.argv.slice(2);
@@ -140,26 +233,28 @@ function main() {
     const command = args[0];
     switch (command) {
         case 'list':
-            console.log('Available WoWok Skills:');
-            (0, skills_1.getSkills)().forEach(skill => {
-                console.log(`  - ${skill.name}: ${skill.description}`);
-            });
+            cmdList();
             break;
         case 'get':
             if (args.length < 2) {
                 console.error('Error: Skill name required');
                 process.exit(1);
             }
-            const skill = (0, skills_1.getSkillByName)(args[1]);
-            if (skill) {
-                console.log(`Name: ${skill.name}`);
-                console.log(`Description: ${skill.description}`);
-                console.log(`Version: ${skill.version}`);
+            cmdGet(args[1]);
+            break;
+        case 'role':
+            if (args.length < 2) {
+                console.error('Error: Role required (customer|provider|arbitrator|shared)');
+                process.exit(1);
             }
-            else {
-                console.error(`Skill not found: ${args[1]}`);
+            cmdRole(args[1]);
+            break;
+        case 'recommend':
+            if (args.length < 2) {
+                console.error('Error: Intent description required');
                 process.exit(1);
             }
+            cmdRecommend(args.slice(1).join(' '));
             break;
         case 'init':
             cmdInit();

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './skills';
 export * from './types';
+export { wowokSkills, getSkills, getSkillByName, getSkillsByRole, getSkillsByLoading, getRoleSkills, recommendSkills } from './skills';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -14,6 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./skills"), exports);
+exports.recommendSkills = exports.getRoleSkills = exports.getSkillsByLoading = exports.getSkillsByRole = exports.getSkillByName = exports.getSkills = exports.wowokSkills = void 0;
+// Export types
 __exportStar(require("./types"), exports);
+// Export skills with role-based helpers
+var skills_1 = require("./skills");
+Object.defineProperty(exports, "wowokSkills", { enumerable: true, get: function () { return skills_1.wowokSkills; } });
+Object.defineProperty(exports, "getSkills", { enumerable: true, get: function () { return skills_1.getSkills; } });
+Object.defineProperty(exports, "getSkillByName", { enumerable: true, get: function () { return skills_1.getSkillByName; } });
+Object.defineProperty(exports, "getSkillsByRole", { enumerable: true, get: function () { return skills_1.getSkillsByRole; } });
+Object.defineProperty(exports, "getSkillsByLoading", { enumerable: true, get: function () { return skills_1.getSkillsByLoading; } });
+Object.defineProperty(exports, "getRoleSkills", { enumerable: true, get: function () { return skills_1.getRoleSkills; } });
+Object.defineProperty(exports, "recommendSkills", { enumerable: true, get: function () { return skills_1.recommendSkills; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,0CAAwB;AAExB,wCAAwC;AACxC,mCAQkB;AAPhB,qGAAA,WAAW,OAAA;AACX,mGAAA,SAAS,OAAA;AACT,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA"}

package/dist/skills.d.ts

@@ -1,5 +1,50 @@
-import { Skill, SkillConfig } from './types';
+import { Skill, SkillConfig, SkillRole, RoleSkills } from './types';
+/**
+ * WoWok Skills organized by role
+ *
+ * Role-based skill selection guide for AI:
+ *
+ * 1. CUSTOMER (wowok-order)
+ *    - Use when: User wants to place orders, track progress, request arbitration as a customer
+ *    - Key actions: Purchase from Service, operate Order/Progress, submit disputes
+ *
+ * 2. PROVIDER (wowok-provider, wowok-machine)
+ *    - Use when: User is a merchant/service provider building or operating services
+ *    - Key actions: Create Service, design Machine workflow, set Allocators, handle customer orders
+ *
+ * 3. ARBITRATOR (wowok-arbitrator)
+ *    - Use when: User operates an arbitration service for dispute resolution
+ *    - Key actions: Create Arbitration, review evidence, organize voting, manage fees
+ *
+ * 4. SHARED (wowok-tools, wowok-safety, wowok-guard)
+ *    - Use when: Any role needs tool usage, safety protocols, or guard design
+ *    - Always loaded: wowok-tools, wowok-safety
+ *    - On-demand: wowok-guard (complex guard design)
+ */
 export declare const wowokSkills: SkillConfig;
+/**
+ * Get all skills
+ */
 export declare function getSkills(): Skill[];
+/**
+ * Get skill by name
+ */
 export declare function getSkillByName(name: string): Skill | undefined;
+/**
+ * Get skills by role
+ */
+export declare function getSkillsByRole(role: SkillRole): Skill[];
+/**
+ * Get skills by loading mode
+ */
+export declare function getSkillsByLoading(mode: 'always' | 'on-demand'): Skill[];
+/**
+ * Get role-based skill groupings for AI guidance
+ */
+export declare function getRoleSkills(): RoleSkills[];
+/**
+ * AI skill selection helper
+ * Returns recommended skills based on user intent keywords
+ */
+export declare function recommendSkills(intent: string): Skill[];
 //# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,WAAW,EAAE,WAiCzB,CAAC;AAEF,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAEnC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE9D"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,WAAW,EAAE,WA0EzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,EAAE,CAEnC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,KAAK,EAAE,CAExE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,EAAE,CA4B5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,CAyBvD"}

package/dist/skills.js

@@ -3,44 +3,182 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.wowokSkills = void 0;
 exports.getSkills = getSkills;
 exports.getSkillByName = getSkillByName;
+exports.getSkillsByRole = getSkillsByRole;
+exports.getSkillsByLoading = getSkillsByLoading;
+exports.getRoleSkills = getRoleSkills;
+exports.recommendSkills = recommendSkills;
+/**
+ * WoWok Skills organized by role
+ *
+ * Role-based skill selection guide for AI:
+ *
+ * 1. CUSTOMER (wowok-order)
+ *    - Use when: User wants to place orders, track progress, request arbitration as a customer
+ *    - Key actions: Purchase from Service, operate Order/Progress, submit disputes
+ *
+ * 2. PROVIDER (wowok-provider, wowok-machine)
+ *    - Use when: User is a merchant/service provider building or operating services
+ *    - Key actions: Create Service, design Machine workflow, set Allocators, handle customer orders
+ *
+ * 3. ARBITRATOR (wowok-arbitrator)
+ *    - Use when: User operates an arbitration service for dispute resolution
+ *    - Key actions: Create Arbitration, review evidence, organize voting, manage fees
+ *
+ * 4. SHARED (wowok-tools, wowok-safety, wowok-guard)
+ *    - Use when: Any role needs tool usage, safety protocols, or guard design
+ *    - Always loaded: wowok-tools, wowok-safety
+ *    - On-demand: wowok-guard (complex guard design)
+ */
 exports.wowokSkills = {
     skills: [
+        // === CUSTOMER ROLE ===
         {
-            name: 'wowok-build',
-            description: 'Complex system building — Service, Machine, Guard, Allocation, Reward orchestration',
-            version: '1.0.0'
+            name: 'wowok-order',
+            description: 'Customer order lifecycle — place orders, track progress via Order/Progress, submit arbitration disputes, claim compensation. Use when user acts as a customer/buyer.',
+            version: '1.0.0',
+            role: 'customer',
+            loading: 'on-demand',
+            related: ['wowok-provider', 'wowok-arbitrator', 'wowok-messenger', 'wowok-tools']
         },
+        // === PROVIDER ROLE ===
         {
-            name: 'wowok-guard',
-            description: 'Guard design mastery — programmable trust rules and multi-signature authorization',
-            version: '1.0.0'
+            name: 'wowok-provider',
+            description: 'Service provider guide — create Service, design Machine workflow, configure Allocators for fund distribution, handle order fulfillment and customer service via Messenger. Use when user is a merchant/seller.',
+            version: '1.0.0',
+            role: 'provider',
+            loading: 'on-demand',
+            related: ['wowok-machine', 'wowok-guard', 'wowok-messenger', 'wowok-tools']
         },
         {
             name: 'wowok-machine',
-            description: 'Machine workflow design — state machines, progress tracking, multi-step processes',
-            version: '1.0.0'
+            description: 'Machine workflow design — state machines, node definitions, progress tracking, forward/guard logic. Used by providers to design order processing workflows.',
+            version: '1.0.0',
+            role: 'provider',
+            loading: 'on-demand',
+            related: ['wowok-provider', 'wowok-guard']
         },
+        // === ARBITRATOR ROLE ===
         {
-            name: 'wowok-order',
-            description: 'Order lifecycle management — payment, allocation, arbitration, and settlement',
-            version: '1.0.0'
+            name: 'wowok-arbitrator',
+            description: 'Arbitration service operation — create Arbitration, receive evidence via Messenger, organize voting processes, manage compensation funds, extract fees. Use when user operates dispute resolution.',
+            version: '1.0.0',
+            role: 'arbitrator',
+            loading: 'on-demand',
+            related: ['wowok-order', 'wowok-messenger', 'wowok-tools']
         },
+        // === SHARED / ALL ROLES ===
         {
-            name: 'wowok-safety',
-            description: 'Safety protocol — dry-run, confirm, execute with user authorization checkpoints',
-            version: '1.0.0'
+            name: 'wowok-messenger',
+            description: 'Encrypted messaging — end-to-end encrypted communication, WTS evidence generation, conversation management. Used by all roles for secure off-chain communication and arbitration evidence.',
+            version: '1.0.0',
+            role: 'shared',
+            loading: 'on-demand',
+            related: ['wowok-order', 'wowok-provider', 'wowok-arbitrator']
         },
         {
             name: 'wowok-tools',
-            description: 'MCP tool usage mastery — 13 tools, nested parameters, schema references',
-            version: '1.0.0'
+            description: 'MCP tool usage mastery — query_toolkit, onchain_operations, messenger_operation, schema_query, and all 13+ tools with correct parameter formats. ALWAYS loaded for all roles.',
+            version: '1.0.0',
+            role: 'shared',
+            loading: 'always',
+            related: ['wowok-safety']
+        },
+        {
+            name: 'wowok-safety',
+            description: 'Safety protocol — dry-run validation, user confirmation checkpoints, execute with authorization. ALWAYS loaded for protection against mistakes.',
+            version: '1.0.0',
+            role: 'shared',
+            loading: 'always',
+            related: ['wowok-tools']
+        },
+        {
+            name: 'wowok-guard',
+            description: 'Guard design mastery — programmable trust rules, multi-signature authorization, guard2file export/import. Used by providers and arbitrators for complex validation logic.',
+            version: '1.0.0',
+            role: 'shared',
+            loading: 'on-demand',
+            related: ['wowok-provider', 'wowok-machine']
         }
     ]
 };
+/**
+ * Get all skills
+ */
 function getSkills() {
     return exports.wowokSkills.skills;
 }
+/**
+ * Get skill by name
+ */
 function getSkillByName(name) {
     return exports.wowokSkills.skills.find(skill => skill.name === name);
 }
+/**
+ * Get skills by role
+ */
+function getSkillsByRole(role) {
+    return exports.wowokSkills.skills.filter(skill => skill.role === role);
+}
+/**
+ * Get skills by loading mode
+ */
+function getSkillsByLoading(mode) {
+    return exports.wowokSkills.skills.filter(skill => skill.loading === mode);
+}
+/**
+ * Get role-based skill groupings for AI guidance
+ */
+function getRoleSkills() {
+    const roles = [
+        {
+            role: 'customer',
+            roleName: 'Customer',
+            description: 'Users placing orders and participating in commerce as buyers'
+        },
+        {
+            role: 'provider',
+            roleName: 'Service Provider',
+            description: 'Merchants and sellers creating services and handling orders'
+        },
+        {
+            role: 'arbitrator',
+            roleName: 'Arbitrator',
+            description: 'Dispute resolution services and voting organizers'
+        },
+        {
+            role: 'shared',
+            roleName: 'Shared Tools',
+            description: 'Common tools and protocols for all roles'
+        }
+    ];
+    return roles.map(r => ({
+        ...r,
+        skills: getSkillsByRole(r.role)
+    }));
+}
+/**
+ * AI skill selection helper
+ * Returns recommended skills based on user intent keywords
+ */
+function recommendSkills(intent) {
+    const lower = intent.toLowerCase();
+    // Provider keywords
+    if (/\b(create service|merchant|seller|provider|build service|allocators?|machine design)\b/.test(lower)) {
+        return getSkillsByRole('provider');
+    }
+    // Customer keywords
+    if (/\b(place order|buy|purchase|customer|order status|track progress|dispute|compensation)\b/.test(lower)) {
+        return getSkillsByRole('customer');
+    }
+    // Arbitrator keywords
+    if (/\b(arbitration|arbitrator|dispute resolution|voting|evidence|arb object)\b/.test(lower)) {
+        return getSkillsByRole('arbitrator');
+    }
+    // Guard keywords
+    if (/\b(guard design|validation rules?|multi.sig|permission|authorization)\b/.test(lower)) {
+        return [getSkillByName('wowok-guard')];
+    }
+    // Default: return all on-demand skills
+    return getSkillsByLoading('on-demand');
+}
 //# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":";;;AAqCA,8BAEC;AAED,wCAEC;AAzCY,QAAA,WAAW,GAAgB;IACtC,MAAM,EAAE;QACN;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,qFAAqF;YAClG,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,mFAAmF;YAChG,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,mFAAmF;YAChG,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,+EAA+E;YAC5F,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,iFAAiF;YAC9F,OAAO,EAAE,OAAO;SACjB;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,yEAAyE;YACtF,OAAO,EAAE,OAAO;SACjB;KACF;CACF,CAAC;AAEF,SAAgB,SAAS;IACvB,OAAO,mBAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,mBAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,9 +1,40 @@
+/**
+ * Skill role categories for AI selection
+ */
+export type SkillRole = 'customer' | 'provider' | 'arbitrator' | 'shared';
+/**
+ * Skill loading mode
+ * - 'always': Always loaded, metadata in prompt
+ * - 'on-demand': Loaded only when description matches task
+ */
+export type LoadingMode = 'always' | 'on-demand';
+/**
+ * Skill definition
+ */
 export interface Skill {
     name: string;
     description: string;
     version: string;
+    /** Role this skill is for */
+    role: SkillRole;
+    /** Loading mode */
+    loading: LoadingMode;
+    /** Related skills that might also be relevant */
+    related?: string[];
 }
+/**
+ * Skill configuration
+ */
 export interface SkillConfig {
     skills: Skill[];
 }
+/**
+ * Role-based skill grouping for AI guidance
+ */
+export interface RoleSkills {
+    role: SkillRole;
+    roleName: string;
+    description: string;
+    skills: Skill[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,mBAAmB;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}