@compilr-dev/sdk 0.10.4 → 0.10.6

package/dist/agent.js

@@ -454,6 +454,12 @@ class CompilrAgentImpl {
     getUsage() {
         return { ...this.totalUsage };
     }
+    getModel() {
+        return this.agent.getModel();
+    }
+    setModel(modelId) {
+        this.agent.setModel(modelId);
+    }
     unwrap() {
         return this.agent;
     }

package/dist/config.d.ts

@@ -316,6 +316,10 @@ export interface CompilrAgent {
     clearHistory(): this;
     /** Get token usage info */
     getUsage(): UsageInfo;
+    /** Get the current model ID */
+    getModel(): string;
+    /** Change the model for subsequent LLM calls (same provider only) */
+    setModel(modelId: string): void;
     /** Get the underlying Agent instance */
     unwrap(): unknown;
     /** Abort the current run */

package/dist/guide/shared-content.js

@@ -129,22 +129,103 @@ Research projects have: /outline, /literature-review, /methodology, /abstract.
 Business projects have: /business-vision, /market-analysis, /financial-model, /pitch.
 
 Skills can be combined with your own instructions: type /design then add context.`,
+    },
+    {
+        id: 'custom-skills',
+        title: 'Custom Skills — Create Your Own Slash Commands',
+        keywords: [
+            'custom skill',
+            'user skill',
+            'project skill',
+            '/skill',
+            'SKILL.md',
+            'fork',
+            'bind',
+            'slash command',
+            'create skill',
+        ],
+        content: `You can create custom skills that become slash commands (e.g., /my-template).
+
+**What is a custom skill?**
+A folder with a SKILL.md file containing YAML frontmatter (name, description) and a markdown body (the prompt the agent receives). Follows the Anthropic Agent Skills format.
+
+**Two scopes:**
+- **User scope** (~/.compilr-dev/skills/) — personal, works across all projects
+- **Project scope** (<project>/.compilr/skills/) — shared via version control
+
+**CLI:** Use the /skill overlay to create, edit, fork, bind, enable/disable, delete, and rename skills. Press n to create, e to edit (fullscreen editor), f to fork an SDK skill, b to manage bindings.
+
+**Desktop:** The Agents panel has a Skills section showing custom skills. Click the maximize button to open the SkillsView tab with full management (create, fork, bind/unbind, enable/disable, delete). Click a skill name to view/edit in the code editor.
+
+**Forking SDK skills:**
+You cannot override built-in skills directly. Instead, fork them: this creates a copy with your changes. Then bind a slash command to your fork (e.g., /design → design-acme). The capability bundle still loads based on the command name.
+
+**Bindings:**
+Bindings remap slash commands to custom skills. Example: bind /design to your forked design-acme skill. When you type /design, it uses your custom prompt instead of the SDK version. Use the Bindings tab/section to manage them.
+
+**Validation:**
+Skills with issues (short description, empty body, name mismatch) show a ⚠ warning. Fix them in the editor — validation runs automatically on save.
+
+**Custom skills appear in:**
+- Slash command autocomplete (/ in chat)
+- Help menu (/help in CLI)
+- Slash command picker (/ button in Desktop)`,
     },
     // ── Models & Providers ──────────────────────────────────────────────────
     {
         id: 'models',
-        title: 'Models and Providers',
-        keywords: ['model', 'provider', 'claude', 'openai', 'gemini', 'ollama', 'llm'],
+        title: 'Models, Providers, and Model Switching',
+        keywords: [
+            'model',
+            'provider',
+            'claude',
+            'openai',
+            'gemini',
+            'ollama',
+            'llm',
+            'switch model',
+            'change model',
+            'hot swap',
+            'tier',
+            'fast',
+            'balanced',
+            'powerful',
+            'settings model',
+            'agent model',
+            'per-agent model',
+        ],
         content: `Compilr Dev supports multiple LLM providers:
 
-- Claude (Anthropic) — Claude Opus, Sonnet, Haiku
+- Claude (Anthropic) — Opus (powerful), Sonnet (balanced), Haiku (fast)
 - OpenAI — GPT-4o, GPT-4o-mini
 - Gemini (Google) — Gemini 2.5 Pro, Flash
 - Ollama — Local models (llama, codellama, etc.)
 - Together, Groq, Fireworks, Perplexity, OpenRouter
 
 Each provider requires an API key (except Ollama which runs locally).
-Models are organized by tier: premium, balanced, fast.`,
+
+**Model tiers:**
+- **Fast** — quick responses, lower cost (Haiku, GPT-4o-mini, Flash)
+- **Balanced** — best mix of speed and capability, the default (Sonnet, GPT-4o)
+- **Powerful** — best reasoning for complex tasks (Opus)
+
+**Settings model vs agent model — important distinction:**
+- The model in Settings is a **template for new agents**. Changing it does NOT affect existing agents. It only determines which model new agents get when you create them.
+- Each agent has its **own model**. You can change an agent's model independently without affecting other agents.
+
+**How to change an agent's model:**
+- **Desktop:** Click the model name in the status bar (bottom right) to open the model picker for the active chat's agent. You can also change models from the Agents panel.
+- **CLI:** Use /model to change the active agent's model.
+
+**Same provider only (Level 1):** You can switch between models within the same provider (e.g., Claude Sonnet → Claude Opus). Switching providers (e.g., Claude → Gemini) is not yet supported.
+
+**When to switch models:**
+- Use a **powerful** model (Opus) for complex architecture decisions, debugging hard problems, or writing nuanced content
+- Use the **balanced** model (Sonnet) for everyday coding, planning, and general tasks
+- Use a **fast** model (Haiku) for quick questions, simple edits, or when cost matters
+- Switch back after the hard task is done — no need to stay on the expensive model
+
+**Cost awareness:** switching from Haiku to Opus mid-conversation can significantly increase cost. The model tier is shown in the status bar and agent cards so you always know what you're using.`,
     },
     // ── Context & Memory ────────────────────────────────────────────────────
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@compilr-dev/agents": "^0.5.7",
+    "@compilr-dev/agents": "^0.5.8",
     "@compilr-dev/logger": "^0.1.0",
     "@compilr-dev/sdk": "^0.10.2",
     "ajv": "^6.14.0",