Merge branch 'main' into hermes-pr-fix

# Conflicts:
#	README.md

Author: rohitg00

README.md

@@ -5,7 +5,45 @@ Universal skills manager for AI coding agents. Install, manage, and sync skills
 ## Installation
 
 ```bash
+# Full install (default) — every feature, everything works:
 npm install -g skillkit
+
+# Slim install — core commands only, ~75% smaller, no native addons:
+npm install -g skillkit --omit=optional
+```
+
+### What's optional
+
+Four power features ship as **optional dependencies** so the core CLI
+stays lean. They install automatically with `npm install -g skillkit`,
+and are skipped with `--omit=optional`:
+
+| Feature                  | Package              | Command                        |
+| ------------------------ | -------------------- | ------------------------------ |
+| Interactive terminal UI  | `@skillkit/tui`      | `skillkit ui` / `skillkit tui` |
+| REST/OpenAPI server      | `@skillkit/api`      | `skillkit serve`               |
+| Peer mesh networking     | `@skillkit/mesh`     | `skillkit mesh …`              |
+| Inter-agent messaging    | `@skillkit/messaging`| `skillkit message …`           |
+
+Add one later with `npm install -g @skillkit/tui` (or `api` / `mesh` / `messaging`).
+
+### Using `npx`
+
+`npx skillkit add <owner/repo>` works with zero install. First run pulls
+the package into the npx cache (`~/.npm/_npx/`); every subsequent run
+from the same cache is instant.
+
+```bash
+npx skillkit add anthropics/skills                    # full
+npx --omit=optional skillkit add anthropics/skills    # slim, 118 pkgs, 9 s
+```
+
+Running `npx` more than a couple of times? Install globally — no
+prompt-to-proceed, no refetch on each release:
+
+```bash
+npm install -g skillkit --omit=optional
+skillkit add anthropics/skills
 ```
 
 ## Quick Start

apps/skillkit/README.md

@@ -1,6 +1,6 @@
 {
   "name": "skillkit",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 41 more",
   "type": "module",
   "bin": {
@@ -53,15 +53,16 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@skillkit/api": "workspace:*",
     "@skillkit/core": "workspace:*",
     "@skillkit/agents": "workspace:*",
     "@skillkit/cli": "workspace:*",
+    "clipanion": "^4.0.0-rc.4"
+  },
+  "optionalDependencies": {
+    "@skillkit/api": "workspace:*",
     "@skillkit/tui": "workspace:*",
-    "@skillkit/memory": "workspace:*",
     "@skillkit/mesh": "workspace:*",
-    "@skillkit/messaging": "workspace:*",
-    "clipanion": "^4.0.0-rc.4"
+    "@skillkit/messaging": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",

apps/skillkit/package.json

@@ -1,6 +1,7 @@
-// Re-export all public APIs from packages
 export * from '@skillkit/core';
 export * from '@skillkit/agents';
 
-// Re-export TUI entry point
-export { startTUI } from '@skillkit/tui';
+export async function startTUI(...args: unknown[]): Promise<unknown> {
+  const mod = await import('@skillkit/tui');
+  return mod.startTUI(...(args as Parameters<typeof mod.startTUI>));
+}

apps/skillkit/src/index.ts

@@ -7,4 +7,7 @@ export default defineConfig({
   splitting: false,
   sourcemap: true,
   clean: true,
+  platform: 'node',
+  target: 'node18',
+  skipNodeModulesBundle: true,
 });