@skillsmith/mcp-server 0.1.0

package/dist/src/tools/get-skill.js

@@ -0,0 +1,224 @@
+/**
+ * @fileoverview MCP Get Skill Tool for retrieving detailed skill information
+ * @module @skillsmith/mcp-server/tools/get-skill
+ * @see {@link https://github.com/wrsmith108/skillsmith|Skillsmith Repository}
+ * @see SMI-790: Wire get-skill tool to SkillRepository
+ *
+ * Retrieves comprehensive details for a specific skill including:
+ * - Basic metadata (name, author, version, category)
+ * - Quality scores with breakdown (quality, popularity, maintenance, security, documentation)
+ * - Trust tier with explanation
+ * - Repository link and tags
+ * - Installation command
+ *
+ * @example
+ * // Get skill by ID with context
+ * const response = await executeGetSkill({ id: 'anthropic/commit' }, context);
+ * console.log(response.skill.description);
+ *
+ * @example
+ * // Format for terminal display
+ * const response = await executeGetSkill({ id: 'community/jest-helper' }, context);
+ * console.log(formatSkillDetails(response));
+ */
+import { z } from 'zod';
+import { TrustTierDescriptions, SkillsmithError, ErrorCodes, } from '@skillsmith/core';
+import { isValidSkillId, mapTrustTierFromDb, extractCategoryFromTags } from '../utils/validation.js';
+/**
+ * Zod schema for get-skill input validation
+ */
+export const getSkillInputSchema = z.object({
+    id: z.string().min(1, 'Skill ID is required'),
+});
+/**
+ * Get skill tool schema for MCP
+ */
+export const getSkillToolSchema = {
+    name: 'get_skill',
+    description: 'Get full details for a specific skill by ID',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'The skill ID (e.g., "anthropic/commit" or UUID)',
+            },
+        },
+        required: ['id'],
+    },
+};
+// isValidSkillId imported from ../utils/validation.js
+/**
+ * Retrieve full details for a specific skill by ID.
+ *
+ * Uses SkillRepository to fetch skill from the SQLite database.
+ *
+ * @param input - Input containing the skill ID to retrieve
+ * @param context - Tool context with database and services
+ * @returns Promise resolving to skill details and install command
+ * @throws {SkillsmithError} VALIDATION_REQUIRED_FIELD - When ID is empty
+ * @throws {SkillsmithError} SKILL_INVALID_ID - When ID format is invalid
+ * @throws {SkillsmithError} SKILL_NOT_FOUND - When skill doesn't exist
+ *
+ * @example
+ * // Get a verified skill
+ * const response = await executeGetSkill({ id: 'anthropic/commit' }, context);
+ * console.log(response.skill.score); // 95
+ * console.log(response.installCommand); // 'claude skill add anthropic/commit'
+ *
+ * @example
+ * // Handle not found
+ * try {
+ *   await executeGetSkill({ id: 'unknown/skill' }, context);
+ * } catch (error) {
+ *   if (error.code === 'SKILL_NOT_FOUND') {
+ *     console.log(error.suggestion); // 'Try searching for similar skills...'
+ *   }
+ * }
+ */
+export async function executeGetSkill(input, context) {
+    const startTime = performance.now();
+    // Validate input
+    if (!input.id || input.id.trim().length === 0) {
+        throw new SkillsmithError(ErrorCodes.VALIDATION_REQUIRED_FIELD, 'Skill ID is required', {
+            details: { field: 'id' },
+        });
+    }
+    const skillId = input.id.trim();
+    // Validate ID format
+    if (!isValidSkillId(skillId)) {
+        throw new SkillsmithError(ErrorCodes.SKILL_INVALID_ID, 'Invalid skill ID format: "' + input.id + '"', {
+            details: { id: input.id },
+            suggestion: 'Skill IDs should be in format "author/skill-name" (e.g., "anthropic/commit") or a valid UUID',
+        });
+    }
+    // Look up skill from database using SkillRepository
+    const dbSkill = context.skillRepository.findById(skillId);
+    if (!dbSkill) {
+        throw new SkillsmithError(ErrorCodes.SKILL_NOT_FOUND, 'Skill "' + input.id + '" not found', {
+            details: { id: input.id },
+            suggestion: 'Try searching for similar skills with the search tool',
+        });
+    }
+    // Convert database skill to MCP skill format
+    const skill = {
+        id: dbSkill.id,
+        name: dbSkill.name,
+        description: dbSkill.description || '',
+        author: dbSkill.author || 'unknown',
+        repository: dbSkill.repoUrl || undefined,
+        version: undefined, // Version not stored in current schema
+        category: extractCategoryFromTags(dbSkill.tags),
+        trustTier: mapTrustTierFromDb(dbSkill.trustTier),
+        score: Math.round((dbSkill.qualityScore ?? 0) * 100),
+        scoreBreakdown: undefined, // Breakdown not stored in current schema
+        tags: dbSkill.tags || [],
+        installCommand: 'claude skill add ' + dbSkill.id,
+        createdAt: dbSkill.createdAt,
+        updatedAt: dbSkill.updatedAt,
+    };
+    const endTime = performance.now();
+    return {
+        skill,
+        installCommand: skill.installCommand || 'claude skill add ' + skill.id,
+        timing: {
+            totalMs: Math.round(endTime - startTime),
+        },
+    };
+}
+/**
+ * Format skill details for terminal/CLI display.
+ *
+ * Produces a comprehensive human-readable string including:
+ * - Basic info (ID, author, version, category)
+ * - Full description
+ * - Trust tier with explanation
+ * - Visual score breakdown bars
+ * - Repository and tags
+ * - Installation command
+ *
+ * @param response - Get skill response from executeGetSkill
+ * @returns Formatted string suitable for terminal output
+ *
+ * @example
+ * const response = await executeGetSkill({ id: 'anthropic/commit' });
+ * console.log(formatSkillDetails(response));
+ * // Output:
+ * // === commit ===
+ * // ID: anthropic/commit
+ * // Author: anthropic
+ * // Version: 1.2.0
+ * // ...
+ */
+export function formatSkillDetails(response) {
+    const skill = response.skill;
+    const lines = [];
+    lines.push('\n=== ' + skill.name + ' ===\n');
+    // Basic info
+    lines.push('ID: ' + skill.id);
+    lines.push('Author: ' + skill.author);
+    lines.push('Version: ' + (skill.version || 'N/A'));
+    lines.push('Category: ' + skill.category);
+    lines.push('');
+    // Description
+    lines.push('Description:');
+    lines.push('  ' + skill.description);
+    lines.push('');
+    // Trust tier with explanation
+    lines.push('Trust Tier: ' + formatTrustTier(skill.trustTier));
+    lines.push('  ' + TrustTierDescriptions[skill.trustTier]);
+    lines.push('');
+    // Score breakdown
+    lines.push('Overall Score: ' + skill.score + '/100');
+    if (skill.scoreBreakdown) {
+        lines.push('Score Breakdown:');
+        lines.push('  Quality:       ' + formatScoreBar(skill.scoreBreakdown.quality));
+        lines.push('  Popularity:    ' + formatScoreBar(skill.scoreBreakdown.popularity));
+        lines.push('  Maintenance:   ' + formatScoreBar(skill.scoreBreakdown.maintenance));
+        lines.push('  Security:      ' + formatScoreBar(skill.scoreBreakdown.security));
+        lines.push('  Documentation: ' + formatScoreBar(skill.scoreBreakdown.documentation));
+    }
+    lines.push('');
+    // Repository
+    if (skill.repository) {
+        lines.push('Repository: ' + skill.repository);
+    }
+    // Tags
+    if (skill.tags && skill.tags.length > 0) {
+        lines.push('Tags: ' + skill.tags.join(', '));
+    }
+    lines.push('');
+    // Installation
+    lines.push('--- Installation ---');
+    lines.push('  ' + response.installCommand);
+    lines.push('');
+    // Timing
+    lines.push('---');
+    lines.push('Retrieved in ' + response.timing.totalMs + 'ms');
+    return lines.join('\n');
+}
+/**
+ * Format trust tier with visual indicator
+ */
+function formatTrustTier(tier) {
+    switch (tier) {
+        case 'verified':
+            return '[*] VERIFIED';
+        case 'community':
+            return '[+] COMMUNITY';
+        case 'standard':
+            return '[=] STANDARD';
+        case 'unverified':
+            return '[?] UNVERIFIED';
+    }
+}
+/**
+ * Format score as a visual bar
+ */
+function formatScoreBar(score) {
+    const filled = Math.round(score / 10);
+    const empty = 10 - filled;
+    const bar = '='.repeat(filled) + '-'.repeat(empty);
+    return '[' + bar + '] ' + score + '/100';
+}
+//# sourceMappingURL=get-skill.js.map

