psadk 1.3.3 → 1.3.5

package/build/main/lib/tools/PSSkillTool.d.ts

@@ -0,0 +1,14 @@
+import { PSAgentLogger } from '../PSAgentLogger';
+import { PSAgentTool } from '../PSAgentTool';
+import { PSSkillToolExecutionConfig, SkillExecutionResult } from '../skills/types';
+export declare class PSSkillTool extends PSAgentTool {
+    static readonly toolName = "skill";
+    private skillsPath;
+    private allowedSkills?;
+    constructor(config: PSSkillToolExecutionConfig);
+    /**
+     * Validates if a skill is allowed to be executed
+     */
+    private isSkillAllowed;
+    run(input: Record<string, any>, log?: PSAgentLogger): Promise<SkillExecutionResult>;
+}

package/build/main/lib/tools/PSSkillTool.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PSSkillTool = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const v4_1 = require("zod/v4");
+const PSAgentTool_1 = require("../PSAgentTool");
+const utils_1 = require("../skills/utils");
+const debuglogger_1 = __importDefault(require("../utils/debuglogger"));
+const dlog = (0, debuglogger_1.default)('PSAI:SkillTool:');
+//@todo arguments implementations, templated variable values expected in the arguments
+class PSSkillTool extends PSAgentTool_1.PSAgentTool {
+    constructor(config) {
+        super({
+            name: PSSkillTool.toolName,
+            description: 'Execute skills by reading their markdown content and injecting it as context. ' +
+                'Skills are reusable knowledge modules that provide specialized guidance and instructions.',
+            type: 'API',
+            local_execution: true,
+            hitl: true,
+            inputschema: {
+                url: `http://localhost/${PSSkillTool.toolName}`,
+                method: 'POST',
+                requestBody: v4_1.z.toJSONSchema(v4_1.z
+                    .object({
+                    skill_name: v4_1.z.string().meta({
+                        title: 'Skill_Name',
+                        description: 'The name of the skill to execute. Must be a valid skill name installed in the skills directory.',
+                    }),
+                    arguments: v4_1.z.string().optional().meta({
+                        title: 'Arguments',
+                        description: 'Optional arguments or context to provide to the skill. This will be included with the skill content.',
+                    }),
+                })
+                    .meta({
+                    title: `${PSSkillTool.toolName}_request_body`,
+                    description: `The request body parameters for the ${PSSkillTool.toolName} tool.`,
+                }), { io: 'input' }),
+            },
+        });
+        this.skillsPath = config.skillsPath;
+        this.allowedSkills = config.allowedSkills;
+    }
+    /**
+     * Validates if a skill is allowed to be executed
+     */
+    isSkillAllowed(skillName) {
+        if (!this.allowedSkills) {
+            return true; // No restrictions
+        }
+        return this.allowedSkills.includes(skillName);
+    }
+    async run(input, log) {
+        const logger = log || dlog;
+        // Debug logging
+        logger.info(`🔍 PSSkillTool received input:`, input);
+        // Access properties from request_body (the actual skill parameters are nested)
+        const requestBody = (input === null || input === void 0 ? void 0 : input.request_body) || input;
+        const skill_name = requestBody === null || requestBody === void 0 ? void 0 : requestBody.skill_name;
+        // Validate input
+        if (!skill_name || typeof skill_name !== 'string') {
+            throw new Error('Invalid skill name provided.');
+        }
+        // Validate skill name for security
+        if (!(0, utils_1.validateSkillName)(skill_name)) {
+            throw new Error(`Invalid skill name format: ${skill_name}. Skill names must contain only alphanumeric characters, hyphens, and underscores.`);
+        }
+        // Check if skill is allowed
+        if (!this.isSkillAllowed(skill_name)) {
+            throw new Error(`Skill not allowed: ${skill_name}. This agent is restricted to specific skills only.`);
+        }
+        // Check if skill exists on filesystem
+        if (!(0, utils_1.skillExists)(this.skillsPath, skill_name)) {
+            throw new Error(`Skill not found: ${skill_name}. Please ensure the skill is installed in ${this.skillsPath}.`);
+        }
+        try {
+            // Read skill content
+            const skillContent = await (0, utils_1.readSkillContent)(this.skillsPath, skill_name);
+            logger.info(`✅ Skill executed successfully: ${skill_name}`);
+            return {
+                status: 'success',
+                skill_name,
+                content: skillContent.content,
+                message: `Skill '${skill_name}' has been loaded and its content is now available in your context.`,
+            };
+        }
+        catch (error) {
+            logger.error(`❌ Failed to execute skill ${skill_name}:`, error);
+            if (error instanceof Error) {
+                throw new Error(`Failed to execute skill '${skill_name}': ${error.message}`);
+            }
+            throw new Error(`Unknown error occurred while executing skill '${skill_name}'`);
+        }
+    }
+}
+exports.PSSkillTool = PSSkillTool;
+PSSkillTool.toolName = 'skill';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNTa2lsbFRvb2wuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3Rvb2xzL1BTU2tpbGxUb29sLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLHVEQUF1RDtBQUN2RCwrQkFBMkI7QUFHM0IsZ0RBQTZDO0FBSzdDLDJDQUl5QjtBQUN6Qix1RUFBK0M7QUFFL0MsTUFBTSxJQUFJLEdBQUcsSUFBQSxxQkFBVyxFQUFDLGlCQUFpQixDQUFDLENBQUM7QUFFNUMsc0ZBQXNGO0FBQ3RGLE1BQWEsV0FBWSxTQUFRLHlCQUFXO0lBSzFDLFlBQVksTUFBa0M7UUFDNUMsS0FBSyxDQUFDO1lBQ0osSUFBSSxFQUFFLFdBQVcsQ0FBQyxRQUFRO1lBQzFCLFdBQVcsRUFDVCxnRkFBZ0Y7Z0JBQ2hGLDJGQUEyRjtZQUM3RixJQUFJLEVBQUUsS0FBSztZQUNYLGVBQWUsRUFBRSxJQUFJO1lBQ3JCLElBQUksRUFBRSxJQUFJO1lBQ1YsV0FBVyxFQUFFO2dCQUNYLEdBQUcsRUFBRSxvQkFBb0IsV0FBVyxDQUFDLFFBQVEsRUFBRTtnQkFDL0MsTUFBTSxFQUFFLE1BQU07Z0JBQ2QsV0FBVyxFQUFFLE1BQUMsQ0FBQyxZQUFZLENBQ3pCLE1BQUM7cUJBQ0UsTUFBTSxDQUFDO29CQUNOLFVBQVUsRUFBRSxNQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsSUFBSSxDQUFDO3dCQUMxQixLQUFLLEVBQUUsWUFBWTt3QkFDbkIsV0FBVyxFQUNULGlHQUFpRztxQkFDcEcsQ0FBQztvQkFDRixTQUFTLEVBQUUsTUFBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLElBQUksQ0FBQzt3QkFDcEMsS0FBSyxFQUFFLFdBQVc7d0JBQ2xCLFdBQVcsRUFDVCxzR0FBc0c7cUJBQ3pHLENBQUM7aUJBQ0gsQ0FBQztxQkFDRCxJQUFJLENBQUM7b0JBQ0osS0FBSyxFQUFFLEdBQUcsV0FBVyxDQUFDLFFBQVEsZUFBZTtvQkFD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

