@compilr-dev/sdk 0.10.2 → 0.10.4

package/dist/index.d.ts

@@ -68,7 +68,9 @@ export { createPlatformTools, createProjectTools, createWorkItemTools, createDoc
 export type { ProjectAnchorStoreConfig, ImageToolsConfig, ImageResizer } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
 export type { CustomSkill, CompilrSkillExtension, ForkedFromMarker, SkillEligibilityContext, SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './skills/index.js';
-export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, } from './skills/index.js';
+export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readSkillScopeConfig, readSkillScopeConfigSync, writeSkillScopeConfig, getSkillBindings, resolveSkillBinding, } from './skills/index.js';
+export type { SkillScope, SkillPromptResolution, AvailableSkillEntry, SkillSources, } from './skills/index.js';
+export { resolveSkillPrompt, getAllAvailableSkills } from './skills/index.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';

package/dist/index.js

@@ -152,7 +152,8 @@ export { createPlatformTools, createProjectTools, createWorkItemTools, createDoc
 // Platform Workflow (pure step-criteria logic)
 // =============================================================================
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
-export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, } from './skills/index.js';
+export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readSkillScopeConfig, readSkillScopeConfigSync, writeSkillScopeConfig, getSkillBindings, resolveSkillBinding, } from './skills/index.js';
+export { resolveSkillPrompt, getAllAvailableSkills } from './skills/index.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)

package/dist/skills/index.d.ts