package/dist/src/tools/get-skill.js.map

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

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

@@ -0,0 +1,20 @@
+/**
+ * MCP Tools exports
+ */
+export { searchToolSchema, executeSearch, formatSearchResults } from './search.js';
+export type { SearchInput } from './search.js';
+export { installTool, installSkill, installInputSchema } from './install.js';
+export type { InstallInput, InstallResult } from './install.js';
+export { uninstallTool, uninstallSkill, uninstallInputSchema, listInstalledSkills, } from './uninstall.js';
+export type { UninstallInput, UninstallResult } from './uninstall.js';
+export { getSkillToolSchema, executeGetSkill } from './get-skill.js';
+export type { GetSkillInput } from './get-skill.js';
+export { recommendToolSchema, recommendInputSchema, executeRecommend, formatRecommendations, } from './recommend.js';
+export type { RecommendInput, SkillRecommendation, RecommendResponse } from './recommend.js';
+export { validateToolSchema, validateInputSchema, executeValidate, formatValidationResults, } from './validate.js';
+export type { ValidateInput, ValidationError, ValidateResponse } from './validate.js';
+export { compareToolSchema, compareInputSchema, executeCompare, formatComparisonResults, } from './compare.js';
+export type { CompareInput, SkillSummary, SkillDifference, CompareResponse } from './compare.js';
+export { analyzeToolSchema, analyzeInputSchema, executeAnalyze, formatAnalysisResults, } from './analyze.js';
+export type { AnalyzeInput, AnalyzeFramework, AnalyzeDependency, AnalyzeResponse, } from './analyze.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC5E,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG/D,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG5F,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrF,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGhG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAA"}

