@revealui/ai 0.1.0

package/dist/skills/compat/vercel-compat.js

@@ -0,0 +1,132 @@
+/**
+ * Vercel Skills Compatibility Layer
+ *
+ * Ensures Vercel Skills work seamlessly with RevealUI's skill system.
+ */
+/**
+ * Check if a skill from Vercel is compatible with RevealUI.
+ *
+ * @param skill - Skill to check
+ * @returns true if compatible, error message if not
+ */
+export function checkVercelCompatibility(skill) {
+    // Check if skill has required fields
+    if (!skill.metadata.name) {
+        return 'Skill must have a name';
+    }
+    if (!skill.metadata.description) {
+        return 'Skill must have a description';
+    }
+    // Check compatibility field
+    if (skill.metadata.compatibility) {
+        const hasRevealUICompat = skill.metadata.compatibility.includes('universal') ||
+            skill.metadata.compatibility.includes('claude-code') ||
+            skill.metadata.compatibility.includes('anthropic');
+        if (!hasRevealUICompat) {
+            return `Skill is not compatible with RevealUI. Compatible with: ${skill.metadata.compatibility.join(', ')}`;
+        }
+    }
+    return true;
+}
+/**
+ * Normalize a Vercel skill to RevealUI format.
+ *
+ * Some Vercel skills may use different conventions or formats.
+ * This function ensures they work with RevealUI's expectations.
+ *
+ * @param skill - Skill to normalize
+ * @returns Normalized skill
+ */
+export function normalizeVercelSkill(skill) {
+    const normalized = { ...skill };
+    // Ensure compatibility includes universal if not specified
+    if (!normalized.metadata.compatibility) {
+        normalized.metadata.compatibility = ['universal'];
+    }
+    // Normalize allowed-tools format
+    // Vercel skills might use different tool names
+    if (normalized.metadata.allowedTools) {
+        normalized.metadata.allowedTools = normalized.metadata.allowedTools.map((tool) => normalizeToolName(tool));
+    }
+    return normalized;
+}
+/**
+ * Map Vercel tool names to RevealUI tool names.
+ */
+const TOOL_NAME_MAP = {
+    // Vercel Skills CLI uses these names
+    bash: 'Bash',
+    read: 'Read',
+    write: 'Write',
+    edit: 'Edit',
+    glob: 'Glob',
+    grep: 'Grep',
+    // Common variations
+    'file-read': 'Read',
+    'file-write': 'Write',
+    'file-edit': 'Edit',
+    shell: 'Bash',
+    terminal: 'Bash',
+};
+/**
+ * Normalize a tool name from Vercel format to RevealUI format.
+ *
+ * @param toolSpec - Tool specification (e.g., "bash(git:*)" or "read")
+ * @returns Normalized tool specification
+ */
+function normalizeToolName(toolSpec) {
+    // Extract tool name and filter
+    const match = toolSpec.match(/^([^(]+)(\(.*\))?$/);
+    if (!match) {
+        return toolSpec;
+    }
+    const [, toolName, filter] = match;
+    const name = toolName?.trim().toLowerCase() ?? '';
+    // Map to RevealUI tool name
+    const mappedName = TOOL_NAME_MAP[name] ?? capitalize(name);
+    // Reconstruct with filter if present
+    return filter ? `${mappedName}${filter}` : mappedName;
+}
+/**
+ * Capitalize first letter of a string.
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Convert RevealUI skill metadata to Vercel format.
+ *
+ * Useful if we want to export RevealUI skills to the Vercel ecosystem.
+ *
+ * @param metadata - RevealUI skill metadata
+ * @returns Vercel-compatible metadata
+ */
+export function toVercelFormat(metadata) {
+    const vercel = {
+        name: metadata.name,
+        description: metadata.description,
+    };
+    if (metadata.version) {
+        vercel.version = metadata.version;
+    }
+    if (metadata.license) {
+        vercel.license = metadata.license;
+    }
+    if (metadata.author) {
+        vercel.author = metadata.author;
+    }
+    if (metadata.repository) {
+        vercel.repository = metadata.repository;
+    }
+    if (metadata.tags) {
+        vercel.tags = metadata.tags;
+    }
+    if (metadata.compatibility) {
+        vercel.compatibility = metadata.compatibility;
+    }
+    // Convert allowedTools to Vercel format
+    if (metadata.allowedTools) {
+        vercel['allowed-tools'] = metadata.allowedTools.map((tool) => tool.toLowerCase()).join(' ');
+    }
+    return vercel;
+}

package/dist/skills/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agent Skills
+ *
+ * Implementation of the Agent Skills open standard (skills.sh).
+ * Allows RevealUI agents to install and use skill packages.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   globalSkillRegistry,
+ *   loadFromGitHub,
+ *   SkillActivator,
+ *   AgentSkillProvider,
+ * } from '@revealui/ai/skills'
+ *
+ * // Install a skill from GitHub
+ * await loadFromGitHub('vercel-labs/agent-skills/skills/react-best-practices', {
+ *   targetDir: registry.getSkillDirectory('react-best-practices', 'local'),
+ *   scope: 'local',
+ *   registry: globalSkillRegistry,
+ * })
+ *
+ * // Activate skills based on context
+ * const activator = new SkillActivator({ registry: globalSkillRegistry })
+ * const provider = new AgentSkillProvider({ activator })
+ *
+ * const result = await provider.injectSkillInstructions(messages, {
+ *   taskDescription: 'Refactor this React component',
+ * })
+ * ```
+ */
+export { SkillActivator, type SkillActivatorConfig } from './activation/index.js';
+export { type CatalogConfig, type CatalogMetadata, clearCatalogCache, fetchVercelCatalog, getSkillById, getSkillsByCompatibility, getSkillsByTag, getTrendingSkills, type SearchOptions, searchVercelCatalog, type VercelCatalog, type VercelCatalogSkill, type VercelSkillSearchResult, } from './catalog/index.js';
+export { batchGenerateEmbeddings, checkVercelCompatibility, enhanceSkillMetadata, formatAllowedToolsString, generateEmbeddingsForVercelSkill, isToolSupported, mapRevealUIToolsToVercel, mapVercelToolsToRevealUI, normalizeVercelSkill, REVEALUI_TO_VERCEL, REVEALUI_TOOLS, type RevealUITool, toVercelFormat, VERCEL_TO_REVEALUI, VERCEL_TOOLS, type VercelTool, } from './compat/index.js';
+export { type AgentMessage, AgentSkillProvider, type AgentSkillProviderConfig, createAgentSkillProvider, type SkillInjectionResult, } from './integration/index.js';
+export { checkVercelSkillUpdates, createSkill, type GitHubLoadOptions, type GitHubSource, isVercelCliAvailable, type LocalLoadOptions, loadAllFromDirectory, loadFromGitHub, loadFromLocal, loadFromVercelSkills, parseGitHubSource, parseVercelSource, removeSkill, type SkillTemplate, type UpdateInfo, updateFromGitHub, updateVercelSkill, type VercelLoadOptions, type VercelSource, validateGitHubSource, } from './loader/index.js';
+export { generateSkillMd, type ParsedSkillMd, parseAllowedToolsString, parseSkillMd, parseSkillMetadataOnly, validateSkillMd, } from './parser/index.js';
+export { globalSkillRegistry, SkillRegistry, type SkillStorageConfig, } from './registry/index.js';
+export { type AllowedTool, AllowedToolSchema, matchesAllowedTool, type ParsedAllowedTool, parseAllowedTool, type Skill, type SkillActivationContext, SkillActivationContextSchema, type SkillActivationResult, SkillActivationResultSchema, type SkillMetadata, SkillMetadataSchema, type SkillResource, SkillResourceSchema, SkillSchema, type SkillSource, SkillSourceSchema, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,iBAAiB,EACjB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,YAAY,EACjB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,uBAAuB,EACvB,YAAY,EACZ,sBAAsB,EACtB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,KAAK,WAAW,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,KAAK,EACV,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,mBAAmB,EACnB,WAAW,EACX,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}

package/dist/skills/index.js

@@ -0,0 +1,47 @@
+/**
+ * Agent Skills
+ *
+ * Implementation of the Agent Skills open standard (skills.sh).
+ * Allows RevealUI agents to install and use skill packages.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   globalSkillRegistry,
+ *   loadFromGitHub,
+ *   SkillActivator,
+ *   AgentSkillProvider,
+ * } from '@revealui/ai/skills'
+ *
+ * // Install a skill from GitHub
+ * await loadFromGitHub('vercel-labs/agent-skills/skills/react-best-practices', {
+ *   targetDir: registry.getSkillDirectory('react-best-practices', 'local'),
+ *   scope: 'local',
+ *   registry: globalSkillRegistry,
+ * })
+ *
+ * // Activate skills based on context
+ * const activator = new SkillActivator({ registry: globalSkillRegistry })
+ * const provider = new AgentSkillProvider({ activator })
+ *
+ * const result = await provider.injectSkillInstructions(messages, {
+ *   taskDescription: 'Refactor this React component',
+ * })
+ * ```
+ */
+// Activation
+export { SkillActivator } from './activation/index.js';
+// Catalog
+export { clearCatalogCache, fetchVercelCatalog, getSkillById, getSkillsByCompatibility, getSkillsByTag, getTrendingSkills, searchVercelCatalog, } from './catalog/index.js';
+// Compatibility
+export { batchGenerateEmbeddings, checkVercelCompatibility, enhanceSkillMetadata, formatAllowedToolsString, generateEmbeddingsForVercelSkill, isToolSupported, mapRevealUIToolsToVercel, mapVercelToolsToRevealUI, normalizeVercelSkill, REVEALUI_TO_VERCEL, REVEALUI_TOOLS, toVercelFormat, VERCEL_TO_REVEALUI, VERCEL_TOOLS, } from './compat/index.js';
+// Integration
+export { AgentSkillProvider, createAgentSkillProvider, } from './integration/index.js';
+// Loaders
+export { checkVercelSkillUpdates, createSkill, isVercelCliAvailable, loadAllFromDirectory, loadFromGitHub, loadFromLocal, loadFromVercelSkills, parseGitHubSource, parseVercelSource, removeSkill, updateFromGitHub, updateVercelSkill, validateGitHubSource, } from './loader/index.js';
+// Parser
+export { generateSkillMd, parseAllowedToolsString, parseSkillMd, parseSkillMetadataOnly, validateSkillMd, } from './parser/index.js';
+// Registry
+export { globalSkillRegistry, SkillRegistry, } from './registry/index.js';
+// Types
+export { AllowedToolSchema, matchesAllowedTool, parseAllowedTool, SkillActivationContextSchema, SkillActivationResultSchema, SkillMetadataSchema, SkillResourceSchema, SkillSchema, SkillSourceSchema, } from './types.js';

