@skillsmith/core 0.4.0 → 0.4.1

package/dist/src/services/SkillAnalyzer.js

@@ -0,0 +1,421 @@
+/**
+ * SMI-XXX: SkillAnalyzer - Analyze skills for optimization patterns
+ *
+ * Detects optimization opportunities based on:
+ * - Line count (>500 lines suggests decomposition)
+ * - Tool usage patterns (heavy tool usage suggests subagent)
+ * - Sequential Task() calls (can be parallelized)
+ * - Large examples sections (can use progressive disclosure)
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+/**
+ * Tool detection patterns for analyzing skill content
+ */
+const TOOL_PATTERNS = {
+    Read: {
+        patterns: ['read file', 'read the file', 'examine', 'view file', 'cat ', 'Read tool'],
+        weight: 1,
+    },
+    Write: {
+        patterns: [
+            'write file',
+            'create file',
+            'save to',
+            'output to file',
+            'Write tool',
+            'write the file',
+        ],
+        weight: 2,
+    },
+    Edit: {
+        patterns: ['edit file', 'modify file', 'update file', 'patch', 'Edit tool', 'replace in'],
+        weight: 2,
+    },
+    Bash: {
+        patterns: [
+            'bash',
+            'npm ',
+            'npx ',
+            'git ',
+            'docker',
+            'yarn ',
+            'pnpm ',
+            'execute command',
+            'run command',
+            'terminal',
+            'shell',
+            'Bash tool',
+        ],
+        weight: 3,
+    },
+    Grep: {
+        patterns: ['grep', 'search for', 'find text', 'pattern match', 'Grep tool'],
+        weight: 1,
+    },
+    Glob: {
+        patterns: ['glob', 'find file', 'file pattern', 'list files', 'Glob tool'],
+        weight: 1,
+    },
+    WebFetch: {
+        patterns: ['fetch', 'http', 'api call', 'url', 'WebFetch', 'download', 'request'],
+        weight: 2,
+    },
+    WebSearch: {
+        patterns: ['web search', 'search online', 'lookup online', 'WebSearch'],
+        weight: 2,
+    },
+    Task: {
+        patterns: ['Task(', 'Task tool', 'spawn agent', 'delegate to', 'subagent'],
+        weight: 3,
+    },
+};
+/**
+ * Thresholds for optimization decisions
+ */
+const THRESHOLDS = {
+    /** Maximum lines before recommending decomposition */
+    maxLinesBeforeDecompose: 500,
+    /** Minimum lines for an extractable section */
+    minSectionLines: 50,
+    /** Heavy tool usage count that suggests subagent */
+    heavyToolUsageCount: 5,
+    /** Sequential Task() calls that should be parallelized */
+    sequentialTaskThreshold: 2,
+    /** Minimum optimization score to recommend transformation */
+    minTransformScore: 30,
+    /** Large examples section threshold */
+    largeExamplesThreshold: 200,
+};
+/**
+ * Analyze a skill's content for optimization opportunities
+ *
+ * @param content - The full SKILL.md content
+ * @returns Analysis of optimization potential
+ */
+export function analyzeSkill(content) {
+    const lines = content.split('\n');
+    const lineCount = lines.length;
+    // Analyze sections
+    const { mainContentLines, examplesLines, sections } = analyzeSections(content);
+    // Analyze tool usage
+    const toolUsage = analyzeToolUsage(content);
+    // Analyze Task() patterns
+    const taskPatterns = analyzeTaskPatterns(content);
+    // Find extractable sections
+    const extractableSections = findExtractableSections(sections, lineCount);
+    // Generate recommendations
+    const recommendations = generateRecommendations(lineCount, mainContentLines, examplesLines, toolUsage, taskPatterns, extractableSections);
+    // Calculate optimization score
+    const optimizationScore = calculateOptimizationScore(lineCount, toolUsage, taskPatterns, recommendations);
+    return {
+        lineCount,
+        mainContentLines,
+        examplesLines,
+        toolUsage,
+        taskPatterns,
+        extractableSections,
+        recommendations,
+        optimizationScore,
+        shouldTransform: optimizationScore >= THRESHOLDS.minTransformScore,
+    };
+}
+/**
+ * Analyze sections within the skill content
+ */
+function analyzeSections(content) {
+    const lines = content.split('\n');
+    const sections = [];
+    let currentSection = null;
+    let examplesStartLine = -1;
+    let examplesEndLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headerMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headerMatch) {
+            // Save previous section
+            if (currentSection) {
+                sections.push({
+                    name: currentSection.name,
+                    startLine: currentSection.startLine,
+                    endLine: i - 1,
+                    content: currentSection.lines.join('\n'),
+                });
+            }
+            currentSection = {
+                name: headerMatch[2].trim(),
+                startLine: i,
+                lines: [],
+            };
+            // Track examples section
+            const sectionName = headerMatch[2].toLowerCase();
+            if (sectionName.includes('example') || sectionName.includes('usage')) {
+                examplesStartLine = i;
+            }
+        }
+        if (currentSection) {
+            currentSection.lines.push(line);
+        }
+    }
+    // Save last section
+    if (currentSection) {
+        sections.push({
+            name: currentSection.name,
+            startLine: currentSection.startLine,
+            endLine: lines.length - 1,
+            content: currentSection.lines.join('\n'),
+        });
+        if (examplesStartLine >= 0 && examplesEndLine < 0) {
+            examplesEndLine = lines.length - 1;
+        }
+    }
+    // Calculate line counts
+    const examplesLines = examplesStartLine >= 0
+        ? examplesEndLine - examplesStartLine + 1
+        : estimateExamplesLines(content);
+    const mainContentLines = lines.length - examplesLines;
+    return { mainContentLines, examplesLines, sections };
+}
+/**
+ * Estimate examples lines by looking for code blocks
+ */
+function estimateExamplesLines(content) {
+    const codeBlockMatches = content.match(/```[\s\S]*?```/g) || [];
+    let totalLines = 0;
+    for (const block of codeBlockMatches) {
+        totalLines += block.split('\n').length;
+    }
+    return totalLines;
+}
+/**
+ * Analyze tool usage patterns in the content
+ */
+function analyzeToolUsage(content) {
+    const lowerContent = content.toLowerCase();
+    const detectedTools = [];
+    let totalWeight = 0;
+    for (const [tool, config] of Object.entries(TOOL_PATTERNS)) {
+        for (const pattern of config.patterns) {
+            if (lowerContent.includes(pattern.toLowerCase())) {
+                if (!detectedTools.includes(tool)) {
+                    detectedTools.push(tool);
+                    totalWeight += config.weight;
+                }
+                break;
+            }
+        }
+    }
+    // Count specific tool patterns
+    const bashCommandCount = (content.match(/\b(npm|npx|git|docker|yarn|pnpm)\s/gi) || []).length;
+    const fileReadCount = (content.match(/\b(read|cat|head|tail|grep|find)\s/gi) || []).length;
+    const fileWriteCount = (content.match(/\b(write|edit|modify|create)\s+file/gi) || []).length;
+    // Determine if heavy tool usage suggests subagent
+    const suggestsSubagent = bashCommandCount >= THRESHOLDS.heavyToolUsageCount ||
+        fileReadCount + fileWriteCount >= THRESHOLDS.heavyToolUsageCount ||
+        totalWeight >= 10;
+    // Calculate confidence
+    const matchCount = detectedTools.length;
+    const confidence = matchCount >= 4 ? 'high' : matchCount >= 2 ? 'medium' : 'low';
+    return {
+        detectedTools,
+        bashCommandCount,
+        fileReadCount,
+        fileWriteCount,
+        suggestsSubagent,
+        confidence,
+    };
+}
+/**
+ * Analyze Task() call patterns
+ */
+function analyzeTaskPatterns(content) {
+    // Find Task() calls
+    const taskCalls = content.match(/Task\s*\([^)]+\)/g) || [];
+    const taskCallCount = taskCalls.length;
+    // Detect sequential patterns (Task calls on consecutive lines without batching)
+    const lines = content.split('\n');
+    let sequentialCalls = 0;
+    let consecutiveTaskLines = 0;
+    for (const line of lines) {
+        if (line.includes('Task(') || line.includes('Task (')) {
+            consecutiveTaskLines++;
+        }
+        else if (consecutiveTaskLines > 0) {
+            if (consecutiveTaskLines >= THRESHOLDS.sequentialTaskThreshold) {
+                sequentialCalls += consecutiveTaskLines;
+            }
+            consecutiveTaskLines = 0;
+        }
+    }
+    // Check for final sequence
+    if (consecutiveTaskLines >= THRESHOLDS.sequentialTaskThreshold) {
+        sequentialCalls += consecutiveTaskLines;
+    }
+    const canBatch = sequentialCalls >= THRESHOLDS.sequentialTaskThreshold;
+    // Estimate savings from batching
+    // Batching reduces context overhead by ~30-50%
+    const batchSavingsPercent = canBatch ? Math.min(50, sequentialCalls * 10) : 0;
+    return {
+        taskCallCount,
+        sequentialCalls,
+        canBatch,
+        batchSavingsPercent,
+    };
+}
+/**
+ * Find sections that could be extracted as sub-skills
+ */
+function findExtractableSections(sections, totalLines) {
+    const extractable = [];
+    for (const section of sections) {
+        const lineCount = section.endLine - section.startLine + 1;
+        // Skip small sections
+        if (lineCount < THRESHOLDS.minSectionLines) {
+            continue;
+        }
+        // Calculate priority based on size relative to total
+        const sizeRatio = lineCount / totalLines;
+        let priority = 3;
+        if (sizeRatio > 0.3) {
+            priority = 1;
+        }
+        else if (sizeRatio > 0.15) {
+            priority = 2;
+        }
+        // Determine reason for extraction
+        let reason = '';
+        const lowerName = section.name.toLowerCase();
+        if (lowerName.includes('api') || lowerName.includes('reference')) {
+            reason = 'API reference sections can be loaded on-demand';
+        }
+        else if (lowerName.includes('example') || lowerName.includes('usage')) {
+            reason = 'Examples can be progressively disclosed';
+        }
+        else if (lowerName.includes('advanced') || lowerName.includes('configuration')) {
+            reason = 'Advanced topics are rarely needed in initial context';
+        }
+        else if (lineCount > 100) {
+            reason = 'Large section suitable for sub-skill extraction';
+        }
+        else {
+            reason = 'Section size suggests separate loading benefit';
+        }
+        extractable.push({
+            name: section.name,
+            startLine: section.startLine,
+            endLine: section.endLine,
+            lineCount,
+            priority,
+            reason,
+        });
+    }
+    // Sort by priority
+    return extractable.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Generate optimization recommendations
+ */
+function generateRecommendations(lineCount, mainContentLines, examplesLines, toolUsage, taskPatterns, extractableSections) {
+    const recommendations = [];
+    // Recommend decomposition for large skills
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        const sectionNames = extractableSections.slice(0, 3).map((s) => s.name);
+        recommendations.push({
+            type: 'decompose',
+            description: `Skill has ${lineCount} lines (threshold: ${THRESHOLDS.maxLinesBeforeDecompose}). Decompose into main SKILL.md + sub-skills.`,
+            estimatedSavings: Math.min(70, Math.floor((lineCount - 400) / 10)),
+            priority: 1,
+            affectedAreas: sectionNames.length > 0 ? sectionNames : ['full-content'],
+        });
+    }
+    // Recommend subagent for heavy tool usage
+    if (toolUsage.suggestsSubagent) {
+        recommendations.push({
+            type: 'subagent',
+            description: `Heavy tool usage detected (${toolUsage.bashCommandCount} bash, ${toolUsage.fileReadCount} reads). Generate companion subagent for context isolation.`,
+            estimatedSavings: 40,
+            priority: 2,
+            affectedAreas: toolUsage.detectedTools,
+        });
+    }
+    // Recommend parallelization for sequential Task() calls
+    if (taskPatterns.canBatch) {
+        recommendations.push({
+            type: 'parallelize',
+            description: `${taskPatterns.sequentialCalls} sequential Task() calls detected. Batch into single message for parallel execution.`,
+            estimatedSavings: taskPatterns.batchSavingsPercent,
+            priority: 2,
+            affectedAreas: ['Task-calls'],
+        });
+    }
+    // Recommend progressive disclosure for large examples
+    if (examplesLines > THRESHOLDS.largeExamplesThreshold) {
+        recommendations.push({
+            type: 'progressive-disclosure',
+            description: `Large examples section (${examplesLines} lines). Move to sub-skill for on-demand loading.`,
+            estimatedSavings: Math.min(60, Math.floor(examplesLines / 5)),
+            priority: 3,
+            affectedAreas: ['examples'],
+        });
+    }
+    // Sort by priority
+    return recommendations.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Calculate overall optimization score
+ */
+function calculateOptimizationScore(lineCount, toolUsage, taskPatterns, recommendations) {
+    let score = 0;
+    // Line count factor (0-40 points)
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        score += Math.min(40, Math.floor((lineCount - 400) / 10));
+    }
+    else if (lineCount > 300) {
+        score += Math.floor((lineCount - 300) / 20);
+    }
+    // Tool usage factor (0-30 points)
+    if (toolUsage.suggestsSubagent) {
+        score += 20;
+    }
+    score += Math.min(10, toolUsage.detectedTools.length * 2);
+    // Task pattern factor (0-20 points)
+    if (taskPatterns.canBatch) {
+        score += Math.min(20, taskPatterns.sequentialCalls * 5);
+    }
+    // Recommendation impact (0-10 points)
+    score += Math.min(10, recommendations.length * 3);
+    return Math.min(100, score);
+}
+/**
+ * Quick check if a skill needs transformation without full analysis
+ *
+ * @param content - The full SKILL.md content
+ * @returns Whether quick transformation check passed
+ */
+export function quickTransformCheck(content) {
+    const lineCount = content.split('\n').length;
+    // Quick checks that indicate transformation needed
+    if (lineCount > THRESHOLDS.maxLinesBeforeDecompose) {
+        return true;
+    }
+    // Check for heavy tool usage patterns
+    const heavyToolPatterns = ['npm ', 'npx ', 'git ', 'docker', 'Bash('];
+    let heavyToolCount = 0;
+    for (const pattern of heavyToolPatterns) {
+        if (content.includes(pattern)) {
+            heavyToolCount++;
+        }
+    }
+    if (heavyToolCount >= 3) {
+        return true;
+    }
+    // Check for sequential Task() calls
+    const taskMatches = content.match(/Task\s*\(/g) || [];
+    if (taskMatches.length >= THRESHOLDS.sequentialTaskThreshold) {
+        return true;
+    }
+    return false;
+}
+export default { analyzeSkill, quickTransformCheck };
+//# sourceMappingURL=SkillAnalyzer.js.map

package/dist/src/services/SkillAnalyzer.js.map

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

package/dist/src/services/SkillDecomposer.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SMI-XXX: SkillDecomposer - Decompose large skills into sub-skills
+ *
+ * Transforms skills >500 lines into a main SKILL.md + sub-skills structure
+ * following the Skillsmith optimization standard:
+ * - Main SKILL.md: <500 lines, contains header + navigation + core content
+ * - Sub-skills: Extracted sections loaded on-demand
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+import type { SkillAnalysis } from './SkillAnalyzer.js';
+/**
+ * Result of skill decomposition
+ */
+export interface DecompositionResult {
+    /** The optimized main SKILL.md content */
+    mainSkill: DecomposedSkill;
+    /** Extracted sub-skills */
+    subSkills: SubSkill[];
+    /** Whether decomposition was applied */
+    wasDecomposed: boolean;
+    /** Statistics about the decomposition */
+    stats: DecompositionStats;
+}
+/**
+ * The main skill after decomposition
+ */
+export interface DecomposedSkill {
+    /** Filename (always SKILL.md) */
+    filename: string;
+    /** The optimized content */
+    content: string;
+    /** Line count after optimization */
+    lineCount: number;
+    /** References to sub-skills */
+    subSkillRefs: string[];
+}
+/**
+ * An extracted sub-skill
+ */
+export interface SubSkill {
+    /** Filename (e.g., api.md, examples.md) */
+    filename: string;
+    /** Original section name */
+    sectionName: string;
+    /** The extracted content */
+    content: string;
+    /** Line count */
+    lineCount: number;
+    /** Why this section was extracted */
+    extractionReason: string;
+}
+/**
+ * Statistics about the decomposition
+ */
+export interface DecompositionStats {
+    /** Original line count */
+    originalLines: number;
+    /** Main skill line count after decomposition */
+    mainSkillLines: number;
+    /** Total lines in sub-skills */
+    subSkillLines: number;
+    /** Number of sub-skills created */
+    subSkillCount: number;
+    /** Estimated token reduction percentage */
+    tokenReductionPercent: number;
+}
+/**
+ * Configuration for decomposition behavior
+ */
+export interface DecomposerOptions {
+    /** Maximum lines for main skill (default: 400) */
+    maxMainSkillLines?: number;
+    /** Minimum lines for a section to be extracted (default: 50) */
+    minExtractableLines?: number;
+    /** Whether to add navigation links to main skill (default: true) */
+    addNavigation?: boolean;
+    /** Whether to add "Optimized by Skillsmith" attribution (default: true) */
+    addAttribution?: boolean;
+}
+/**
+ * Decompose a skill into main + sub-skills based on analysis
+ *
+ * @param content - The original SKILL.md content
+ * @param analysis - Analysis from SkillAnalyzer
+ * @param options - Decomposition options
+ * @returns Decomposition result with main skill and sub-skills
+ */
+export declare function decomposeSkill(content: string, analysis: SkillAnalysis, options?: DecomposerOptions): DecompositionResult;
+/**
+ * Parallelize sequential Task() calls in skill content
+ *
+ * @param content - The skill content
+ * @returns Content with Task() calls batched for parallel execution
+ */
+export declare function parallelizeTaskCalls(content: string): string;
+declare const _default: {
+    decomposeSkill: typeof decomposeSkill;
+    parallelizeTaskCalls: typeof parallelizeTaskCalls;
+};
+export default _default;
+//# sourceMappingURL=SkillDecomposer.d.ts.map

package/dist/src/services/SkillDecomposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDecomposer.d.ts","sourceRoot":"","sources":["../../../src/services/SkillDecomposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,SAAS,EAAE,eAAe,CAAA;IAE1B,2BAA2B;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAA;IAErB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAA;IAEtB,yCAAyC;IACzC,KAAK,EAAE,kBAAkB,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAEhB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IAEf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IAEjB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAEhB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IAEnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IAEf,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IAEjB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAA;IAErB,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAA;IAEtB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAA;IAErB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;IAErB,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAWD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AASD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,mBAAmB,CAoCrB;AAuUD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2C5D;;;;;AAcD,wBAAuD"}