package/build/module/index.d.ts

@@ -11,3 +11,6 @@ export * from './lib/tools/PSWriteFileTool';
 export * from './lib/tools/PSSubAgentTool';
 export * from './lib/tools/PSMemoryTool';
 export * from './lib/tools/PSClarifyTool';
+export * from './lib/tools/PSSkillTool';
+export * from './lib/skills/types';
+export * from './lib/skills/utils';

package/build/module/index.js

@@ -27,4 +27,7 @@ __exportStar(require("./lib/tools/PSWriteFileTool"), exports);
 __exportStar(require("./lib/tools/PSSubAgentTool"), exports);
 __exportStar(require("./lib/tools/PSMemoryTool"), exports);
 __exportStar(require("./lib/tools/PSClarifyTool"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDZDQUEyQjtBQUMzQixnREFBOEI7QUFDOUIsc0RBQW9DO0FBQ3BDLHNEQUFvQztBQUNwQyxvREFBa0M7QUFDbEMsb0RBQWtDO0FBQ2xDLHVEQUFxQztBQUNyQyxnRUFBOEM7QUFDOUMsNkRBQTJDO0FBQzNDLDhEQUE0QztBQUM1Qyw2REFBMkM7QUFDM0MsMkRBQXlDO0FBQ3pDLDREQUEwQyJ9
+__exportStar(require("./lib/tools/PSSkillTool"), exports);
+__exportStar(require("./lib/skills/types"), exports);
+__exportStar(require("./lib/skills/utils"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDZDQUEyQjtBQUMzQixnREFBOEI7QUFDOUIsc0RBQW9DO0FBQ3BDLHNEQUFvQztBQUNwQyxvREFBa0M7QUFDbEMsb0RBQWtDO0FBQ2xDLHVEQUFxQztBQUNyQyxnRUFBOEM7QUFDOUMsNkRBQTJDO0FBQzNDLDhEQUE0QztBQUM1Qyw2REFBMkM7QUFDM0MsMkRBQXlDO0FBQ3pDLDREQUEwQztBQUMxQywwREFBd0M7QUFDeEMscURBQW1DO0FBQ25DLHFEQUFtQyJ9

package/build/module/lib/PSAgentLogger.d.ts

@@ -1,11 +1,11 @@
 export type AgentLoggerType = 'debug' | 'info' | 'error' | 'warn' | 'done';
 export interface IStreamLogger {
     log(type: string, message: string, ...optionalParams: any[]): number;
-    debug(message: string, ...optionalParams: any[]): void;
-    info(message: string, ...optionalParams: any[]): void;
-    error(message: string, ...optionalParams: any[]): void;
-    warn(message: string, ...optionalParams: any[]): void;
-    done(message: string, ...optionalParams: any[]): void;
+    debug(message: string, ...optionalParams: any[]): number;
+    info(message: string, ...optionalParams: any[]): number;
+    error(message: string, ...optionalParams: any[]): number;
+    warn(message: string, ...optionalParams: any[]): number;
+    done(message: string, ...optionalParams: any[]): number;
 }
 export declare class PSAgentLogger implements IStreamLogger {
     static id: number;

package/build/module/lib/skills/constants.d.ts

@@ -2,6 +2,7 @@ declare const SKILL_CONSTANTS: {
     SKILL_WATCH_PATTERN: string;
     SKILLS_FOLDER_WATCH_PATTERN: string;
     SLINGSHOT_DIR: string;
+    AGENTS_DIR: string;
     SKILLS_DIR: string;
     GLOBAL_SKILLS_DIR: string;
     SKILL_DEFINITION_FILE: string;

package/build/module/lib/skills/constants.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const STATIC_CONSTANTS = {
     // Directory names
     SLINGSHOT_DIR: '.slingshot',
+    AGENTS_DIR: '.agents', // Base directory for npx skills CLI
     SKILLS_DIR: 'skills',
     GLOBAL_SKILLS_DIR: 'skills', // For extension global path
     // File names
@@ -23,4 +24,4 @@ const SKILL_CONSTANTS = {
     SKILLS_FOLDER_WATCH_PATTERN: `${STATIC_CONSTANTS.SLINGSHOT_DIR}/${STATIC_CONSTANTS.SKILLS_DIR}/**`,
 };
 exports.default = SKILL_CONSTANTS;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9za2lsbHMvY29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUE7O0dBRUc7QUFDSCxNQUFNLGdCQUFnQixHQUFHO0lBQ3ZCLGtCQUFrQjtJQUNsQixhQUFhLEVBQUUsWUFBWTtJQUMzQixVQUFVLEVBQUUsUUFBUTtJQUNwQixpQkFBaUIsRUFBRSxRQUFRLEVBQUUsNEJBQTRCO0lBRXpELGFBQWE7SUFDYixxQkFBcUIsRUFBRSxVQUFVO0lBQ2pDLGFBQWEsRUFBRSxxQkFBcUI7SUFDcEMsVUFBVSxFQUFFLG1CQUFtQjtJQUUvQixTQUFTO0lBQ1QsY0FBYyxFQUFFLEdBQUcsRUFBRSxlQUFlO0NBQ3JDLENBQUM7QUFFRixNQUFNLGVBQWUsR0FBRztJQUN0QixHQUFHLGdCQUFnQjtJQUNuQix3Q0FBd0M7SUFDeEMsbUJBQW1CLEVBQUUsR0FBRyxnQkFBZ0IsQ0FBQyxhQUFhLElBQUksZ0JBQWdCLENBQUMsVUFBVSxPQUFPLGdCQUFnQixDQUFDLHFCQUFxQixFQUFFO0lBQ3BJLHlFQUF5RTtJQUN6RSwyQkFBMkIsRUFBRSxHQUFHLGdCQUFnQixDQUFDLGFBQWEsSUFBSSxnQkFBZ0IsQ0FBQyxVQUFVLEtBQUs7Q0FDbkcsQ0FBQztBQUVGLGtCQUFlLGVBQWUsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9za2lsbHMvY29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUE7O0dBRUc7QUFDSCxNQUFNLGdCQUFnQixHQUFHO0lBQ3ZCLGtCQUFrQjtJQUNsQixhQUFhLEVBQUUsWUFBWTtJQUMzQixVQUFVLEVBQUUsU0FBUyxFQUFFLG9DQUFvQztJQUMzRCxVQUFVLEVBQUUsUUFBUTtJQUNwQixpQkFBaUIsRUFBRSxRQUFRLEVBQUUsNEJBQTRCO0lBRXpELGFBQWE7SUFDYixxQkFBcUIsRUFBRSxVQUFVO0lBQ2pDLGFBQWEsRUFBRSxxQkFBcUI7SUFDcEMsVUFBVSxFQUFFLG1CQUFtQjtJQUUvQixTQUFTO0lBQ1QsY0FBYyxFQUFFLEdBQUcsRUFBRSxlQUFlO0NBQ3JDLENBQUM7QUFFRixNQUFNLGVBQWUsR0FBRztJQUN0QixHQUFHLGdCQUFnQjtJQUNuQix3Q0FBd0M7SUFDeEMsbUJBQW1CLEVBQUUsR0FBRyxnQkFBZ0IsQ0FBQyxhQUFhLElBQUksZ0JBQWdCLENBQUMsVUFBVSxPQUFPLGdCQUFnQixDQUFDLHFCQUFxQixFQUFFO0lBQ3BJLHlFQUF5RTtJQUN6RSwyQkFBMkIsRUFBRSxHQUFHLGdCQUFnQixDQUFDLGFBQWEsSUFBSSxnQkFBZ0IsQ0FBQyxVQUFVLEtBQUs7Q0FDbkcsQ0FBQztBQUVGLGtCQUFlLGVBQWUsQ0FBQyJ9

package/build/module/lib/skills/skillParser.d.ts

@@ -1,5 +1,10 @@
+import { SkillMetadata } from './types';
 /**
- * Parses a SKILL.md file to extract metadata for the registry.
+ * Parses a SKILL.md file content to extract all metadata using gray-matter
+ */
+export declare function parseSkillMetadataFromContent(content: string, skillPath: string): SkillMetadata;
+/**
+ * Parses a SKILL.md file to extract metadata for the registry (legacy format)
  * @param {string} filePath - The absolute path to the SKILL.md file.
  * @returns {Object|null} - Returns { name, description, folderPath } or null if invalid.
  */

package/build/module/lib/skills/skillParser.js

@@ -3,12 +3,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSkillMetadataFromContent = parseSkillMetadataFromContent;
 exports.default = parseSkillMetadata;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-const yaml_1 = __importDefault(require("yaml"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
 /**
- * Parses a SKILL.md file to extract metadata for the registry.
+ * Parses a SKILL.md file content to extract all metadata using gray-matter
+ */
+function parseSkillMetadataFromContent(content, skillPath) {
+    const parsed = (0, gray_matter_1.default)(content);
+    return {
+        name: parsed.data.name || 'unknown',
+        description: parsed.data.description || 'No description available',
+        version: parsed.data.version,
+        author: parsed.data.author,
+        license: parsed.data.license,
+        path: skillPath,
+    };
+}
+/**
+ * Parses a SKILL.md file to extract metadata for the registry (legacy format)
  * @param {string} filePath - The absolute path to the SKILL.md file.
  * @returns {Object|null} - Returns { name, description, folderPath } or null if invalid.
  */
@@ -18,23 +33,18 @@ function parseSkillMetadata(filePath) {
             return null;
         }
         const fileContent = node_fs_1.default.readFileSync(filePath, 'utf8');
-        // Use gray-matter to parse YAML frontmatter safely
-        const data = yaml_1.default.parse(fileContent);
-        // Validation: Name is required by the spec
-        if (!data || !data.name) {
-            return null;
-        }
-        const trimmedName = data.name.trim();
-        const trimmedDescription = data.description ? data.description.trim() : '';
+        const skillPath = node_path_1.default.dirname(filePath);
+        // Parse using the unified function
+        const fullMetadata = parseSkillMetadataFromContent(fileContent, skillPath);
+        // Return legacy format for backward compatibility
         return {
-            name: trimmedName,
-            description: trimmedDescription || 'No description provided.',
-            // We store the directory path, not the file path, as that's the "Skill Root"
-            folderPath: node_path_1.default.dirname(filePath),
+            name: fullMetadata.name,
+            description: fullMetadata.description,
+            folderPath: fullMetadata.path,
         };
     }
     catch {
         return null;
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2tpbGxQYXJzZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3NraWxscy9za2lsbFBhcnNlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQVVBLHFDQThCQztBQXhDRCxzREFBeUI7QUFDekIsMERBQTZCO0FBRTdCLGdEQUF3QjtBQUV4Qjs7OztHQUlHO0FBQ0gsU0FBd0Isa0JBQWtCLENBQ3hDLFFBQWdCO0lBRWhCLElBQUksQ0FBQztRQUNILElBQUksQ0FBQyxpQkFBRSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQzdCLE9BQU8sSUFBSSxDQUFDO1FBQ2QsQ0FBQztRQUVELE1BQU0sV0FBVyxHQUFHLGlCQUFFLENBQUMsWUFBWSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUV0RCxtREFBbUQ7UUFDbkQsTUFBTSxJQUFJLEdBQUcsY0FBSSxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUVyQywyQ0FBMkM7UUFDM0MsSUFBSSxDQUFDLElBQUksSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUN4QixPQUFPLElBQUksQ0FBQztRQUNkLENBQUM7UUFFRCxNQUFNLFdBQVcsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ3JDLE1BQU0sa0JBQWtCLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBRTNFLE9BQU87WUFDTCxJQUFJLEVBQUUsV0FBVztZQUNqQixXQUFXLEVBQUUsa0JBQWtCLElBQUksMEJBQTBCO1lBQzdELDZFQUE2RTtZQUM3RSxVQUFVLEVBQUUsbUJBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDO1NBQ25DLENBQUM7SUFDSixDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0FBQ0gsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2tpbGxQYXJzZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3NraWxscy9za2lsbFBhcnNlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQVVBLHNFQWNDO0FBT0QscUNBdUJDO0FBdERELHNEQUF5QjtBQUN6QiwwREFBNkI7QUFFN0IsOERBQWlDO0FBSWpDOztHQUVHO0FBQ0gsU0FBZ0IsNkJBQTZCLENBQzNDLE9BQWUsRUFDZixTQUFpQjtJQUVqQixNQUFNLE1BQU0sR0FBRyxJQUFBLHFCQUFNLEVBQUMsT0FBTyxDQUFDLENBQUM7SUFFL0IsT0FBTztRQUNMLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksSUFBSSxTQUFTO1FBQ25DLFdBQVcsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLFdBQVcsSUFBSSwwQkFBMEI7UUFDbEUsT0FBTyxFQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTztRQUM1QixNQUFNLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNO1FBQzFCLE9BQU8sRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU87UUFDNUIsSUFBSSxFQUFFLFNBQVM7S0FDaEIsQ0FBQztBQUNKLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsU0FBd0Isa0JBQWtCLENBQ3hDLFFBQWdCO0lBRWhCLElBQUksQ0FBQztRQUNILElBQUksQ0FBQyxpQkFBRSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQzdCLE9BQU8sSUFBSSxDQUFDO1FBQ2QsQ0FBQztRQUVELE1BQU0sV0FBVyxHQUFHLGlCQUFFLENBQUMsWUFBWSxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUN0RCxNQUFNLFNBQVMsR0FBRyxtQkFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUV6QyxtQ0FBbUM7UUFDbkMsTUFBTSxZQUFZLEdBQUcsNkJBQTZCLENBQUMsV0FBVyxFQUFFLFNBQVMsQ0FBQyxDQUFDO1FBRTNFLGtEQUFrRDtRQUNsRCxPQUFPO1lBQ0wsSUFBSSxFQUFFLFlBQVksQ0FBQyxJQUFJO1lBQ3ZCLFdBQVcsRUFBRSxZQUFZLENBQUMsV0FBVztZQUNyQyxVQUFVLEVBQUUsWUFBWSxDQUFDLElBQUk7U0FDOUIsQ0FBQztJQUNKLENBQUM7SUFBQyxNQUFNLENBQUM7UUFDUCxPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7QUFDSCxDQUFDIn0=

package/build/module/lib/skills/types.d.ts

@@ -0,0 +1,61 @@
+export interface SkillContent {
+    metadata: SkillFrontmatter;
+    content: string;
+    rawContent: string;
+}
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    dependencies?: string[];
+}
+export interface SkillSourceConfig {
+    source: string;
+    sourceType?: 'git' | 'npm' | 'local';
+    version?: string;
+    branch?: string;
+}
+export interface SkillSourcesObject {
+    [skillName: string]: SkillSourceConfig;
+}
+export interface PSSkillToolConfig {
+    skillsPath: string;
+    allowedSkills?: string[];
+    skillSources?: SkillSourcesObject;
+    autoInstall?: boolean;
+}
+export interface PSSkillToolExecutionConfig {
+    skillsPath: string;
+    allowedSkills?: string[];
+}
+export interface SkillInstallationOptions {
+    source: string;
+    skillsPath: string;
+    timeout?: number;
+}
+export interface SkillInvocation {
+    skill_name: string;
+    arguments?: string;
+}
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    path: string;
+    version?: string;
+    author?: string;
+    license?: string;
+}
+export interface SkillExecutionResult {
+    status: 'success' | 'error';
+    skill_name: string;
+    content?: string;
+    metadata?: {
+        name: string;
+        description: string;
+        version: string;
+        author: string;
+    };
+    message: string;
+    error?: string;
+}

package/build/module/lib/skills/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3NraWxscy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/build/module/lib/skills/utils.d.ts

@@ -1,3 +1,5 @@
+import { IStreamLogger } from '../PSAgentLogger';
+import { SkillContent, SkillInstallationOptions, SkillMetadata, SkillSourcesObject } from './types';
 /**
  * Gets the slingshot directories for both workspace and user levels.
  * Creates the directories if they don't exist.
@@ -8,3 +10,57 @@ export default function getSlingshotDirectories(repoRoot: string): {
     workspaceLevelSlingshotDir: string | null;
     userLevelSlingshotDir: string | null;
 };
+/**
+ * Validates skill name for security (prevents path traversal)
+ */
+export declare function validateSkillName(skillName: string): boolean;
+/**
+ * Validates skill source URL for security (prevents command injection)
+ */
+export declare function validateSkillSource(source: string): boolean;
+/**
+ * Ensures skills directory exists
+ */
+export declare function ensureSkillsDirectory(skillsPath: string): Promise<void>;
+/**
+ * Gets the path to a skill's SKILL.md file
+ * Skills are stored in the .agents/skills subdirectory as created by npx skills CLI
+ */
+export declare function getSkillFilePath(skillsPath: string, skillName: string): string;
+/**
+ * Checks if a skill exists locally
+ */
+export declare function skillExists(skillsPath: string, skillName: string): boolean;
+/**
+ * Reads skill content and parses frontmatter using skillParser
+ */
+export declare function readSkillContent(skillsPath: string, skillName: string): Promise<SkillContent>;
+/**
+ * Scans a directory for installed skills and returns metadata
+ */
+export declare function scanInstalledSkills(skillsPath: string): Promise<Map<string, SkillMetadata>>;
+/**
+ * Normalizes skill source URLs to handle common formatting issues
+ */
+export declare function normalizeSkillSource(source: string): string;
+/**
+ * Extract skill name from source URL
+ */
+export declare function extractSkillName(source: string): string;
+/**
+ * Install a skill using npx skills command (simplified)
+ */
+export declare function installSkill(options: SkillInstallationOptions): Promise<SkillMetadata>;
+/**
+ * Converts skill metadata to XML format for system prompts
+ */
+export declare function convertSkillsToSystemPromptXml(skills: SkillMetadata[]): string;
+/**
+ * Get skills XML from a skills directory scan
+ */
+export declare function getSkillsSystemPromptFromDirectory(skillsPath: string): Promise<string>;
+/**
+ * Setup skills directory and get system prompt
+ * Accepts skill sources as an object mapping skill names to source configurations
+ */
+export declare function setupSkillsAndGetPrompt(skillsPath: string, sources?: SkillSourcesObject, log?: IStreamLogger): Promise<string>;