@vinaes/succ 1.3.19

package/dist/lib/similarity-worker.js

@@ -0,0 +1,36 @@
+/**
+ * Worker thread for parallel cosine similarity calculations
+ *
+ * Used by consolidation and auto-linking to speed up O(n²) comparisons
+ */
+import { parentPort, workerData } from 'worker_threads';
+/**
+ * Cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+    return magnitude === 0 ? 0 : dotProduct / magnitude;
+}
+// Main worker logic
+if (parentPort) {
+    const { pairs, embeddings, threshold } = workerData;
+    const results = [];
+    for (const [i, j] of pairs) {
+        const similarity = cosineSimilarity(embeddings[i], embeddings[j]);
+        if (similarity >= threshold) {
+            results.push({ i, j, similarity });
+        }
+    }
+    parentPort.postMessage(results);
+}
+//# sourceMappingURL=similarity-worker.js.map

package/dist/lib/similarity-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity-worker.js","sourceRoot":"","sources":["../../src/lib/similarity-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAcxD;;GAEG;AACH,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAEpC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;AACtD,CAAC;AAED,oBAAoB;AACpB,IAAI,UAAU,EAAE,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,UAAwB,CAAC;IAElE,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/lib/skills.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Skills Discovery and Suggestion
+ *
+ * Provides LLM-powered skill suggestions based on user prompts.
+ * Supports three LLM backends: Claude CLI, Local LLM, OpenRouter.
+ *
+ * Flow:
+ * 1. Fast heuristics (length, cooldown)
+ * 2. LLM keyword extraction (multilingual)
+ * 3. BM25 search for skill candidates
+ * 4. LLM ranking with reasoning
+ */
+import { type LLMBackend } from './llm.js';
+export type { LLMBackend } from './llm.js';
+export interface Skill {
+    id?: number;
+    name: string;
+    description: string;
+    source: 'local' | 'skyll';
+    path?: string;
+    content?: string;
+    skyll_id?: string;
+    usage_count?: number;
+    last_used?: string;
+}
+export interface SkillSuggestion extends Skill {
+    reason: string;
+    confidence: number;
+}
+import type { SkillsConfig } from './config.js';
+export type { SkillsConfig } from './config.js';
+interface LLMConfig {
+    backend: LLMBackend;
+    model: string;
+    endpoint?: string;
+    apiKey?: string;
+}
+export declare function invalidateSkillsIndex(): void;
+/**
+ * Extract technical keywords from user prompt using LLM
+ */
+export declare function extractKeywords(prompt: string, config: LLMConfig): Promise<string[]>;
+/**
+ * Search for skill candidates using BM25
+ * Returns skills and top BM25 score for fast-path optimization
+ */
+export declare function searchSkillCandidates(keywords: string[], limit?: number): Promise<{
+    skills: Skill[];
+    topScore: number;
+}>;
+/**
+ * Rank skill candidates using LLM
+ */
+export declare function rankSkillsWithLLM(userPrompt: string, candidates: Skill[], config: LLMConfig, options?: {
+    limit?: number;
+    minConfidence?: number;
+}): Promise<SkillSuggestion[]>;
+/**
+ * Main suggestion function with fallback chain
+ */
+export declare function suggestSkills(userPrompt: string, config?: Partial<SkillsConfig>): Promise<SkillSuggestion[]>;
+/**
+ * Scan local skills from .claude/commands/ directory
+ */
+export declare function scanLocalSkills(projectDir: string): Skill[];
+/**
+ * Index local skills into database
+ */
+export declare function indexLocalSkills(projectDir: string): Promise<number>;
+/**
+ * Track skill usage
+ */
+export declare function trackSkillUsage(skillName: string): Promise<void>;
+/**
+ * Get skills config from main config
+ */
+export declare function getSkillsConfig(): SkillsConfig;
+//# sourceMappingURL=skills.d.ts.map

package/dist/lib/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAUnF,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,SAAS;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiGD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA+BD;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B1F;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAwChD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,EAAE,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,OAAO,CAAC,eAAe,EAAE,CAAC,CA+E5B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,eAAe,EAAE,CAAC,CA+G5B;AA2BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE,CAgD3D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAU9C"}

package/dist/lib/skills.js

