@younndai/lyt-skills 0.9.0

package/dist/list.d.ts

@@ -0,0 +1,19 @@
+import { type Runtime } from "./symlink.js";
+export type SkillRuntimeState = "symlink" | "copy" | "missing" | "divergent" | "not-a-dir";
+export interface SkillRuntimeRow {
+    name: string;
+    lytVersion: string | null;
+    runtimes: Record<Runtime, SkillRuntimeState>;
+}
+export interface ListSkillsResult {
+    sourceDir: string;
+    runtimes: readonly Runtime[];
+    skills: readonly SkillRuntimeRow[];
+}
+export interface ListSkillsOptions {
+    sourceDir?: string | undefined;
+    runtimes?: readonly Runtime[] | undefined;
+    targetDirOverrides?: Partial<Record<Runtime, string>> | undefined;
+}
+export declare function listSkillsTriRuntime(opts?: ListSkillsOptions): ListSkillsResult;
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAmBA,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAsBnF"}

package/dist/list.js

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { existsSync, lstatSync, readFileSync, readlinkSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { ALL_RUNTIMES, getBundledSkillsDir, getRuntimeTargetDir, listBundledSkills, } from "./symlink.js";
+export function listSkillsTriRuntime(opts = {}) {
+    const sourceDir = opts.sourceDir ? resolve(opts.sourceDir) : getBundledSkillsDir();
+    const runtimes = opts.runtimes ?? ALL_RUNTIMES;
+    const skillNames = [...listBundledSkills(sourceDir)].sort();
+    const skills = skillNames.map((name) => {
+        const skillSourceDir = resolve(join(sourceDir, name));
+        const lytVersion = readLytVersion(join(skillSourceDir, "SKILL.md"));
+        const runtimeStates = {
+            claude: "missing",
+            codex: "missing",
+            agents: "missing",
+        };
+        for (const runtime of runtimes) {
+            const targetBase = opts.targetDirOverrides?.[runtime] ?? getRuntimeTargetDir(runtime);
+            const targetSkillDir = join(targetBase, name);
+            runtimeStates[runtime] = detectState(targetSkillDir, skillSourceDir);
+        }
+        return { name, lytVersion, runtimes: runtimeStates };
+    });
+    return { sourceDir, runtimes, skills };
+}
+function detectState(targetSkillDir, sourceSkillDir) {
+    if (!existsSync(targetSkillDir))
+        return "missing";
+    const stat = lstatSync(targetSkillDir);
+    if (stat.isSymbolicLink()) {
+        const target = resolve(readlinkSync(targetSkillDir));
+        return target === sourceSkillDir ? "symlink" : "divergent";
+    }
+    if (statSync(targetSkillDir).isDirectory())
+        return "copy";
+    return "not-a-dir";
+}
+function readLytVersion(skillMdPath) {
+    if (!existsSync(skillMdPath))
+        return null;
+    const md = readFileSync(skillMdPath, "utf8");
+    const match = md.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const fm = match[1];
+    const versionMatch = fm.match(/^lyt-version:\s*(\S.*)$/m);
+    if (!versionMatch)
+        return null;
+    return versionMatch[1].trim();
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

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

package/dist/symlink.d.ts

@@ -0,0 +1,41 @@
+export type Runtime = "claude" | "codex" | "agents";
+export declare const ALL_RUNTIMES: readonly Runtime[];
+export type SymlinkStatus = "installed-symlink" | "installed-copy" | "installed-copy-fallback" | "already-linked" | "replaced" | "divergent-symlink" | "renamed-collision" | "target-not-a-directory";
+export interface SkillRuntimeResult {
+    skill: string;
+    runtime: Runtime;
+    targetPath: string;
+    status: SymlinkStatus;
+    message?: string;
+}
+export interface SymlinkResult {
+    sourceDir: string;
+    runtimes: readonly Runtime[];
+    results: readonly SkillRuntimeResult[];
+}
+export interface SymlinkSkillsOptions {
+    sourceDir?: string | undefined;
+    runtimes?: readonly Runtime[] | undefined;
+    skillNames?: readonly string[] | undefined;
+    copy?: boolean | undefined;
+    force?: boolean | undefined;
+    targetDirOverrides?: Partial<Record<Runtime, string>> | undefined;
+    /**
+     * Test-only seam: override the low-level symlink call. Required for EPERM-
+     * fallback coverage because ESM module exports are not vi.spyOn-configurable.
+     * Production callers leave this undefined.
+     */
+    symlinkFnOverride?: ((target: string, path: string, type: "junction" | "dir") => void) | undefined;
+    /**
+     * Test-only seam: override the collision-rename timestamp. Production
+     * callers leave this undefined (real UTC clock). Tests inject a fixed stamp
+     * to exercise the repeat-collision disambiguator deterministically (W1.1
+     * test d).
+     */
+    collisionStampFn?: (() => string) | undefined;
+}
+export declare function getRuntimeTargetDir(runtime: Runtime): string;
+export declare function getBundledSkillsDir(): string;
+export declare function listBundledSkills(sourceDir: string): readonly string[];
+export declare function symlinkSkillsTriRuntime(opts?: SymlinkSkillsOptions): SymlinkResult;
+//# sourceMappingURL=symlink.d.ts.map

package/dist/symlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink.d.ts","sourceRoot":"","sources":["../src/symlink.ts"],"names":[],"mappings":"AAiCA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,SAAS,OAAO,EAAkC,CAAC;AAE9E,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,gBAAgB,GAChB,yBAAyB,GACzB,gBAAgB,GAChB,UAAU,GACV,mBAAmB,GAInB,mBAAmB,GACnB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE;;;;OAIG;IACH,iBAAiB,CAAC,EACd,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,KAAK,IAAI,CAAC,GAClE,SAAS,CAAC;IACd;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAC/C;AAQD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAStE;AAiCD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,oBAAyB,GAAG,aAAa,CAyCtF"}

package/dist/symlink.js

@@ -0,0 +1,233 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, readlinkSync, renameSync, rmSync, statSync, symlinkSync, } from "node:fs";
+import { homedir, platform } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const ALL_RUNTIMES = ["claude", "codex", "agents"];
+const RUNTIME_DEFAULT_DIR = {
+    claude: () => join(homedir(), ".claude", "skills"),
+    codex: () => join(homedir(), ".codex", "skills"),
+    agents: () => join(homedir(), ".agents", "skills"),
+};
+export function getRuntimeTargetDir(runtime) {
+    return RUNTIME_DEFAULT_DIR[runtime]();
+}
+export function getBundledSkillsDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "skills");
+}
+export function listBundledSkills(sourceDir) {
+    if (!existsSync(sourceDir)) {
+        return [];
+    }
+    return readdirSync(sourceDir).filter((name) => {
+        const fullPath = join(sourceDir, name);
+        if (!statSync(fullPath).isDirectory())
+            return false;
+        return existsSync(join(fullPath, "SKILL.md"));
+    });
+}
+function symlinkType() {
+    return platform() === "win32" ? "junction" : "dir";
+}
+function createLink(sourceSkillDir, targetSkillDir, copy, symlinkFn) {
+    if (copy) {
+        cpSync(sourceSkillDir, targetSkillDir, { recursive: true });
+        return "installed-copy";
+    }
+    try {
+        symlinkFn(sourceSkillDir, targetSkillDir, symlinkType());
+        return "installed-symlink";
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "EPERM" || code === "EACCES") {
+            cpSync(sourceSkillDir, targetSkillDir, { recursive: true });
+            return "installed-copy-fallback";
+        }
+        throw err;
+    }
+}
+const defaultSymlinkFn = (target, path, type) => {
+    symlinkSync(target, path, type);
+};
+export function symlinkSkillsTriRuntime(opts = {}) {
+    const sourceDir = opts.sourceDir ? resolve(opts.sourceDir) : getBundledSkillsDir();
+    const runtimes = opts.runtimes ?? ALL_RUNTIMES;
+    const copy = opts.copy ?? false;
+    const force = opts.force ?? false;
+    if (!existsSync(sourceDir)) {
+        throw new Error(`Bundled skills directory not found at: ${sourceDir}. Did the package build correctly?`);
+    }
+    const allBundled = listBundledSkills(sourceDir);
+    const skillNames = opts.skillNames
+        ? allBundled.filter((n) => opts.skillNames.includes(n))
+        : allBundled;
+    const symlinkFn = opts.symlinkFnOverride ?? defaultSymlinkFn;
+    const collisionStampFn = opts.collisionStampFn ?? defaultCollisionStamp;
+    const results = [];
+    for (const runtime of runtimes) {
+        const targetBase = opts.targetDirOverrides?.[runtime] ?? getRuntimeTargetDir(runtime);
+        mkdirSync(targetBase, { recursive: true });
+        for (const skill of skillNames) {
+            const sourceSkillDir = resolve(join(sourceDir, skill));
+            const targetSkillDir = join(targetBase, skill);
+            const result = installOne({
+                sourceSkillDir,
+                targetSkillDir,
+                copy,
+                force,
+                symlinkFn,
+                collisionStampFn,
+            });
+            results.push({ skill, runtime, targetPath: targetSkillDir, ...result });
+        }
+    }
+    return { sourceDir, runtimes, results };
+}
+function installOne(input) {
+    const { sourceSkillDir, targetSkillDir, copy, force, symlinkFn, collisionStampFn } = input;
+    if (!existsSync(targetSkillDir)) {
+        return { status: createLink(sourceSkillDir, targetSkillDir, copy, symlinkFn) };
+    }
+    const stat = lstatSync(targetSkillDir);
+    if (stat.isSymbolicLink()) {
+        const existingTarget = resolve(readlinkSync(targetSkillDir));
+        if (existingTarget === sourceSkillDir) {
+            return { status: "already-linked" };
+        }
+        if (!force) {
+            return {
+                status: "divergent-symlink",
+                message: `existing symlink points to ${existingTarget}; re-run with --force to replace`,
+            };
+        }
+        rmSync(targetSkillDir, { recursive: true, force: true });
+        const newStatus = createLink(sourceSkillDir, targetSkillDir, copy, symlinkFn);
+        return {
+            status: "replaced",
+            message: `replaced symlink (was ${existingTarget}); now ${newStatus}`,
+        };
+    }
+    if (stat.isDirectory()) {
+        // Collision-safe install (D30.4 / OD-1 — P0). A NON-symlink directory
+        // sits at the skill target. We NEVER `rmSync` a directory whose content
+        // we did not write — that was the data-loss footgun in the prior
+        // `--force` branch (and the silent-refuse without it).
+        //
+        // - Pristine lyt copy-fallback (content byte-identical to the bundled
+        // source) → safe to upgrade in place to the symlink, no backup. This
+        // is the heal path for EPERM copy-fallback installs (D30.2 caveat b).
+        // - Anything else (the user's OWN dir, or a stale/divergent copy) →
+        // RENAME it aside to `<skill>.local-<ts>` (preserve — never lose),
+        // then install the lyt symlink over the now-free target.
+        //
+        // Note: `force` is intentionally NOT consulted here — collision-safety is
+        // the default, not an opt-in. A pristine replace and a rename-aside are
+        // both non-destructive, so there is nothing for `--force` to gate.
+        if (dirsEqual(sourceSkillDir, targetSkillDir)) {
+            rmSync(targetSkillDir, { recursive: true, force: true });
+            const newStatus = createLink(sourceSkillDir, targetSkillDir, copy, symlinkFn);
+            return {
+                status: "replaced",
+                message: `replaced pristine copy (content matched bundled); now ${newStatus}`,
+            };
+        }
+        const renamedTo = renameAside(targetSkillDir, collisionStampFn);
+        const newStatus = createLink(sourceSkillDir, targetSkillDir, copy, symlinkFn);
+        return {
+            status: "renamed-collision",
+            message: `⚠ a non-lyt directory was already at this skill target; set it aside as ` +
+                `'${basename(renamedTo)}' (preserved — nothing deleted) and installed the lyt skill (${newStatus})`,
+        };
+    }
+    // `force` is referenced only in the divergent-symlink branch above; reference
+    // it here too so the unused-param lint stays quiet on the collision-safe
+    // directory branch that deliberately ignores it.
+    void force;
+    return {
+        status: "target-not-a-directory",
+        message: `${targetSkillDir} is neither a symlink nor a directory; refusing to touch`,
+    };
+}
+// Compact UTC stamp for collision-rename suffixes: `YYYYMMDDTHHMMSSZ`.
+// Colon-free (Windows forbids ':' in filenames), lexically sortable, and
+// human-readable. OD-1 (2026-06-03): chosen over epoch-ms for legibility; the
+// repeat-collision disambiguator in renameAside covers sub-second reruns.
+function defaultCollisionStamp() {
+    return new Date()
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .replace(/\.\d{3}Z$/, "Z");
+}
+// Rename a colliding non-lyt directory aside, preserving it. Appends a numeric
+// `-N` disambiguator when the timestamped name already exists (covers two
+// collisions within the same second / the same injected stamp — W1.1 test d).
+// Returns the path it was renamed to. NEVER deletes.
+function renameAside(targetSkillDir, stampFn) {
+    const base = `${targetSkillDir}.local-${stampFn()}`;
+    let candidate = base;
+    let n = 2;
+    while (existsSync(candidate)) {
+        candidate = `${base}-${n}`;
+        n++;
+    }
+    renameSync(targetSkillDir, candidate);
+    return candidate;
+}
+// Recursively compare two directory trees for byte-equality (names + file
+// contents + structure), WITHOUT following symlinks. Detects a pristine lyt
+// copy-fallback (content === bundled source) that is safe to upgrade to a
+// symlink in place. A symlink anywhere in either tree → not equal
+// (conservative: never treat a link-bearing tree as pristine).
+function dirsEqual(a, b) {
+    let aNames;
+    let bNames;
+    try {
+        aNames = readdirSync(a).sort();
+        bNames = readdirSync(b).sort();
+    }
+    catch {
+        return false;
+    }
+    if (aNames.length !== bNames.length)
+        return false;
+    for (let i = 0; i < aNames.length; i++) {
+        if (aNames[i] !== bNames[i])
+            return false;
+        const an = join(a, aNames[i]);
+        const bn = join(b, bNames[i]);
+        const as = lstatSync(an);
+        const bs = lstatSync(bn);
+        if (as.isSymbolicLink() || bs.isSymbolicLink())
+            return false;
+        if (as.isDirectory() !== bs.isDirectory())
+            return false;
+        if (as.isDirectory()) {
+            if (!dirsEqual(an, bn))
+                return false;
+        }
+        else {
+            if (as.size !== bs.size)
+                return false;
+            if (!readFileSync(an).equals(readFileSync(bn)))
+                return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=symlink.js.map

package/dist/symlink.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@younndai/lyt-skills",
+  "version": "0.9.0",
+  "description": "Lyt harness skills — 15 skills (/lyt-plan, /lyt-progress, /lyt-result, /lyt-retro, /lyt-insight, /lyt-handoff, /lyt-decision, /lyt-pattern, /lyt-capture, /lyt-recall, /lyt-pod, /lyt-mesh-explore, /lyt-primer-context, /lyt-search, /lyt-sync) symlinked tri-runtime into ~/.claude/skills/, ~/.codex/skills/, ~/.agents/skills/. Composed into the `lyt skills install` and `lyt skills list` meta-CLI verbs.",
+  "homepage": "https://linkyourthink.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/younndai/lyt",
+    "directory": "packages/lyt-skills"
+  },
+  "author": {
+    "name": "MARLINK TRADING SRL (YounndAI)",
+    "url": "https://younndai.com"
+  },
+  "contributors": [
+    {
+      "name": "Alexandru Mareș",
+      "url": "https://allemaar.com"
+    }
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.9",
+    "npm": ">=10"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf --glob dist .turbo *.tsbuildinfo",
+    "prepack": "npm run clean && npm run build",
+    "prepublishOnly": "node ../../scripts/check-no-vendored-deps.mjs --root ../.."
+  },
+  "dependencies": {
+    "@younndai/lyt-vault": "^0.9.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@lyt/typescript-config": "*",
+    "@types/node": "^22.10.5",
+    "rimraf": "*",
+    "typescript": "*",
+    "vitest": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "lyt",
+    "claude-code",
+    "skill",
+    "harness",
+    "younndai"
+  ]
+}

package/skills/lyt-capture/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: lyt-capture
+description: >
+  Capture a Figment (a markdown note) into a Lyt vault under the 8-field frontmatter contract. Trigger when the user runs /lyt-capture, or says "save this", "capture this", "add to my vault", "remember this in Lyt", or similar phrasing on content they want kept in their Lyt vault. Writes an Obsidian-flavored markdown file under <vault>/notes/ with frontmatter (title, created, modified, tags, purpose, topic, mesh-visibility, weight, meta) per yai.lyt v1 (arc §3). Wraps `lyt pattern run knowledge-capture capture` under the hood. Companion to lyt-recall.
+visibility: public
+lyt-version: 0.2.0
+capabilities: [write]
+runtimes: [claude, codex, agents]
+requires_writable_vault: true
+---
+
+# /lyt-capture
+
+Capture a Figment into a Lyt vault under the v1 8-field frontmatter contract. A Figment is a single markdown file with frontmatter that the user can read in Obsidian, link to via `[[wikilinks]]`, and later find via `/lyt-recall`.
+
+Under the hood this skill calls `lyt pattern run knowledge-capture capture` — but the harness convention is to fill in the Figment body inline rather than invoke the CLI verb directly, because the user usually has specific content they want captured (not a template stub).
+
+## When to invoke
+
+When the user runs `/lyt-capture`, or says something like:
+
+- "save this to my vault"
+- "capture this"
+- "add this to Lyt"
+- "remember this"
+- "put this in my notes"
+
+If the user pastes content and only says "save it," interpret as `/lyt-capture` on the pasted content.
+
+## Phase 1 — Resolve the target vault
+
+Follow this chain, in order, and stop at the first success:
+
+1. **`--vault <path>` argument** — if the user passed one in the invocation, use it as-is (resolve to absolute path if relative).
+2. **`$LYT_ACTIVE_VAULT` environment variable** — if set, use it.
+3. **`~/lyt/vaults/<handle>/main/`** — the default convention per the unified `{handle}/{repo}` naming (Windows: `%USERPROFILE%\lyt\vaults\<handle>\main`). Resolve `<handle>` from the pod identity (`identity.yon` / `pod.yon`); never hardcode it.
+
+Do **not** guess from cwd. If `--vault` / env var / home convention all miss, ask the user which vault to target — fabricating a path from cwd would silently capture into the wrong vault.
+
+If the resolved path **does not exist or is not a Lyt vault** (no `.lyt/vault.yon` inside), do **not** create files in it. Stop and tell the user:
+
+> The target vault `<path>` doesn't exist (or isn't a Lyt vault — no `.lyt/vault.yon`). Create it with `lyt vault init <name>`, or pass `--vault <existing-path>`.
+
+## Phase 2 — Build the Figment under the v1 8-field contract
+
+Per yai.lyt v1 frontmatter contract (arc §3), every captured Figment carries 8 mandatory frontmatter fields plus a `meta:` escape hatch.
+
+1. **Determine a title.** Use the user's explicit title if given. Otherwise infer a short noun-phrase (5–8 words) from the content. If unsure, ask.
+2. **Compute the slug** — lowercase, kebab-case the title, strip non-`[a-z0-9-]` characters, max 60 chars.
+3. **Compute the filename** — `notes/YYYY-MM-DD-<slug>.md` using today's date.
+4. **If a file already exists at that path**, append `-2`, `-3`, etc. to the slug until the path is free. Never overwrite.
+5. **Fill the 8 mandatory frontmatter fields:**
+
+| Field             | Source                                | Notes                                                                                    |
+| ----------------- | ------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `title`           | inferred / explicit                   | the title from step 1                                                                    |
+| `created`         | auto                                  | ISO 8601 timestamp, e.g. `2026-05-28T20:36:42.880Z`                                      |
+| `modified`        | auto                                  | same as `created` at capture time                                                        |
+| `tags`            | inferred from content (optional list) | e.g. `[design, lyt]`                                                                     |
+| `purpose`         | **PROMPT the user** if not inferrable | one-line author-stated purpose — "Why is this note worth keeping?"                       |
+| `topic`           | **PROMPT the user** if not inferrable | semantic category — free-text or a tag the user already uses                             |
+| `mesh-visibility` | default `local`                       | one of `local` / `parent` / `public` — ask only if user signals a non-default visibility |
+| `weight`          | default `3`                           | int 1–5 importance signal — ask only if user signals a non-default weight                |
+
+**Do NOT author-fill `links-out-of-vault`.** That field is reserved for the lyt scanner (block-B); it is intentionally absent at capture-write time. The contract is "scanner-filled, not author-filled."
+
+The `meta:` blob is a free-form escape hatch (`{}` by default) — fill it only when the content carries a field the 8-field contract does not cover.
+
+6. **Compose the file content** matching the `knowledge-capture/capture` pattern template:
+
+```markdown
+---
+title: "<title>"
+created: <ISO 8601 timestamp>
+modified: <ISO 8601 timestamp>
+tags: [<inferred tags, optional>]
+purpose: "<one-line author-stated purpose>"
+topic: "<semantic category>"
+mesh-visibility: local
+weight: 3
+meta: {}
+---
+
+<body content — plain Obsidian-flavored markdown>
+```
+
+If the user provides explicit values for `mesh-visibility` (e.g. "share to parent") or `weight` (e.g. "important — weight 5"), apply them; otherwise use the defaults.
+
+## Phase 3 — Write, index, record metrics, confirm
+
+1. Write the file using your `Write` tool.
+2. **Index it so it's searchable immediately.** The figment you just wrote is on disk but NOT yet in the search/recall/primer caches — index it with:
+
+```
+lyt capture --index-only <relative-path-from-vault-root> --vault <vault>
+```
+
+e.g. `lyt capture --index-only notes/2026-06-10-my-note.md --vault personal/main`. This runs the same index-on-write path the CLI capture uses (FTS + lanes/arcs), so a subsequent `/lyt-recall` or `lyt search` hits with **no** manual `lyt reindex`. It is best-effort: if it reports `index deferred`, the figment is still saved and self-heals on the next search — do not block the capture or re-write the file. 3. **Record the capture metric.** Per arc §9.2 (the v1 ergonomics test), call:
+
+```
+lyt capture-metric record --json '{"time_to_complete_ms":<measured-ms>,"field_values_json":"<json-snapshot>","llm_assist":true}'
+```
+
+where `time_to_complete_ms` is the wall-clock from invocation to write, `field_values_json` is a JSON-encoded snapshot of the 8 fields actually written (so post-hoc analysis can compute fill rates), and `llm_assist` is `true` when this skill helped fill the frontmatter (almost always — set `false` only if the user pre-filled every field manually).
+
+If the `lyt capture-metric` invocation fails (e.g. registry unreachable), do not block the capture — the metric is best-effort.
+
+4. Confirm to the user in one line:
+
+> Captured to `<relative-path-from-vault-root>` in `<vault-path>`.
+
+5. Do **not** run any git operations. Phase 8's sync watcher (when shipped) will handle commits.
+
+## Rules
+
+- **8-field contract is mandatory.** Every captured Figment carries all 8 mandatory fields. `purpose` and `topic` are author-supplied; if not inferrable from content, **prompt the user** rather than fabricating values.
+- **`links-out-of-vault` is scanner-filled.** Never author-fill it. Its absence at capture-write is intentional.
+- **`mesh-visibility` default = `local`; `weight` default = `3`.** Override only when the user signals a non-default.
+- **User Figments are plain Obsidian-flavored markdown.** Wikilinks (`[[other-note]]`), tags (`#tag`), callouts, embeds — all fine. **Do NOT write YON inside user Figments.** YON is reserved for system files (`.lyt/vault.yon`, `.lyt/memscope.yon`, pattern.yon).
+- **Never overwrite an existing Figment.** Always pick a fresh slug suffix.
+- **Never touch files outside `<vault>/notes/`** unless the user explicitly says so.
+- **Never run `git add`/`git commit`** — sync is a Phase 8 concern.
+- If the user's content references other Figments by name, use `[[wikilinks]]` so Obsidian resolves them; don't expand them yourself.
+
+## Direct CLI path (when no content yet)
+
+If the user wants a quick capture without you authoring the body inline, run the top-level alias directly:
+
+```
+lyt capture "<the thought>" --vault <vault> --purpose <p> --topic <t>
+```
+
+This is a true alias for `lyt pattern run knowledge-capture capture` (same v1 8-field ceremony) and indexes on write, so the capture is immediately searchable. The `<text>` becomes the title (slug derived from it); the file lands at `<vault>/notes/<date>-<slug>.md`. `purpose` and `topic` are mandatory — pass them as flags (or `--vars purpose=<p> --vars topic=<t>`; the `--vars` flag is **repeatable single** key=value, NOT a comma-joined list), or the command prompts for them on a TTY. `mesh-visibility` and `weight` default to `local` / `3`.
+
+## Companion skill
+
+After capturing, the same content is findable via `/lyt-recall <keyword>`.