@@ -8,4 +8,8 @@ export type { SkillEligibilityContext } from './resolver.js';
 export { resolveLayeredSkills, resolveSkillsForAgent } from './resolver.js';
 export type { SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './operations.js';
 export { detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill, } from './operations.js';
+export type { SkillScope } from './paths.js';
+export { getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readScopeConfig as readSkillScopeConfig, readScopeConfigSync as readSkillScopeConfigSync, writeScopeConfig as writeSkillScopeConfig, getAllBindings as getSkillBindings, resolveBinding as resolveSkillBinding, } from './paths.js';
+export type { SkillPromptResolution, AvailableSkillEntry, SkillSources, } from './prompt-resolver.js';
+export { resolveSkillPrompt, getAllAvailableSkills } from './prompt-resolver.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -2,4 +2,6 @@ export { RESERVED_SKILL_NAMES, isReservedSkillName } from './types.js';
 export { parseSkillMarkdown, loadSkillsFromDir } from './loader.js';
 export { resolveLayeredSkills, resolveSkillsForAgent } from './resolver.js';
 export { detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill, } from './operations.js';
+export { getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readScopeConfig as readSkillScopeConfig, readScopeConfigSync as readSkillScopeConfigSync, writeScopeConfig as writeSkillScopeConfig, getAllBindings as getSkillBindings, resolveBinding as resolveSkillBinding, } from './paths.js';
+export { resolveSkillPrompt, getAllAvailableSkills } from './prompt-resolver.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/paths.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Skill path resolution and config I/O.
+ *
+ * Portable across CLI and Desktop — takes explicit paths instead of
+ * relying on CLI-specific project detection.
+ */
+export type SkillScope = 'user' | 'project';
+/** Resolve the skills directory for a given scope. */
+export declare function getSkillsDir(scope: SkillScope, projectDir?: string): string;
+/** Ensure the skills directory exists. Returns the path. */
+export declare function ensureSkillsDir(scope: SkillScope, projectDir?: string): Promise<string>;
+/** Path to a single skill folder (no creation). */
+export declare function getSkillFolder(name: string, scope: SkillScope, projectDir?: string): string;
+/** Path to a skill's SKILL.md file. */
+export declare function getSkillFile(name: string, scope: SkillScope, projectDir?: string): string;
+/**
+ * Validate a skill name. Lowercase letters, digits, and hyphens only.
+ */
+export declare function isValidSkillName(name: string): boolean;
+/** Shape of <scope>/.compilr/config.json */
+export interface ScopeConfig {
+    slashCommands?: Record<string, string>;
+}
+/** Path to the scope config file. */
+export declare function getScopeConfigPath(scope: SkillScope, projectDir?: string): string;
+/** Read the scope config asynchronously. Returns empty object if file doesn't exist. */
+export declare function readScopeConfig(scope: SkillScope, projectDir?: string): Promise<ScopeConfig>;
+/** Read the scope config synchronously. Returns empty object if file doesn't exist. */
+export declare function readScopeConfigSync(scope: SkillScope, projectDir?: string): ScopeConfig;
+/** Write the scope config. Creates parent directories if needed. */
+export declare function writeScopeConfig(scope: SkillScope, config: ScopeConfig, projectDir?: string): Promise<void>;
+/** Get all bindings across both scopes (project takes priority). */
+export declare function getAllBindings(projectDir?: string): Promise<Record<string, {
+    skillName: string;
+    scope: SkillScope;
+}>>;
+/**
+ * Resolve a command name to a bound skill name via config.json.
+ * Synchronous — config files are tiny.
+ */
+export declare function resolveBinding(commandName: string, projectDir?: string): string | null;

package/dist/skills/paths.js

@@ -0,0 +1,118 @@
+/**
+ * Skill path resolution and config I/O.
+ *
+ * Portable across CLI and Desktop — takes explicit paths instead of
+ * relying on CLI-specific project detection.
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { readFileSync } from 'node:fs';
+// =============================================================================
+// Path Resolution
+// =============================================================================
+/** Resolve the skills directory for a given scope. */
+export function getSkillsDir(scope, projectDir) {
+    if (scope === 'user') {
+        return path.join(os.homedir(), '.compilr-dev', 'skills');
+    }
+    if (!projectDir)
+        throw new Error('projectDir required for project scope');
+    return path.join(projectDir, '.compilr', 'skills');
+}
+/** Ensure the skills directory exists. Returns the path. */
+export async function ensureSkillsDir(scope, projectDir) {
+    const dir = getSkillsDir(scope, projectDir);
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/** Path to a single skill folder (no creation). */
+export function getSkillFolder(name, scope, projectDir) {
+    return path.join(getSkillsDir(scope, projectDir), name);
+}
+/** Path to a skill's SKILL.md file. */
+export function getSkillFile(name, scope, projectDir) {
+    return path.join(getSkillFolder(name, scope, projectDir), 'SKILL.md');
+}
+/**
+ * Validate a skill name. Lowercase letters, digits, and hyphens only.
+ */
+export function isValidSkillName(name) {
+    if (!name || name.length === 0 || name.length > 64)
+        return false;
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+/** Path to the scope config file. */
+export function getScopeConfigPath(scope, projectDir) {
+    if (scope === 'user') {
+        return path.join(os.homedir(), '.compilr-dev', 'config.json');
+    }
+    if (!projectDir)
+        throw new Error('projectDir required for project scope');
+    return path.join(projectDir, '.compilr', 'config.json');
+}
+/** Read the scope config asynchronously. Returns empty object if file doesn't exist. */
+export async function readScopeConfig(scope, projectDir) {
+    try {
+        const content = await fs.readFile(getScopeConfigPath(scope, projectDir), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/** Read the scope config synchronously. Returns empty object if file doesn't exist. */
+export function readScopeConfigSync(scope, projectDir) {
+    try {
+        const content = readFileSync(getScopeConfigPath(scope, projectDir), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/** Write the scope config. Creates parent directories if needed. */
+export async function writeScopeConfig(scope, config, projectDir) {
+    const configPath = getScopeConfigPath(scope, projectDir);
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/** Get all bindings across both scopes (project takes priority). */
+export async function getAllBindings(projectDir) {
+    const result = {};
+    const userConfig = await readScopeConfig('user');
+    if (userConfig.slashCommands) {
+        for (const [cmd, skill] of Object.entries(userConfig.slashCommands)) {
+            result[cmd] = { skillName: skill, scope: 'user' };
+        }
+    }
+    if (projectDir) {
+        const projectConfig = await readScopeConfig('project', projectDir);
+        if (projectConfig.slashCommands) {
+            for (const [cmd, skill] of Object.entries(projectConfig.slashCommands)) {
+                result[cmd] = { skillName: skill, scope: 'project' };
+            }
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Binding Resolution
+// =============================================================================
+/**
+ * Resolve a command name to a bound skill name via config.json.
+ * Synchronous — config files are tiny.
+ */
+export function resolveBinding(commandName, projectDir) {
+    if (projectDir) {
+        const projectConfig = readScopeConfigSync('project', projectDir);
+        if (projectConfig.slashCommands?.[commandName]) {
+            return projectConfig.slashCommands[commandName];
+        }
+    }
+    const userConfig = readScopeConfigSync('user');
+    if (userConfig.slashCommands?.[commandName]) {
+        return userConfig.slashCommands[commandName];
+    }
+    return null;
+}

package/dist/skills/prompt-resolver.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Unified skill prompt resolver — used by both CLI and Desktop.
+ *
+ * Resolves a slash command name to a skill prompt using:
+ * 1. Binding resolution (config.json slashCommands)
+ * 2. 5-layer priority: project → user → SDK platform → agents builtin → agents-coding
+ *
+ * Also provides getAllAvailableSkills() for autocomplete/picker display.
+ */
+import type { ForkedFromMarker } from './types.js';
+/** Result of resolving a skill prompt */
+export interface SkillPromptResolution {
+    /** The resolved skill prompt text */
+    prompt: string;
+    /** The skill name that provided the prompt (may differ from input if bound) */
+    skillName: string;
+    /** Whether this was resolved via a config.json binding */
+    isBound: boolean;
+    /** Fork info if the resolved skill is forked from an SDK skill */
+    forkedFrom?: ForkedFromMarker;
+    /** Source layer where the skill was found */
+    source?: 'project' | 'user' | 'sdk' | 'agents' | 'agents-coding' | 'factory';
+}
+/** Entry in the available skills list (for autocomplete/picker) */
+export interface AvailableSkillEntry {
+    /** Skill name (used as slash command) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Where this skill comes from */
+    source: 'project' | 'user' | 'sdk' | 'agents' | 'binding';
+    /** Scope for custom skills */
+    scope?: 'user' | 'project';
+    /** Whether the skill is enabled (custom skills only) */
+    enabled?: boolean;
+    /** Whether the skill has validation warnings */
+    hasWarnings?: boolean;
+    /** For binding entries: the command name */
+    boundCommand?: string;
+    /** Whether this is a forked skill */
+    isForked?: boolean;
+}
+/** Additional skill sources that consumers can provide */
+export interface SkillSources {
+    /** Factory skills (from @compilr-dev/factory) */
+    factorySkills?: readonly {
+        name: string;
+        description: string;
+        prompt: string;
+    }[];
+    /** Coding skills (from @compilr-dev/agents-coding) */
+    codingSkills?: readonly {
+        name: string;
+        description: string;
+        prompt: string;
+    }[];
+}
+/**
+ * Resolve a slash command name to a skill prompt.
+ *
+ * Resolution order:
+ * 1. Check bindings (config.json slashCommands — project overrides user)
+ * 2. Project-scoped custom skills (<projectDir>/.compilr/skills/)
+ * 3. User-scoped custom skills (~/.compilr-dev/skills/)
+ * 4. SDK platform skills
+ * 5. Additional sources (factory, agents builtin, agents-coding)
+ *
+ * @param name - The slash command name (without leading /)
+ * @param projectDir - Project directory for project-scoped skills and bindings
+ * @param sources - Additional skill sources (factory, coding)
+ * @returns Resolution result with prompt and metadata, or null if not found
+ */
+export declare function resolveSkillPrompt(name: string, projectDir?: string, sources?: SkillSources): SkillPromptResolution | null;
+/**
+ * Get all available skills for display (autocomplete, picker, help menu).
+ *
+ * Returns a deduplicated list from all sources with metadata.
+ * Project skills override user skills override SDK skills (by name).
+ *
+ * @param projectDir - Project directory for project-scoped skills and bindings
+ * @param sources - Additional skill sources (factory, coding)
+ * @returns List of all available skills with source and metadata
+ */
+export declare function getAllAvailableSkills(projectDir?: string, sources?: SkillSources): AvailableSkillEntry[];

package/dist/skills/prompt-resolver.js

@@ -0,0 +1,235 @@
+/**
+ * Unified skill prompt resolver — used by both CLI and Desktop.
+ *
+ * Resolves a slash command name to a skill prompt using:
+ * 1. Binding resolution (config.json slashCommands)
+ * 2. 5-layer priority: project → user → SDK platform → agents builtin → agents-coding
+ *
+ * Also provides getAllAvailableSkills() for autocomplete/picker display.
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSkillMarkdown } from './loader.js';
+import { resolveBinding, getSkillsDir, readScopeConfigSync } from './paths.js';
+import { platformSkills } from './platform-skills.js';
+// Re-export builtinSkills from agents (available via SDK re-export)
+// The SDK re-exports builtinSkills from @compilr-dev/agents
+import { builtinSkills } from '@compilr-dev/agents';
+// =============================================================================
+// Prompt Resolution
+// =============================================================================
+/**
+ * Read a skill prompt from a scoped directory (project or user).
+ * Returns null if the skill doesn't exist, is disabled, or has malformed frontmatter.
+ */
+function readScopedSkillPrompt(scope, name, projectDir) {
+    try {
+        const file = join(getSkillsDir(scope, projectDir), name, 'SKILL.md');
+        if (!existsSync(file))
+            return null;
+        const content = readFileSync(file, 'utf-8');
+        const parsed = parseSkillMarkdown(content);
+        if (!parsed || parsed.enabled === false)
+            return null;
+        return parsed.prompt;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the forkedFrom marker from a scoped skill.
+ */
+function readScopedSkillForkedFrom(scope, name, projectDir) {
+    try {
+        const file = join(getSkillsDir(scope, projectDir), name, 'SKILL.md');
+        const content = readFileSync(file, 'utf-8');
+        const parsed = parseSkillMarkdown(content);
+        return parsed?.forkedFrom ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a slash command name to a skill prompt.
+ *
+ * Resolution order:
+ * 1. Check bindings (config.json slashCommands — project overrides user)
+ * 2. Project-scoped custom skills (<projectDir>/.compilr/skills/)
+ * 3. User-scoped custom skills (~/.compilr-dev/skills/)
+ * 4. SDK platform skills
+ * 5. Additional sources (factory, agents builtin, agents-coding)
+ *
+ * @param name - The slash command name (without leading /)
+ * @param projectDir - Project directory for project-scoped skills and bindings
+ * @param sources - Additional skill sources (factory, coding)
+ * @returns Resolution result with prompt and metadata, or null if not found
+ */
+export function resolveSkillPrompt(name, projectDir, sources) {
+    // 1. Check bindings
+    const boundName = resolveBinding(name, projectDir);
+    if (boundName && boundName !== name) {
+        for (const scope of ['project', 'user']) {
+            const prompt = readScopedSkillPrompt(scope, boundName, projectDir);
+            if (prompt) {
+                const forkedFrom = readScopedSkillForkedFrom(scope, boundName, projectDir);
+                return {
+                    prompt,
+                    skillName: boundName,
+                    isBound: true,
+                    forkedFrom: forkedFrom ?? undefined,
+                    source: scope,
+                };
+            }
+        }
+        // Bound skill not found — fall through to normal resolution
+    }
+    // 2. Project-scoped custom skills
+    if (projectDir) {
+        const prompt = readScopedSkillPrompt('project', name, projectDir);
+        if (prompt) {
+            return { prompt, skillName: name, isBound: false, source: 'project' };
+        }
+    }
+    // 3. User-scoped custom skills
+    {
+        const prompt = readScopedSkillPrompt('user', name);
+        if (prompt) {
+            return { prompt, skillName: name, isBound: false, source: 'user' };
+        }
+    }
+    // 4. SDK platform skills
+    const sdkSkill = platformSkills.find((s) => s.name === name);
+    if (sdkSkill) {
+        return { prompt: sdkSkill.prompt, skillName: name, isBound: false, source: 'sdk' };
+    }
+    // 5. Additional sources
+    if (sources?.factorySkills) {
+        const factorySkill = sources.factorySkills.find((s) => s.name === name);
+        if (factorySkill) {
+            return { prompt: factorySkill.prompt, skillName: name, isBound: false, source: 'factory' };
+        }
+    }
+    const agentsSkill = builtinSkills.find((s) => s.name === name);
+    if (agentsSkill) {
+        return { prompt: agentsSkill.prompt, skillName: name, isBound: false, source: 'agents' };
+    }
+    if (sources?.codingSkills) {
+        const codingSkill = sources.codingSkills.find((s) => s.name === name);
+        if (codingSkill) {
+            return {
+                prompt: codingSkill.prompt,
+                skillName: name,
+                isBound: false,
+                source: 'agents-coding',
+            };
+        }
+    }
+    return null;
+}
+// =============================================================================
+// Available Skills List
+// =============================================================================
+/**
+ * Get all available skills for display (autocomplete, picker, help menu).
+ *
+ * Returns a deduplicated list from all sources with metadata.
+ * Project skills override user skills override SDK skills (by name).
+ *
+ * @param projectDir - Project directory for project-scoped skills and bindings
+ * @param sources - Additional skill sources (factory, coding)
+ * @returns List of all available skills with source and metadata
+ */
+export function getAllAvailableSkills(projectDir, sources) {
+    const entries = [];
+    const seen = new Set();
+    // 1. Custom skills (project + user)
+    for (const scope of ['project', 'user']) {
+        try {
+            const dir = getSkillsDir(scope, scope === 'project' ? projectDir : undefined);
+            const dirEntries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of dirEntries) {
+                if (!entry.isDirectory() || seen.has(entry.name))
+                    continue;
+                seen.add(entry.name);
+                try {
+                    const content = readFileSync(join(dir, entry.name, 'SKILL.md'), 'utf-8');
+                    const parsed = parseSkillMarkdown(content);
+                    if (parsed) {
+                        entries.push({
+                            name: parsed.name,
+                            description: parsed.description,
+                            source: scope,
+                            scope,
+                            enabled: parsed.enabled !== false,
+                            hasWarnings: parsed.description.length < 60 || !parsed.prompt.trim(),
+                            isForked: !!parsed.forkedFrom,
+                        });
+                    }
+                }
+                catch {
+                    /* skip malformed */
+                }
+            }
+        }
+        catch {
+            /* dir doesn't exist */
+        }
+    }
+    // 2. SDK platform skills
+    for (const skill of platformSkills) {
+        if (!seen.has(skill.name)) {
+            seen.add(skill.name);
+            entries.push({ name: skill.name, description: skill.description, source: 'sdk' });
+        }
+    }
+    // 3. Agents builtin skills
+    for (const skill of builtinSkills) {
+        if (!seen.has(skill.name)) {
+            seen.add(skill.name);
+            entries.push({ name: skill.name, description: skill.description, source: 'agents' });
+        }
+    }
+    // 4. Additional sources
+    if (sources?.factorySkills) {
+        for (const skill of sources.factorySkills) {
+            if (!seen.has(skill.name)) {
+                seen.add(skill.name);
+                entries.push({ name: skill.name, description: skill.description, source: 'sdk' });
+            }
+        }
+    }
+    if (sources?.codingSkills) {
+        for (const skill of sources.codingSkills) {
+            if (!seen.has(skill.name)) {
+                seen.add(skill.name);
+                entries.push({ name: skill.name, description: skill.description, source: 'agents' });
+            }
+        }
+    }
+    // 5. Bound commands (as separate entries)
+    for (const scope of ['project', 'user']) {
+        try {
+            const config = readScopeConfigSync(scope, scope === 'project' ? projectDir : undefined);
+            if (config.slashCommands) {
+                for (const [cmd, skillName] of Object.entries(config.slashCommands)) {
+                    if (!seen.has(cmd)) {
+                        seen.add(cmd);
+                        entries.push({
+                            name: cmd,
+                            description: `→ ${skillName} [${scope} binding]`,
+                            source: 'binding',
+                            scope,
+                            boundCommand: cmd,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return entries;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -58,6 +58,7 @@
   "dependencies": {
     "@compilr-dev/agents": "^0.5.7",
     "@compilr-dev/logger": "^0.1.0",
+    "@compilr-dev/sdk": "^0.10.2",
     "ajv": "^6.14.0",
     "yaml": "^2.8.4"
   },