package/dist/skills/integration/agent-skill-provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Agent Skill Provider
+ *
+ * Integrates skills into agent system prompts.
+ */
+import type { SkillActivator } from '../activation/index.js';
+import type { Skill, SkillActivationContext, SkillActivationResult } from '../types.js';
+/**
+ * Configuration for the agent skill provider.
+ */
+export interface AgentSkillProviderConfig {
+    /** Skill activator instance */
+    activator: SkillActivator;
+    /** Maximum tokens to use for skill instructions */
+    maxTokenBudget?: number;
+    /** Template for wrapping skill instructions */
+    instructionTemplate?: (skill: Skill) => string;
+}
+/**
+ * Message structure for agent communication.
+ */
+export interface AgentMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Result of skill injection.
+ */
+export interface SkillInjectionResult {
+    /** Updated messages with skill instructions */
+    messages: AgentMessage[];
+    /** Skills that were activated */
+    activatedSkills: Skill[];
+    /** Activation reasons */
+    activationReasons: SkillActivationResult['activationReasons'];
+    /** Total tokens used for skills (approximate) */
+    estimatedTokens: number;
+}
+/**
+ * Provider for injecting skill instructions into agent prompts.
+ */
+export declare class AgentSkillProvider {
+    private activator;
+    private maxTokenBudget;
+    private instructionTemplate;
+    constructor(config: AgentSkillProviderConfig);
+    /**
+     * Inject activated skill instructions into agent messages.
+     *
+     * @param messages - Current agent messages
+     * @param context - Activation context
+     * @returns Updated messages with skill instructions
+     */
+    injectSkillInstructions(messages: AgentMessage[], context: SkillActivationContext): Promise<SkillInjectionResult>;
+    /**
+     * Format multiple skill instructions into a single block.
+     */
+    private formatSkillInstructions;
+    /**
+     * Estimate token count for text (rough approximation).
+     * Uses ~4 characters per token as a rough estimate.
+     */
+    private estimateTokens;
+    /**
+     * Build a system prompt augmentation from activated skills.
+     *
+     * @param skills - Skills to include
+     * @returns Formatted skill instructions string
+     */
+    buildSkillPromptAugmentation(skills: Skill[]): string;
+    /**
+     * Get skill-specific tool restrictions.
+     *
+     * @param skills - Activated skills
+     * @returns Combined allowed tools from all skills
+     */
+    getToolRestrictions(skills: Skill[]): string[];
+    /**
+     * Check if a skill requires approval before execution.
+     */
+    requiresApproval(skills: Skill[]): boolean;
+    /**
+     * Get available skills for the agent to reference.
+     */
+    getAvailableSkills(): Array<{
+        name: string;
+        description: string;
+    }>;
+}
+/**
+ * Create a skill provider with common defaults.
+ */
+export declare function createAgentSkillProvider(activator: SkillActivator, options?: Partial<AgentSkillProviderConfig>): AgentSkillProvider;
+//# sourceMappingURL=agent-skill-provider.d.ts.map

