claude-skills-cli 0.0.6 → 0.0.8

package/dist/validators/file-structure-validator.js

@@ -0,0 +1,125 @@
+/**
+ * File structure validation - paths, scripts, assets
+ */
+import { existsSync, readdirSync, readFileSync, statSync, } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Validate that skill directory exists and is valid
+ */
+export function validate_directory(skill_path) {
+    const errors = [];
+    if (!existsSync(skill_path)) {
+        errors.push({
+            type: 'not_found',
+            message: `Skill directory does not exist: ${skill_path}`,
+        });
+        return { valid: false, errors };
+    }
+    const stats = statSync(skill_path);
+    if (!stats.isDirectory()) {
+        errors.push({
+            type: 'not_directory',
+            message: `Path is not a directory: ${skill_path}`,
+        });
+        return { valid: false, errors };
+    }
+    return { valid: true, errors: [] };
+}
+/**
+ * Validate path formats (no Windows backslashes)
+ */
+export function validate_path_formats(content, file_name = 'SKILL.md') {
+    const invalid_paths = [];
+    const errors = [];
+    const lines = content.split('\n');
+    lines.forEach((line, index) => {
+        // Skip code blocks (they might legitimately show Windows paths as examples)
+        if (line.trim().startsWith('```'))
+            return;
+        // Detect backslashes in file paths
+        // Match patterns like: scripts\file.py, references\doc.md, etc.
+        const backslash_pattern = /(?:scripts|references|assets|examples)\\[\w\\.-]+/g;
+        const matches = line.match(backslash_pattern);
+        if (matches) {
+            matches.forEach((match) => {
+                const fixed = match.replace(/\\/g, '/');
+                // Store in validation
+                invalid_paths.push({
+                    line_number: index + 1,
+                    path: match,
+                    error: 'Windows-style backslash detected',
+                    suggested_fix: fixed,
+                });
+                errors.push({
+                    type: 'windows_path',
+                    message: `Windows-style path in ${file_name}:${index + 1}\n` +
+                        `  → Found: ${match}\n` +
+                        `  → Use: ${fixed}`,
+                });
+            });
+        }
+    });
+    return {
+        validation: { invalid_paths },
+        errors,
+    };
+}
+/**
+ * Validate scripts directory
+ */
+export function validate_scripts(skill_path) {
+    const scripts_dir = join(skill_path, 'scripts');
+    const warnings = [];
+    if (existsSync(scripts_dir)) {
+        const files = readdirSync(scripts_dir);
+        const script_files = files.filter((f) => f.endsWith('.js') ||
+            f.endsWith('.ts') ||
+            f.endsWith('.mjs') ||
+            f.endsWith('.sh'));
+        if (script_files.length === 0) {
+            warnings.push({
+                type: 'empty_directory',
+                message: 'scripts/ directory exists but is empty',
+            });
+        }
+        for (const script_file of script_files) {
+            const script_path = join(scripts_dir, script_file);
+            const stats = statSync(script_path);
+            // Check if executable (0o111 = --x--x--x)
+            if ((stats.mode & 0o111) === 0) {
+                warnings.push({
+                    type: 'not_executable',
+                    message: `Script is not executable: ${script_file}`,
+                });
+            }
+            // Check for shebang
+            const content = readFileSync(script_path, 'utf-8');
+            const first_line = content.split('\n')[0];
+            if (!first_line.startsWith('#!')) {
+                warnings.push({
+                    type: 'missing_shebang',
+                    message: `Script missing shebang: ${script_file}`,
+                });
+            }
+        }
+    }
+    return { warnings };
+}
+/**
+ * Validate assets directory
+ */
+export function validate_assets(skill_path) {
+    const assets_dir = join(skill_path, 'assets');
+    const warnings = [];
+    if (existsSync(assets_dir)) {
+        const files = readdirSync(assets_dir);
+        if (files.length === 0) {
+            warnings.push({
+                type: 'empty_directory',
+                message: 'assets/ directory exists but is empty',
+            });
+        }
+    }
+    return { warnings };
+}
+//# sourceMappingURL=file-structure-validator.js.map

package/dist/validators/file-structure-validator.js.map

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

package/dist/validators/frontmatter-validator.js

