@skillsmith/mcp-server 0.3.0 → 0.3.1

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

@@ -1,260 +0,0 @@
-/**
- * @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, trackSkillView, } 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.
- *
- * SMI-1183: Uses API as primary source with local DB fallback.
- * - Tries live API first (api.skillsmith.app)
- * - Falls back to local SkillRepository if API is offline or fails
- *
- * @param input - Input containing the skill ID to retrieve
- * @param context - Tool context with API client and local 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
- */
-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',
-        });
-    }
-    // SMI-1183: Try API first, fall back to local DB
-    if (!context.apiClient.isOffline()) {
-        try {
-            const apiResponse = await context.apiClient.getSkill(skillId);
-            const apiSkill = apiResponse.data;
-            // Convert API skill to MCP skill format
-            const skill = {
-                id: apiSkill.id,
-                name: apiSkill.name,
-                description: apiSkill.description || '',
-                author: apiSkill.author || 'unknown',
-                repository: apiSkill.repo_url || undefined,
-                version: undefined,
-                category: extractCategoryFromTags(apiSkill.tags),
-                trustTier: mapTrustTierFromDb(apiSkill.trust_tier),
-                score: Math.round((apiSkill.quality_score ?? 0) * 100),
-                scoreBreakdown: undefined,
-                tags: apiSkill.tags || [],
-                installCommand: 'claude skill add ' + apiSkill.id,
-                createdAt: apiSkill.created_at,
-                updatedAt: apiSkill.updated_at,
-            };
-            const endTime = performance.now();
-            // SMI-1184: Track skill view event (silent on failure)
-            if (context.distinctId) {
-                trackSkillView(context.distinctId, skill.id, 'mcp');
-            }
-            return {
-                skill,
-                installCommand: skill.installCommand || 'claude skill add ' + skill.id,
-                timing: {
-                    totalMs: Math.round(endTime - startTime),
-                },
-            };
-        }
-        catch (error) {
-            // SMI-1183: Log and fall through to local database for all errors
-            // This allows local-only skills to be found even if API returns 404
-            console.warn('[skillsmith] API getSkill failed, using local database:', error.message);
-        }
-    }
-    // Fallback: Look up skill from local 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();
-    // SMI-1184: Track skill view event (silent on failure)
-    if (context.distinctId) {
-        trackSkillView(context.distinctId, skill.id, 'mcp');
-    }
-    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 'experimental':
-            return '[~] EXPERIMENTAL';
-        case 'unknown':
-            return '[?] UNKNOWN';
-    }
-}
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,122 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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,CAyIxB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;CAsBvB,CAAA;AAED,eAAe,WAAW,CAAA"}