Lyt

@younndai/lyt-skills
Agent-harness skills — let Claude Code, Codex, and any agent runtime drive your markdown vaults as first-class operators.
Part of the Lyt (Link Your Think™) toolchain — federated markdown vaults you own, made legible to AI.

Website · Repository · Apache 2.0 · Trademark Policy · Contributing

[![npm](https://img.shields.io/npm/v/@younndai/lyt-skills)](https://www.npmjs.com/package/@younndai/lyt-skills) [![license](https://img.shields.io/npm/l/@younndai/lyt-skills)](./LICENSE) [![status](https://img.shields.io/badge/status-public%20alpha-orange)](https://github.com/YounndAI/lyt#status) > ⚠️ **Public alpha — under active testing.** Lyt works and we use it daily, but surfaces change between releases and docs are still growing. The normal install follows `latest`; `@alpha` is the opt-in preview channel. Your vaults are plain markdown in plain git repos — your data is never locked in, and Lyt never phones home. ## What is this? `@younndai/lyt-skills` is where [Lyt](https://github.com/YounndAI/lyt)'s **AI-first** design becomes tangible: twelve harness skills that let AI agents — Claude Code, Codex, and generic agent runtimes — drive your markdown vaults as **first-class operators**. Install once and your agent can create and adopt vaults, capture notes, search your pod, prime on context, explore meshes, and sync vaults — through the same governed operation set you use, under the same permission semantics. This is the "install once, every agent runtime knows Lyt" layer. The `/lyt-create` skill routes mesh/vault creation and Receipt V1 interpretation. `/lyt-capture` wraps the `knowledge-capture` pattern verb from the `lyt pattern run` runtime; the read/orient + addressing + lifecycle skills (`/lyt-pod`, `/lyt-search`, `/lyt-recall`, `/lyt-primer-context`, `/lyt-mesh-explore`, `/lyt-sync`, `/lyt-alias`, `/lyt-adopt`, `/lyt-update`) wrap the corresponding CLI verbs directly. Pairs with [`@younndai/lyt-vault`](https://www.npmjs.com/package/@younndai/lyt-vault), which ships the bundled `knowledge-capture` pattern the capture/recall skills resolve against (workflow patterns are bring-your-own via `lyt pattern install`). ## Install ```bash npm install -g @younndai/lyt # the meta package bundles lyt-skills lyt skills install # links the 12 SKILL.md files into your harness(es) ``` Tri-runtime: the installer detects Claude Code, Codex, and generic agent runtimes, and installs per-runtime (symlink by default, `--copy` for regular directories). ## The 12 skills | Skill | Wraps | Use it when | | --------------------- | ------------------------------------- | ------------------------------------------------------------ | | `/lyt-create` | `lyt mesh init` + `lyt vault init` | Creating a mesh/vault and interpreting its Receipt V1. | | `/lyt-capture` | knowledge-capture + capture | Saving a Figment (markdown note) into a vault. | | `/lyt-recall` | `lyt search --vault` (tiered cascade) | Ranked search across a single vault. | | `/lyt-search` | `lyt search` (tiered cascade) | Ranked search across the whole pod, a mesh, or a vault. | | `/lyt-pod` | `lyt mesh list` + `lyt vault list` | Enumerating every mesh + vault on the machine. | | `/lyt-mesh-explore` | `lyt mesh info` | Drilling into one mesh's members and metadata. | | `/lyt-alias` | `lyt alias` set/`--list`/`--remove` | Managing pod-local vault aliases (name → rid). | | `/lyt-primer-context` | `lyt primer` + `lyt vault info` | Priming an agent with vault/mesh/pod context. | | `/lyt-sync` | gated git pull/commit/push | Syncing a vault with its remote under the writable gate. | | `/lyt-adopt` | `lyt vault adopt` | Bringing an existing markdown vault into the pod. | | `/lyt-update` | `lyt outdated` + `lyt update` | Checking for and installing a newer Lyt release. | | `/lyt-pattern` | meta-skill over `lyt pattern *` | Listing, installing, linking patterns from an agent context. | Each skill autodetects the active vault via `lyt vault info --by-path`, the `LYT_ACTIVE_VAULT` env var, or an explicit `--vault` flag, then calls the CLI verb (or `lyt pattern run ` for `/lyt-capture`) at the resolved path. ## The capture contract `/lyt-capture` enforces an 8-field frontmatter contract on every captured Figment: | Field | Source | Default | | -------------------------------------- | ------------------------------------------------ | -------- | | `title`, `created`, `modified`, `tags` | Auto-filled by the skill | — | | `purpose` | Handler-prompted (1 line — what the note is for) | required | | `topic` | Handler-prompted (semantic category) | required | | `mesh-visibility` | Handler-overridable | `local` | | `weight` | Handler-overridable (1–5) | `3` | A `meta:` escape-hatch blob accepts free-form fields without schema churn. The result: every note an agent saves is structured, searchable, and legible to the next agent that reads it. On an interactive terminal, `/lyt-capture` also resolves **where** the note lands — `--dir `, an opt-in `topics//` folder, or the default `notes/` (fail-closed against escapes) — and offers your vault's existing topics (recommended first) so `topic:` stays consistent. `tags` fill with no model required; with a local embedding model present, a `topic:` is additionally suggested (recommended, never auto-selected) — computed on-device, never sent anywhere. ## Patterns vs skills - A **pattern** is data: a `pattern.yon` descriptor + a `templates/` folder of markdown templates with frontmatter. Patterns live at `~/lyt/patterns/`. - A **skill** is a thin SKILL.md adapter an agent harness loads; it calls the pattern runtime. Fork any installed pattern (`lyt pattern fork knowledge-capture --as kc-custom`) without modifying the master. See `lyt help patterns` and `lyt help skills`. ## The Lyt toolchain | Package | Role | | --------------------------------------------------------------------------------------- | --------------------------------------- | | [`@younndai/lyt`](https://github.com/YounndAI/lyt/tree/main/packages/lyt) | The unified `lyt` CLI (meta package) | | [`@younndai/lyt-vault`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-vault) | The vault primitive | | [`@younndai/lyt-mesh`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-mesh) | The mesh layer — multi-vault operations | | [`@younndai/lyt-skills`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-skills) | **This package** — agent-harness skills | | [`@younndai/lyt-mcp`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-mcp) | The MCP server | | [`@younndai/lyt-runner`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-runner) | The YON automation runner | | [`@younndai/lyt-llm`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-llm) | The LLM gateway | --- ## About YounndAI **YounndAI™ — You and AI, unified.** (pronounced _"yoon-dye"_) A philosophy of intelligence: building with intention, so humans and machines think together without losing what makes either whole. ## License & Attribution Apache-2.0. © 2026 MARLINK TRADING SRL (YounndAI). See [`LICENSE`](./LICENSE) and [`NOTICE`](./NOTICE). "LYT", "Lyt", and "YounndAI" are trademarks of MARLINK TRADING SRL — see [`TRADEMARK.md`](https://github.com/YounndAI/lyt/blob/main/TRADEMARK.md). Created by [Alexandru Mareș](https://allemaar.com). Website: [linkyourthink.com](https://linkyourthink.com)

Structure before scale. Harmony above all.

--- | | | | ------------- | ---------------------------------------------------------------------------------------- | | **Project** | [Lyt — Link Your Think](https://linkyourthink.com) | | **Author** | [Alexandru Mareș](https://allemaar.com) | | **Company** | [MARLINK TRADING SRL](https://younndai.com) · YounndAI™ | | **License** | [Apache 2.0](./LICENSE) — © 2026 MARLINK TRADING SRL | | **Trademark** | [YounndAI™ Trademark Guidelines](https://github.com/YounndAI/lyt/blob/main/TRADEMARK.md) |