@@ -0,0 +1,165 @@
+/**
+ * YAML frontmatter validation for SKILL.md
+ */
+/**
+ * Check if content has valid YAML frontmatter
+ */
+export function has_yaml_frontmatter(content) {
+    return content.startsWith('---\n') || content.startsWith('---\r\n');
+}
+/**
+ * Check if description field spans multiple lines in raw YAML
+ */
+export function is_description_multiline(frontmatter) {
+    // Find the description line
+    const desc_line_match = frontmatter.match(/^description:\s*(.*)$/m);
+    if (!desc_line_match) {
+        return false;
+    }
+    const value_on_same_line = desc_line_match[1].trim();
+    // If there's no value on the same line as "description:", it's multi-line
+    if (!value_on_same_line) {
+        return true;
+    }
+    // Check if there are continuation lines (indented lines after description:)
+    // that are not other YAML fields
+    const lines = frontmatter.split('\n');
+    let found_desc = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.match(/^description:/)) {
+            found_desc = true;
+            continue;
+        }
+        if (found_desc) {
+            // If next line starts with spaces/tabs and is not a comment and is not another field
+            if (line.match(/^\s+\S/) &&
+                !line.trim().startsWith('#') &&
+                !line.match(/^[a-z_-]+:/)) {
+                return true;
+            }
+            // Stop checking after we hit another field or end
+            if (line.match(/^[a-z_-]+:/)) {
+                break;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Extract frontmatter and body from SKILL.md content
+ */
+export function extract_frontmatter(content) {
+    if (!has_yaml_frontmatter(content)) {
+        return {
+            name: null,
+            description: null,
+            body: content,
+            description_is_multiline: false,
+        };
+    }
+    const parts = content.split('---\n');
+    if (parts.length < 3) {
+        return {
+            name: null,
+            description: null,
+            body: content,
+            description_is_multiline: false,
+        };
+    }
+    const frontmatter = parts[1];
+    const body = parts.slice(2).join('---\n');
+    // Extract name
+    const name_match = frontmatter.match(/name:\s*(.+)/);
+    const name = name_match ? name_match[1].trim() : null;
+    // Extract description
+    const desc_match = frontmatter.match(/description:\s*(.+?)(?=\n[a-z]+:|$)/s);
+    const description = desc_match ? desc_match[1].trim() : null;
+    // Check if description spans multiple lines in the raw YAML
+    const description_is_multiline = is_description_multiline(frontmatter);
+    return { name, description, body, description_is_multiline };
+}
+/**
+ * Validate YAML frontmatter structure
+ */
+export function validate_frontmatter_structure(content) {
+    const validation = {
+        valid: true,
+        has_frontmatter: false,
+        parse_error: null,
+        missing_fields: [],
+    };
+    if (!has_yaml_frontmatter(content)) {
+        validation.valid = false;
+        validation.parse_error = 'Missing YAML frontmatter';
+        return validation;
+    }
+    validation.has_frontmatter = true;
+    const parts = content.split('---\n');
+    if (parts.length < 3) {
+        validation.valid = false;
+        validation.parse_error = 'Malformed YAML frontmatter';
+        return validation;
+    }
+    const frontmatter = parts[1];
+    // Check required fields
+    if (!frontmatter.includes('name:')) {
+        validation.missing_fields.push('name');
+        validation.valid = false;
+    }
+    if (!frontmatter.includes('description:')) {
+        validation.missing_fields.push('description');
+        validation.valid = false;
+    }
+    return validation;
+}
+/**
+ * Validate skill name format
+ */
+export function validate_name_format(name, directory_name) {
+    const validation = {
+        name,
+        format_valid: true,
+        directory_name,
+        matches_directory: true,
+        errors: [],
+    };
+    // Validate kebab-case format
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        validation.format_valid = false;
+        validation.errors.push(`Skill name must be lowercase kebab-case: '${name}'`);
+    }
+    // Check name matches directory
+    if (name !== directory_name) {
+        validation.matches_directory = false;
+        validation.errors.push(`Skill name '${name}' must match directory name '${directory_name}'`);
+    }
+    return validation;
+}
+/**
+ * Validate hard limits for name and description
+ */
+export function validate_hard_limits(name, description) {
+    const limits = {
+        name: { length: 0, limit: 64, valid: true, error: null },
+        description: { length: 0, limit: 1024, valid: true, error: null },
+    };
+    // Validate name length
+    if (name) {
+        limits.name.length = name.length;
+        if (name.length > 64) {
+            limits.name.valid = false;
+            limits.name.error = `Skill name too long (max 64 chars): ${name.length}`;
+        }
+    }
+    // Validate description length (Anthropic hard limit)
+    if (description) {
+        limits.description.length = description.length;
+        if (description.length > 1024) {
+            limits.description.valid = false;
+            limits.description.error = `Description too long (max 1024 chars per Anthropic): ${description.length}`;
+        }
+    }
+    return limits;
+}
+//# sourceMappingURL=frontmatter-validator.js.map

package/dist/validators/frontmatter-validator.js.map

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

package/dist/validators/references-validator.js

@@ -0,0 +1,125 @@
+/**
+ * References validation (Level 3 progressive disclosure)
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Check nesting depth of reference files
+ */
+function check_reference_nesting(skill_path, file_path, visited = new Set()) {
+    if (visited.has(file_path)) {
+        return { depth: 0, references: [] };
+    }
+    visited.add(file_path);
+    const full_path = join(skill_path, file_path);
+    if (!existsSync(full_path)) {
+        return { depth: 0, references: [] };
+    }
+    const content = readFileSync(full_path, 'utf-8');
+    const reference_pattern = /\[([^\]]+)\]\((references\/[^)]+\.md)\)/g;
+    const matches = [...content.matchAll(reference_pattern)];
+    const references = matches.map((m) => m[2]);
+    if (references.length === 0) {
+        return { depth: 1, references: [] };
+    }
+    // Recursively check nested references
+    let max_depth = 1;
+    for (const ref of references) {
+        const nested = check_reference_nesting(skill_path, ref, new Set(visited));
+        max_depth = Math.max(max_depth, 1 + nested.depth);
+    }
+    return { depth: max_depth, references };
+}
+/**
+ * Validate references directory and links
+ */
+export function validate_references(skill_path) {
+    const references_dir = join(skill_path, 'references');
+    const skill_md_path = join(skill_path, 'SKILL.md');
+    const files_found = [];
+    const files_referenced = [];
+    const missing_files = [];
+    const nesting_data = [];
+    const warnings = [];
+    const errors = [];
+    // Check references directory if it exists
+    if (existsSync(references_dir)) {
+        const files = readdirSync(references_dir);
+        const md_files = files.filter((f) => f.endsWith('.md'));
+        files_found.push(...md_files);
+        if (md_files.length === 0) {
+            warnings.push({
+                type: 'empty_directory',
+                message: 'references/ directory exists but is empty',
+            });
+        }
+        // Check for references in SKILL.md
+        if (existsSync(skill_md_path)) {
+            const skill_content = readFileSync(skill_md_path, 'utf-8');
+            for (const md_file of md_files) {
+                if (!skill_content.includes(md_file)) {
+                    warnings.push({
+                        type: 'orphaned_file',
+                        message: `Reference file '${md_file}' not mentioned in SKILL.md`,
+                    });
+                }
+            }
+        }
+    }
+    // Level 3 validation: Check that all referenced files exist
+    if (existsSync(skill_md_path)) {
+        const skill_content = readFileSync(skill_md_path, 'utf-8');
+        // Extract markdown links to references/ directory
+        // Matches: [text](references/file.md) or [text](references/subdir/file.md)
+        const reference_link_pattern = /\[([^\]]+)\]\((references\/[^)]+\.md)\)/g;
+        const matches = skill_content.matchAll(reference_link_pattern);
+        for (const match of matches) {
+            const link_text = match[1];
+            const file_path = match[2]; // e.g., "references/examples.md"
+            const full_path = join(skill_path, file_path);
+            files_referenced.push(file_path);
+            if (!existsSync(full_path)) {
+                missing_files.push(file_path);
+                errors.push({
+                    type: 'missing_file',
+                    message: `Referenced file not found: ${file_path}\n` +
+                        `  → Linked from: [${link_text}]\n` +
+                        `  → Create the file or remove the broken link`,
+                });
+            }
+            else {
+                // Check nesting depth
+                const nesting = check_reference_nesting(skill_path, file_path);
+                let warning = null;
+                if (nesting.depth > 1) {
+                    warning = `File has depth ${nesting.depth} (recommended: 1). Keep references one level deep from SKILL.md.`;
+                    warnings.push({
+                        type: 'nesting_depth',
+                        message: `${file_path} has nesting depth ${nesting.depth} (recommended: 1)\n` +
+                            `  → Keep references one level deep from SKILL.md for clarity`,
+                    });
+                }
+                nesting_data.push({
+                    file: file_path,
+                    references: nesting.references,
+                    depth: nesting.depth,
+                    warning,
+                });
+            }
+        }
+    }
+    // Calculate orphaned files
+    const orphaned = files_found.filter((f) => !files_referenced.some((ref) => ref.includes(f)));
+    const validation = {
+        files_found,
+        files_referenced,
+        missing_files,
+        orphaned_files: orphaned,
+        nesting: nesting_data,
+        max_nesting_depth: nesting_data.length > 0
+            ? Math.max(...nesting_data.map((n) => n.depth))
+            : 0,
+    };
+    return { validation, warnings, errors };
+}
+//# sourceMappingURL=references-validator.js.map