@@ -0,0 +1,439 @@
+/**
+ * Skills Discovery and Suggestion
+ *
+ * Provides LLM-powered skill suggestions based on user prompts.
+ * Supports three LLM backends: Claude CLI, Local LLM, OpenRouter.
+ *
+ * Flow:
+ * 1. Fast heuristics (length, cooldown)
+ * 2. LLM keyword extraction (multilingual)
+ * 3. BM25 search for skill candidates
+ * 4. LLM ranking with reasoning
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logError, logWarn, logInfo } from './fault-logger.js';
+import { getAllSkills as getAllSkillsDb, upsertSkill, trackSkillUsageDb } from './storage/index.js';
+import { getConfig } from './config.js';
+import * as bm25 from './bm25.js';
+import { searchSkyll } from './skyll-client.js';
+import { callLLM as sharedCallLLM, getLLMConfig } from './llm.js';
+import { KEYWORD_EXTRACTION_PROMPT as KEYWORD_PROMPT, SKILL_RANKING_PROMPT as RANKING_PROMPT, } from '../prompts/index.js';
+// ============================================================================
+// Default Config
+// ============================================================================
+// Auto-suggest settings (LLM config comes from unified llm.* config)
+const DEFAULT_AUTO_SUGGEST = {
+    enabled: false, // Disabled by default - enable in config if needed
+    on_user_prompt: true,
+    min_confidence: 0.7,
+    max_suggestions: 2,
+    cooldown_prompts: 3,
+    min_prompt_length: 20,
+};
+const DEFAULT_SKILLS_CONFIG = {
+    enabled: false, // Disabled by default - enable in config if needed
+    local_paths: ['.claude/commands'],
+    auto_suggest: DEFAULT_AUTO_SUGGEST,
+    track_usage: true,
+};
+const suggestionCache = new Map();
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+function hashPrompt(prompt) {
+    // Simple hash for cache key (first 100 chars lowercase)
+    return prompt.toLowerCase().trim().slice(0, 100);
+}
+function getCachedSuggestions(prompt) {
+    const key = hashPrompt(prompt);
+    const cached = suggestionCache.get(key);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+        return cached.suggestions;
+    }
+    // Cleanup expired entries
+    if (cached) {
+        suggestionCache.delete(key);
+    }
+    return null;
+}
+function cacheSuggestions(prompt, suggestions) {
+    const key = hashPrompt(prompt);
+    suggestionCache.set(key, {
+        suggestions,
+        timestamp: Date.now(),
+    });
+    // Limit cache size to 50 entries (LRU-like cleanup)
+    if (suggestionCache.size > 50) {
+        const oldestKey = suggestionCache.keys().next().value;
+        if (oldestKey) {
+            suggestionCache.delete(oldestKey);
+        }
+    }
+}
+// ============================================================================
+// BM25 Index
+// ============================================================================
+let skillsBm25Index = null;
+const BM25_FAST_PATH_THRESHOLD = 0.8; // Skip LLM ranking if top BM25 score > 0.8
+async function getSkillsBm25Index() {
+    if (skillsBm25Index) {
+        return skillsBm25Index;
+    }
+    // Use dispatcher to get all skills (routes to PG or SQLite)
+    const rows = await getAllSkillsDb();
+    // Build searchable content from name + description + content
+    const docs = rows.map((r) => ({
+        id: r.id,
+        content: `${r.name} ${r.description} ${r.content || ''}`,
+    }));
+    skillsBm25Index = bm25.buildIndex(docs, 'docs');
+    return skillsBm25Index;
+}
+export function invalidateSkillsIndex() {
+    skillsBm25Index = null;
+}
+// ============================================================================
+// LLM Integration (uses shared llm.ts module)
+// ============================================================================
+/**
+ * Call LLM with skills-specific config
+ * Wraps the shared LLM module with local config mapping
+ */
+async function callLLM(prompt, config, timeout = 15000) {
+    return sharedCallLLM(prompt, { timeout, maxTokens: 500 }, {
+        backend: config.backend,
+        model: config.model,
+        endpoint: config.endpoint,
+        apiKey: config.apiKey,
+    });
+}
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Extract technical keywords from user prompt using LLM
+ */
+export async function extractKeywords(prompt, config) {
+    const llmPrompt = KEYWORD_PROMPT.replace('{prompt}', prompt.slice(0, 500));
+    try {
+        logInfo('skills', `Calling LLM for keyword extraction (backend=${config.backend})`);
+        const result = await callLLM(llmPrompt, config, 30000); // 30s timeout for slow models
+        logInfo('skills', `LLM result: ${result.slice(0, 200)}`);
+        // Parse JSON response
+        const jsonMatch = result.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            return [];
+        }
+        const parsed = JSON.parse(jsonMatch[0]);
+        const keywords = Array.isArray(parsed.keywords) ? parsed.keywords.slice(0, 5) : [];
+        logInfo('skills', `Extracted keywords: ${JSON.stringify(keywords)}`);
+        return keywords;
+    }
+    catch (err) {
+        logError('skills', 'Failed to extract keywords', err instanceof Error ? err : new Error(String(err)));
+        return [];
+    }
+}
+/**
+ * Search for skill candidates using BM25
+ * Returns skills and top BM25 score for fast-path optimization
+ */
+export async function searchSkillCandidates(keywords, limit = 15) {
+    if (keywords.length === 0) {
+        return { skills: [], topScore: 0 };
+    }
+    const index = await getSkillsBm25Index();
+    // Search with combined keywords
+    const query = keywords.join(' ');
+    const results = bm25.search(query, index, 'docs', limit);
+    if (results.length === 0) {
+        return { skills: [], topScore: 0 };
+    }
+    // Get all skills from dispatcher and filter by matched IDs
+    const allSkills = await getAllSkillsDb();
+    const matchedIds = new Set(results.map((r) => r.docId));
+    const rows = allSkills
+        .filter((s) => matchedIds.has(s.id))
+        .map((s) => ({
+        id: s.id,
+        name: s.name,
+        description: s.description,
+        source: s.source,
+        path: s.path,
+        usage_count: s.usageCount,
+        last_used: s.lastUsed,
+    }));
+    // Sort by BM25 score order
+    const idToScore = new Map(results.map((r) => [r.docId, r.score]));
+    const sortedSkills = rows.sort((a, b) => (idToScore.get(b.id) || 0) - (idToScore.get(a.id) || 0));
+    return {
+        skills: sortedSkills,
+        topScore: results[0]?.score || 0,
+    };
+}
+/**
+ * Rank skill candidates using LLM
+ */
+export async function rankSkillsWithLLM(userPrompt, candidates, config, options = {}) {
+    const { limit = 2, minConfidence = 0.7 } = options;
+    if (candidates.length === 0) {
+        return [];
+    }
+    // Format skills list with usage indicator
+    const skillsList = candidates
+        .map((s, i) => {
+        const usedMarker = s.usage_count && s.usage_count > 0 ? ' *' : '';
+        return `${i + 1}. ${s.name}${usedMarker}: ${s.description}`;
+    })
+        .join('\n');
+    const llmPrompt = RANKING_PROMPT.replace('{user_prompt}', userPrompt.slice(0, 500)).replace('{skills_list}', skillsList);
+    // Use lightweight models for ranking (simple task)
+    const rankingConfig = { ...config };
+    if (config.backend === 'api') {
+        // Prefer smaller, faster model for ranking if using local Ollama
+        rankingConfig.model = config.model?.includes('qwen') ? 'qwen2.5:0.5b' : config.model;
+    }
+    try {
+        logInfo('skills', `Ranking ${candidates.length} candidates with LLM (model=${rankingConfig.model})`);
+        const result = await callLLM(llmPrompt, rankingConfig, 30000);
+        logInfo('skills', `Ranking result: ${result.slice(0, 300)}`);
+        // Parse JSON response
+        const jsonMatch = result.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            logInfo('skills', `No JSON found in ranking result`);
+            return [];
+        }
+        const parsed = JSON.parse(jsonMatch[0]);
+        logInfo('skills', `Parsed suggestions: ${JSON.stringify(parsed.suggestions)}`);
+        if (!Array.isArray(parsed.suggestions)) {
+            return [];
+        }
+        // Map suggestions to full skill data
+        const mapped = parsed.suggestions
+            .filter((s) => s.confidence >= minConfidence)
+            .slice(0, limit)
+            .map((s) => {
+            const skill = candidates.find((c) => c.name === s.name);
+            if (!skill) {
+                logInfo('skills', `Skill not found: ${s.name}`);
+                return null;
+            }
+            return {
+                ...skill,
+                reason: s.reason,
+                confidence: s.confidence,
+            };
+        })
+            .filter((s) => s !== null);
+        logInfo('skills', `Final suggestions: ${mapped.length}`);
+        return mapped;
+    }
+    catch (err) {
+        logError('skills', 'Failed to suggest skills', err instanceof Error ? err : new Error(String(err)));
+        return [];
+    }
+}
+/**
+ * Main suggestion function with fallback chain
+ */
+export async function suggestSkills(userPrompt, config) {
+    const autoSuggest = { ...DEFAULT_AUTO_SUGGEST, ...config?.auto_suggest };
+    // Check cache first
+    const cached = getCachedSuggestions(userPrompt);
+    if (cached) {
+        logInfo('skills', 'Returning cached suggestions');
+        return cached;
+    }
+    // Get unified LLM config for skills
+    const llmConfig = getLLMConfig();
+    // Build LLM config from unified llm.* settings
+    const baseLlmConfig = {
+        backend: llmConfig.backend,
+        model: llmConfig.model,
+        endpoint: llmConfig.endpoint,
+        apiKey: llmConfig.apiKey,
+    };
+    // Fallback chain - api first, then claude
+    const backends = ['api', 'claude'];
+    const orderedBackends = [llmConfig.backend, ...backends.filter((b) => b !== llmConfig.backend)];
+    for (const backend of orderedBackends) {
+        try {
+            const backendConfig = { ...baseLlmConfig, backend };
+            // Step 1: Extract keywords
+            const keywords = await extractKeywords(userPrompt, backendConfig);
+            if (keywords.length === 0) {
+                return [];
+            }
+            // Step 2: Search candidates (local first, then Skyll if enabled)
+            logInfo('skills', `Searching candidates for keywords: ${JSON.stringify(keywords)}`);
+            const { skills: candidateSkills, topScore } = await searchSkillCandidates(keywords, 15);
+            logInfo('skills', `Found ${candidateSkills.length} local candidates (topScore: ${topScore.toFixed(2)})`);
+            // Skyll fallback: if no local candidates or onlyWhenNoLocal is false
+            const skyllConfig = config?.skyll || {};
+            const skyllEnabled = skyllConfig.enabled !== false;
+            const onlyWhenNoLocal = skyllConfig.only_when_no_local !== false;
+            let candidates = candidateSkills;
+            if (skyllEnabled && (candidates.length === 0 || !onlyWhenNoLocal)) {
+                try {
+                    const skyllResults = await searchSkyll(keywords, { limit: 10 });
+                    if (skyllResults.length > 0) {
+                        // Merge: local first, then Skyll (avoiding duplicates by name)
+                        const existingNames = new Set(candidates.map((c) => c.name.toLowerCase()));
+                        const newSkills = skyllResults.filter((s) => !existingNames.has(s.name.toLowerCase()));
+                        candidates = [...candidates, ...newSkills].slice(0, 15);
+                    }
+                }
+                catch (err) {
+                    logError('skills', 'Skyll search failed', err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            if (candidates.length === 0) {
+                return [];
+            }
+            // Fast path: if top BM25 score is very high, skip LLM ranking
+            if (topScore >= BM25_FAST_PATH_THRESHOLD) {
+                logInfo('skills', `Fast path: topScore ${topScore.toFixed(2)} >= ${BM25_FAST_PATH_THRESHOLD}, skipping LLM ranking`);
+                const fastPathResults = candidates
+                    .slice(0, autoSuggest.max_suggestions)
+                    .map((skill) => ({
+                    ...skill,
+                    reason: `High relevance match (score: ${topScore.toFixed(2)})`,
+                    confidence: Math.min(topScore, 0.95), // Cap at 0.95 since no LLM validation
+                }));
+                // Cache before returning
+                cacheSuggestions(userPrompt, fastPathResults);
+                return fastPathResults;
+            }
+            // Step 3: Rank with LLM
+            const ranked = await rankSkillsWithLLM(userPrompt, candidates, backendConfig, {
+                limit: autoSuggest.max_suggestions,
+                minConfidence: autoSuggest.min_confidence,
+            });
+            // Cache before returning
+            cacheSuggestions(userPrompt, ranked);
+            return ranked;
+        }
+        catch (err) {
+            logError('skills', 'Backend suggestion failed', err instanceof Error ? err : new Error(String(err)));
+            // Try next backend
+        }
+    }
+    return [];
+}
+// ============================================================================
+// Local Skills Scanning
+// ============================================================================
+/**
+ * Parse SKILL.md frontmatter
+ */
+function parseSkillFrontmatter(content) {
+    // Normalize line endings for cross-platform support
+    const normalized = content.replace(/\r\n/g, '\n');
+    const frontmatterMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        return {};
+    }
+    const frontmatter = frontmatterMatch[1];
+    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    return {
+        name: nameMatch?.[1]?.trim(),
+        description: descMatch?.[1]?.trim(),
+    };
+}
+/**
+ * Scan local skills from .claude/commands/ directory
+ */
+export function scanLocalSkills(projectDir) {
+    const config = getConfig();
+    const localPaths = config.skills?.local_paths || DEFAULT_SKILLS_CONFIG.local_paths;
+    const skills = [];
+    for (const localPath of localPaths) {
+        const skillsDir = path.join(projectDir, localPath);
+        if (!fs.existsSync(skillsDir)) {
+            continue;
+        }
+        const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                // Single file skill (name.md)
+                const filePath = path.join(skillsDir, entry.name);
+                const content = fs.readFileSync(filePath, 'utf8');
+                const { name, description } = parseSkillFrontmatter(content);
+                skills.push({
+                    name: name || entry.name.replace('.md', ''),
+                    description: description || `Skill from ${entry.name}`,
+                    source: 'local',
+                    path: filePath,
+                    content,
+                });
+            }
+            else if (entry.isDirectory()) {
+                // Directory skill (name/SKILL.md)
+                const skillMdPath = path.join(skillsDir, entry.name, 'SKILL.md');
+                if (fs.existsSync(skillMdPath)) {
+                    const content = fs.readFileSync(skillMdPath, 'utf8');
+                    const { name, description } = parseSkillFrontmatter(content);
+                    skills.push({
+                        name: name || entry.name,
+                        description: description || `Skill from ${entry.name}`,
+                        source: 'local',
+                        path: skillMdPath,
+                        content,
+                    });
+                }
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Index local skills into database
+ */
+export async function indexLocalSkills(projectDir) {
+    const skills = scanLocalSkills(projectDir);
+    let indexed = 0;
+    for (const skill of skills) {
+        try {
+            await upsertSkill({
+                name: skill.name,
+                description: skill.description,
+                source: 'local',
+                path: skill.path,
+                content: skill.content,
+            });
+            indexed++;
+        }
+        catch (err) {
+            logWarn('skills', err instanceof Error ? err.message : 'Failed to index skill');
+        }
+    }
+    // Invalidate BM25 index
+    invalidateSkillsIndex();
+    return indexed;
+}
+/**
+ * Track skill usage
+ */
+export async function trackSkillUsage(skillName) {
+    try {
+        await trackSkillUsageDb(skillName);
+    }
+    catch (err) {
+        logWarn('skills', err instanceof Error ? err.message : 'Failed to track skill usage');
+    }
+}
+/**
+ * Get skills config from main config
+ */
+export function getSkillsConfig() {
+    const config = getConfig();
+    return {
+        ...DEFAULT_SKILLS_CONFIG,
+        ...config.skills,
+        auto_suggest: {
+            ...DEFAULT_SKILLS_CONFIG.auto_suggest,
+            ...config.skills?.auto_suggest,
+        },
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

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

package/dist/lib/skyll-client.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Skyll API Client
+ *
+ * Integrates with Skyll (https://github.com/assafelovic/skyll) for external skill discovery.
+ * Uses aggressive caching to minimize API calls (rate limit: 60 req/hour without API key).
+ *
+ * Features:
+ * - Search skills by keywords
+ * - Get skill details
+ * - Local DB caching with TTL
+ * - Rate limiting
+ */
+import type { Skill } from './skills.js';
+export interface SkyllSkill {
+    id: string;
+    title: string;
+    description: string;
+    source?: string;
+    version?: string;
+    refs?: {
+        skills_sh?: string;
+        github?: string;
+        raw?: string;
+    };
+    content?: string;
+    install_count?: number;
+    relevance_score?: number;
+}
+export interface SkyllSearchResult {
+    query: string;
+    count: number;
+    skills: SkyllSkill[];
+}
+/**
+ * Search Skyll API for skills matching keywords
+ */
+export declare function searchSkyll(keywords: string[], options?: {
+    limit?: number;
+    skipCache?: boolean;
+}): Promise<Skill[]>;
+/**
+ * Get skill details from Skyll API
+ */
+export declare function getSkyllSkill(skillId: string): Promise<Skill | null>;
+/**
+ * Clear expired cache entries
+ */
+export declare function clearExpiredCache(): Promise<number>;
+/**
+ * Get Skyll API status
+ */
+export declare function getSkyllStatus(): Promise<{
+    enabled: boolean;
+    hasApiKey: boolean;
+    requestsThisHour: number;
+    rateLimit: number;
+    cachedSkills: number;
+}>;
+//# sourceMappingURL=skyll-client.d.ts.map

package/dist/lib/skyll-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skyll-client.d.ts","sourceRoot":"","sources":["../../src/lib/skyll-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMzC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAqHD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,OAAO,CAAC,KAAK,EAAE,CAAC,CA4ElB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAiE1E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAOzD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAkBD"}