claude-skills-cli 0.0.5 → 0.0.7

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"}