package/dist/validators/references-validator.js.map

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

package/dist/validators/text-analysis.js

@@ -0,0 +1,71 @@
+/**
+ * Text analysis utilities for skill validation
+ */
+/**
+ * Extract body content from SKILL.md (excluding YAML frontmatter)
+ */
+export function extract_body(content) {
+    const parts = content.split('---\n');
+    return parts.length >= 3
+        ? parts.slice(2).join('---\n').trim()
+        : content;
+}
+/**
+ * Count words in text
+ */
+export function count_words(text) {
+    return text
+        .trim()
+        .split(/\s+/)
+        .filter((w) => w.length > 0).length;
+}
+/**
+ * Estimate tokens (rough approximation: 1 word ≈ 1.3 tokens for English)
+ */
+export function estimate_tokens(word_count) {
+    return Math.round(word_count * 1.3);
+}
+/**
+ * Estimate tokens for a string by counting words and applying ratio
+ */
+export function estimate_string_tokens(text) {
+    const word_count = count_words(text);
+    return estimate_tokens(word_count);
+}
+/**
+ * Remove HTML comments from content (for line counting)
+ */
+export function strip_html_comments(text) {
+    return text.replace(/<!--[\s\S]*?-->/g, '');
+}
+/**
+ * Extract keywords from text (simplified extraction)
+ */
+export function extract_keywords(text) {
+    const words = text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 3);
+    const unique = [...new Set(words)];
+    return unique.filter((w) => ![
+        'this',
+        'that',
+        'with',
+        'from',
+        'have',
+        'will',
+        'when',
+        'what',
+        'where',
+        'which',
+        'their',
+        'them',
+        'then',
+        'than',
+        'these',
+        'those',
+        'there',
+    ].includes(w));
+}
+//# sourceMappingURL=text-analysis.js.map

