skillshield 1.0.0

package/dist/utils/errors.js

@@ -0,0 +1,130 @@
+import chalk from 'chalk';
+const ERROR_MESSAGES = {
+    PARSE_ERROR: 'Failed to parse SKILL.md file',
+    MODEL_ERROR: 'Model execution error',
+    SECURITY_ERROR: 'Security violation detected',
+    CHANNEL_ERROR: 'Channel communication error',
+    HUB_ERROR: 'Hub operation failed',
+    SANDBOX_ERROR: 'Sandbox execution error',
+    CONFIG_ERROR: 'Invalid configuration',
+    TOOL_ERROR: 'Tool execution failed',
+    TIMEOUT_ERROR: 'Operation timed out',
+    NOT_FOUND: 'Resource not found',
+    INVALID_INPUT: 'Invalid input provided',
+    PERMISSION_DENIED: 'Permission denied',
+};
+export class SkillKitError extends Error {
+    constructor(code, message, details) {
+        const fullMessage = message || ERROR_MESSAGES[code] || 'Unknown error';
+        super(fullMessage);
+        this.name = 'SkillKitError';
+        this.code = code;
+        this.details = details;
+        this.timestamp = new Date();
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, SkillKitError.prototype);
+    }
+}
+export class ParseError extends SkillKitError {
+    constructor(message, details) {
+        super('PARSE_ERROR', message, details);
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+export class ModelError extends SkillKitError {
+    constructor(message, details) {
+        super('MODEL_ERROR', message, details);
+        this.name = 'ModelError';
+        Object.setPrototypeOf(this, ModelError.prototype);
+    }
+}
+export class SecurityError extends SkillKitError {
+    constructor(message, details) {
+        super('SECURITY_ERROR', message, details);
+        this.name = 'SecurityError';
+        Object.setPrototypeOf(this, SecurityError.prototype);
+    }
+}
+export class ChannelError extends SkillKitError {
+    constructor(message, details) {
+        super('CHANNEL_ERROR', message, details);
+        this.name = 'ChannelError';
+        Object.setPrototypeOf(this, ChannelError.prototype);
+    }
+}
+export class HubError extends SkillKitError {
+    constructor(message, details) {
+        super('HUB_ERROR', message, details);
+        this.name = 'HubError';
+        Object.setPrototypeOf(this, HubError.prototype);
+    }
+}
+export class SandboxError extends SkillKitError {
+    constructor(message, details) {
+        super('SANDBOX_ERROR', message, details);
+        this.name = 'SandboxError';
+        Object.setPrototypeOf(this, SandboxError.prototype);
+    }
+}
+export class ConfigError extends SkillKitError {
+    constructor(message, details) {
+        super('CONFIG_ERROR', message, details);
+        this.name = 'ConfigError';
+        Object.setPrototypeOf(this, ConfigError.prototype);
+    }
+}
+export class ToolError extends SkillKitError {
+    constructor(message, details) {
+        super('TOOL_ERROR', message, details);
+        this.name = 'ToolError';
+        Object.setPrototypeOf(this, ToolError.prototype);
+    }
+}
+export class TimeoutError extends SkillKitError {
+    constructor(message, details) {
+        super('TIMEOUT_ERROR', message, details);
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+export function formatError(error, verbose = false) {
+    const timestamp = new Date().toISOString();
+    if (error instanceof SkillKitError) {
+        return {
+            code: error.code,
+            message: error.message,
+            details: error.details,
+            timestamp,
+            stack: verbose ? error.stack : undefined,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: 'MODEL_ERROR',
+            message: error.message,
+            timestamp,
+            stack: verbose ? error.stack : undefined,
+        };
+    }
+    return {
+        code: 'MODEL_ERROR',
+        message: String(error),
+        timestamp,
+    };
+}
+export function formatErrorForCLI(error) {
+    const formatted = formatError(error, true);
+    let output = '';
+    output += chalk.red.bold(`❌ ${formatted.code}\n`);
+    output += chalk.red(`${formatted.message}\n`);
+    if (formatted.details) {
+        output += chalk.dim(`\nDetails:\n${JSON.stringify(formatted.details, null, 2)}\n`);
+    }
+    if (formatted.stack) {
+        output += chalk.dim(`\nStack:\n${formatted.stack}\n`);
+    }
+    output += chalk.dim(`\nTime: ${formatted.timestamp}`);
+    return output;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,28 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare class Logger {
+    private minLevel;
+    private verbose;
+    private quiet;
+    private fileStream;
+    constructor(options?: {
+        level?: LogLevel;
+        verbose?: boolean;
+        quiet?: boolean;
+        logFile?: boolean;
+    });
+    private initializeFileLogging;
+    private formatTimestamp;
+    private shouldLog;
+    private writeToFile;
+    private log;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    setLevel(level: LogLevel): void;
+    setVerbose(verbose: boolean): void;
+    setQuiet(quiet: boolean): void;
+    close(): void;
+}
+export declare const defaultLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAuB3D,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,UAAU,CAAsC;gBAE5C,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAgBjG,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,GAAG;IA0BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,KAAK,IAAI,IAAI;CAMd;AAGD,eAAO,MAAM,aAAa,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,121 @@
+import chalk from 'chalk';
+import { createWriteStream, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const LEVEL_COLORS = {
+    debug: chalk.gray,
+    info: chalk.blue,
+    warn: chalk.yellow,
+    error: chalk.red,
+};
+const LEVEL_EMOJI = {
+    debug: '🐛',
+    info: 'ℹ️',
+    warn: '⚠️',
+    error: '❌',
+};
+export class Logger {
+    constructor(options) {
+        this.minLevel = 'info';
+        this.verbose = false;
+        this.quiet = false;
+        this.fileStream = null;
+        if (options?.level) {
+            this.minLevel = options.level;
+        }
+        if (options?.verbose) {
+            this.verbose = options.verbose;
+        }
+        if (options?.quiet) {
+            this.quiet = options.quiet;
+        }
+        if (options?.logFile) {
+            this.initializeFileLogging();
+        }
+    }
+    initializeFileLogging() {
+        try {
+            const logsDir = join(homedir(), '.skillkit', 'logs');
+            if (!existsSync(logsDir)) {
+                mkdirSync(logsDir, { recursive: true });
+            }
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const logPath = join(logsDir, `skillkit-${timestamp}.log`);
+            this.fileStream = createWriteStream(logPath, { flags: 'a' });
+        }
+        catch (error) {
+            // Silently fail if file logging can't be set up
+        }
+    }
+    formatTimestamp() {
+        return new Date().toISOString();
+    }
+    shouldLog(level) {
+        return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[this.minLevel];
+    }
+    writeToFile(level, message, context) {
+        if (!this.fileStream)
+            return;
+        const timestamp = this.formatTimestamp();
+        const contextStr = context ? ` ${JSON.stringify(context)}` : '';
+        const logLine = `[${timestamp}] [${level.toUpperCase()}] ${message}${contextStr}\n`;
+        this.fileStream.write(logLine);
+    }
+    log(level, message, context) {
+        if (!this.shouldLog(level))
+            return;
+        this.writeToFile(level, message, context);
+        if (this.quiet) {
+            // Output JSON only
+            console.log(JSON.stringify({ level, message, context, timestamp: this.formatTimestamp() }));
+            return;
+        }
+        const timestamp = chalk.gray(this.formatTimestamp());
+        const emoji = LEVEL_EMOJI[level];
+        const coloredLevel = LEVEL_COLORS[level](level.toUpperCase().padEnd(5));
+        let output = `${emoji} ${timestamp} [${coloredLevel}] ${message}`;
+        if (this.verbose && context) {
+            output += `\n${chalk.dim(JSON.stringify(context, null, 2))}`;
+        }
+        else if (context && level === 'error') {
+            output += `\n${chalk.dim(JSON.stringify(context, null, 2))}`;
+        }
+        console.log(output);
+    }
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    setLevel(level) {
+        this.minLevel = level;
+    }
+    setVerbose(verbose) {
+        this.verbose = verbose;
+    }
+    setQuiet(quiet) {
+        this.quiet = quiet;
+    }
+    close() {
+        if (this.fileStream) {
+            this.fileStream.end();
+            this.fileStream = null;
+        }
+    }
+}
+// Singleton instance
+export const defaultLogger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/examples/basic-usage.ts

@@ -0,0 +1,276 @@
+/**
+ * Basic SkillKit Usage Examples
+ * Demonstrates core functionality
+ */
+
+import {
+  initializeConfig,
+  getConfig,
+  SkillRunner,
+  executeSkill,
+  ModelProvider,
+} from '../src/index.js';
+
+/**
+ * Example 1: Initialize configuration
+ */
+async function example1_InitializeConfig() {
+  console.log('=== Example 1: Initialize Configuration ===\n');
+
+  // Initialize with custom config directory
+  const config = initializeConfig('/home/user/.skillkit');
+
+  // Set API keys
+  config.setApiKey(ModelProvider.ANTHROPIC, 'sk-ant-...');
+  config.setApiKey(ModelProvider.OPENAI, 'sk-proj-...');
+
+  // Set default provider
+  config.setDefaultProvider(ModelProvider.ANTHROPIC);
+
+  // Configure model
+  config.setModel(ModelProvider.ANTHROPIC, 'claude-3-5-sonnet-20241022');
+  config.setMaxTokens(4096);
+
+  // Save configuration
+  config.save();
+
+  console.log('Configuration saved to:', config.getConfigPath());
+  console.log('Default provider:', config.getDefaultProvider());
+  console.log('Default model:', config.getModel(ModelProvider.ANTHROPIC));
+}
+
+/**
+ * Example 2: Execute a simple skill
+ */
+async function example2_SimpleExecution() {
+  console.log('\n=== Example 2: Simple Skill Execution ===\n');
+
+  // Get global config
+  const config = getConfig();
+  config.setApiKey(ModelProvider.ANTHROPIC, process.env.ANTHROPIC_API_KEY!);
+  config.setDefaultProvider(ModelProvider.ANTHROPIC);
+
+  const result = await executeSkill(
+    '/path/to/skill.md', // Could be file path or registry ID
+    {
+      topic: 'machine learning',
+      language: 'spanish',
+    },
+    {
+      streaming: false,
+      timeout: 30000,
+      maxTokens: 2048,
+    }
+  );
+
+  if (result.success) {
+    console.log('Execution successful!');
+    console.log('Output:', result.outputs);
+    console.log('Duration:', result.duration, 'ms');
+    console.log('Tokens used:', result.usage?.totalTokens);
+  } else {
+    console.error('Execution failed:', result.error);
+  }
+}
+
+/**
+ * Example 3: Using SkillRunner for advanced control
+ */
+async function example3_SkillRunnerAdvanced() {
+  console.log('\n=== Example 3: Advanced SkillRunner Usage ===\n');
+
+  const runner = new SkillRunner({
+    verbose: true,
+    skipSecurityScans: false,
+  });
+
+  // Listen to execution events
+  runner.on('execution:start', (data) => {
+    console.log(`Started executing: ${data.skillName}`);
+  });
+
+  runner.on('execution:complete', (data) => {
+    console.log(`Completed executing: ${data.skillName}`);
+  });
+
+  runner.on('execution:error', (data) => {
+    console.error(`Error in ${data.executionId}:`, data.error);
+  });
+
+  // Execute with custom options
+  const result = await runner.executeSkill(
+    'search-master-5x', // From ClawHub registry
+    {
+      query: 'latest TypeScript frameworks 2026',
+      maxResults: 5,
+    },
+    {
+      provider: ModelProvider.OPENAI,
+      model: 'gpt-4-turbo',
+      streaming: true,
+      onChunk: (chunk) => {
+        if (chunk.type === 'content') {
+          console.log('Streaming:', chunk.content);
+        }
+      },
+    }
+  );
+
+  console.log('\nFinal result:', result.outputs);
+}
+
+/**
+ * Example 4: Batch execution
+ */
+async function example4_BatchExecution() {
+  console.log('\n=== Example 4: Batch Skill Execution ===\n');
+
+  const runner = new SkillRunner();
+
+  const batchResult = await runner.executeBatch({
+    skillPath: 'summarizer',
+    inputs: [
+      { text: 'Long article 1...', language: 'en' },
+      { text: 'Long article 2...', language: 'en' },
+      { text: 'Long article 3...', language: 'en' },
+    ],
+    options: {
+      provider: ModelProvider.ANTHROPIC,
+      timeout: 30000,
+    },
+    continueOnError: true,
+  });
+
+  console.log(`Batch completed: ${batchResult.succeeded}/${batchResult.total} succeeded`);
+  console.log('Total duration:', batchResult.duration, 'ms');
+
+  for (const result of batchResult.results) {
+    if ('success' in result && result.success) {
+      console.log('Success:', result.outputs);
+    } else if ('error' in result) {
+      console.error('Failed:', result.error);
+    }
+  }
+}
+
+/**
+ * Example 5: Configuration management
+ */
+async function example5_ConfigManagement() {
+  console.log('\n=== Example 5: Configuration Management ===\n');
+
+  const config = getConfig();
+
+  // Get current config
+  const fullConfig = config.getConfig();
+  console.log('Current language:', config.getLanguage());
+  console.log('Timeout:', config.getTimeout(), 'ms');
+  console.log('Security level:', config.getSecurityLevel());
+
+  // Update settings
+  config.setLanguage('es');
+  config.setTimeout(45000);
+  config.setSecurityLevel('strict');
+
+  // Custom settings
+  config.setCustom('myOrganization', 'ACME Corp');
+  config.setCustom('customApiEndpoint', 'https://api.acme.com');
+
+  console.log('\nUpdated settings:');
+  console.log('Language:', config.getLanguage());
+  console.log('Organization:', config.getCustom('myOrganization'));
+
+  // Validate API keys
+  const validation = config.validateApiKeys([
+    ModelProvider.ANTHROPIC,
+    ModelProvider.OPENAI,
+  ]);
+
+  console.log('API keys valid:', validation.valid);
+  if (!validation.valid) {
+    console.log('Missing keys:', validation.missing);
+  }
+
+  config.save();
+}
+
+/**
+ * Example 6: Multiple providers
+ */
+async function example6_MultipleProviders() {
+  console.log('\n=== Example 6: Multi-Provider Execution ===\n');
+
+  const runner = new SkillRunner();
+  const skillPath = 'content-writer';
+  const input = { topic: 'AI trends', wordCount: 500 };
+
+  const providers = [
+    ModelProvider.ANTHROPIC,
+    ModelProvider.OPENAI,
+    ModelProvider.GOOGLE,
+  ];
+
+  const results = await Promise.all(
+    providers.map((provider) =>
+      runner.executeSkill(skillPath, input, { provider })
+    )
+  );
+
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i];
+    console.log(
+      `${providers[i]} result:`,
+      result.success ? 'Success' : 'Failed'
+    );
+    console.log('  Duration:', result.duration, 'ms');
+    console.log('  Model:', result.modelUsed);
+  }
+}
+
+/**
+ * Example 7: Error handling
+ */
+async function example7_ErrorHandling() {
+  console.log('\n=== Example 7: Error Handling ===\n');
+
+  const runner = new SkillRunner();
+
+  try {
+    const result = await runner.executeSkill(
+      'nonexistent-skill',
+      { foo: 'bar' },
+      { timeout: 5000 }
+    );
+
+    if (!result.success) {
+      console.error('Execution failed:');
+      console.error('  Status:', result.status);
+      console.error('  Error:', result.error);
+    }
+  } catch (error) {
+    console.error('Error during execution:', error);
+  }
+}
+
+/**
+ * Run all examples
+ */
+async function main() {
+  try {
+    // Uncomment examples to run
+    // await example1_InitializeConfig();
+    // await example2_SimpleExecution();
+    // await example3_SkillRunnerAdvanced();
+    // await example4_BatchExecution();
+    // await example5_ConfigManagement();
+    // await example6_MultipleProviders();
+    // await example7_ErrorHandling();
+
+    console.log('\nAll examples completed!');
+  } catch (error) {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/examples/code-reviewer.skill.md

@@ -0,0 +1,83 @@
+---
+name: code-reviewer
+version: 1.0.0
+description: Review code for bugs, security issues, performance problems, and best practices
+author: ArtefactForge
+tags: [code-review, security, performance, best-practices, developer-tools]
+---
+
+# System Prompt
+
+You are a senior software engineer performing code reviews. You focus on correctness, security, performance, readability, and maintainability. You are direct and constructive — you explain WHY something is a problem and suggest a concrete fix. You never rewrite the entire code unless asked; you point to specific lines and issues.
+
+# Instructions
+
+1. Read the submitted code carefully
+2. Identify issues in this priority order:
+   - **Critical**: Bugs, security vulnerabilities, data loss risks
+   - **Warning**: Performance issues, race conditions, memory leaks
+   - **Suggestion**: Readability improvements, naming conventions, missing types
+3. For each issue, provide:
+   - The problematic line or section
+   - What the problem is
+   - A suggested fix (code snippet)
+4. End with an overall assessment (APPROVE, REQUEST CHANGES, or BLOCK)
+5. If the code is clean, say so — don't invent problems
+
+# Input
+
+The user pastes a code snippet or file. Optionally specifies the language and context.
+
+# Output Format
+
+```
+## Code Review: [filename or description]
+
+### Critical Issues
+- **Line X**: [description]
+  ```suggestion
+  // fixed code here
+  ```
+
+### Warnings
+- **Line X**: [description]
+
+### Suggestions
+- **Line X**: [description]
+
+### Verdict: [APPROVE | REQUEST CHANGES | BLOCK]
+[One sentence summary]
+```
+
+# Examples
+
+**Input:**
+```javascript
+app.get('/user/:id', (req, res) => {
+  const query = `SELECT * FROM users WHERE id = ${req.params.id}`;
+  db.query(query, (err, result) => {
+    res.json(result);
+  });
+});
+```
+
+**Output:**
+## Code Review: user endpoint
+
+### Critical Issues
+- **Line 2**: SQL injection vulnerability. User input is interpolated directly into query string.
+  ```suggestion
+  const query = 'SELECT * FROM users WHERE id = ?';
+  db.query(query, [req.params.id], (err, result) => {
+  ```
+- **Line 3**: Missing error handling. If `err` is truthy, `result` may be undefined.
+  ```suggestion
+  db.query(query, [req.params.id], (err, result) => {
+    if (err) return res.status(500).json({ error: 'Database error' });
+    if (!result.length) return res.status(404).json({ error: 'User not found' });
+    res.json(result[0]);
+  });
+  ```
+
+### Verdict: BLOCK
+SQL injection vulnerability must be fixed before merge.