youmd 0.4.4 → 0.5.0

package/dist/lib/skills.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Skill engine — install, remove, resolve, sync, link.
+ *
+ * Manages the lifecycle of skills from the catalog to the filesystem.
+ * Skills are SKILL.md files with identity-aware template variables.
+ */
+import { checkTemplateReadiness } from "./skill-renderer";
+/**
+ * Get the directory for an installed skill.
+ */
+export declare function getSkillDir(skillName: string): string;
+/**
+ * Get the SKILL.md path for an installed skill.
+ */
+export declare function getSkillPath(skillName: string): string;
+/**
+ * Read a skill's SKILL.md content and frontmatter.
+ */
+export declare function readSkillFile(skillName: string): {
+    content: string;
+    metadata: Record<string, unknown>;
+} | null;
+/**
+ * Resolve a skill source to its raw markdown content.
+ *
+ * Supported sources:
+ *   bundled:path/to/file.md — relative to repo root
+ *   local:/absolute/path.md — local filesystem
+ *   github:owner/repo/path  — (future) GitHub raw content
+ */
+export declare function resolveSkillSource(source: string): string | null;
+/**
+ * Async source resolver — handles remote sources (GitHub).
+ *
+ * github:owner/repo/path → https://raw.githubusercontent.com/owner/repo/main/path
+ * Also supports full https:// URLs to raw markdown files.
+ */
+export declare function resolveSkillSourceAsync(source: string): Promise<string | null>;
+/**
+ * Install a skill from its source to ~/.youmd/skills/<name>/SKILL.md.
+ * Uses sync resolution for local/bundled, falls back to async for remote.
+ */
+export declare function installSkill(skillName: string): {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Async install — handles remote sources (GitHub, HTTPS URLs).
+ */
+export declare function installSkillAsync(skillName: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * Remove an installed skill.
+ */
+export declare function removeSkill(skillName: string): {
+    ok: boolean;
+    error?: string;
+};
+/**
+ * Use a skill — render it with current identity data.
+ * Returns the rendered content.
+ */
+export declare function useSkill(skillName: string): {
+    ok: boolean;
+    content?: string;
+    readiness?: ReturnType<typeof checkTemplateReadiness>;
+    error?: string;
+};
+/**
+ * Re-interpolate all installed skills against current identity data.
+ */
+export declare function syncAllSkills(): {
+    synced: string[];
+    errors: string[];
+};
+/**
+ * Sync only skills affected by specific identity field changes.
+ */
+export declare function syncAffectedSkills(changedFields: string[]): {
+    synced: string[];
+    errors: string[];
+};
+export type AgentTarget = "claude" | "cursor" | "codex";
+/**
+ * Link installed skills to an agent's directory.
+ *
+ * claude → .claude/skills/youmd/
+ * cursor → .cursor/rules/youmd.md (single file concatenation)
+ * codex  → .codex/skills/youmd/
+ */
+export declare function linkToAgent(target: AgentTarget): {
+    ok: boolean;
+    path?: string;
+    error?: string;
+};
+/**
+ * Initialize a project with skills: install core skills, generate CLAUDE.md,
+ * scaffold project-context/, and link to .claude/skills/.
+ */
+export declare function initProject(): {
+    ok: boolean;
+    steps: Array<{
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }>;
+};
+interface SkillMetrics {
+    skills: Record<string, {
+        uses: number;
+        installs: number;
+        lastUsed: string;
+        lastInstalled?: string;
+    }>;
+    identityFields: Record<string, {
+        references: number;
+    }>;
+    lastUpdated: string;
+}
+export declare function trackSkillEvent(skillName: string, event: "use" | "install" | "remove"): void;
+export declare function getMetrics(): SkillMetrics;
+export {};
+//# sourceMappingURL=skills.d.ts.map

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

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