@skillsmith/mcp-server 0.1.0

package/dist/src/tools/validate.js

@@ -0,0 +1,497 @@
+/**
+ * @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 { promises as fs } from 'fs';
+import { join } from 'path';
+import { SkillsmithError, ErrorCodes } from '@skillsmith/core';
+/**
+ * Zod schema for validate tool input
+ */
+export const validateInputSchema = z.object({
+    /** Path to SKILL.md file or skill directory */
+    skill_path: z.string().min(1, 'skill_path is required'),
+    /** Enable strict validation (default false) */
+    strict: z.boolean().default(false),
+});
+/**
+ * MCP tool schema definition for skill_validate
+ */
+export const validateToolSchema = {
+    name: 'skill_validate',
+    description: 'Validate a SKILL.md file or skill directory against Skillsmith specification. Checks structure, required fields, and security patterns.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            skill_path: {
+                type: 'string',
+                description: 'Path to SKILL.md file or skill directory containing SKILL.md',
+            },
+            strict: {
+                type: 'boolean',
+                description: 'Enable strict validation mode (default false). Strict mode treats warnings as errors.',
+                default: false,
+            },
+        },
+        required: ['skill_path'],
+    },
+};
+/**
+ * Maximum field lengths for validation
+ */
+const FIELD_LIMITS = {
+    name: 64,
+    description: 1024,
+    author: 128,
+    version: 32,
+    category: 64,
+    license: 64,
+    tagLength: 32,
+    maxTags: 20,
+};
+/**
+ * Dangerous URL patterns for SSRF prevention
+ */
+const SSRF_PATTERNS = [
+    /^file:\/\//i,
+    /^gopher:\/\//i,
+    /^dict:\/\//i,
+    /^ldap:\/\//i,
+    /localhost/i,
+    /127\.0\.0\.\d+/,
+    /0\.0\.0\.0/,
+    /\[::1\]/,
+    /10\.\d+\.\d+\.\d+/,
+    /172\.(1[6-9]|2\d|3[01])\.\d+\.\d+/,
+    /192\.168\.\d+\.\d+/,
+];
+/**
+ * Path traversal patterns
+ */
+const PATH_TRAVERSAL_PATTERNS = [/\.\./, /\.\.%2[fF]/, /%2[eE]%2[eE]/, /\\\.\\./];
+/**
+ * Parse YAML frontmatter from markdown content
+ */
+function parseYamlFrontmatter(content) {
+    const trimmed = content.trim();
+    if (!trimmed.startsWith('---')) {
+        return null;
+    }
+    const endIndex = trimmed.indexOf('---', 3);
+    if (endIndex === -1) {
+        return null;
+    }
+    const yamlContent = trimmed.slice(3, endIndex).trim();
+    const result = {};
+    const lines = yamlContent.split('\n');
+    let currentKey = null;
+    let arrayBuffer = [];
+    let inArray = false;
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (!trimmedLine || trimmedLine.startsWith('#')) {
+            continue;
+        }
+        if (trimmedLine.startsWith('- ')) {
+            if (currentKey && inArray) {
+                const value = trimmedLine
+                    .slice(2)
+                    .trim()
+                    .replace(/^["']|["']$/g, '');
+                arrayBuffer.push(value);
+            }
+            continue;
+        }
+        const colonIndex = trimmedLine.indexOf(':');
+        if (colonIndex > 0) {
+            if (currentKey && inArray && arrayBuffer.length > 0) {
+                result[currentKey] = arrayBuffer;
+                arrayBuffer = [];
+            }
+            const key = trimmedLine.slice(0, colonIndex).trim();
+            const value = trimmedLine.slice(colonIndex + 1).trim();
+            if (value === '' || value === '|' || value === '>') {
+                currentKey = key;
+                inArray = true;
+                arrayBuffer = [];
+            }
+            else {
+                currentKey = null;
+                inArray = false;
+                let parsedValue = value;
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    parsedValue = value.slice(1, -1);
+                }
+                else if (value === 'true') {
+                    parsedValue = true;
+                }
+                else if (value === 'false') {
+                    parsedValue = false;
+                }
+                else if (/^-?\d+(\.\d+)?$/.test(value)) {
+                    parsedValue = parseFloat(value);
+                }
+                else if (value.startsWith('[') && value.endsWith(']')) {
+                    parsedValue = value
+                        .slice(1, -1)
+                        .split(',')
+                        .map((item) => item.trim().replace(/^["']|["']$/g, ''))
+                        .filter((item) => item.length > 0);
+                }
+                result[key] = parsedValue;
+            }
+        }
+    }
+    if (currentKey && inArray && arrayBuffer.length > 0) {
+        result[currentKey] = arrayBuffer;
+    }
+    return result;
+}
+/**
+ * Check for SSRF patterns in a URL
+ */
+function hasSsrfPattern(url) {
+    return SSRF_PATTERNS.some((pattern) => pattern.test(url));
+}
+/**
+ * Check for path traversal patterns
+ */
+function hasPathTraversal(path) {
+    return PATH_TRAVERSAL_PATTERNS.some((pattern) => pattern.test(path));
+}
+/**
+ * Validate skill metadata
+ */
+function validateMetadata(metadata, strict) {
+    const errors = [];
+    // Required fields
+    if (!metadata.name) {
+        errors.push({
+            field: 'name',
+            message: 'Required field "name" is missing',
+            severity: 'error',
+        });
+    }
+    else if (typeof metadata.name !== 'string') {
+        errors.push({
+            field: 'name',
+            message: 'Field "name" must be a string',
+            severity: 'error',
+        });
+    }
+    else if (metadata.name.length > FIELD_LIMITS.name) {
+        errors.push({
+            field: 'name',
+            message: `Field "name" exceeds maximum length of ${FIELD_LIMITS.name} characters`,
+            severity: 'error',
+        });
+    }
+    // Description validation
+    if (!metadata.description) {
+        errors.push({
+            field: 'description',
+            message: 'Required field "description" is missing',
+            severity: strict ? 'error' : 'warning',
+        });
+    }
+    else if (typeof metadata.description !== 'string') {
+        errors.push({
+            field: 'description',
+            message: 'Field "description" must be a string',
+            severity: 'error',
+        });
+    }
+    else if (metadata.description.length > FIELD_LIMITS.description) {
+        errors.push({
+            field: 'description',
+            message: `Field "description" exceeds maximum length of ${FIELD_LIMITS.description} characters`,
+            severity: 'error',
+        });
+    }
+    // Author validation
+    if (metadata.author !== undefined) {
+        if (typeof metadata.author !== 'string') {
+            errors.push({
+                field: 'author',
+                message: 'Field "author" must be a string',
+                severity: 'error',
+            });
+        }
+        else if (metadata.author.length > FIELD_LIMITS.author) {
+            errors.push({
+                field: 'author',
+                message: `Field "author" exceeds maximum length of ${FIELD_LIMITS.author} characters`,
+                severity: 'error',
+            });
+        }
+    }
+    // Version validation
+    if (metadata.version !== undefined) {
+        if (typeof metadata.version !== 'string') {
+            errors.push({
+                field: 'version',
+                message: 'Field "version" must be a string',
+                severity: 'error',
+            });
+        }
+        else if (metadata.version.length > FIELD_LIMITS.version) {
+            errors.push({
+                field: 'version',
+                message: `Field "version" exceeds maximum length of ${FIELD_LIMITS.version} characters`,
+                severity: 'error',
+            });
+        }
+    }
+    else if (strict) {
+        errors.push({
+            field: 'version',
+            message: 'Field "version" is recommended',
+            severity: 'warning',
+        });
+    }
+    // Tags validation
+    if (metadata.tags !== undefined) {
+        if (!Array.isArray(metadata.tags)) {
+            errors.push({
+                field: 'tags',
+                message: 'Field "tags" must be an array',
+                severity: 'error',
+            });
+        }
+        else {
+            if (metadata.tags.length > FIELD_LIMITS.maxTags) {
+                errors.push({
+                    field: 'tags',
+                    message: `Field "tags" exceeds maximum count of ${FIELD_LIMITS.maxTags}`,
+                    severity: 'error',
+                });
+            }
+            for (let i = 0; i < metadata.tags.length; i++) {
+                const tag = metadata.tags[i];
+                if (typeof tag !== 'string') {
+                    errors.push({
+                        field: `tags[${i}]`,
+                        message: 'Tag must be a string',
+                        severity: 'error',
+                    });
+                }
+                else if (tag.length > FIELD_LIMITS.tagLength) {
+                    errors.push({
+                        field: `tags[${i}]`,
+                        message: `Tag exceeds maximum length of ${FIELD_LIMITS.tagLength} characters`,
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+    }
+    else if (strict) {
+        errors.push({
+            field: 'tags',
+            message: 'Field "tags" is recommended for discoverability',
+            severity: 'warning',
+        });
+    }
+    // Security: Check repository URL for SSRF
+    if (metadata.repository !== undefined) {
+        if (typeof metadata.repository !== 'string') {
+            errors.push({
+                field: 'repository',
+                message: 'Field "repository" must be a string',
+                severity: 'error',
+            });
+        }
+        else if (hasSsrfPattern(metadata.repository)) {
+            errors.push({
+                field: 'repository',
+                message: 'Field "repository" contains potentially dangerous URL pattern',
+                severity: 'error',
+            });
+        }
+    }
+    // Security: Check homepage URL for SSRF
+    if (metadata.homepage !== undefined) {
+        if (typeof metadata.homepage !== 'string') {
+            errors.push({
+                field: 'homepage',
+                message: 'Field "homepage" must be a string',
+                severity: 'error',
+            });
+        }
+        else if (hasSsrfPattern(metadata.homepage)) {
+            errors.push({
+                field: 'homepage',
+                message: 'Field "homepage" contains potentially dangerous URL pattern',
+                severity: 'error',
+            });
+        }
+    }
+    // Security: Check for path traversal in any string fields
+    for (const [key, value] of Object.entries(metadata)) {
+        if (typeof value === 'string' && hasPathTraversal(value)) {
+            errors.push({
+                field: key,
+                message: `Field "${key}" contains path traversal pattern`,
+                severity: 'error',
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * 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 async function executeValidate(input, _context) {
+    const startTime = performance.now();
+    // Validate input with Zod
+    const validated = validateInputSchema.parse(input);
+    const { skill_path, strict } = validated;
+    // Security: Check for path traversal in input path
+    if (hasPathTraversal(skill_path)) {
+        throw new SkillsmithError(ErrorCodes.VALIDATION_INVALID_TYPE, 'Path contains path traversal pattern', { details: { path: skill_path } });
+    }
+    // Determine actual file path
+    let filePath = skill_path;
+    let isDirectory = false;
+    try {
+        const stats = await fs.stat(skill_path);
+        isDirectory = stats.isDirectory();
+        if (isDirectory) {
+            filePath = join(skill_path, 'SKILL.md');
+        }
+    }
+    catch {
+        // Path doesn't exist or is inaccessible
+        throw new SkillsmithError(ErrorCodes.SKILL_NOT_FOUND, `Path not found: ${skill_path}`, {
+            details: { path: skill_path },
+        });
+    }
+    // Read file content
+    let content;
+    try {
+        content = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        throw new SkillsmithError(ErrorCodes.SKILL_NOT_FOUND, `Cannot read file: ${filePath}`, {
+            details: { path: filePath },
+        });
+    }
+    // Parse frontmatter
+    const metadata = parseYamlFrontmatter(content);
+    const errors = [];
+    if (!metadata) {
+        errors.push({
+            field: 'frontmatter',
+            message: 'Failed to parse YAML frontmatter. Ensure file starts with "---" and ends with "---"',
+            severity: 'error',
+        });
+    }
+    else {
+        // Validate metadata
+        errors.push(...validateMetadata(metadata, strict));
+    }
+    // Determine validity
+    const hasErrors = errors.some((e) => e.severity === 'error');
+    const valid = !hasErrors;
+    const endTime = performance.now();
+    return {
+        valid,
+        errors,
+        metadata: valid && metadata ? metadata : null,
+        path: filePath,
+        timing: {
+            totalMs: Math.round(endTime - startTime),
+        },
+    };
+}
+/**
+ * Format validation results for terminal display
+ */
+export function formatValidationResults(response) {
+    const lines = [];
+    lines.push('\n=== Skill Validation Results ===\n');
+    lines.push(`Path: ${response.path}`);
+    lines.push('');
+    if (response.valid) {
+        lines.push('Status: VALID');
+        lines.push('');
+        if (response.metadata) {
+            lines.push('Metadata:');
+            if (response.metadata.name) {
+                lines.push(`  Name: ${response.metadata.name}`);
+            }
+            if (response.metadata.description) {
+                const desc = String(response.metadata.description);
+                lines.push(`  Description: ${desc.slice(0, 80)}${desc.length > 80 ? '...' : ''}`);
+            }
+            if (response.metadata.author) {
+                lines.push(`  Author: ${response.metadata.author}`);
+            }
+            if (response.metadata.version) {
+                lines.push(`  Version: ${response.metadata.version}`);
+            }
+            if (response.metadata.tags && Array.isArray(response.metadata.tags)) {
+                lines.push(`  Tags: ${response.metadata.tags.join(', ')}`);
+            }
+        }
+    }
+    else {
+        lines.push('Status: INVALID');
+        lines.push('');
+    }
+    if (response.errors.length > 0) {
+        const errorCount = response.errors.filter((e) => e.severity === 'error').length;
+        const warningCount = response.errors.filter((e) => e.severity === 'warning').length;
+        lines.push(`Issues: ${errorCount} error(s), ${warningCount} warning(s)`);
+        lines.push('');
+        for (const error of response.errors) {
+            const prefix = error.severity === 'error' ? '[ERROR]' : '[WARN]';
+            lines.push(`  ${prefix} ${error.field}: ${error.message}`);
+        }
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push(`Completed in ${response.timing.totalMs}ms`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/src/utils/installed-skills.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Utility for auto-detecting installed skills from ~/.claude/skills/
+ * @module @skillsmith/mcp-server/utils/installed-skills
+ * @see SMI-906: Auto-detect installed skills from ~/.claude/skills/
+ *
+ * Scans the user's skills directory and extracts skill IDs from SKILL.md files.
+ * Falls back to folder name if no SKILL.md or no ID found in frontmatter.
+ *
+ * @example
+ * const skills = await getInstalledSkills();
+ * // Returns: ["docker", "linear", "varlock"]
+ */
+/**
+ * Result from parsing a SKILL.md file
+ */
+interface SkillMdParsed {
+    /** Skill ID from name field */
+    id: string | null;
+    /** Skill name from name field */
+    name: string | null;
+    /** Skill description from description field */
+    description: string | null;
+}
+/**
+ * Parse SKILL.md frontmatter to extract skill metadata.
+ *
+ * Extracts the `name` field from YAML frontmatter in SKILL.md files.
+ * Frontmatter is delimited by `---` lines at the start of the file.
+ *
+ * @param content - Content of the SKILL.md file
+ * @returns Parsed skill metadata, or null values if parsing fails
+ *
+ * @example
+ * const content = `---
+ * name: docker
+ * description: Docker skill
+ * ---
+ * # Docker Skill`;
+ * parseSkillMd(content); // { id: "docker", name: "docker", description: "Docker skill" }
+ */
+export declare function parseSkillMd(content: string): SkillMdParsed;
+/**
+ * Get the skill ID from a skill directory.
+ *
+ * Looks for SKILL.md in the directory and extracts the ID from frontmatter.
+ * Falls back to the directory name if no SKILL.md or no ID found.
+ *
+ * @param skillDir - Path to the skill directory
+ * @param dirName - Name of the directory (used as fallback)
+ * @returns Skill ID
+ */
+export declare function getSkillIdFromDir(skillDir: string, dirName: string): string;
+/**
+ * Auto-detect installed skills from ~/.claude/skills/ directory.
+ *
+ * Scans the skills directory for subdirectories containing SKILL.md files.
+ * Extracts the skill ID from the `name` field in SKILL.md frontmatter.
+ * Falls back to directory name if no SKILL.md or no name field found.
+ *
+ * @param skillsDir - Optional custom skills directory path (defaults to ~/.claude/skills/)
+ * @returns Promise resolving to array of skill IDs
+ *
+ * @example
+ * const skills = await getInstalledSkills();
+ * // Returns: ["docker", "linear", "varlock"]
+ *
+ * @example
+ * // With custom directory
+ * const skills = await getInstalledSkills('/path/to/custom/skills');
+ */
+export declare function getInstalledSkills(skillsDir?: string): Promise<string[]>;
+/**
+ * Synchronous version of getInstalledSkills for use in non-async contexts.
+ *
+ * @param skillsDir - Optional custom skills directory path (defaults to ~/.claude/skills/)
+ * @returns Array of skill IDs
+ */
+export declare function getInstalledSkillsSync(skillsDir?: string): string[];
+/**
+ * Get detailed information about installed skills.
+ *
+ * Returns full parsed information from SKILL.md files, not just IDs.
+ *
+ * @param skillsDir - Optional custom skills directory path
+ * @returns Array of skill information objects
+ */
+export interface InstalledSkillInfo {
+    /** Skill ID (from name field or directory name) */
+    id: string;
+    /** Directory name */
+    directory: string;
+    /** Full path to skill directory */
+    path: string;
+    /** Whether SKILL.md was found */
+    hasSkillMd: boolean;
+    /** Description from SKILL.md if available */
+    description: string | null;
+}
+export declare function getInstalledSkillsDetailed(skillsDir?: string): Promise<InstalledSkillInfo[]>;
+export {};
+//# sourceMappingURL=installed-skills.d.ts.map

package/dist/src/utils/installed-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-skills.d.ts","sourceRoot":"","sources":["../../../src/utils/installed-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;GAEG;AACH,UAAU,aAAa;IACrB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAuC3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB3E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgC9E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAgCnE;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAA;IACnB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4D/B"}