fix: keep agent skills single sourced

AGENTS.md

@@ -112,6 +112,9 @@ General principles (KISS, DRY, YAGNI, SOLID) as applied in this codebase. Match
 - `kb install-agent` owns native skill discovery for the main supported coding agents. Keep
   `--agents claude|codex|kimi|opencode|cline` targeted so a user can install only the agent they use,
   with project scope by default and user scope available through `--scope user`.
+- Keep `.mimir/skills/` as the canonical skill source in target repositories. Native agent folders
+  created by `kb install-agent` should link to that source by default; use copy mode only as a
+  compatibility fallback for runtimes or filesystems that cannot follow symlinks.
 - `packages/mimir/examples/sovereign-rag-demo` is the tracked synthetic test workspace for manual
   and package validation.
 - `.kb/`, `.mimir/`, and project `private/` folders are local user data or generated agent

README.md

@@ -328,8 +328,9 @@ pnpm exec kb install-agent --agents kimi
 pnpm exec kb install-agent --agents claude,codex,kimi,opencode,cline
 ```
 
-By default, `install-agent` writes project-scope skill folders. Add `--scope user` for global
-installations.
+By default, `install-agent` writes project-scope skill folders as links back to `.mimir/skills/`.
+That keeps one original version of every skill. Add `--scope user` for global installations, or
+`--mode copy` only when an agent/runtime cannot follow symlinked skill directories.
 
 | Agent | Project skill directory | Main MCP helper |
 | --- | --- | --- |
@@ -397,7 +398,9 @@ kimi --mcp-config-file .mimir/kimi-mcp.json
 ```
 
 Kimi can discover project skills from `.kimi/skills/`. The MCP config can also be installed in
-Kimi's global MCP file if you intentionally want a global setup.
+Kimi's global MCP file if you intentionally want a global setup. If you prefer not to create a
+`.kimi/skills/` discovery folder, Kimi can also be launched directly with
+`kimi --skills-dir .mimir/skills --mcp-config-file .mimir/kimi-mcp.json`.
 
 ### OpenCode
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "jcode-mimir",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "private": true,
   "description": "Monorepo for Mimir Core and open-source Mimir add-ons.",
   "type": "module",

packages/mimir-tts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcode.labs/mimir-tts",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Mimir add-on for plug-and-play Edge-quality and offline text-to-speech audio summaries.",
   "type": "module",
   "license": "MIT",

packages/mimir/README.md

@@ -60,9 +60,10 @@ Run `pnpm exec kb doctor --fix` later to repair missing setup or rebuild stale i
 ## Claude Code And Codex
 
 After `pnpm exec kb setup`, use `pnpm exec kb install-agent --agents claude`, `--agents kimi`, or a
-comma-separated list for native agent skill discovery. Mimir Core also generates MCP helpers for
-Claude Code, Codex, Kimi, OpenCode, and Cline under `.mimir/`. See the canonical GitHub README for
-the full agent demo.
+comma-separated list for native agent skill discovery. Native agent folders link back to
+`.mimir/skills/` by default so there is one original skill source. Mimir Core also generates MCP
+helpers for Claude Code, Codex, Kimi, OpenCode, and Cline under `.mimir/`. See the canonical GitHub
+README for the full agent demo.
 
 ## License
 

packages/mimir/dist/index.d.ts

@@ -11,7 +11,7 @@ export { redactText } from "./redaction.js";
 export { securityAudit } from "./security.js";
 export type { SetupResult } from "./setup.js";
 export { setupProject } from "./setup.js";
-export type { AgentInstallScope, AgentSkillInstallation, AgentTarget } from "./skill.js";
+export type { AgentInstallMode, AgentInstallScope, AgentSkillInstallation, AgentTarget, } from "./skill.js";
 export { bundledSkillPath, installAgentSkills, installSkill, parseAgentTargets, SUPPORTED_AGENT_TARGETS, } from "./skill.js";
 export type { AskResult, AuditReport, Config, DestroyIndexResult, DoctorReport, IngestResult, SearchResult, SecurityAuditReport, } from "./types.js";
 export { VERSION } from "./version.js";

packages/mimir/dist/skill.d.ts

@@ -1,5 +1,6 @@
 export type AgentTarget = "claude" | "codex" | "kimi" | "opencode" | "cline";
 export type AgentInstallScope = "project" | "user";
+export type AgentInstallMode = "link" | "copy";
 export interface InstallSkillOptions {
     cwd?: string;
     targetDir?: string;
@@ -22,13 +23,15 @@ export interface InstallAgentSkillsOptions {
     cwd?: string;
     agents?: readonly AgentTarget[];
     scope?: AgentInstallScope;
+    mode?: AgentInstallMode;
     homeDir?: string;
     env?: Record<string, string | undefined>;
 }
 export interface AgentSkillInstallation {
     agent: AgentTarget;
     label: string;
     scope: AgentInstallScope;
+    mode: AgentInstallMode;
     targetDir: string;
     skillPaths: string[];
 }