package/dist/src/tools/index.js

@@ -0,0 +1,20 @@
+/**
+ * MCP Tools exports
+ */
+// Search tool (SMI-581)
+export { searchToolSchema, executeSearch, formatSearchResults } from './search.js';
+// Install tool (SMI-586)
+export { installTool, installSkill, installInputSchema } from './install.js';
+// Uninstall tool (SMI-588)
+export { uninstallTool, uninstallSkill, uninstallInputSchema, listInstalledSkills, } from './uninstall.js';
+// Get skill tool (SMI-582)
+export { getSkillToolSchema, executeGetSkill } from './get-skill.js';
+// Recommend tool (SMI-741)
+export { recommendToolSchema, recommendInputSchema, executeRecommend, formatRecommendations, } from './recommend.js';
+// Validate tool (SMI-742)
+export { validateToolSchema, validateInputSchema, executeValidate, formatValidationResults, } from './validate.js';
+// Compare tool (SMI-743)
+export { compareToolSchema, compareInputSchema, executeCompare, formatComparisonResults, } from './compare.js';
+// Analyze codebase tool (SMI-600)
+export { analyzeToolSchema, analyzeInputSchema, executeAnalyze, formatAnalysisResults, } from './analyze.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGlF,yBAAyB;AACzB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAG5E,2BAA2B;AAC3B,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAA;AAGvB,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGpE,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAGvB,0BAA0B;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GACxB,MAAM,eAAe,CAAA;AAGtB,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAGrB,kCAAkC;AAClC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,122 @@
+/**
+ * @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 { type ScanReport } from '@skillsmith/core';
+import type { ToolContext } from '../context.js';
+export declare const installInputSchema: z.ZodObject<{
+    skillId: z.ZodString;
+    force: z.ZodDefault<z.ZodBoolean>;
+    skipScan: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    skillId: string;
+    force: boolean;
+    skipScan: boolean;
+}, {
+    skillId: string;
+    force?: boolean | undefined;
+    skipScan?: boolean | undefined;
+}>;
+export type InstallInput = z.infer<typeof installInputSchema>;
+export interface InstallResult {
+    success: boolean;
+    skillId: string;
+    installPath: string;
+    securityReport?: ScanReport;
+    tips?: string[];
+    error?: string;
+}
+/**
+ * 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 declare function installSkill(input: InstallInput, _context?: ToolContext): Promise<InstallResult>;
+/**
+ * MCP tool definition
+ */
+export declare const installTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            skillId: {
+                type: string;
+                description: string;
+            };
+            force: {
+                type: string;
+                description: string;
+            };
+            skipScan: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export default installTool;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/tools/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAInE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAG7D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,UAAU,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,aAAa,CAAC,CA4HxB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;CAsBvB,CAAA;AAED,eAAe,WAAW,CAAA"}