package/dist/skills/integration/agent-skill-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skill-provider.d.ts","sourceRoot":"","sources":["../../../src/skills/integration/agent-skill-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEvF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,SAAS,EAAE,cAAc,CAAA;IAEzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,QAAQ,EAAE,YAAY,EAAE,CAAA;IAExB,iCAAiC;IACjC,eAAe,EAAE,KAAK,EAAE,CAAA;IAExB,yBAAyB;IACzB,iBAAiB,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAA;IAE7D,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,mBAAmB,CAA0B;gBAEzC,MAAM,EAAE,wBAAwB;IAM5C;;;;;;OAMG;IACG,uBAAuB,CAC3B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA8ChC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;OAKG;IACH,4BAA4B,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM;IAsBrD;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE;IAc9C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO;IAI1C;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAGnE;AAuBD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAC1C,kBAAkB,CAKpB"}

package/dist/skills/integration/agent-skill-provider.js

@@ -0,0 +1,161 @@
+/**
+ * Agent Skill Provider
+ *
+ * Integrates skills into agent system prompts.
+ */
+/**
+ * Provider for injecting skill instructions into agent prompts.
+ */
+export class AgentSkillProvider {
+    activator;
+    maxTokenBudget;
+    instructionTemplate;
+    constructor(config) {
+        this.activator = config.activator;
+        this.maxTokenBudget = config.maxTokenBudget ?? 4000;
+        this.instructionTemplate = config.instructionTemplate ?? defaultInstructionTemplate;
+    }
+    /**
+     * Inject activated skill instructions into agent messages.
+     *
+     * @param messages - Current agent messages
+     * @param context - Activation context
+     * @returns Updated messages with skill instructions
+     */
+    async injectSkillInstructions(messages, context) {
+        // Activate skills based on context
+        const { activatedSkills, activationReasons } = await this.activator.activate(context);
+        if (activatedSkills.length === 0) {
+            return {
+                messages,
+                activatedSkills: [],
+                activationReasons: {},
+                estimatedTokens: 0,
+            };
+        }
+        // Format skill instructions
+        const skillInstructions = this.formatSkillInstructions(activatedSkills);
+        const estimatedTokens = this.estimateTokens(skillInstructions);
+        // Find system message or create one
+        const updatedMessages = [...messages];
+        const systemIndex = updatedMessages.findIndex((m) => m.role === 'system');
+        if (systemIndex >= 0) {
+            // Append to existing system message
+            const existingMessage = updatedMessages[systemIndex];
+            if (existingMessage) {
+                updatedMessages[systemIndex] = {
+                    role: existingMessage.role,
+                    content: `${existingMessage.content}\n\n${skillInstructions}`,
+                };
+            }
+        }
+        else {
+            // Prepend new system message
+            updatedMessages.unshift({
+                role: 'system',
+                content: skillInstructions,
+            });
+        }
+        return {
+            messages: updatedMessages,
+            activatedSkills,
+            activationReasons,
+            estimatedTokens,
+        };
+    }
+    /**
+     * Format multiple skill instructions into a single block.
+     */
+    formatSkillInstructions(skills) {
+        const skillBlocks = skills.map((skill) => this.instructionTemplate(skill));
+        return `<activated-skills>
+${skillBlocks.join('\n\n')}
+</activated-skills>`;
+    }
+    /**
+     * Estimate token count for text (rough approximation).
+     * Uses ~4 characters per token as a rough estimate.
+     */
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Build a system prompt augmentation from activated skills.
+     *
+     * @param skills - Skills to include
+     * @returns Formatted skill instructions string
+     */
+    buildSkillPromptAugmentation(skills) {
+        if (skills.length === 0)
+            return '';
+        let totalTokens = 0;
+        const includedSkills = [];
+        // Add skills until we hit token budget
+        for (const skill of skills) {
+            const formatted = this.instructionTemplate(skill);
+            const tokens = this.estimateTokens(formatted);
+            if (totalTokens + tokens <= this.maxTokenBudget) {
+                includedSkills.push(skill);
+                totalTokens += tokens;
+            }
+            else {
+                break;
+            }
+        }
+        return this.formatSkillInstructions(includedSkills);
+    }
+    /**
+     * Get skill-specific tool restrictions.
+     *
+     * @param skills - Activated skills
+     * @returns Combined allowed tools from all skills
+     */
+    getToolRestrictions(skills) {
+        const allTools = new Set();
+        for (const skill of skills) {
+            if (skill.metadata.allowedTools) {
+                for (const tool of skill.metadata.allowedTools) {
+                    allTools.add(tool);
+                }
+            }
+        }
+        return Array.from(allTools);
+    }
+    /**
+     * Check if a skill requires approval before execution.
+     */
+    requiresApproval(skills) {
+        return skills.some((s) => s.metadata.requiresApproval);
+    }
+    /**
+     * Get available skills for the agent to reference.
+     */
+    getAvailableSkills() {
+        return this.activator.getAvailableSkills();
+    }
+}
+/**
+ * Default template for formatting skill instructions.
+ */
+function defaultInstructionTemplate(skill) {
+    const parts = [];
+    parts.push(`<skill name="${skill.metadata.name}">`);
+    parts.push(`<description>${skill.metadata.description}</description>`);
+    if (skill.metadata.allowedTools?.length) {
+        parts.push(`<allowed-tools>${skill.metadata.allowedTools.join(', ')}</allowed-tools>`);
+    }
+    parts.push(`<instructions>`);
+    parts.push(skill.instructions);
+    parts.push(`</instructions>`);
+    parts.push(`</skill>`);
+    return parts.join('\n');
+}
+/**
+ * Create a skill provider with common defaults.
+ */
+export function createAgentSkillProvider(activator, options) {
+    return new AgentSkillProvider({
+        activator,
+        ...options,
+    });
+}