package/skills/lyt-decision/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: lyt-decision
+description: >
+  Record a locked architectural or product decision as a Lyt Figment. Trigger when the user runs /lyt-decision, or says "lock this decision", "record the decision", "decide between options", "this is decided". Wraps `lyt pattern run decision-log decision`. Writes to <vault>/Projects/<project>/work/<date>-decision-<slug>.md.
+visibility: public
+lyt-version: 0.2.0
+capabilities: [write]
+runtimes: [claude, codex, agents]
+requires_writable_vault: true
+---
+
+# /lyt-decision
+
+Record a locked decision — the choice, the alternatives, the reasoning. Use when a decision is durable enough that future-you (or a future agent) will need to read it cold.
+
+## When to invoke
+
+- `/lyt-decision` slash trigger
+- "lock this decision"
+- "we decided X — record it"
+- after a `/insight-assess` or `/insight-adversarial` lands a locked verdict
+- before starting work whose direction depends on a non-obvious choice
+
+## Phase 1 — Resolve target
+
+Same chain as `/lyt-plan`. Slug describes the decision (e.g., `transclusion-priming-files`, `gh-prefix-soft`).
+
+## Phase 2 — Run the verb
+
+```
+lyt pattern run decision-log decision --vault <vault> --project <project> --slug <slug>
+```
+
+## Phase 3 — Fill the body
+
+Sections to fill:
+
+- **The decision** — one sentence, imperative voice
+- **Context** — what forced this decision
+- **Alternatives considered** — A / B / C with one-line each
+- **Why this option won** — one paragraph; reference rationale if long-form
+- **Reversibility** — how hard to undo, what downstream work depends on this
+- **Cross-references** — wikilinks to rationale file (if separate), related decisions
+
+## Long-form reasoning
+
+If the reasoning is too long for the decision file, write a separate `<date>-rationale-<slug>.md` via `lyt pattern run decision-log rationale --vault <v> --project <p> --slug <s>` and link from the decision file's `supports-decision:` (in the rationale) and `Cross-references` (in the decision).
+
+## Companion skills
+
+- `/lyt-insight` — for distilled lessons LEARNED from acting on decisions
+- `/lyt-handoff` — handoffs often reference locked decisions