package/dist/validators/text-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-analysis.js","sourceRoot":"","sources":["../../src/validators/text-analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC;QACvB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;QACrC,CAAC,CAAC,OAAO,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI;SACT,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI;SAChB,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,EAAE,CACL,CAAC;QACA,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;KACP,CAAC,QAAQ,CAAC,CAAC,CAAC,CACd,CAAC;AACH,CAAC"}

package/docs/prompt-that-started-it-all.md

@@ -0,0 +1,19 @@
+ok, you're going to become a super duper Claude skills builder, ok?
+
+I'm going to give you some resources I want you to study
+
+- https://www.anthropic.com/news/skills
+- https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
+- https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview#custom-skills-examples
+
+feel free to continue you're resource gathering outside of these
+links, there are many linked items in these links that could be of
+use!
+
+this is from an image in one of the links which is quite important!
+
+| Level | File                                      | Context Window             | # Tokens    |
+| ----- | ----------------------------------------- | -------------------------- | ----------- |
+| 1     | SKILL.md Metadata (YAML)                  | Always loaded              | ~100        |
+| 2     | SKILL.md Body (Markdown)                  | Loaded when Skill triggers | <5k         |
+| 3+    | Bundled files (text files, scripts, data) | Loaded as-needed by Claude | unlimited\* |

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "claude-skills-cli",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "CLI toolkit for creating and managing Claude Agent Skills",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
-    "claude-skills": "./dist/index.js"
+    "claude-skills-cli": "./dist/index.js"
   },
   "files": [
     "dist",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.7",
-    "@types/node": "^24.8.1",
+    "@types/node": "^24.9.0",
     "@types/archiver": "^6.0.3",
     "prettier": "^3.6.2",
     "typescript": "^5.9.3"