@magnolia/skill-loader 0.1.0-preview.1

package/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright (c) 2026 Magnolia International Ltd.
+(http://www.magnolia-cms.com). All rights reserved.
+
+
+The software is dual-licensed under both the Magnolia
+Network Agreement and the GNU General Public License.
+You may elect to use one or the other of these licenses.
+
+The software is distributed in the hope that it will be
+useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
+implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
+Redistribution, except as permitted by whichever of the GPL
+or MNA you select, is prohibited.
+
+1. For the GPL license (GPL), you can redistribute and/or
+modify this file under the terms of the GNU General
+Public License, Version 3, as published by the Free Software
+Foundation.  You should have received a copy of the GNU
+General Public License, Version 3 along with this program;
+if not, write to the Free Software Foundation, Inc., 51
+Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+
+2. For the Magnolia Network Agreement (MNA), this file
+and the accompanying materials are made available under the
+terms of the MNA which accompanies this distribution, and
+is available at http://www.magnolia-cms.com/mna.html

package/README.md

@@ -0,0 +1,354 @@
+# @magnolia/skill-loader
+
+A Node.js library for loading, filtering, and managing AI prompt "skills" for use with LLMs.
+
+## Overview
+
+Skills are structured prompts with metadata that can be conditionally included based on context (target platform, version constraints, detected features, etc.). This library provides a flexible, type-safe way to manage these prompts across different tools and applications.
+
+## Installation
+
+```bash
+npm install @magnolia/skill-loader
+```
+
+## Quick Start
+
+### Using SkillLoader (Low-level API)
+
+```typescript
+import { SkillLoader } from '@magnolia/skill-loader';
+
+// Create a loader with a directory of skill files
+const loader = new SkillLoader()
+  .addDirectory('./skills');
+
+// Load skills filtered by context
+const skills = await loader.load({
+  target: 'freemarker',
+  version: '6.3.0',
+  detectedFieldTypes: ['textField', 'damLinkField'],
+});
+
+// Get combined prompt content
+const prompt = await loader.getPrompt({
+  target: 'freemarker',
+});
+```
+
+### Using SkillManager (High-level API with Priority Management)
+
+```typescript
+import { SkillManager } from '@magnolia/skill-loader';
+
+// Create a manager with priority-based directory loading
+const manager = new SkillManager({
+  directories: [
+    { path: './plugin-skills', priority: 1 },      // Lowest priority
+    { path: '~/.app/skills', priority: 10 },       // Medium priority
+    { path: './project/skills', priority: 100 },   // Highest priority
+  ],
+  cacheTtl: 60000, // 1 minute cache
+});
+
+// Register additional directories dynamically
+manager.registerSkillDirectory('./custom-skills', 50);
+
+// Load and use skills
+const prompt = await manager.getPrompt({ target: 'freemarker' });
+```
+
+## Skill File Format
+
+Skills are Markdown files with YAML frontmatter:
+
+```markdown
+---
+name: my-skill
+description: A helpful skill for FreeMarker templates
+targets: [freemarker]
+version: ">=6.2"
+tags: [ftl, generation]
+requires: [damLinkField]
+priority: 100
+---
+
+# My Skill
+
+Your prompt content here...
+```
+
+### Frontmatter Fields
+
+| Field         | Type     | Description                                           |
+|---------------|----------|-------------------------------------------------------|
+| `name`        | string   | Unique identifier (defaults to filename)              |
+| `description` | string   | Human-readable description                            |
+| `targets`     | string[] | Target platforms (e.g., `freemarker`, `spa`, `react`) |
+| `version`     | string   | Semver constraint (e.g., `>=6.2`, `^6.3.0`)           |
+| `tags`        | string[] | Tags for categorization and filtering                 |
+| `requires`    | string[] | Field types that must be detected for inclusion       |
+| `priority`    | number   | Sort order (higher = earlier in output)               |
+
+## API
+
+### SkillManager (Recommended)
+
+The `SkillManager` provides a high-level API for managing skills from multiple directories with configurable priority-based loading. This is the recommended approach for applications that need to manage skills from multiple sources.
+
+#### Constructor
+
+```typescript
+const manager = new SkillManager(options?)
+
+interface SkillManagerOptions {
+  directories?: SkillDirectory[];  // Directories to load, sorted by priority
+  enabled?: boolean;               // Enable/disable skill loading (default: true)
+  cacheTtl?: number;              // Cache TTL in milliseconds (default: 60000)
+  customFilter?: (skill, context) => boolean;  // Custom filter function
+  customSort?: (a, b) => number;  // Custom sort function
+}
+
+interface SkillDirectory {
+  path: string;      // Absolute or relative path to skills directory
+  priority?: number; // Priority (higher = loaded later = overrides earlier)
+}
+```
+
+#### Methods
+
+```typescript
+// Register a directory with optional priority
+manager.registerSkillDirectory(path: string, priority?: number): void
+
+// Load all skills without filtering
+const all = await manager.loadAll(): Promise<Skill[]>
+
+// Load skills filtered by context
+const filtered = await manager.load(context: SkillContext): Promise<Skill[]>
+
+// Get a single skill by name
+const skill = await manager.get(name: string): Promise<Skill | undefined>
+
+// Get combined prompt from filtered skills
+const prompt = await manager.getPrompt(
+  context: SkillContext,
+  options?: PromptOptions
+): Promise<string>
+
+// List all skills with metadata
+const list = await manager.listSkills(): Promise<SkillInfo[]>
+
+// Get registered directories with priorities
+const dirs = manager.getDirectories(): Array<{ path: string; priority: number }>
+
+// Get statistics
+const stats = manager.getStats(): {
+  totalDirectories: number;
+  enabledDirectories: number;
+  enabled: boolean;
+}
+
+// Clear cache to force reload
+manager.clearCache(): void
+```
+
+#### Priority-Based Loading
+
+Skills are loaded in priority order (lowest to highest). When multiple directories contain skills with the same name, the skill from the **higher priority** directory wins.
+
+**Example:**
+
+```typescript
+const manager = new SkillManager({
+  directories: [
+    { path: './built-in-skills', priority: 1 },    // Base skills
+    { path: './plugin-skills', priority: 10 },     // Plugin overrides
+    { path: './user-skills', priority: 100 },      // User overrides
+    { path: './project-skills', priority: 1000 },  // Project-specific (highest)
+  ],
+});
+
+// If all directories have a skill named "dialog-generation.prompt.md",
+// the one from './project-skills' will be used (highest priority)
+```
+
+#### Dynamic Registration
+
+```typescript
+const manager = new SkillManager();
+
+// Register directories dynamically
+manager.registerSkillDirectory('./core-skills', 1);
+manager.registerSkillDirectory('./plugin-a-skills', 10);
+manager.registerSkillDirectory('./plugin-b-skills', 11);
+manager.registerSkillDirectory('./user-skills', 100);
+
+// Re-registering the same path updates its priority
+manager.registerSkillDirectory('./user-skills', 200);
+```
+
+#### Disabling Skill Loading
+
+```typescript
+const manager = new SkillManager({ enabled: false });
+
+// All methods return empty results when disabled
+await manager.loadAll();      // Returns []
+await manager.getPrompt({});  // Returns ""
+```
+
+### SkillLoader (Low-level API)
+
+The `SkillLoader` provides direct control over skill sources and loading. Use this for simple use cases or when you need fine-grained control.
+
+```typescript
+const loader = new SkillLoader(options?)
+  .addDirectory(path, pattern?)  // Add a directory source
+  .addFile(path)                 // Add a single file
+  .addSkills(skills[])           // Add inline skills
+  .addUrl(url, headers?)         // Add a remote URL source
+
+// Load all skills
+const all = await loader.loadAll();
+
+// Load with filtering
+const filtered = await loader.load(context);
+
+// Get a single skill
+const skill = await loader.get('skill-name');
+
+// Get combined prompt
+const prompt = await loader.getPrompt(context, options?);
+
+// Clear cache
+loader.clearCache();
+```
+
+### Context Filtering
+
+```typescript
+interface SkillContext {
+  target?: string;            // Platform: 'freemarker', 'spa', 'react', etc.
+  version?: string;           // Version to match against constraints
+  detectedFieldTypes?: string[]; // Field types present in current context
+  requiredTags?: string[];    // Skills must have at least one of these
+  excludedTags?: string[];    // Skills with these tags are excluded
+}
+```
+
+### Standalone Functions
+
+```typescript
+import {
+  parseSkillFile,
+  createSkill,
+  filterSkills,
+  loadSkillsFromDirectory,
+} from '@magnolia/skill-loader';
+
+// Parse a skill file
+const skill = parseSkillFile(content, filename);
+
+// Create a skill programmatically
+const skill = createSkill('name', 'content', { targets: ['spa'] });
+
+// Filter skills
+const filtered = filterSkills(skills, context);
+
+// Load from directory
+const skills = await loadSkillsFromDirectory('./skills', '*.prompt.md');
+```
+
+## Filtering Logic
+
+### Target Matching
+
+Skills with `targets` are included only if the context `target` matches (case-insensitive). Skills without `targets` are always included.
+
+### Version Matching
+
+Skills with `version` are included only if the context `version` satisfies the semver constraint. Uses the [semver](https://github.com/npm/node-semver) library.
+
+### Requires Matching
+
+Skills with `requires` are only included when at least one required field type is in `detectedFieldTypes`.
+
+### Tag Filtering
+
+- `requiredTags`: Skills must have at least one matching tag
+- `excludedTags`: Skills with any matching tag are excluded
+
+## Use Cases
+
+### When to Use SkillManager
+
+Use `SkillManager` when you need:
+
+- **Multiple skill sources** with override capabilities (plugins, user configs, project-specific)
+- **Priority-based loading** where later sources override earlier ones
+- **Dynamic registration** of skill directories at runtime
+- **Centralized management** of skills across an application
+- **Easy enable/disable** of skill loading
+
+**Example:** Plugin System
+
+```typescript
+const manager = new SkillManager({
+  directories: [
+    { path: '~/.myapp/skills', priority: 100 },
+    { path: './project/skills', priority: 1000 },
+  ],
+});
+
+// Plugins register their skills dynamically
+plugins.forEach((plugin, index) => {
+  if (plugin.skillsDir) {
+    manager.registerSkillDirectory(plugin.skillsDir, 1 + index);
+  }
+});
+```
+
+### When to Use SkillLoader
+
+Use `SkillLoader` when you need:
+
+- **Simple, single-source** skill loading
+- **Fine-grained control** over sources (files, URLs, inline)
+- **Custom loading logic** without priority management
+- **Lightweight** skill loading without extra abstractions
+
+**Example:** Simple CLI Tool
+
+```typescript
+const loader = new SkillLoader()
+  .addDirectory('./skills')
+  .addFile('./custom-skill.md');
+
+const prompt = await loader.getPrompt({ target: 'react' });
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+See LICENSE.txt for license information.
+
+## Support
+
+- [GitLab Issues](https://gitlab.magnolia-platform.com/ps/extensions/ai/dev-mcp/magnolia-skill-loader/issues) **Currently Internal Access Only**
+- [Magnolia Documentation](https://docs.magnolia-cms.com)

package/dist/filter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @magnolia/skill-loader - Filtering Logic
+ *
+ * Implements skill filtering based on context (target, version, requires, tags).
+ */
+import { Skill, SkillContext } from './types.js';
+/**
+ * Filter an array of skills by context.
+ *
+ * @param skills - Array of skills to filter
+ * @param context - Context to filter against
+ * @returns Filtered and sorted array of skills
+ */
+export declare function filterSkills(skills: Skill[], context: SkillContext): Skill[];
+/**
+ * Check if a skill matches the given context.
+ *
+ * A skill is included if ALL of the following are true:
+ * 1. Target matches (if skill has targets)
+ * 2. Version satisfies constraint (if skill has version)
+ * 3. At least one required field type is detected (if skill has requires)
+ * 4. Has at least one required tag (if context has requiredTags)
+ * 5. Has none of the excluded tags (if context has excludedTags)
+ */
+export declare function matchesContext(skill: Skill, context: SkillContext): boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,KAAK,EAAE,CAc5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CA6B3E"}

package/dist/filter.js

@@ -0,0 +1,160 @@
+/**
+ * @magnolia/skill-loader - Filtering Logic
+ *
+ * Implements skill filtering based on context (target, version, requires, tags).
+ */
+import { satisfies, valid, coerce } from 'semver';
+/**
+ * Filter an array of skills by context.
+ *
+ * @param skills - Array of skills to filter
+ * @param context - Context to filter against
+ * @returns Filtered and sorted array of skills
+ */
+export function filterSkills(skills, context) {
+    const filtered = skills.filter((skill) => matchesContext(skill, context));
+    // Sort by priority (higher first), then by name for stability
+    return filtered.sort((a, b) => {
+        const priorityA = a.metadata.priority ?? 0;
+        const priorityB = b.metadata.priority ?? 0;
+        if (priorityA !== priorityB) {
+            return priorityB - priorityA; // Higher priority first
+        }
+        return a.name.localeCompare(b.name);
+    });
+}
+/**
+ * Check if a skill matches the given context.
+ *
+ * A skill is included if ALL of the following are true:
+ * 1. Target matches (if skill has targets)
+ * 2. Version satisfies constraint (if skill has version)
+ * 3. At least one required field type is detected (if skill has requires)
+ * 4. Has at least one required tag (if context has requiredTags)
+ * 5. Has none of the excluded tags (if context has excludedTags)
+ */
+export function matchesContext(skill, context) {
+    const { metadata } = skill;
+    // Check target matching
+    if (!matchesTarget(metadata.targets, context.target)) {
+        return false;
+    }
+    // Check version matching
+    if (!matchesVersion(metadata.version, context.version)) {
+        return false;
+    }
+    // Check requires matching
+    if (!matchesRequires(metadata.requires, context.detectedFieldTypes)) {
+        return false;
+    }
+    // Check required tags
+    if (!matchesRequiredTags(metadata.tags, context.requiredTags)) {
+        return false;
+    }
+    // Check excluded tags
+    if (!matchesExcludedTags(metadata.tags, context.excludedTags)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Check if skill targets match context target.
+ * Skills with no targets are included for all targets.
+ */
+function matchesTarget(skillTargets, contextTarget) {
+    // No targets on skill = universal skill
+    if (!skillTargets || skillTargets.length === 0) {
+        return true;
+    }
+    // No target in context = include all skills
+    if (!contextTarget) {
+        return true;
+    }
+    // Check if context target is in skill targets (case-insensitive)
+    const normalizedContextTarget = contextTarget.toLowerCase();
+    return skillTargets.some((target) => target.toLowerCase() === normalizedContextTarget);
+}
+/**
+ * Check if context version satisfies skill version constraint.
+ * Skills with no version constraint are included for all versions.
+ */
+function matchesVersion(skillVersion, contextVersion) {
+    // No version constraint on skill = include for all versions
+    if (!skillVersion) {
+        return true;
+    }
+    // No version in context = include skill (can't check constraint)
+    if (!contextVersion) {
+        return true;
+    }
+    // Try to coerce the context version to a valid semver
+    const coercedVersion = coerce(contextVersion);
+    if (!coercedVersion) {
+        // Can't parse context version, include the skill
+        return true;
+    }
+    // Check if version is a valid semver (might just be a simple string like "6.3")
+    const validVersion = valid(coercedVersion);
+    if (!validVersion) {
+        return true;
+    }
+    try {
+        return satisfies(validVersion, skillVersion);
+    }
+    catch {
+        // Invalid semver range, include the skill
+        return true;
+    }
+}
+/**
+ * Check if at least one required field type is detected.
+ * Skills with no requires are always included.
+ */
+function matchesRequires(skillRequires, detectedFieldTypes) {
+    // No requires on skill = always include
+    if (!skillRequires || skillRequires.length === 0) {
+        return true;
+    }
+    // No detected field types = exclude skills with requires
+    if (!detectedFieldTypes || detectedFieldTypes.length === 0) {
+        return false;
+    }
+    // Check if at least one required field type is detected
+    const normalizedDetected = new Set(detectedFieldTypes.map((f) => f.toLowerCase()));
+    return skillRequires.some((required) => normalizedDetected.has(required.toLowerCase()));
+}
+/**
+ * Check if skill has at least one of the required tags.
+ * If no required tags in context, all skills pass.
+ */
+function matchesRequiredTags(skillTags, requiredTags) {
+    // No required tags in context = all skills pass
+    if (!requiredTags || requiredTags.length === 0) {
+        return true;
+    }
+    // Required tags but skill has no tags = fail
+    if (!skillTags || skillTags.length === 0) {
+        return false;
+    }
+    // Check if skill has at least one required tag
+    const normalizedSkillTags = new Set(skillTags.map((t) => t.toLowerCase()));
+    return requiredTags.some((tag) => normalizedSkillTags.has(tag.toLowerCase()));
+}
+/**
+ * Check if skill has none of the excluded tags.
+ * If no excluded tags in context, all skills pass.
+ */
+function matchesExcludedTags(skillTags, excludedTags) {
+    // No excluded tags in context = all skills pass
+    if (!excludedTags || excludedTags.length === 0) {
+        return true;
+    }
+    // No tags on skill = can't match excluded tags, so pass
+    if (!skillTags || skillTags.length === 0) {
+        return true;
+    }
+    // Check if skill has any excluded tag (if so, fail)
+    const normalizedSkillTags = new Set(skillTags.map((t) => t.toLowerCase()));
+    return !excludedTags.some((tag) => normalizedSkillTags.has(tag.toLowerCase()));
+}
+//# sourceMappingURL=filter.js.map

package/dist/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,OAAqB;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE1E,8DAA8D;IAC9D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QAE3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,GAAG,SAAS,CAAC,CAAC,wBAAwB;QACxD,CAAC;QAED,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAAqB;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAE3B,wBAAwB;IACxB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yBAAyB;IACzB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CACpB,YAAkC,EAClC,aAAiC;IAEjC,wCAAwC;IACxC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,MAAM,uBAAuB,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAC7D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CACrB,YAAgC,EAChC,cAAkC;IAElC,4DAA4D;IAC5D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,iDAAiD;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,aAAmC,EACnC,kBAAwC;IAExC,wCAAwC;IACxC,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yDAAyD;IACzD,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wDAAwD;IACxD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAChC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC/C,CAAC;IAEF,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,SAA+B,EAC/B,YAAkC;IAElC,gDAAgD;IAChD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3E,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,SAA+B,EAC/B,YAAkC;IAElC,gDAAgD;IAChD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAChC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAC3C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @magnolia/skill-loader
+ *
+ * A Node.js library for loading, filtering, and managing AI prompt skills.
+ *
+ * @example
+ * ```typescript
+ * import { SkillLoader, createSkill } from '@magnolia/skill-loader';
+ *
+ * const loader = new SkillLoader()
+ *   .addDirectory('./skills');
+ *
+ * const skills = await loader.load({
+ *   target: 'freemarker',
+ *   version: '6.3.0',
+ *   detectedFieldTypes: ['damLinkField'],
+ * });
+ *
+ * const prompt = await loader.getPrompt({ target: 'freemarker' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { SkillLoader, loadSkills } from './loader.js';
+export { SkillManager } from './manager.js';
+export type { Skill, SkillMetadata, SkillContext, SkillSource, SkillLoaderOptions, PromptOptions, } from './types.js';
+export type { SkillManagerOptions, SkillDirectory, SkillInfo, SkillManagerLogger, } from './manager.js';
+export { SkillLoaderError } from './types.js';
+export { parseSkillFile, createSkill } from './parser.js';
+export { filterSkills, matchesContext } from './filter.js';
+export { loadSkillsFromDirectory } from './sources/directory.js';
+export { loadSkillFromFile } from './sources/file.js';
+export { loadSkillsFromUrl } from './sources/url.js';
+export { processInlineSkills } from './sources/inline.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,YAAY,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * @magnolia/skill-loader
+ *
+ * A Node.js library for loading, filtering, and managing AI prompt skills.
+ *
+ * @example
+ * ```typescript
+ * import { SkillLoader, createSkill } from '@magnolia/skill-loader';
+ *
+ * const loader = new SkillLoader()
+ *   .addDirectory('./skills');
+ *
+ * const skills = await loader.load({
+ *   target: 'freemarker',
+ *   version: '6.3.0',
+ *   detectedFieldTypes: ['damLinkField'],
+ * });
+ *
+ * const prompt = await loader.getPrompt({ target: 'freemarker' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main classes
+export { SkillLoader, loadSkills } from './loader.js';
+export { SkillManager } from './manager.js';
+// Error class (not a type-only export)
+export { SkillLoaderError } from './types.js';
+// Parser functions
+export { parseSkillFile, createSkill } from './parser.js';
+// Filter functions
+export { filterSkills, matchesContext } from './filter.js';
+// Source loaders (for advanced usage)
+export { loadSkillsFromDirectory } from './sources/directory.js';
+export { loadSkillFromFile } from './sources/file.js';
+export { loadSkillsFromUrl } from './sources/url.js';
+export { processInlineSkills } from './sources/inline.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAmB5C,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE3D,sCAAsC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}