package/dist/skills/integration/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Agent Skill Integration
+ *
+ * Inject skill instructions into agent prompts.
+ */
+export { type AgentMessage, AgentSkillProvider, type AgentSkillProviderConfig, createAgentSkillProvider, type SkillInjectionResult, } from './agent-skill-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/integration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/integration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAA"}

package/dist/skills/integration/index.js

@@ -0,0 +1,6 @@
+/**
+ * Agent Skill Integration
+ *
+ * Inject skill instructions into agent prompts.
+ */
+export { AgentSkillProvider, createAgentSkillProvider, } from './agent-skill-provider.js';

package/dist/skills/loader/github-loader.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GitHub Skill Loader
+ *
+ * Install skills from GitHub repositories.
+ */
+import type { SkillRegistry } from '../registry/index.js';
+import type { Skill } from '../types.js';
+/**
+ * GitHub skill source specification.
+ *
+ * Formats:
+ * - owner/repo - Clone entire repo
+ * - owner/repo/path/to/skill - Clone specific path
+ */
+export interface GitHubSource {
+    owner: string;
+    repo: string;
+    path?: string;
+    ref?: string;
+}
+/**
+ * Parse a GitHub source string into components.
+ *
+ * @example
+ * parseGitHubSource("vercel-labs/agent-skills")
+ * // { owner: "vercel-labs", repo: "agent-skills" }
+ *
+ * parseGitHubSource("vercel-labs/agent-skills/skills/react-best-practices")
+ * // { owner: "vercel-labs", repo: "agent-skills", path: "skills/react-best-practices" }
+ */
+export declare function parseGitHubSource(source: string): GitHubSource;
+/**
+ * Options for loading from GitHub.
+ */
+export interface GitHubLoadOptions {
+    /** Target directory for installation */
+    targetDir: string;
+    /** Scope: local (project) or global */
+    scope: 'local' | 'global';
+    /** Registry to register skill with */
+    registry: SkillRegistry;
+    /** Generate embedding for semantic search */
+    generateEmbedding?: boolean;
+    /** Force reinstall if already exists */
+    force?: boolean;
+}
+/**
+ * Load a skill from a GitHub repository.
+ *
+ * Uses git sparse checkout for efficiency when loading from a subdirectory.
+ */
+export declare function loadFromGitHub(source: string, options: GitHubLoadOptions): Promise<Skill>;
+/**
+ * Update an installed skill from GitHub.
+ */
+export declare function updateFromGitHub(skillName: string, registry: SkillRegistry): Promise<Skill | undefined>;
+/**
+ * Check if a GitHub source is valid and accessible.
+ */
+export declare function validateGitHubSource(source: string): Promise<boolean>;
+//# sourceMappingURL=github-loader.d.ts.map

package/dist/skills/loader/github-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-loader.d.ts","sourceRoot":"","sources":["../../../src/skills/loader/github-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAIxC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA+B9D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IAEjB,uCAAuC;IACvC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAA;IAEzB,sCAAsC;IACtC,QAAQ,EAAE,aAAa,CAAA;IAEvB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAE3B,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC,CA8D/F;AAwDD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW3E"}