clodds 1.1.0 → 1.2.0

package/dist/skills/executor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Skill Executor - Central registry for all 110 bundled CLI skill handlers.
+ * Skill Executor - Central registry for all 118 bundled CLI skill handlers.
  *
  * ARCHITECTURE:
  * - Each skill lives in src/skills/bundled/<name>/index.ts

package/dist/skills/executor.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Skill Executor - Central registry for all 110 bundled CLI skill handlers.
+ * Skill Executor - Central registry for all 118 bundled CLI skill handlers.
  *
  * ARCHITECTURE:
  * - Each skill lives in src/skills/bundled/<name>/index.ts
@@ -117,6 +117,8 @@ const SKILL_MANIFEST = [
     'jupiter',
     'kamino',
     'ledger',
+    'lighter',
+    'marginfi',
     'market-index',
     'markets',
     'mcp',
@@ -135,6 +137,7 @@ const SKILL_MANIFEST = [
     'opportunity',
     'orca',
     'pairing',
+    'pancakeswap',
     'percolator',
     'permissions',
     'plugins',
@@ -162,6 +165,7 @@ const SKILL_MANIFEST = [
     'sizing',
     'slippage',
     'smarkets',
+    'solend',
     'strategy',
     'streaming',
     'tailscale',
@@ -189,7 +193,300 @@ const SKILL_MANIFEST = [
     'token-security',
     'dca',
     'shield',
+    'setup',
 ];
+const SKILL_CATEGORIES = {
+    // DeFi & DEX
+    'pancakeswap': 'DeFi & DEX',
+    'bridge': 'DeFi & DEX',
+    'trading-evm': 'DeFi & DEX',
+    'onchainkit': 'DeFi & DEX',
+    'ens': 'DeFi & DEX',
+    'erc8004': 'DeFi & DEX',
+    'endaoment': 'DeFi & DEX',
+    'clanker': 'DeFi & DEX',
+    'slippage': 'DeFi & DEX',
+    'router': 'DeFi & DEX',
+    'mev': 'DeFi & DEX',
+    'virtuals': 'DeFi & DEX',
+    // Futures & Perps
+    'hyperliquid': 'Futures & Perps',
+    'lighter': 'Futures & Perps',
+    'drift': 'Futures & Perps',
+    'drift-sdk': 'Futures & Perps',
+    'binance-futures': 'Futures & Perps',
+    'bybit-futures': 'Futures & Perps',
+    'mexc-futures': 'Futures & Perps',
+    'trading-futures': 'Futures & Perps',
+    // Prediction Markets
+    'trading-polymarket': 'Prediction Markets',
+    'betfair': 'Prediction Markets',
+    'trading-kalshi': 'Prediction Markets',
+    'trading-manifold': 'Prediction Markets',
+    'predictfun': 'Prediction Markets',
+    'predictit': 'Prediction Markets',
+    'smarkets': 'Prediction Markets',
+    'metaculus': 'Prediction Markets',
+    'veil': 'Prediction Markets',
+    'agentbets': 'Prediction Markets',
+    'opinion': 'Prediction Markets',
+    // Solana DeFi
+    'jupiter': 'Solana DeFi',
+    'raydium': 'Solana DeFi',
+    'orca': 'Solana DeFi',
+    'meteora': 'Solana DeFi',
+    'meteora-dbc': 'Solana DeFi',
+    'pumpfun': 'Solana DeFi',
+    'pump-swarm': 'Solana DeFi',
+    'kamino': 'Solana DeFi',
+    'marginfi': 'Solana DeFi',
+    'trading-solana': 'Solana DeFi',
+    'copy-trading-solana': 'Solana DeFi',
+    'solend': 'Solana DeFi',
+    // Portfolio & Risk
+    'portfolio': 'Portfolio & Risk',
+    'portfolio-sync': 'Portfolio & Risk',
+    'positions': 'Portfolio & Risk',
+    'bags': 'Portfolio & Risk',
+    'risk': 'Portfolio & Risk',
+    'sizing': 'Portfolio & Risk',
+    'ledger': 'Portfolio & Risk',
+    'history': 'Portfolio & Risk',
+    'divergence': 'Portfolio & Risk',
+    'edge': 'Portfolio & Risk',
+    'dca': 'Portfolio & Risk',
+    // Data & Feeds
+    'feeds': 'Data & Feeds',
+    'markets': 'Data & Feeds',
+    'market-index': 'Data & Feeds',
+    'news': 'Data & Feeds',
+    'ticks': 'Data & Feeds',
+    'signals': 'Data & Feeds',
+    'whale-tracking': 'Data & Feeds',
+    'analytics': 'Data & Feeds',
+    'metrics': 'Data & Feeds',
+    'weather': 'Data & Feeds',
+    // AI & Strategy
+    'ai-strategy': 'AI & Strategy',
+    'strategy': 'AI & Strategy',
+    'arbitrage': 'AI & Strategy',
+    'copy-trading': 'AI & Strategy',
+    'crypto-hft': 'AI & Strategy',
+    'execution': 'AI & Strategy',
+    'backtest': 'AI & Strategy',
+    'pairing': 'AI & Strategy',
+    'mm': 'AI & Strategy',
+    'opportunity': 'AI & Strategy',
+    'research': 'AI & Strategy',
+    'embeddings': 'AI & Strategy',
+    'features': 'AI & Strategy',
+    'trading-system': 'AI & Strategy',
+    'percolator': 'AI & Strategy',
+    // Infrastructure
+    'credentials': 'Infrastructure',
+    'automation': 'Infrastructure',
+    'monitoring': 'Infrastructure',
+    'alerts': 'Infrastructure',
+    'triggers': 'Infrastructure',
+    'webhooks': 'Infrastructure',
+    'streaming': 'Infrastructure',
+    'sessions': 'Infrastructure',
+    'remote': 'Infrastructure',
+    'mcp': 'Infrastructure',
+    'plugins': 'Infrastructure',
+    'processes': 'Infrastructure',
+    'routing': 'Infrastructure',
+    'tailscale': 'Infrastructure',
+    'search-config': 'Infrastructure',
+    'setup': 'Infrastructure',
+    // Social & Identity
+    'farcaster': 'Social & Identity',
+    'identity': 'Social & Identity',
+    'presence': 'Social & Identity',
+    'botchan': 'Social & Identity',
+    'auto-reply': 'Social & Identity',
+    'tweet-ideas': 'Social & Identity',
+    'voice': 'Social & Identity',
+    'tts': 'Social & Identity',
+    // Utilities
+    'doctor': 'Utilities',
+    'usage': 'Utilities',
+    'verify': 'Utilities',
+    'sandbox': 'Utilities',
+    'permissions': 'Utilities',
+    'integrations': 'Utilities',
+    'memory': 'Utilities',
+    'qmd': 'Utilities',
+    'qrcoin': 'Utilities',
+    'bankr': 'Utilities',
+    'yoink': 'Utilities',
+    'acp': 'Utilities',
+    'harden': 'Utilities',
+    // Security
+    'token-security': 'Security',
+    'shield': 'Security',
+};
+// =============================================================================
+// COMMAND ALIASES — alternative names that map to real commands
+// =============================================================================
+const COMMAND_ALIASES = {
+    '/pancakeswap': '/cake',
+    '/pancake': '/cake',
+    '/hyperliquid': '/hl',
+    '/hyper': '/hl',
+    '/polymarket': '/poly',
+    '/prediction': '/poly',
+    '/uniswap': '/swap',
+    '/sushiswap': '/swap',
+    '/balance': '/bags',
+    '/wallet': '/bags',
+    '/pnl': '/positions',
+    '/trades': '/history',
+    '/arb': '/arbitrage',
+    '/hft': '/crypto-hft',
+    '/bt': '/backtest',
+    '/creds': '/credentials',
+    '/keys': '/credentials',
+    '/mon': '/monitoring',
+    '/pricecheck': '/feeds',
+    '/sol': '/trading-solana',
+    '/solana': '/trading-solana',
+    '/evm': '/trading-evm',
+    '/kalshi': '/trading-kalshi',
+    '/manifold': '/trading-manifold',
+    '/security': '/token-security',
+    '/audit': '/token-security',
+    '/config': '/setup',
+    '/onboard': '/setup',
+    '/start': '/setup',
+    '/mrg': '/marginfi',
+};
+// =============================================================================
+// ENV VAR DOCUMENTATION — describes what each var is for
+// =============================================================================
+const ENV_VAR_DOCS = {
+    EVM_PRIVATE_KEY: {
+        description: 'Private key for EVM chains (ETH, BSC, ARB, Base)',
+        example: 'export EVM_PRIVATE_KEY="0xabcdef..."',
+    },
+    SOLANA_PRIVATE_KEY: {
+        description: 'Base58 private key for Solana transactions',
+        example: 'export SOLANA_PRIVATE_KEY="5abc..."',
+    },
+    SOLANA_KEYPAIR_PATH: {
+        description: 'Path to Solana keypair JSON file (alternative to SOLANA_PRIVATE_KEY)',
+        example: 'export SOLANA_KEYPAIR_PATH="~/.config/solana/id.json"',
+    },
+    HYPERLIQUID_PRIVATE_KEY: {
+        description: 'Private key for Hyperliquid L1',
+        example: 'export HYPERLIQUID_PRIVATE_KEY="0xabcdef..."',
+    },
+    HYPERLIQUID_WALLET: {
+        description: 'Wallet address on Hyperliquid (for vault/sub-account trading)',
+        example: 'export HYPERLIQUID_WALLET="0x1234..."',
+    },
+    LIGHTER_API_KEY: {
+        description: 'API key for Lighter DEX (optional, increases rate limits)',
+        example: 'export LIGHTER_API_KEY="your-api-key"',
+        url: 'https://lighter.xyz',
+    },
+    POLY_API_KEY: {
+        description: 'Polymarket CLOB API key',
+        example: 'export POLY_API_KEY="your-key"',
+        url: 'https://docs.polymarket.com',
+    },
+    POLY_API_SECRET: {
+        description: 'Polymarket CLOB API secret',
+        example: 'export POLY_API_SECRET="your-secret"',
+    },
+    POLY_API_PASSPHRASE: {
+        description: 'Polymarket CLOB API passphrase',
+        example: 'export POLY_API_PASSPHRASE="your-passphrase"',
+    },
+    OPENAI_API_KEY: {
+        description: 'OpenAI API key for embeddings and AI features',
+        example: 'export OPENAI_API_KEY="sk-..."',
+        url: 'https://platform.openai.com/api-keys',
+    },
+    BETFAIR_APP_KEY: {
+        description: 'Betfair application key',
+        example: 'export BETFAIR_APP_KEY="your-app-key"',
+        url: 'https://developer.betfair.com',
+    },
+    BETFAIR_SESSION_TOKEN: {
+        description: 'Betfair session token for authenticated requests',
+        example: 'export BETFAIR_SESSION_TOKEN="your-token"',
+    },
+    BINANCE_API_KEY: {
+        description: 'Binance API key for futures trading',
+        example: 'export BINANCE_API_KEY="your-key"',
+        url: 'https://www.binance.com/en/my/settings/api-management',
+    },
+    BINANCE_API_SECRET: {
+        description: 'Binance API secret',
+        example: 'export BINANCE_API_SECRET="your-secret"',
+    },
+    BYBIT_API_KEY: {
+        description: 'Bybit API key for derivatives trading',
+        example: 'export BYBIT_API_KEY="your-key"',
+        url: 'https://www.bybit.com/app/user/api-management',
+    },
+    BYBIT_API_SECRET: {
+        description: 'Bybit API secret',
+        example: 'export BYBIT_API_SECRET="your-secret"',
+    },
+    MEXC_API_KEY: {
+        description: 'MEXC API key for futures trading',
+        example: 'export MEXC_API_KEY="your-key"',
+        url: 'https://www.mexc.com/user/openapi',
+    },
+    MEXC_API_SECRET: {
+        description: 'MEXC API secret',
+        example: 'export MEXC_API_SECRET="your-secret"',
+    },
+    DRY_RUN: {
+        description: 'When "true", simulates trades without executing',
+        example: 'export DRY_RUN="true"',
+    },
+    CLODDS_CREDENTIAL_KEY: {
+        description: 'Encryption key for credential storage (AES-256-GCM)',
+        example: 'export CLODDS_CREDENTIAL_KEY="your-32-char-key"',
+    },
+};
+// =============================================================================
+// SKILL RELATIONS — maps skills to related skills for "See Also"
+// =============================================================================
+const SKILL_RELATIONS = {
+    'pancakeswap': ['trading-evm', 'bridge', 'bags', 'slippage'],
+    'lighter': ['hyperliquid', 'drift', 'trading-futures', 'positions'],
+    'hyperliquid': ['lighter', 'drift', 'binance-futures', 'positions', 'copy-trading'],
+    'drift': ['hyperliquid', 'lighter', 'trading-solana', 'positions'],
+    'trading-polymarket': ['betfair', 'trading-kalshi', 'predictfun', 'feeds', 'arbitrage'],
+    'betfair': ['trading-polymarket', 'smarkets', 'trading-kalshi', 'arbitrage'],
+    'trading-kalshi': ['trading-polymarket', 'betfair', 'predictit'],
+    'jupiter': ['raydium', 'orca', 'trading-solana', 'bags', 'kamino', 'marginfi', 'solend'],
+    'marginfi': ['kamino', 'solend', 'jupiter', 'bags'],
+    'raydium': ['jupiter', 'orca', 'meteora', 'pumpfun'],
+    'portfolio': ['positions', 'bags', 'history', 'risk'],
+    'positions': ['portfolio', 'bags', 'risk', 'history'],
+    'bags': ['portfolio', 'positions', 'trading-solana', 'trading-evm'],
+    'arbitrage': ['trading-polymarket', 'betfair', 'feeds', 'signals'],
+    'bridge': ['trading-evm', 'pancakeswap', 'bags'],
+    'credentials': ['setup', 'doctor'],
+    'doctor': ['setup', 'credentials', 'monitoring'],
+    'copy-trading': ['hyperliquid', 'crypto-hft', 'execution'],
+    'binance-futures': ['bybit-futures', 'mexc-futures', 'hyperliquid', 'trading-futures'],
+    'bybit-futures': ['binance-futures', 'mexc-futures', 'hyperliquid'],
+    'mexc-futures': ['binance-futures', 'bybit-futures', 'hyperliquid'],
+    'feeds': ['markets', 'signals', 'news', 'ticks'],
+    'signals': ['feeds', 'strategy', 'alerts', 'triggers'],
+    'risk': ['sizing', 'portfolio', 'positions'],
+    'setup': ['credentials', 'doctor'],
+    'token-security': ['shield', 'verify'],
+    'shield': ['token-security', 'harden'],
+    'solend': ['kamino', 'marginfi', 'jupiter', 'bags'],
+    'kamino': ['marginfi', 'solend', 'jupiter', 'bags'],
+};
 /** Normalize skill handler to consistent interface */
 function normalizeSkill(skill) {
     // Normalize commands array (some skills have {name,description,usage} format)
@@ -207,7 +504,28 @@ function normalizeSkill(skill) {
         wrappedHandle = async (args) => {
             const missing = requiredEnv.filter((v) => !process.env[v]);
             if (missing.length > 0) {
-                return `⚠ ${skill.name} requires environment variables to be set:\n\n${missing.map((v) => `  • ${v}`).join('\n')}\n\nSet them in your environment or .env file to use this skill.`;
+                const lines = [`**${skill.name}** requires configuration:\n`];
+                for (const v of missing) {
+                    const doc = ENV_VAR_DOCS[v];
+                    if (doc) {
+                        lines.push(`  ${v} — ${doc.description}`);
+                        lines.push(`    ${doc.example}`);
+                        if (doc.url)
+                            lines.push(`    Docs: ${doc.url}`);
+                    }
+                    else {
+                        lines.push(`  ${v}`);
+                    }
+                }
+                lines.push('\nSet these in your environment or .env file.');
+                // Suggest /setup if available
+                const related = SKILL_RELATIONS[skill.name];
+                if (related) {
+                    const suggestions = related.slice(0, 3).map(r => `/${r}`);
+                    lines.push(`\nSee also: ${suggestions.join(', ')}`);
+                }
+                lines.push('Run /setup to configure all skills interactively.');
+                return lines.join('\n');
             }
             return boundHandle(args);
         };
@@ -297,53 +615,201 @@ async function initializeSkills() {
     return initializing;
 }
 /**
- * Register the built-in /skills command that shows skill status
+ * Register the built-in /skills command with categories, search, and status
  */
 function registerBuiltinSkillsCommand() {
     const skillsHandler = {
         name: 'skills-status',
-        description: 'Show status of all loaded skills',
+        description: 'Browse, search, and check status of all skills',
         commands: ['/skills'],
-        handle: async (_args) => {
-            const lines = ['# Skill Status\n'];
-            // Ready skills
-            const ready = [];
-            const needsConfig = [];
-            for (const skill of registeredSkills) {
-                if (skill.name === 'skills-status')
-                    continue;
-                const reqs = skillRequirements.get(skill.name);
-                if (reqs && reqs.length > 0) {
-                    const missing = reqs.filter((v) => !process.env[v]);
-                    if (missing.length > 0) {
-                        needsConfig.push(`  ⚙ ${skill.name} — needs: ${missing.join(', ')}`);
-                        continue;
-                    }
-                }
-                ready.push(`  ✓ ${skill.name}`);
-            }
-            lines.push(`## Ready (${ready.length})`);
-            if (ready.length > 0) {
-                lines.push(ready.join('\n'));
+        handle: async (args) => {
+            const parts = args.trim().split(/\s+/);
+            const subCmd = parts[0]?.toLowerCase();
+            // /skills search <query>
+            if (subCmd === 'search' || subCmd === 'find' || subCmd === 'grep') {
+                const query = parts.slice(1).join(' ').toLowerCase();
+                if (!query)
+                    return 'Usage: /skills search <query>\nExample: /skills search swap';
+                return handleSkillSearch(query);
             }
-            if (needsConfig.length > 0) {
-                lines.push(`\n## Needs Configuration (${needsConfig.length})`);
-                lines.push(needsConfig.join('\n'));
+            // /skills <category>
+            if (subCmd && subCmd !== 'status' && subCmd !== 'all' && subCmd !== '') {
+                const categories = Object.values(SKILL_CATEGORIES);
+                const matchedCat = categories.find(c => c.toLowerCase().includes(subCmd) || c.toLowerCase().replace(/[&\s]/g, '').includes(subCmd));
+                if (matchedCat)
+                    return handleSkillCategory(matchedCat);
+                // Maybe they typed a skill name
+                const matchedSkill = registeredSkills.find(s => s.name.includes(subCmd) || s.commands.some(c => c.includes(subCmd)));
+                if (matchedSkill)
+                    return handleSkillInfo(matchedSkill);
+                // Fuzzy search fallback
+                return handleSkillSearch(subCmd);
             }
-            if (failedSkills.length > 0) {
-                lines.push(`\n## Failed to Load (${failedSkills.length})`);
-                for (const f of failedSkills) {
-                    // Truncate long error messages
-                    const shortErr = f.error.length > 80 ? f.error.slice(0, 77) + '...' : f.error;
-                    lines.push(`  ✗ ${f.name} — ${shortErr}`);
-                }
-            }
-            lines.push(`\n**Total:** ${registeredSkills.length - 1} loaded, ${failedSkills.length} failed, ${SKILL_MANIFEST.length} in manifest`);
-            return lines.join('\n');
+            // /skills (default) — categorized overview
+            return handleSkillOverview();
         },
     };
     registerSkill(skillsHandler);
 }
+function handleSkillOverview() {
+    const lines = ['**Skills Directory**\n'];
+    // Group by category
+    const grouped = new Map();
+    for (const skill of registeredSkills) {
+        if (skill.name === 'skills-status')
+            continue;
+        const cat = SKILL_CATEGORIES[skill.name] || 'Utilities';
+        if (!grouped.has(cat)) {
+            grouped.set(cat, []);
+        }
+        const reqs = skillRequirements.get(skill.name);
+        const ready = !reqs || reqs.length === 0 || reqs.every((v) => !!process.env[v]);
+        grouped.get(cat).push({
+            name: skill.name,
+            cmds: skill.commands,
+            ready,
+        });
+    }
+    // Category display order
+    const categoryOrder = [
+        'Futures & Perps', 'DeFi & DEX', 'Solana DeFi', 'Prediction Markets',
+        'AI & Strategy', 'Portfolio & Risk', 'Data & Feeds', 'Security',
+        'Infrastructure', 'Social & Identity', 'Utilities',
+    ];
+    for (const cat of categoryOrder) {
+        const skills = grouped.get(cat);
+        if (!skills || skills.length === 0)
+            continue;
+        const readyCount = skills.filter(s => s.ready).length;
+        lines.push(`**${cat}** (${readyCount}/${skills.length} ready)`);
+        for (const s of skills) {
+            const status = s.ready ? '+' : '-';
+            const cmds = s.cmds.map(c => `/${c}`).join(', ');
+            lines.push(`  ${status} ${s.name} (${cmds})`);
+        }
+        lines.push('');
+    }
+    // Failed skills
+    if (failedSkills.length > 0) {
+        lines.push(`**Failed to Load** (${failedSkills.length})`);
+        for (const f of failedSkills) {
+            const shortErr = f.error.length > 60 ? f.error.slice(0, 57) + '...' : f.error;
+            lines.push(`  x ${f.name} — ${shortErr}`);
+        }
+        lines.push('');
+    }
+    const total = registeredSkills.length - 1;
+    lines.push(`**Total:** ${total} loaded, ${failedSkills.length} failed`);
+    lines.push('');
+    lines.push('**Commands:**');
+    lines.push('  /skills <category>        — Browse a category (e.g., /skills defi)');
+    lines.push('  /skills search <query>    — Search skills by name or keyword');
+    lines.push('  /skills <name>            — Info about a specific skill');
+    lines.push('  /setup                    — Configure environment for skills');
+    return lines.join('\n');
+}
+function handleSkillSearch(query) {
+    const results = [];
+    for (const skill of registeredSkills) {
+        if (skill.name === 'skills-status')
+            continue;
+        const searchable = `${skill.name} ${skill.description} ${skill.commands.join(' ')}`.toLowerCase();
+        const cat = SKILL_CATEGORIES[skill.name] || 'Utilities';
+        if (searchable.includes(query)) {
+            results.push({
+                name: skill.name,
+                cmds: skill.commands,
+                desc: skill.description,
+                cat,
+            });
+        }
+    }
+    if (results.length === 0) {
+        return `No skills found matching "${query}". Try /skills to browse all categories.`;
+    }
+    const lines = [`**Search results for "${query}"** (${results.length} found)\n`];
+    for (const r of results) {
+        const cmds = r.cmds.map(c => `/${c}`).join(', ');
+        lines.push(`  ${r.name} (${cmds}) — ${r.desc}`);
+        lines.push(`    Category: ${r.cat}`);
+    }
+    return lines.join('\n');
+}
+function handleSkillCategory(category) {
+    const skills = [];
+    for (const skill of registeredSkills) {
+        if (skill.name === 'skills-status')
+            continue;
+        const cat = SKILL_CATEGORIES[skill.name];
+        if (cat !== category)
+            continue;
+        const reqs = skillRequirements.get(skill.name);
+        const ready = !reqs || reqs.length === 0 || reqs.every((v) => !!process.env[v]);
+        skills.push({ name: skill.name, cmds: skill.commands, desc: skill.description, ready });
+    }
+    if (skills.length === 0) {
+        return `No skills in category "${category}".`;
+    }
+    const lines = [`**${category}** (${skills.length} skills)\n`];
+    for (const s of skills) {
+        const status = s.ready ? '+' : '-';
+        const cmds = s.cmds.map(c => `/${c}`).join(', ');
+        lines.push(`  ${status} **${s.name}** (${cmds})`);
+        lines.push(`    ${s.desc}`);
+        const reqs = skillRequirements.get(s.name);
+        if (reqs && reqs.length > 0) {
+            const missing = reqs.filter(v => !process.env[v]);
+            if (missing.length > 0) {
+                lines.push(`    Needs: ${missing.join(', ')}`);
+            }
+        }
+        const related = SKILL_RELATIONS[s.name];
+        if (related) {
+            lines.push(`    See also: ${related.slice(0, 3).map(r => `/${r}`).join(', ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+function handleSkillInfo(skill) {
+    const lines = [`**${skill.name}**`];
+    lines.push(skill.description);
+    lines.push('');
+    const cat = SKILL_CATEGORIES[skill.name] || 'Utilities';
+    lines.push(`Category: ${cat}`);
+    lines.push(`Commands: ${skill.commands.map(c => `/${c}`).join(', ')}`);
+    const reqs = skillRequirements.get(skill.name);
+    if (reqs && reqs.length > 0) {
+        const missing = reqs.filter(v => !process.env[v]);
+        lines.push('');
+        lines.push('**Environment Variables:**');
+        for (const v of reqs) {
+            const doc = ENV_VAR_DOCS[v];
+            const status = process.env[v] ? 'set' : 'MISSING';
+            if (doc) {
+                lines.push(`  ${status === 'set' ? '+' : '-'} ${v} (${status}) — ${doc.description}`);
+                if (status !== 'set')
+                    lines.push(`    ${doc.example}`);
+            }
+            else {
+                lines.push(`  ${status === 'set' ? '+' : '-'} ${v} (${status})`);
+            }
+        }
+    }
+    const related = SKILL_RELATIONS[skill.name];
+    if (related && related.length > 0) {
+        lines.push('');
+        lines.push('**Related Skills:**');
+        for (const r of related) {
+            const relSkill = registeredSkills.find(s => s.name === r);
+            if (relSkill) {
+                lines.push(`  /${relSkill.commands[0] || r} — ${relSkill.description}`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push(`Run /${skill.commands[0] || skill.name} help for full command list.`);
+    return lines.join('\n');
+}
 /** Map of /command → dispatch target for skills with command-dispatch: tool */
 const dispatchMap = new Map();
 /**
@@ -384,8 +850,12 @@ async function executeSkillCommand(message) {
     }
     // Parse command and arguments
     const spaceIndex = trimmed.indexOf(' ');
-    const command = spaceIndex === -1 ? trimmed.toLowerCase() : trimmed.slice(0, spaceIndex).toLowerCase();
+    let command = spaceIndex === -1 ? trimmed.toLowerCase() : trimmed.slice(0, spaceIndex).toLowerCase();
     const args = spaceIndex === -1 ? '' : trimmed.slice(spaceIndex + 1);
+    // Resolve aliases (e.g., /pancakeswap → /cake, /start → /setup)
+    if (COMMAND_ALIASES[command]) {
+        command = COMMAND_ALIASES[command];
+    }
     // Check dispatch map first (command-dispatch: tool skills bypass LLM)
     const dispatch = dispatchMap.get(command);
     if (dispatch) {
@@ -434,14 +904,18 @@ function getRegisteredSkills() {
  * Get skill handler by command
  */
 function getSkillByCommand(command) {
-    const normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    let normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    if (COMMAND_ALIASES[normalized])
+        normalized = COMMAND_ALIASES[normalized];
     return commandToSkill.get(normalized);
 }
 /**
  * Check if a command is handled by a skill (handler or dispatch)
  */
 function isSkillCommand(command) {
-    const normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    let normalized = command.toLowerCase().startsWith('/') ? command.toLowerCase() : `/${command.toLowerCase()}`;
+    if (COMMAND_ALIASES[normalized])
+        normalized = COMMAND_ALIASES[normalized];
     return commandToSkill.has(normalized) || dispatchMap.has(normalized);
 }
 /**