@skillsmith/mcp-server 0.1.0

package/dist/src/tools/uninstall.js

@@ -0,0 +1,250 @@
+/**
+ * @fileoverview MCP Uninstall Skill Tool for safely removing installed skills
+ * @module @skillsmith/mcp-server/tools/uninstall
+ * @see {@link https://github.com/wrsmith108/skillsmith|Skillsmith Repository}
+ *
+ * Provides skill uninstallation functionality with:
+ * - Manifest-based tracking of installed skills
+ * - Modification detection (warns if files changed since install)
+ * - Force removal option for modified or untracked skills
+ * - Clean removal from ~/.claude/skills/ directory
+ *
+ * @example
+ * // Uninstall a skill
+ * const result = await uninstallSkill({ skillName: 'commit' });
+ * if (result.success) {
+ *   console.log(result.message);
+ * }
+ *
+ * @example
+ * // Force uninstall modified skill
+ * const result = await uninstallSkill({
+ *   skillName: 'my-custom-skill',
+ *   force: true
+ * });
+ */
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+// Input schema
+export const uninstallInputSchema = z.object({
+    skillName: z.string().min(1).describe('Name of the skill to uninstall'),
+    force: z.boolean().default(false).describe('Force removal even if modified'),
+});
+// 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 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));
+}
+/**
+ * Check if skill directory has been modified since installation
+ */
+async function checkForModifications(skillPath, installedAt) {
+    try {
+        const installDate = new Date(installedAt);
+        // Get all files in skill directory
+        const files = await fs.readdir(skillPath, { withFileTypes: true });
+        for (const file of files) {
+            if (file.isFile()) {
+                const filePath = path.join(skillPath, file.name);
+                const stats = await fs.stat(filePath);
+                // Check if modified after installation
+                if (stats.mtime > installDate) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recursively remove directory
+ */
+async function removeDirectory(dirPath) {
+    await fs.rm(dirPath, { recursive: true, force: true });
+}
+/**
+ * Uninstall a skill from the local Claude Code skills directory.
+ *
+ * This function:
+ * 1. Loads the manifest to find the skill
+ * 2. Checks for local modifications (warns unless force=true)
+ * 3. Removes the skill directory from ~/.claude/skills/
+ * 4. Updates the manifest to remove the skill entry
+ *
+ * If the skill exists on disk but not in manifest, force=true is required.
+ *
+ * @param input - Uninstall parameters
+ * @param input.skillName - Name of the skill to uninstall
+ * @param input.force - Force removal even if modified (default: false)
+ * @returns Promise resolving to uninstall result with success status
+ *
+ * @example
+ * // Standard uninstall
+ * const result = await uninstallSkill({ skillName: 'jest-helper' });
+ * if (result.success) {
+ *   console.log(`Removed from ${result.removedPath}`);
+ * }
+ *
+ * @example
+ * // Handle modified skill
+ * const result = await uninstallSkill({ skillName: 'custom-skill' });
+ * if (!result.success && result.warning) {
+ *   console.log(result.warning); // 'Local modifications will be lost...'
+ *   // Ask user confirmation, then:
+ *   await uninstallSkill({ skillName: 'custom-skill', force: true });
+ * }
+ *
+ * @example
+ * // Check if skill is installed first
+ * const installed = await listInstalledSkills();
+ * if (installed.includes('my-skill')) {
+ *   await uninstallSkill({ skillName: 'my-skill' });
+ * }
+ */
+export async function uninstallSkill(input, _context) {
+    const { skillName, force } = input;
+    try {
+        // Load manifest
+        const manifest = await loadManifest();
+        const skillEntry = manifest.installedSkills[skillName];
+        // Check if skill exists in manifest
+        if (!skillEntry) {
+            // Still try to check the filesystem
+            const potentialPath = path.join(CLAUDE_SKILLS_DIR, skillName);
+            try {
+                await fs.access(potentialPath);
+                // Skill exists on disk but not in manifest
+                if (!force) {
+                    return {
+                        success: false,
+                        skillName,
+                        message: `Skill "${skillName}" not in manifest but exists on disk. Use force=true to remove.`,
+                        warning: 'This skill was not installed via Skillsmith.',
+                    };
+                }
+                // Force remove
+                await removeDirectory(potentialPath);
+                return {
+                    success: true,
+                    skillName,
+                    message: `Skill "${skillName}" removed from disk (was not in manifest).`,
+                    removedPath: potentialPath,
+                };
+            }
+            catch {
+                return {
+                    success: false,
+                    skillName,
+                    message: `Skill "${skillName}" is not installed.`,
+                };
+            }
+        }
+        // Get install path
+        const installPath = skillEntry.installPath;
+        // Check for modifications
+        if (!force) {
+            const modified = await checkForModifications(installPath, skillEntry.installedAt);
+            if (modified) {
+                return {
+                    success: false,
+                    skillName,
+                    message: `Skill "${skillName}" has been modified since installation. Use force=true to remove anyway.`,
+                    warning: 'Local modifications will be lost if you force uninstall.',
+                };
+            }
+        }
+        // Remove skill directory
+        try {
+            await removeDirectory(installPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+            // Already removed, continue to update manifest
+        }
+        // Update manifest
+        delete manifest.installedSkills[skillName];
+        await saveManifest(manifest);
+        return {
+            success: true,
+            skillName,
+            message: `Skill "${skillName}" has been uninstalled successfully.`,
+            removedPath: installPath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            skillName,
+            message: error instanceof Error ? error.message : 'Unknown error during uninstall',
+        };
+    }
+}
+/**
+ * List all skills currently installed via Skillsmith.
+ *
+ * Reads the manifest file and returns an array of skill names.
+ * This only includes skills tracked in the manifest, not skills
+ * manually placed in ~/.claude/skills/.
+ *
+ * @returns Promise resolving to array of installed skill names
+ *
+ * @example
+ * const skills = await listInstalledSkills();
+ * console.log(`${skills.length} skills installed:`);
+ * skills.forEach(s => console.log(`  - ${s}`));
+ */
+export async function listInstalledSkills() {
+    const manifest = await loadManifest();
+    return Object.keys(manifest.installedSkills);
+}
+/**
+ * MCP tool definition
+ */
+export const uninstallTool = {
+    name: 'uninstall_skill',
+    description: 'Uninstall a Claude Code skill from ~/.claude/skills/',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            skillName: {
+                type: 'string',
+                description: 'Name of the skill to uninstall',
+            },
+            force: {
+                type: 'boolean',
+                description: 'Force removal even if skill has been modified',
+            },
+        },
+        required: ['skillName'],
+    },
+};
+export default uninstallTool;
+//# sourceMappingURL=uninstall.js.map

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

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

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

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview MCP Skill Validate Tool for validating SKILL.md files
+ * @module @skillsmith/mcp-server/tools/validate
+ * @see SMI-742: Add MCP Tool skill_validate
+ *
+ * Validates skill definition files against the Skillsmith specification:
+ * - YAML frontmatter structure
+ * - Required fields (name, description)
+ * - Field length limits
+ * - Security patterns (SSRF, path traversal)
+ *
+ * @example
+ * // Basic validation
+ * const result = await executeValidate({
+ *   skill_path: '/path/to/SKILL.md'
+ * });
+ *
+ * @example
+ * // Strict validation
+ * const result = await executeValidate({
+ *   skill_path: '/path/to/skill-directory',
+ *   strict: true
+ * });
+ */
+import { z } from 'zod';
+import type { ToolContext } from '../context.js';
+/**
+ * Zod schema for validate tool input
+ */
+export declare const validateInputSchema: z.ZodObject<{
+    /** Path to SKILL.md file or skill directory */
+    skill_path: z.ZodString;
+    /** Enable strict validation (default false) */
+    strict: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    skill_path: string;
+    strict: boolean;
+}, {
+    skill_path: string;
+    strict?: boolean | undefined;
+}>;
+/**
+ * Input type (before parsing, allows optional fields)
+ */
+export type ValidateInput = z.input<typeof validateInputSchema>;
+/**
+ * Validation error with severity
+ */
+export interface ValidationError {
+    /** Field that has the error */
+    field: string;
+    /** Error message */
+    message: string;
+    /** Severity level */
+    severity: 'error' | 'warning';
+}
+/**
+ * Validation response
+ */
+export interface ValidateResponse {
+    /** Whether the skill is valid */
+    valid: boolean;
+    /** List of validation errors/warnings */
+    errors: ValidationError[];
+    /** Parsed metadata if valid */
+    metadata: Record<string, unknown> | null;
+    /** File path validated */
+    path: string;
+    /** Performance timing */
+    timing: {
+        totalMs: number;
+    };
+}
+/**
+ * MCP tool schema definition for skill_validate
+ */
+export declare const validateToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            skill_path: {
+                type: string;
+                description: string;
+            };
+            strict: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute skill validation.
+ *
+ * Validates a SKILL.md file against the Skillsmith specification.
+ * Checks structure, required fields, field lengths, and security patterns.
+ *
+ * @param input - Validation parameters
+ * @returns Promise resolving to validation response
+ * @throws {SkillsmithError} When path is invalid or file cannot be read
+ *
+ * @example
+ * const response = await executeValidate({
+ *   skill_path: './skills/my-skill/SKILL.md',
+ *   strict: true
+ * });
+ * if (response.valid) {
+ *   console.log('Skill is valid:', response.metadata);
+ * } else {
+ *   console.log('Errors:', response.errors);
+ * }
+ */
+export declare function executeValidate(input: ValidateInput, _context?: ToolContext): Promise<ValidateResponse>;
+/**
+ * Format validation results for terminal display
+ */
+export declare function formatValidationResults(response: ValidateResponse): string;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/tools/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,+CAA+C;;IAE/C,+CAA+C;;;;;;;;EAE/C,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACxC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;CAoB9B,CAAA;AA+TD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA2E3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAqD1E"}