@poping/yome 0.0.2 → 0.0.3

package/README.zh-CN.md

@@ -0,0 +1,335 @@
+<div align="center">
+
+<img src=".assets/yome-icon.png" width="120" alt="Yome" />
+
+# YOME AGENT
+
+### Empower Kernel · 赋能内核
+
+*主动式上下文 · 原生应用赋能 · 智能 Bash 内核*
+*让 AI 真正感知你、连接你、为你交付的开源底座。*
+
+[English](./README.md) · [简体中文](./README.zh-CN.md)
+
+</div>
+
+---
+
+Yome Agent 不是又一个 chat agent。它是 [Yome](https://yome.work) 的开源底盘 —— 一台把 LLM、你的设备、你机器上的原生 app 编织成统一运行环境的 **Empower Kernel**。
+
+模型已经很强了。它住在你 12 个 context 之外的某处。今天你是 context 与 tool 之间的 router; 80% 的工作日花在搬运而不是创造。Yome Agent 的存在是为了把这层路由职责从你手里拿走 —— 不是再造一个工具,而是让你已有的工具醒来。
+
+---
+
+## 60 秒上手
+
+```bash
+# 安装
+npm install -g @poping/yome
+
+# 配置 (写入 ~/.yome/config.json)
+yome --key sk-... --base-url https://your.endpoint --model your-model
+
+# 运行
+yome                              # 交互式 REPL
+yome "总结一下 package.json"       # 一次性
+
+# 安装第一个原生 skill (PowerPoint 编辑器)
+yome skill install github:Whopus/yome-skill-ppt
+yome skill list
+```
+
+`yome` 跑起来后,试一下:
+
+```
+> 帮我新建一个 ppt,标题 "Q3 Review",保存到桌面
+```
+
+模型会自己用 Bash 调 `ppt new ~/Desktop/q3.pptx` → `ppt title 1 --text="Q3 Review"` → `ppt save`。Microsoft PowerPoint 在你桌面打开,文件落地。这就是 Empower Kernel 的最小闭环。
+
+---
+
+## 三大引擎
+
+Yome Agent 由三个相互独立、又彼此咬合的引擎组成。每一个都是 Yome 商业蓝图中 *Agentic Empower Intelligence* 的一块 ground truth。
+
+---
+
+### 1. Agentic Contextual Engine · 主动式上下文引擎
+
+> Context 不是一段静态字符串,而是一条 *living continuum*。
+
+Agent loop 不能只活在用户敲下 Enter 的那 30 秒;它应当 always-on, never-forget, ambient。这是 Yome Agent 与传统 chat-style coding agent 的根本分野。
+
+| 能力 | 含义 |
+|---|---|
+| **Daemon · 守护进程** | Agent 长驻后台,跨会话保持状态,不再"开个窗口才会思考" |
+| **Live compaction · 即时压缩** | 长会话自动压缩历史,token 永远不爆,记忆永远不丢 |
+| **Custom missions · 定制任务** | 把"每周一上午整理周报"这种重复任务沉淀成可复用 mission |
+| **Async agent · 异步 agent** | 后台跑长任务,完成后主动 push 通知,而不是阻塞你的 prompt |
+
+**当前可用:**
+
+```bash
+yome thread list                                # 列出当前 cwd 的历史会话
+yome thread share <session-id> --skill=<slug>   # 构建脱敏的 case bundle
+yome thread submit <bundle-dir> --skill=<slug>  # 作为 PR 发布 (需要 gh CLI)
+```
+
+会话 / 历史压缩 / case bundle 这三件已落地。Daemon、custom missions、async agent 在 `next` 分支推进。
+
+---
+
+### 2. Agentic Native Skill · 原生应用赋能
+
+> 真正稀缺的能力不是"另一个 prompt 模板",也不是"远端跑的 MCP wrapper"。是**调起你机器上已经装好的那些原生 app**,让它们听懂 agent 的指令。
+
+我们把这种 skill 叫 **Native Skill**:
+
+| 类型 | 跑在哪 | 干什么 | 例子 |
+|---|---|---|---|
+| **Prompt Skill** | LLM context window | 加载一段 markdown 提示模板 | code-review, web-research |
+| **MCP Server** | 远端进程 | 暴露 JSON-RPC tool 给 LLM | github MCP, filesystem MCP |
+| **Native Skill** *(Yome)* | 你本机 (macOS / Win / Linux) | 通过 AppleScript / Win32 / DBus 驱动原生 app | ppt, xl, cal, mail, rem |
+
+**安装 / 管理:**
+
+```bash
+yome skill install github:Whopus/yome-skill-ppt
+yome skill perms @yome/ppt                      # 查看授予的 capability
+yome skill perms @yome/ppt --revoke=fs:write    # 撤销某项
+yome skill validate                             # 校验当前目录的 skill
+yome skill publish                              # 发布到 hub (需要 `yome login`)
+```
+
+**Capability 模型。** 每个 skill 必须在 manifest 里声明它需要的 OS 资源,用户在安装时显式 grant。这不是 prompt 里的"请求权限",是真正的 sandbox gate:
+
+| Capability | 含义 |
+|---|---|
+| `applescript` | 可执行 AppleScript (仅 macOS) |
+| `fs:read` / `fs:write` / `fs:delete` | 文件系统访问,作用域受限 |
+| `network` | 出站网络 |
+| `shell` | 任意 shell 命令 (危险,默认拒绝) |
+
+未授权的能力一律返回 `capability not granted: …`,模型看到错误会主动让你 grant,而不是默默失败。
+
+**当前 Native Skills:**
+
+| Skill | Domain | 状态 |
+|---|---|---|
+| `@yome/ppt` | `ppt` | **stable** — 16 个 action,batch-ready,4 套主题 (`--doc`) |
+| `@yome/xl` | `xl` | beta |
+| `@yome/cal` | `cal` | beta |
+| `@yome/rem` | `rem` | beta |
+| `@yome/mail` | `mail` | alpha |
+
+---
+
+### 3. Agentic Bash Kernel · 智能 Bash 内核
+
+> Bash 即接口,skill 即 verb。**用户在 shell 里怎么用,模型在 Bash tool 里就怎么用。** 一套语法,两个用户。
+
+模型不需要学习新工具:
+
+```jsonc
+// 模型工具列表里只有一个 Bash:
+{ "name": "Bash", "description": "Run a shell command." }
+
+// 模型想加一张幻灯片时这样发:
+Bash({ "command": "ppt slide.add" })
+
+// kernel 在 /bin/sh 看到之前就拦截,路由到已安装的
+// @yome/ppt skill, 跑 AppleScript, 返回结果。
+```
+
+#### Skill 三层文档 · L1 / L2 / L3
+
+模型选择和使用 skill 的全部信息分布在三层。每一层都为 token / latency 优化:
+
+| Layer | 在哪 | 给谁看 | 长度 |
+|---|---|---|---|
+| **L1 — Index** | system prompt 永驻 | 模型每次对话都看 | 3 行 / ~60 tokens per skill |
+| **L2 — Signature** | `<domain> --help` 按需返回 | 模型决定要用之后 | ~50 行 / ~250 tokens |
+| **L3 — Cookbook** | `<domain> --doc [name]` 按需返回 | 复杂任务时主动查阅 | KB 级 markdown |
+
+**L1 看起来是这样** (system prompt 里 ppt skill 的真实块):
+
+```
+ppt | when:    user wants to create / edit / export PowerPoint .pptx slides
+    | effects: opens Microsoft PowerPoint, writes files (first save to ~/Desktop may show OS dialog)
+    | start:   ppt --help
+```
+
+只有三个字段,因为 LLM 选 tool 时也只在乎这三件事:**何时该用 / 副作用是什么 / 第一步敲什么**。Skill 作者在 `yome-skill.json` 里写:
+
+```jsonc
+"l1": {
+  "when":    "user wants to create / edit / export PowerPoint .pptx slides",
+  "entry":   "ppt --help",
+  "effects": "opens Microsoft PowerPoint, writes files"
+}
+```
+
+**L2 (`ppt --help`)** 是手写的 `SIGNATURE.md` —— 一行一 action,默认值内联,LLM 一眼扫完知道全部 args:
+
+```
+ppt new [path] [--force]                       create blank presentation
+ppt open <path>                                open existing .pptx
+ppt save [--path=P] [--force]                  save (or save-as)
+ppt slides                                     TSV: index, title, shape count
+ppt slide.add [--index=N] [--layout=N]
+ppt title <slide> --text=<str>
+ppt addtext <slide> --text=<str>
+                       [--left=100 --top=200 --width=400 --height=50]
+                       [--size=N --bold --italic]
+                       [--color=red|#RRGGBB|R,G,B]
+                       [--align=left|center|right]
+ppt fmt <slide> --shape=<n> [--size=N --bold --italic --color --bg --align]
+ppt export --format=pdf|png|jpg --path=<file> [--force]
+…
+```
+
+**L3 (`ppt --doc`)** 列出 cookbook 模板; `ppt --doc blue-white` 返回完整模板内容(配色、字号、batch 例子)。Skill 作者在 `docs/*.md` 里用 frontmatter 声明:
+
+```yaml
+---
+name: blue-white
+label: 蓝白风格
+summary: 商务深蓝主色 + 白底,适合季度回顾、产品发布、销售汇报
+tags: [theme, business]
+---
+```
+
+#### Batch mode · 6 倍提速
+
+序列任务在 cli agent 里是头号性能杀手 —— 每个 AppleScript 调用 200ms cold-start。Yome Bash kernel 内置 `batch` verb 把 N 步合成一次调用; `--merge` 进一步把 N 个 AppleScript 合成一个 `osascript` 进程:
+
+```bash
+ppt batch --merge <<EOF
+new ~/Desktop/q3.pptx
+title 1 --text="Q3 Review"
+slide.add
+title 2 --text="Revenue"
+addtext 2 --text="+18% YoY" --size=72 --bold --color=green --align=center
+slide.add
+title 3 --text="Conclusion"
+save
+export --format=pdf --path=~/Desktop/q3.pdf
+EOF
+```
+
+实测数字 —— 8 个连续 `ppt` action,M1 Mac:
+
+| 模式 | Wall time | 提速 |
+|---|---|---|
+| 8 次独立 `ppt …` 调用 | 2041 ms | 1× |
+| `ppt batch <<EOF…EOF` (顺序执行) | 2353 ms | 1× (含解析开销) |
+| `ppt batch --merge <<EOF…EOF` | **334 ms** | **6.1×** |
+
+Kernel 在 token 级别决定:第一个 token 是不是 reserved system command (47 个: `git`, `ls`, `cd`, `rm`, `node`…) ?是 → 直接放给 `/bin/sh`。否则 → 是不是某个已安装 skill 的 domain ?是 → 路由到 skill。否 → 透传给 shell。
+
+因此 *同一个 Bash tool* 同时承载了:
+
+- 真 shell 命令 (`ls`, `git status`, `python script.py`)
+- skill verb (`ppt new`, `cal create`)
+- shell 复合 (`ppt slides | head -3` —— domain 命令的 stdout 喂给真 shell)
+- 批量 (`ppt batch --merge <<EOF…EOF`)
+
+---
+
+## Skills Marketplace · Skill 市场
+
+```bash
+yome skill search powerpoint              # 搜索公共 hub
+yome skill install github:Whopus/yome-skill-ppt
+yome skill install ./my-local-skill       # 本地目录
+yome skill install github:owner/repo@v2   # 锁定到某 ref
+yome skill update                         # 重新拉取所有已装 skill
+yome skill rollback @yome/ppt             # 一级撤销
+yome skill enable / disable / link / unlink / doctor
+```
+
+`yome skill publish` 把当前目录发布到公共 hub (需先 `yome login` 走 GitHub Device Flow)。Hub 只是发现层,skill 真身依然是 git repo —— 没有 vendor lock-in。
+
+---
+
+## 配置
+
+```bash
+export YOME_API_KEY=sk-...
+export YOME_BASE_URL=https://your.endpoint
+export YOME_MODEL=claude-opus-4-6
+export YOME_PROVIDER=anthropic     # 或 openai (会从 base URL 自动检测)
+```
+
+或一次性写入 `~/.yome/config.json`:
+
+```bash
+yome --key sk-... --base-url https://… --model …
+```
+
+**存储布局:**
+
+```
+~/.yome/
+├── config.json                   # API 配置
+├── skills/                       # 已安装的 native skill
+│   ├── .index.json               # 缓存的注册表
+│   └── yome/
+│       └── ppt/                  # @yome/ppt skill, 就是 git repo 本体
+└── threads/                      # 会话历史 (按 cwd 分目录)
+```
+
+---
+
+## 哲学
+
+> *用户不愿学习新产品,也不愿改变已有的行为模式。*
+
+我们不替代你的工具,而是在不打断现有流程的前提下进行**赋能 (Empower)**。Mail、Chat、Docs、Calendar、Files、Web —— 它们已经在你机器上,我们只是给它们装一层 living context 让它们苏醒。
+
+| Before | After |
+|---|---|
+| Passive Tool · 被动工具 | Proactive Agent · 主动 Agent |
+| You route context → tool | Yome 替你伸进每一台设备 |
+| 12 contexts, 0 AI | 1 个 buddy,知道关于你的一切 |
+
+---
+
+## 项目状态
+
+| 模块 | 状态 |
+|---|---|
+| Bash kernel (tokenizer + dispatcher + permission gate) | **stable** |
+| Native skill 格式 (yome-skill.json + L1/L2/L3 docs) | **stable** |
+| `@yome/ppt` (16 actions, batch + 4 themes) | **stable** |
+| Skill hub (search / install / publish) | **stable** |
+| Capability model (sandbox grants) | **stable** |
+| Thread 历史 + case bundles | **stable** |
+| Live history compaction | beta |
+| Daemon (always-on agent) | experimental, 在 `next` 分支 |
+| Custom missions (recurring tasks) | next-up |
+| Async agent (后台长任务) | next-up |
+
+**Daemon roadmap** *(scoped, 在 `next` 分支)*
+
+- [ ] **系统消息拦截** — 微信 / 飞书 / Slack / WhatsApp / iMessage。实时捕获,过滤垃圾,主动协助回复,不漏任何重要消息。
+- [ ] **日程 / Routine 自动化** — 订阅博主、社交频道、每日 digest、提醒闹铃、日历联动。不用打开就会自己跑。
+- [ ] **状态变化监听** — 实验跑完、CPU / GPU 飙高、build 通过、有人 @你。在关键时刻推送,而不是事后汇总。
+
+---
+
+## License
+
+[Apache License 2.0](./LICENSE) —— Yome Agent + 官方 skills (`yome-skill-ppt`, `yome-skill-xl`, `yome-skill-cal`, `yome-skill-rem`, `yome-skill-fs`)。
+
+社区贡献者发布到 Yome hub 的 skill 是作者自己的 git repo,各自适用其自己的 license。
+
+---
+
+<div align="center">
+
+**YOME — Your Universal AI Work Buddy.**
+*Know everything. Run everywhere. Empower everyone.*
+
+</div>

package/dist/agent.d.ts

@@ -1,4 +1,5 @@
-import type { ToolPermissionContext, PermissionMode } from './permissions/types.js';
+import { type AskPermissionResult } from './tools/index.js';
+import type { ToolPermissionContext, PermissionMode, PermissionBehavior, PermissionRuleSource } from './permissions/types.js';
 import type { Skill } from './skills/index.js';
 import type { AgentDefinition } from './subagent/index.js';
 import type { AgentMessage } from './types.js';
@@ -7,23 +8,44 @@ import type { AgentLoopCallbacks } from './loops/index.js';
 import type { PastedImage } from './utils/imagePaste.js';
 export interface AgentCallbacks extends AgentLoopCallbacks {
     onLoopChanged?: (name: string) => void;
-    onAskPermission?: (toolName: string, message: string, input: Record<string, unknown>) => Promise<boolean>;
+    onAskPermission?: (toolName: string, message: string, input: Record<string, unknown>) => Promise<AskPermissionResult>;
 }
 export declare class Agent {
     private config;
     private messages;
     private systemPrompt;
     private skills;
+    /**
+     * Cached skill list with includeDisabled=true. We re-read SKILL.md files
+     * only when explicitly invalidated (resetContext / reloadSkills /
+     * skill toggle picker reopens). Previously every call to getSkills() hit
+     * the filesystem — and it gets called on every render of the slash menu,
+     * the unified picker, and the system prompt rebuild. After ~50 turns
+     * that adds up to thousands of redundant readdirSync calls.
+     */
+    private cachedSkillsAll;
     private loopRegistry;
     private currentLoopName;
     private permissionContext;
     private sessionId;
     constructor(config: YomeConfig);
+    /** Drop the cached skill list so the next getSkills() call re-reads from disk. */
+    invalidateSkillsCache(): void;
     getSessionId(): string;
     getPermissionContext(): ToolPermissionContext;
     getConfig(): YomeConfig;
     switchModel(entry: ModelEntry): void;
     switchPermissionMode(mode: PermissionMode): void;
+    /**
+     * Append a rule to the live in-memory permission context AND update the
+     * tools subsystem so subsequent invocations see it without restarting.
+     *
+     * `source: 'session'` — never persisted, lives only for this Agent instance.
+     * `source: 'userSettings'` — caller is responsible for also writing to disk
+     *   (via `addPermissionRuleToUserSettings`); this just mirrors the rule into
+     *   memory so the current session benefits immediately.
+     */
+    addPermissionRule(ruleString: string, behavior: PermissionBehavior, source?: PermissionRuleSource): void;
     resetContext(): void;
     restoreSession(sessionId: string): void;
     getMessages(): AgentMessage[];

package/dist/agent.js

@@ -3,7 +3,7 @@ import { getAnthropicTools, executeTool, registerTool, setPermissionContext, set
 import { loadAllSkills } from './skills/index.js';
 import { createLoopRegistry } from './loops/index.js';
 import { createAgentTool, clearAgentCache, getAllAgents } from './subagent/index.js';
-import { initializePermissionContext } from './permissions/loader.js';
+import { initializePermissionContext, addRuleToContext } from './permissions/loader.js';
 import { modelEntryToConfig } from './config.js';
 import { createSessionId, appendMessage, loadSessionMessages, setSessionTitle } from './sessions.js';
 export class Agent {
@@ -11,6 +11,15 @@ export class Agent {
     messages = [];
     systemPrompt;
     skills = [];
+    /**
+     * Cached skill list with includeDisabled=true. We re-read SKILL.md files
+     * only when explicitly invalidated (resetContext / reloadSkills /
+     * skill toggle picker reopens). Previously every call to getSkills() hit
+     * the filesystem — and it gets called on every render of the slash menu,
+     * the unified picker, and the system prompt rebuild. After ~50 turns
+     * that adds up to thousands of redundant readdirSync calls.
+     */
+    cachedSkillsAll = null;
     loopRegistry = createLoopRegistry();
     currentLoopName = 'simple';
     permissionContext;
@@ -24,6 +33,10 @@ export class Agent {
         setPermissionContext(this.permissionContext);
         this.sessionId = createSessionId();
     }
+    /** Drop the cached skill list so the next getSkills() call re-reads from disk. */
+    invalidateSkillsCache() {
+        this.cachedSkillsAll = null;
+    }
     getSessionId() {
         return this.sessionId;
     }
@@ -40,10 +53,24 @@ export class Agent {
         this.permissionContext = { ...this.permissionContext, mode };
         setPermissionContext(this.permissionContext);
     }
+    /**
+     * Append a rule to the live in-memory permission context AND update the
+     * tools subsystem so subsequent invocations see it without restarting.
+     *
+     * `source: 'session'` — never persisted, lives only for this Agent instance.
+     * `source: 'userSettings'` — caller is responsible for also writing to disk
+     *   (via `addPermissionRuleToUserSettings`); this just mirrors the rule into
+     *   memory so the current session benefits immediately.
+     */
+    addPermissionRule(ruleString, behavior, source = 'session') {
+        this.permissionContext = addRuleToContext(this.permissionContext, ruleString, behavior, source);
+        setPermissionContext(this.permissionContext);
+    }
     resetContext() {
         this.messages = [];
         this.systemPrompt = buildSystemPrompt();
         this.skills = loadAllSkills();
+        this.cachedSkillsAll = null;
         clearAgentCache();
         registerTool(createAgentTool(this.config));
         this.sessionId = createSessionId();
@@ -53,6 +80,7 @@ export class Agent {
         this.messages = loadSessionMessages(sessionId);
         this.systemPrompt = buildSystemPrompt();
         this.skills = loadAllSkills();
+        this.cachedSkillsAll = null;
         clearAgentCache();
         registerTool(createAgentTool(this.config));
     }
@@ -66,13 +94,17 @@ export class Agent {
         setSessionTitle(this.sessionId, title);
     }
     getSkills() {
-        return loadAllSkills(true);
+        if (!this.cachedSkillsAll) {
+            this.cachedSkillsAll = loadAllSkills(true);
+        }
+        return this.cachedSkillsAll;
     }
     getAgents() {
         return getAllAgents();
     }
     reloadSkills() {
         this.skills = loadAllSkills();
+        this.cachedSkillsAll = null;
         this.systemPrompt = buildSystemPrompt();
         clearAgentCache();
         registerTool(createAgentTool(this.config));

package/dist/agent.js.map

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

package/dist/context.d.ts

@@ -1 +1,3 @@
+/** Force a re-fetch of git/tree info on next buildSystemPrompt call. */
+export declare function invalidateCwdMeta(): void;
 export declare function buildSystemPrompt(): string;

package/dist/context.js

@@ -2,6 +2,8 @@ import { execSync } from 'child_process';
 import { readdirSync } from 'fs';
 import { join, basename } from 'path';
 import { loadAllSkills } from './skills/index.js';
+import { getInstalledFast } from './yomeSkills/skillsIndex.js';
+import { readManifest } from './yomeSkills/manifest.js';
 function safeExec(cmd, cwd) {
     try {
         return execSync(cmd, { cwd, timeout: 5000, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
@@ -30,15 +32,36 @@ function getFileTree(dir, depth = 2, prefix = '') {
     catch { /* ignore */ }
     return lines.filter(Boolean).join('\n');
 }
+let _cwdMetaCache = null;
+const CWD_META_TTL_MS = 60_000;
+function getCwdMeta(cwd) {
+    const now = Date.now();
+    if (_cwdMetaCache && _cwdMetaCache.cwd === cwd && _cwdMetaCache.expiresAt > now) {
+        return _cwdMetaCache;
+    }
+    _cwdMetaCache = {
+        cwd,
+        expiresAt: now + CWD_META_TTL_MS,
+        gitBranch: safeExec('git rev-parse --abbrev-ref HEAD', cwd),
+        gitStatus: safeExec('git status --porcelain', cwd),
+        tree: getFileTree(cwd),
+    };
+    return _cwdMetaCache;
+}
+/** Force a re-fetch of git/tree info on next buildSystemPrompt call. */
+export function invalidateCwdMeta() {
+    _cwdMetaCache = null;
+}
 export function buildSystemPrompt() {
     const cwd = process.cwd();
     const projectName = basename(cwd);
     const now = new Date();
     const dateStr = now.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric', weekday: 'long' });
-    const gitBranch = safeExec('git rev-parse --abbrev-ref HEAD', cwd);
-    const gitStatus = safeExec('git status --porcelain', cwd);
+    const meta = getCwdMeta(cwd);
+    const gitBranch = meta.gitBranch;
+    const gitStatus = meta.gitStatus;
     const isGit = gitBranch !== null;
-    const tree = getFileTree(cwd);
+    const tree = meta.tree;
     let prompt = `You are Yome, an AI coding assistant running in the user's terminal.
 You help with software engineering tasks: reading code, writing code, debugging, refactoring, and running commands.
 
@@ -79,23 +102,105 @@ You have these tools: Read, Edit, Write, Bash, Glob, Grep, LS.
 - Use Grep to search file contents.
 - Use LS to list directory contents.
 `;
+    // Prompt-style skills (Claude Code-format SKILL.md). The agent injects
+    // their markdown bodies into the prompt at /skill-name invocation time;
+    // here we just advertise them so the model knows they exist.
     const skills = loadAllSkills();
     if (skills.length > 0) {
         prompt += buildSkillsSection(skills);
     }
+    // Hub skills (yome-skill.json packages) — these carry typed command
+    // contracts and capability grants. Every installed + enabled hub skill
+    // is exposed to the model so it can reach for the right command
+    // (e.g. ppt.slide.add) instead of trying to roll one from shell.
+    const hubSkills = getInstalledFast().filter((s) => s.status === 'enabled');
+    if (hubSkills.length > 0) {
+        prompt += buildHubSkillsSection(hubSkills);
+    }
     return prompt;
 }
+/**
+ * Prompt skills (Claude Code SKILL.md format) get the same 3-row L1
+ * shape as hub skills, just with different field sources:
+ *   when    ← frontmatter `when_to_use` (or `description` as fallback)
+ *   effects ← always "loads markdown body into context (prompt-only)"
+ *             unless the SKILL.md explicitly grants `allowed-tools`
+ *   start   ← `/skill-name [argument-hint]`
+ *
+ * Same visual shape means the model doesn't have to context-switch
+ * between two different docs styles when scanning available skills.
+ */
 function buildSkillsSection(skills) {
-    let section = `\n## Available Skills\nThe user can invoke skills with \`/skill-name [args]\`. You can also invoke them when appropriate.\n\n`;
+    let section = `\n## Available Skills (prompt)\nUser invokes with \`/skill-name [args]\`; you can invoke them too when appropriate.\n\n`;
     for (const skill of skills) {
-        section += `### /${skill.name}\n`;
-        section += `${skill.description}\n`;
-        if (skill.whenToUse)
-            section += `When to use: ${skill.whenToUse}\n`;
-        if (skill.argumentHint)
-            section += `Usage: /${skill.name} ${skill.argumentHint}\n`;
-        section += `Source: ${skill.source}\n\n`;
+        const head = `/${skill.name}`;
+        const pad = ' '.repeat(head.length);
+        const when = skill.whenToUse ?? skill.description;
+        const entry = skill.argumentHint ? `/${skill.name} ${skill.argumentHint}` : `/${skill.name}`;
+        const effects = (skill.allowedTools && skill.allowedTools.length > 0)
+            ? `runs tools: ${skill.allowedTools.join(', ')}`
+            : `prompt-only (no tools)`;
+        section += `${head} | when:    ${when}\n`;
+        section += `${pad} | effects: ${effects}\n`;
+        section += `${pad} | start:   ${entry}\n`;
     }
     return section;
 }
+/**
+ * Hub skills are surfaced to the LLM in three layers:
+ *   L1 — this section: ONE skill = THREE short rows answering the only
+ *        questions the model actually has when picking a tool —
+ *          when    (trigger condition)
+ *          effects (truthful side effects)
+ *          start   (first command to discover the rest)
+ *        Authored as `l1: { when, entry, effects }` in yome-skill.json.
+ *   L2 — `<domain> --help` (kernel reads SIGNATURE.md, fallback auto-gen).
+ *   L3 — `<domain> --doc [name]` for cookbook templates / themes.
+ *
+ * The model is told once, in the footer, that --help / --doc / batch exist
+ * for every installed skill — so individual L1 blocks stay focused on
+ * the trigger / effects / entry triad.
+ */
+function buildHubSkillsSection(entries) {
+    let section = `\n## Installed Hub Skills\nUse the Bash tool: \`<domain> <action> [args]\` (no \`yome\` prefix, no SkillCall).\n\n`;
+    for (const e of entries) {
+        const manifest = readManifest(e.installedAt);
+        section += renderL1Block(e.domain, manifest, e.description) + '\n';
+    }
+    section += `\nFor any installed skill:
+  \`<domain> --help\`           one-screen signature (actions + args)
+  \`<domain> --doc\`            list cookbook templates / themes
+  \`<domain> --doc <name>\`     read one template
+  \`<domain> batch <<EOF…EOF\`  run several sub-commands in one call (--keep-going, --merge)
+`;
+    return section;
+}
+/**
+ * Render the 3-row pipe-aligned L1 block for one skill. Falls back to
+ * legacy `prompt_line`, then to `<domain> — <description>` so older
+ * yome-skill.json files keep producing *something* useful.
+ */
+function renderL1Block(domain, manifest, fallbackDesc) {
+    const l1 = manifest?.l1;
+    if (l1 && (l1.when || l1.entry || l1.effects)) {
+        // Right-pad the domain column so the pipes line up vertically — easier
+        // for the model to scan when several skills are listed.
+        const head = domain;
+        const pad = ' '.repeat(head.length);
+        const lines = [];
+        if (l1.when)
+            lines.push(`${head} | when:    ${l1.when}`);
+        if (l1.effects)
+            lines.push(`${pad} | effects: ${l1.effects}`);
+        if (l1.entry)
+            lines.push(`${pad} | start:   ${l1.entry}`);
+        return lines.join('\n');
+    }
+    // Legacy single-line fallback — keeps backward compat with skills that
+    // used `prompt_line` before the structured l1 schema landed.
+    if (manifest?.prompt_line) {
+        return `- ${manifest.prompt_line}`;
+    }
+    return `- ${domain} — ${fallbackDesc ?? '(no description provided)'}`;
+}
 //# sourceMappingURL=context.js.map