@skillsmith/mcp-server 0.1.0

package/dist/src/tools/install.js

@@ -0,0 +1,314 @@
+/**
+ * @fileoverview MCP Install Skill Tool for downloading and installing skills
+ * @module @skillsmith/mcp-server/tools/install
+ * @see {@link https://github.com/wrsmith108/skillsmith|Skillsmith Repository}
+ *
+ * Provides skill installation functionality with:
+ * - GitHub repository fetching (supports owner/repo and full URLs)
+ * - Automatic security scanning before installation
+ * - SKILL.md validation
+ * - Manifest tracking of installed skills
+ * - Optional file fetching (README.md, examples.md, config.json)
+ *
+ * Skills are installed to ~/.claude/skills/ and tracked in ~/.skillsmith/manifest.json
+ *
+ * @example
+ * // Install from owner/repo format
+ * const result = await installSkill({ skillId: 'anthropic/commit' });
+ *
+ * @example
+ * // Install from GitHub URL
+ * const result = await installSkill({
+ *   skillId: 'https://github.com/user/repo/tree/main/skills/my-skill'
+ * });
+ *
+ * @example
+ * // Force reinstall with security scan skip
+ * const result = await installSkill({
+ *   skillId: 'community/helper',
+ *   force: true,
+ *   skipScan: true // Not recommended
+ * });
+ */
+import { z } from 'zod';
+import { SecurityScanner } from '@skillsmith/core';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+// Input schema
+export const installInputSchema = z.object({
+    skillId: z.string().min(1).describe('Skill ID or GitHub URL'),
+    force: z.boolean().default(false).describe('Force reinstall if exists'),
+    skipScan: z.boolean().default(false).describe('Skip security scan (not recommended)'),
+});
+// Paths
+const CLAUDE_SKILLS_DIR = path.join(os.homedir(), '.claude', 'skills');
+const SKILLSMITH_DIR = path.join(os.homedir(), '.skillsmith');
+const MANIFEST_PATH = path.join(SKILLSMITH_DIR, 'manifest.json');
+/**
+ * Load or create manifest
+ */
+async function loadManifest() {
+    try {
+        const content = await fs.readFile(MANIFEST_PATH, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            version: '1.0.0',
+            installedSkills: {},
+        };
+    }
+}
+/**
+ * Save manifest
+ */
+async function saveManifest(manifest) {
+    await fs.mkdir(path.dirname(MANIFEST_PATH), { recursive: true });
+    await fs.writeFile(MANIFEST_PATH, JSON.stringify(manifest, null, 2));
+}
+/**
+ * Parse skill ID or URL to get components
+ */
+function parseSkillId(input) {
+    // Handle full GitHub URLs
+    if (input.startsWith('https://github.com/')) {
+        const url = new URL(input);
+        const parts = url.pathname.split('/').filter(Boolean);
+        return {
+            owner: parts[0],
+            repo: parts[1],
+            path: parts.slice(2).join('/') || '',
+        };
+    }
+    // Handle owner/repo format
+    if (input.includes('/')) {
+        const [owner, ...rest] = input.split('/');
+        const repo = rest[0];
+        const skillPath = rest.slice(1).join('/');
+        return { owner, repo, path: skillPath };
+    }
+    // Handle skill ID from registry
+    throw new Error('Invalid skill ID format: ' + input + '. Use owner/repo or GitHub URL.');
+}
+/**
+ * Fetch file from GitHub
+ */
+async function fetchFromGitHub(owner, repo, filePath) {
+    const url = 'https://raw.githubusercontent.com/' + owner + '/' + repo + '/main/' + filePath;
+    const response = await fetch(url);
+    if (!response.ok) {
+        // Try master branch
+        const masterUrl = 'https://raw.githubusercontent.com/' + owner + '/' + repo + '/master/' + filePath;
+        const masterResponse = await fetch(masterUrl);
+        if (!masterResponse.ok) {
+            throw new Error('Failed to fetch ' + filePath + ': ' + response.status);
+        }
+        return masterResponse.text();
+    }
+    return response.text();
+}
+/**
+ * Validate SKILL.md content
+ */
+function validateSkillMd(content) {
+    const errors = [];
+    // Check for required sections
+    if (!content.includes('# ')) {
+        errors.push('Missing title (# heading)');
+    }
+    // Check minimum length
+    if (content.length < 100) {
+        errors.push('SKILL.md is too short (minimum 100 characters)');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Generate post-install tips
+ */
+function generateTips(skillName) {
+    return [
+        'Skill "' + skillName + '" installed successfully!',
+        'To use this skill, mention it in Claude Code: "Use the ' + skillName + ' skill to..."',
+        'View installed skills: ls ~/.claude/skills/',
+        'To uninstall: use the uninstall_skill tool',
+    ];
+}
+/**
+ * Install a skill from GitHub to the local Claude Code skills directory.
+ *
+ * This function:
+ * 1. Parses the skill ID or GitHub URL
+ * 2. Checks if already installed (returns error unless force=true)
+ * 3. Fetches SKILL.md from GitHub (required)
+ * 4. Validates SKILL.md content
+ * 5. Runs security scan (unless skipScan=true)
+ * 6. Creates installation directory at ~/.claude/skills/{skillName}
+ * 7. Writes skill files
+ * 8. Updates manifest at ~/.skillsmith/manifest.json
+ *
+ * @param input - Installation parameters
+ * @param input.skillId - Skill ID (owner/repo) or full GitHub URL
+ * @param input.force - Force reinstall if skill already exists (default: false)
+ * @param input.skipScan - Skip security scan (default: false, not recommended)
+ * @returns Promise resolving to installation result with success status
+ *
+ * @example
+ * // Successful installation
+ * const result = await installSkill({ skillId: 'anthropic/commit' });
+ * if (result.success) {
+ *   console.log(`Installed to ${result.installPath}`);
+ *   result.tips?.forEach(tip => console.log(tip));
+ * }
+ *
+ * @example
+ * // Handle security scan failure
+ * const result = await installSkill({ skillId: 'untrusted/skill' });
+ * if (!result.success && result.securityReport) {
+ *   console.log('Security issues found:');
+ *   result.securityReport.findings.forEach(f =>
+ *     console.log(`  ${f.severity}: ${f.message}`)
+ *   );
+ * }
+ */
+export async function installSkill(input, _context) {
+    const scanner = new SecurityScanner();
+    try {
+        // Parse skill ID
+        const { owner, repo, path: skillPath } = parseSkillId(input.skillId);
+        const skillName = skillPath ? path.basename(skillPath) : repo;
+        const installPath = path.join(CLAUDE_SKILLS_DIR, skillName);
+        // Check if already installed
+        const manifest = await loadManifest();
+        if (manifest.installedSkills[skillName] && !input.force) {
+            return {
+                success: false,
+                skillId: input.skillId,
+                installPath,
+                error: 'Skill "' + skillName + '" is already installed. Use force=true to reinstall.',
+            };
+        }
+        // Determine files to fetch
+        const basePath = skillPath ? skillPath + '/' : '';
+        const skillMdPath = basePath + 'SKILL.md';
+        // Fetch SKILL.md (required)
+        let skillMdContent;
+        try {
+            skillMdContent = await fetchFromGitHub(owner, repo, skillMdPath);
+        }
+        catch {
+            return {
+                success: false,
+                skillId: input.skillId,
+                installPath,
+                error: 'Could not find SKILL.md at ' + skillMdPath + '. Skills must have a SKILL.md file.',
+            };
+        }
+        // Validate SKILL.md
+        const validation = validateSkillMd(skillMdContent);
+        if (!validation.valid) {
+            return {
+                success: false,
+                skillId: input.skillId,
+                installPath,
+                error: 'Invalid SKILL.md: ' + validation.errors.join(', '),
+            };
+        }
+        // Security scan
+        let securityReport;
+        if (!input.skipScan) {
+            securityReport = scanner.scan(input.skillId, skillMdContent);
+            if (!securityReport.passed) {
+                const criticalFindings = securityReport.findings.filter((f) => f.severity === 'critical' || f.severity === 'high');
+                return {
+                    success: false,
+                    skillId: input.skillId,
+                    installPath,
+                    securityReport,
+                    error: 'Security scan failed with ' +
+                        criticalFindings.length +
+                        ' critical/high findings. Use skipScan=true to override (not recommended).',
+                };
+            }
+        }
+        // Create installation directory
+        await fs.mkdir(installPath, { recursive: true });
+        // Write SKILL.md
+        await fs.writeFile(path.join(installPath, 'SKILL.md'), skillMdContent);
+        // Try to fetch optional files
+        const optionalFiles = ['README.md', 'examples.md', 'config.json'];
+        for (const file of optionalFiles) {
+            try {
+                const content = await fetchFromGitHub(owner, repo, basePath + file);
+                // Scan optional files too
+                if (!input.skipScan) {
+                    const fileScan = scanner.scan(input.skillId + '/' + file, content);
+                    if (!fileScan.passed) {
+                        console.warn('Skipping ' + file + ' due to security findings');
+                        continue;
+                    }
+                }
+                await fs.writeFile(path.join(installPath, file), content);
+            }
+            catch {
+                // Optional files are fine to skip
+            }
+        }
+        // Update manifest
+        manifest.installedSkills[skillName] = {
+            id: input.skillId,
+            name: skillName,
+            version: '1.0.0',
+            source: 'github:' + owner + '/' + repo,
+            installPath,
+            installedAt: new Date().toISOString(),
+            lastUpdated: new Date().toISOString(),
+        };
+        await saveManifest(manifest);
+        return {
+            success: true,
+            skillId: input.skillId,
+            installPath,
+            securityReport,
+            tips: generateTips(skillName),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            skillId: input.skillId,
+            installPath: '',
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * MCP tool definition
+ */
+export const installTool = {
+    name: 'install_skill',
+    description: 'Install a Claude Code skill from GitHub. Performs security scan before installation.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            skillId: {
+                type: 'string',
+                description: 'Skill ID (owner/repo/skill) or GitHub URL',
+            },
+            force: {
+                type: 'boolean',
+                description: 'Force reinstall if skill already exists',
+            },
+            skipScan: {
+                type: 'boolean',
+                description: 'Skip security scan (not recommended)',
+            },
+        },
+        required: ['skillId'],
+    },
+};
+export default installTool;
+//# sourceMappingURL=install.js.map

package/dist/src/tools/install.js.map

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

package/dist/src/tools/recommend.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @fileoverview MCP Skill Recommend Tool for suggesting relevant skills
+ * @module @skillsmith/mcp-server/tools/recommend
+ * @see SMI-741: Add MCP Tool skill_recommend
+ * @see SMI-602: Integrate semantic matching with EmbeddingService
+ * @see SMI-604: Add trigger phrase overlap detection
+ *
+ * Provides skill recommendations based on:
+ * - Currently installed skills (semantic similarity)
+ * - Optional project context (semantic matching)
+ * - Codebase analysis (framework detection)
+ * - Overlap detection (avoid similar skills)
+ *
+ * @example
+ * // Basic recommendation
+ * const results = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   limit: 5
+ * }, toolContext);
+ *
+ * @example
+ * // Recommendation with project context
+ * const results = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   project_context: 'React frontend with Jest testing',
+ *   limit: 10
+ * }, toolContext);
+ */
+import { z } from 'zod';
+import { type MCPTrustTier as TrustTier } from '@skillsmith/core';
+import type { ToolContext } from '../context.js';
+/**
+ * Zod schema for recommend tool input validation
+ */
+export declare const recommendInputSchema: z.ZodObject<{
+    /** Currently installed skill IDs */
+    installed_skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Optional project description for context-aware recommendations */
+    project_context: z.ZodOptional<z.ZodString>;
+    /** Maximum recommendations to return (default 5) */
+    limit: z.ZodDefault<z.ZodNumber>;
+    /** Enable overlap detection (default true) */
+    detect_overlap: z.ZodDefault<z.ZodBoolean>;
+    /** Minimum similarity threshold (0-1, default 0.3) */
+    min_similarity: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    installed_skills: string[];
+    limit: number;
+    detect_overlap: boolean;
+    min_similarity: number;
+    project_context?: string | undefined;
+}, {
+    installed_skills?: string[] | undefined;
+    project_context?: string | undefined;
+    limit?: number | undefined;
+    detect_overlap?: boolean | undefined;
+    min_similarity?: number | undefined;
+}>;
+/**
+ * Input type (before parsing, allows optional fields)
+ */
+export type RecommendInput = z.input<typeof recommendInputSchema>;
+/**
+ * Individual skill recommendation with reasoning
+ */
+export interface SkillRecommendation {
+    /** Skill identifier */
+    skill_id: string;
+    /** Skill name */
+    name: string;
+    /** Why this skill is recommended */
+    reason: string;
+    /** Semantic similarity score (0-1) */
+    similarity_score: number;
+    /** Trust tier for user confidence */
+    trust_tier: TrustTier;
+    /** Overall quality score */
+    quality_score: number;
+}
+/**
+ * Recommendation response with timing info
+ */
+export interface RecommendResponse {
+    /** List of recommended skills */
+    recommendations: SkillRecommendation[];
+    /** Total candidates considered */
+    candidates_considered: number;
+    /** Skills filtered due to overlap */
+    overlap_filtered: number;
+    /** Query context used for matching */
+    context: {
+        installed_count: number;
+        has_project_context: boolean;
+        using_semantic_matching: boolean;
+        /** SMI-906: Whether installed skills were auto-detected from ~/.claude/skills/ */
+        auto_detected: boolean;
+    };
+    /** Performance timing */
+    timing: {
+        totalMs: number;
+    };
+}
+/**
+ * MCP tool schema definition for skill_recommend
+ */
+export declare const recommendToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            installed_skills: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            project_context: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+            detect_overlap: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            min_similarity: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+            };
+        };
+        required: never[];
+    };
+};
+/**
+ * Execute skill recommendation based on installed skills and context.
+ *
+ * Uses semantic similarity to find skills that complement the user's
+ * current installation. When project context is provided, it's used
+ * to improve recommendation relevance. Overlap detection prevents
+ * recommending skills that are too similar to installed ones.
+ *
+ * @param input - Recommendation parameters
+ * @returns Promise resolving to recommendation response
+ * @throws {SkillsmithError} When validation fails
+ *
+ * @example
+ * const response = await executeRecommend({
+ *   installed_skills: ['anthropic/commit'],
+ *   project_context: 'React TypeScript frontend',
+ *   limit: 5
+ * }, toolContext);
+ * console.log(response.recommendations[0].reason);
+ */
+export declare function executeRecommend(input: RecommendInput, context: ToolContext): Promise<RecommendResponse>;
+/**
+ * Format recommendations for terminal display
+ */
+export declare function formatRecommendations(response: RecommendResponse): string;
+//# sourceMappingURL=recommend.d.ts.map

package/dist/src/tools/recommend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.d.ts","sourceRoot":"","sources":["../../../src/tools/recommend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,YAAY,IAAI,SAAS,EAAiC,MAAM,kBAAkB,CAAA;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,oCAAoC;;IAEpC,qEAAqE;;IAErE,oDAAoD;;IAEpD,8CAA8C;;IAE9C,sDAAsD;;;;;;;;;;;;;;EAEtD,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAA;IACxB,qCAAqC;IACrC,UAAU,EAAE,SAAS,CAAA;IACrB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,kCAAkC;IAClC,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAA;IACxB,sCAAsC;IACtC,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAA;QACvB,mBAAmB,EAAE,OAAO,CAAA;QAC5B,uBAAuB,EAAE,OAAO,CAAA;QAChC,kFAAkF;QAClF,aAAa,EAAE,OAAO,CAAA;KACvB,CAAA;IACD,yBAAyB;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/B,CAAA;AAkFD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA4I5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CA4CzE"}