agent-from-zero 0.35.2 → 0.35.3

package/dist/agent.js

@@ -33,7 +33,7 @@ import { promptSelect, promptForm } from "./menu.js"; // arrow-key approval menu
 import { editLine } from "./editor.js"; // our own line editor (keeps the status footer pinned even when input wraps)
 import { normalizeDroppedPaths } from "./drop.js"; // drag-and-drop: a dropped file's path → a clean absolute path in the input
 import { rememberTool, readMemory, readMemoryTyped, extractMemories, MEMORY_PATH } from "./memory.js"; // long-term project memory + auto-extract
-import { currentSkills, findSkill, userSkillMessages } from "./skills.js"; // Markdown-as-plugin skills
+import { allSkills, currentSkills, findSkill, recordSkillUsage, skillLocked, skillMode, userSkillMessages } from "./skills.js"; // Markdown-as-plugin skills
 import { initCostMeter, DEFAULT_PRICING } from "./cost.js"; // token & cost accounting for /cost
 import { launchInk } from "./ink/launch.js"; // the Ink REPL — the default front-end for interactive sessions
 import { listBackground, hasRunningBackground, killAllBackground } from "./background.js"; // background tasks: /bg view + kill-on-exit (Day 37)
@@ -110,7 +110,7 @@ const SESSION_HELP = `commands:
   /undo      revert the most recent file write (write_file / edit_file) this session
   /diff      show every file changed this session, as a diff from where it started
   /resume    list recent sessions in this project and continue one of them
-  /skills    list the reusable skills available in this project
+  /skills    manage skills: turn each on, off, or user-only (search with /, sort with t)
   /skill <name> [args]  run a skill yourself (works even for user-only skills); /<name> [args] works too
   exit       leave (Ctrl+C at the prompt does the same)
 
@@ -607,6 +607,7 @@ async function main() {
             for (const content of userSkillMessages(s, args))
                 messages.push({ role: "user", content });
             autoMode.recordRequest(`/${s.name}${args ? ` ${args}` : ""}`);
+            recordSkillUsage(s.name); // feeds the "/" typeahead's most-used ranking
             console.log(chalk.dim(`(running skill: ${s.name})`));
             running = true;
             interrupted = false;
@@ -625,14 +626,15 @@ async function main() {
         }
         switch (line) {
             case "/skills": {
-                const skills = currentSkills();
+                const skills = allSkills(); // every skill, with its on / user-only / off state (toggle them in the Ink UI's /skills)
                 if (!skills.length) {
                     console.log(chalk.dim("(no skills — add one at .mini-agent/skills/<name>/SKILL.md or ~/.config/mini-agent/skills/)"));
                     return true;
                 }
                 console.log(chalk.dim(`skills in this project:`));
                 for (const s of skills) {
-                    const who = s.disableModelInvocation ? chalk.yellow("user-only") : chalk.green("model+user");
+                    const mode = skillMode(s);
+                    const who = mode === "on" ? chalk.green("on") : mode === "off" ? chalk.dim("off") : chalk.yellow(skillLocked(s) ? "user-only (locked)" : "user-only");
                     console.log(chalk.dim(`  ${s.name} [${who}${chalk.dim("]")} — ${(s.whenToUse || s.description).slice(0, 70)}`));
                 }
                 return true;

package/dist/completion.js

@@ -1,8 +1,9 @@
+import Fuse from "fuse.js"; // the fuzzy matcher Claude Code's "/" typeahead uses
 import { effortMenu } from "./effort.js";
 export const COMMANDS = [
     { value: "/model", description: "Switch the model for this session", children: true },
     { value: "/effort", description: "Choose this model's reasoning effort", children: true },
-    { value: "/skills", description: "Browse and run available skills", children: true },
+    { value: "/skills", description: "Turn skills on, off, or user-only" },
     { value: "/skill", description: "Run a skill by name", children: true },
     { value: "/help", description: "Show commands and keyboard shortcuts" },
     { value: "/clear", description: "Start a fresh conversation" },
@@ -23,6 +24,86 @@ export const COMMANDS = [
     { value: "/diff", description: "Show file changes this session" },
     { value: "/resume", description: "Choose a previous session" },
 ];
+// Every "/<command>" token in the text that names a real command or skill, as
+// [start, end) code-unit ranges — the input box paints these. Claude Code's
+// rule (findSlashCommandPositions): a "/" at the start or after whitespace,
+// then a letter and [A-Za-z0-9:_-]*, anywhere in the text; it lights up only
+// if that name exists. So "/grill-me," lights up, "/grill" and "a/grill-me" don't.
+export function commandTokenRanges(text, names) {
+    const known = new Set(names.map((n) => n.toLowerCase()));
+    const out = [];
+    for (const m of text.matchAll(/(^|\s)(\/[a-zA-Z][a-zA-Z0-9:\-_]*)/g)) {
+        const start = (m.index ?? 0) + m[1].length;
+        if (known.has(m[2].slice(1).toLowerCase()))
+            out.push([start, start + m[2].length]);
+    }
+    return out;
+}
+// Names a "/" can reach: built-in commands, then skills (a built-in wins a clash — it is what runs).
+export function commandNames(ctx) {
+    const builtins = COMMANDS.map((c) => c.value.slice(1));
+    return [...builtins, ...ctx.skills.map((s) => s.name).filter((n) => !builtins.includes(n))];
+}
+function typeaheadItems(ctx) {
+    const builtins = new Set(COMMANDS.map((c) => c.value));
+    const skills = ctx.skills
+        .filter((s) => !builtins.has(`/${s.name}`))
+        .map((s) => ({
+        value: `/${s.name}`,
+        name: s.name,
+        // Claude Code's formatDescriptionWithSource: "desc (User)" / "desc (Project)", plus the argument names.
+        description: `${s.description || s.whenToUse}${s.source ? ` (${s.source === "project" ? "Project" : "User"})` : ""}${s.argNames?.length ? ` (arguments: ${s.argNames.join(", ")})` : ""}`,
+        children: Boolean(s.argNames?.length), // takes arguments → Enter fills it in; none → Enter runs it
+        group: s.source ?? "user",
+        usage: ctx.usage?.(s.name) ?? 0,
+    }));
+    return [...COMMANDS.map((c) => ({ ...c, name: c.value.slice(1), group: "builtin", usage: 0 })), ...skills];
+}
+// The "/" typeahead, Claude Code's generateCommandSuggestions:
+//   bare "/"  → your 5 most-used skills, then built-ins, then user skills, then
+//               project skills, each group alphabetical
+//   "/query"  → Fuse.js over name (weight 3), name parts split on :_- (2) and
+//               description words (0.5), threshold 0.3; then re-sorted: exact
+//               name, then name prefix (shorter first), then fuzzy score (when
+//               it differs by > 0.1), then usage
+function commandTypeahead(input, ctx) {
+    const items = typeaheadItems(ctx);
+    const q = input.slice(1).toLowerCase();
+    const alpha = (a, b) => a.name.localeCompare(b.name);
+    if (!q) {
+        const top = items.filter((i) => i.usage > 0).sort((a, b) => b.usage - a.usage).slice(0, 5);
+        const rest = (group) => items.filter((i) => i.group === group && !top.includes(i)).sort(alpha);
+        return [...top, ...rest("builtin"), ...rest("user"), ...rest("project")];
+    }
+    const docs = items.map((item) => {
+        const parts = item.name.split(/[:_-]/);
+        return { item, commandName: item.name.toLowerCase(), partKey: parts.length > 1 ? parts.map((p) => p.toLowerCase()) : undefined, descriptionKey: item.description.toLowerCase().split(/\s+/).map((w) => w.replace(/[^a-z0-9]/g, "")).filter(Boolean) };
+    });
+    const fuse = new Fuse(docs, { includeScore: true, threshold: 0.3, location: 0, distance: 100, keys: [{ name: "commandName", weight: 3 }, { name: "partKey", weight: 2 }, { name: "descriptionKey", weight: 0.5 }] });
+    const rank = (name) => (name === q ? 0 : name.startsWith(q) ? 1 : 2);
+    return fuse.search(q).sort((a, b) => {
+        const an = a.item.commandName, bn = b.item.commandName;
+        if (rank(an) !== rank(bn))
+            return rank(an) - rank(bn);
+        if (rank(an) === 1 && an.length !== bn.length)
+            return an.length - bn.length;
+        const ds = (a.score ?? 0) - (b.score ?? 0);
+        if (Math.abs(ds) > 0.1)
+            return ds;
+        return b.item.item.usage - a.item.item.usage;
+    }).map((r) => r.item.item);
+}
+// A "/" in the middle of the text gets no list — just ghost text: the rest of
+// the best prefix match, dim, after the cursor; Tab accepts it as "/name ".
+// (Claude Code: getBestCommandMatch on /\s\/([a-zA-Z0-9_:-]*)$/ before the cursor.)
+export function inlineCommandGhost(beforeCursor, ctx) {
+    const m = beforeCursor.match(/\s\/([a-zA-Z0-9_:-]+)$/);
+    if (!m)
+        return null;
+    const partial = m[1].toLowerCase();
+    const best = commandNames(ctx).filter((n) => n.toLowerCase().startsWith(partial) && n.length > partial.length).sort((a, b) => a.length - b.length || a.localeCompare(b))[0];
+    return best ? { start: beforeCursor.length - m[1].length - 1, suffix: best.slice(partial.length), full: best } : null;
+}
 export function slashCompletions(input, ctx) {
     if (!input.startsWith("/") || /[\r\n]/.test(input))
         return null;
@@ -33,7 +114,7 @@ export function slashCompletions(input, ctx) {
         const menu = effortMenu(ctx.model);
         return { items: filter(menu.values.map((value, i) => ({ value: `/effort ${value}`, description: menu.labels[i] }))), hint: menu.header };
     }
-    if (command === "/skills" || command === "/skill") {
+    if ((command === "/skills" && parts.length) || command === "/skill") { // bare "/skills" opens the manager; "/skills <name>" still runs one
         return { items: ctx.skills.filter((s) => s.name.toLowerCase().startsWith(arg)).map((s) => ({ value: `/skill ${s.name}`, description: s.whenToUse || s.description })), hint: ctx.skills.length ? "Choose a skill to run" : "No skills found in project or user skill directories" };
     }
     if (command === "/model") {
@@ -61,5 +142,14 @@ export function slashCompletions(input, ctx) {
         const items = [{ value: "/mcp", description: "Open MCP server menu" }, { value: "/mcp reload", description: "Re-read MCP servers from settings.json" }, ...["tools", "auth", "clear-auth", "reconnect", "enable", "disable"].flatMap((action) => ctx.servers.map((name) => ({ value: `/mcp ${action} ${name}`, description: `${action} ${name}` })))];
         return { items: filter(items, input.trimEnd()) };
     }
+    if (!/\s/.test(input))
+        return { items: commandTypeahead(input, ctx), hint: "No matching commands or skills" };
+    // "/<skill> args…": the user is typing arguments now — no list, just the
+    // skill's argument hint while it has one (Claude Code's argumentHint).
+    const skill = ctx.skills.find((s) => `/${s.name.toLowerCase()}` === command.toLowerCase());
+    if (skill) {
+        const hint = skill.argumentHint || (skill.argNames?.length ? skill.argNames.map((a) => `<${a}>`).join(" ") : "");
+        return hint && !arg ? { items: [], hint } : null;
+    }
     return { items: filter(COMMANDS), hint: "Commands" };
 }

package/dist/config.js

@@ -90,6 +90,8 @@ export const CONFIG = {
     // a cheap/fast one for grunt work (reading many files, broad search), or a
     // strong one as an "advisor" to double-check. undefined → use the main model.
     subAgentModel: process.env.MINI_AGENT_SUBAGENT_MODEL || projectSettings.subAgentModel || globalSettings.subAgentModel || undefined,
+    // /skills on/off/user-only choices. Project entries override global ones.
+    skillOverrides: { ...(globalSettings.skillOverrides ?? {}), ...(projectSettings.skillOverrides ?? {}) },
     // Per-model windows (context.ts contextWindowFor): project entries override global ones.
     contextWindows: { ...(globalSettings.contextWindows ?? {}), ...(projectSettings.contextWindows ?? {}) },
     contextWindow: Number(process.env.MINI_AGENT_CONTEXT_WINDOW) || // env override first

package/dist/ink/app.js

@@ -10,6 +10,7 @@ import { initFormState, reduceForm, renderForm, collectAnswers } from "../form.j
 import { CONFIG, saveGlobalSetting } from "../config.js"; // session allowlist + /model save
 import { effortMenu, setEffort } from "../effort.js";
 import { useSlashCompletion } from "./completion.js";
+import { commandNames, commandTokenRanges, inlineCommandGhost } from "../completion.js"; // which /command tokens to paint + the mid-text ghost suggestion
 import { TerminateReason, listAgentViews } from "../loop.js"; // how a turn can end
 import { compactHistory, compactThreshold, contextWindowFor } from "../context.js"; // /compact + /model info
 import { forgetFilesExcept } from "../tools.js"; // /clear resets the file read-state
@@ -24,7 +25,8 @@ import { cronItemsPending, consumeCronQueue, cronTriggerContent } from "../cron.
 import { newSessionId, saveSession, listSessions, loadSession, setSessionTitle } from "../session.js";
 import { generateSessionTitle, setTerminalTitle } from "../title.js"; // concise session name, generated after the first message + the terminal tab that shows it
 import { isPlanMode, setPlanMode } from "../permissions.js";
-import { findSkill, userSkillMessages } from "../skills.js";
+import { findSkill, recordSkillUsage, skillSource, skillUsageScores, userSkillMessages } from "../skills.js";
+import { SkillsPanel } from "./skills-panel.js"; // /skills: Claude Code's on / user-only / off manager
 import { extractMemories } from "../memory.js";
 import { displayWidth } from "../editor.js"; // display-width measurement (CJK-aware)
 import { runHooks } from "../hooks.js";
@@ -45,6 +47,7 @@ const PLAN_MODE_NOTICE = `[plan mode ON] Investigate this request using only rea
 // it two cells wide — the text after the glyph then jumps on every other frame.
 const SPINNER_FRAMES = ["·", "✢", "✶", "✻", "✽", "✻", "✶", "✢"];
 const SPINNER_COLOR = "#D77757"; // Claude Code's orange
+const SKILL_COLOR = "#B1B9F9"; // Claude Code's lavender for a recognised /skill in the input
 const SHIMMER_PEAK = "#FFD2BD"; // the highlight that sweeps across the verb
 const SHIMMER_TICK_MS = 100; // one animation clock for glyph + shimmer → one repaint per tick
 const SHIMMER_RADIUS = 3; // how many cells the highlight fades over on each side
@@ -163,7 +166,7 @@ const EXIT_NOTES = {
 };
 export function App({ session, runTurn, clipboard }) {
     const { rows, columns } = useTerminalSize();
-    const { client, messages, systemMessage, costMeter, skills: liveSkills, judge, autoMode, model, dir, branch, getStatus } = session;
+    const { client, messages, systemMessage, costMeter, skills: liveSkills, allSkills: everySkill, judge, autoMode, model, dir, branch, getStatus } = session;
     // Seed the scrollback with the welcome banner + the dim startup notices.
     const [items, setItems] = useState(() => [{ kind: "note", text: session.bannerText }, ...session.notices.map((n) => ({ kind: "note", text: chalk.dim(n) }))]);
     const [status, setStatus] = useState(null); // the live spinner line
@@ -210,9 +213,12 @@ export function App({ session, runTurn, clipboard }) {
         modelListEndpoint.current = CONFIG.baseURL;
         void client.models.list().then((page) => setCompletionModels(page.data.map((m) => m.id))).catch(() => { });
     }, [wantsModels, client]);
+    const typeaheadSkills = liveSkills().map((s) => ({ name: s.name, description: s.description, whenToUse: s.whenToUse, argNames: s.argNames, argumentHint: s.argumentHint, source: skillSource(s) }));
     const completion = useSlashCompletion(input, completing, {
-        model: CONFIG.model, skills: liveSkills(), models: completionModels, servers: listMcpServers().map((s) => s.name),
-    }, rows - 10);
+        model: CONFIG.model, skills: typeaheadSkills, models: completionModels, servers: listMcpServers().map((s) => s.name), usage: completing && input.startsWith("/") ? skillUsageScores() : undefined,
+    }, rows - 10, columns);
+    // A "/" later in the text: no list, just the rest of the best match as dim ghost text (Tab accepts).
+    const ghost = completing && cursor === input.length ? inlineCommandGhost(input, { skills: typeaheadSkills }) : null;
     useEffect(() => {
         const id = setInterval(() => setTick((t) => t + 1), 1000);
         return () => clearInterval(id);
@@ -375,7 +381,7 @@ export function App({ session, runTurn, clipboard }) {
                 setFormState(null);
                 if (pending.kind === "form")
                     pending.resolve(null);
-                else
+                else if (pending.kind === "select")
                     pending.onChoose(-1);
             }
             if (immediate)
@@ -466,6 +472,11 @@ export function App({ session, runTurn, clipboard }) {
         }
         if (line.startsWith("/skills "))
             line = `/skill ${line.slice(8).trim()}`;
+        if (line === "/skills") {
+            setDetails(null);
+            setPending({ kind: "skills" });
+            return true;
+        } // Claude Code's manager: on / user-only / off per skill
         if (line === "/effort" || line.startsWith("/effort ")) {
             const target = CONFIG.model;
             const value = line.slice("/effort".length).trim();
@@ -557,6 +568,7 @@ export function App({ session, runTurn, clipboard }) {
                 return true;
             }
             autoMode.recordRequest(`/${s.name}${args ? ` ${args}` : ""}`);
+            recordSkillUsage(s.name); // feeds the "/" typeahead's most-used ranking
             runConversationTurn(userSkillMessages(s, args), { kind: "note", text: chalk.dim(`(running skill: ${s.name})`) });
             return true;
         }
@@ -664,6 +676,8 @@ export function App({ session, runTurn, clipboard }) {
             tuiCleanup();
             return exit(); // Ctrl+C quits immediately (process.on exit cleans up MCP/background)
         }
+        if (pending?.kind === "skills")
+            return; // the /skills panel owns the keyboard while it is open
         const modifiedReturn = char === "[13;5u" || char === "[27;5;13~";
         // A submitted follow-up may still be passing hooks. A second Enter must
         // not approve the old action while that asynchronous preparation runs.
@@ -792,6 +806,13 @@ export function App({ session, runTurn, clipboard }) {
                 return;
             }
         }
+        if (key.tab && ghost) { // accept the inline suggestion as "/name "
+            const next = input.slice(0, ghost.start) + `/${ghost.full} `;
+            setInput(next);
+            setCursor(next.length);
+            setHistIdx(null);
+            return;
+        }
         const completionAction = completion.handleKey(key, (value) => { setInput(value); setCursor(value.length); setHistIdx(null); });
         if (completionAction.handled && !completionAction.submit)
             return;
@@ -932,7 +953,7 @@ export function App({ session, runTurn, clipboard }) {
     const agentDetailView = detailPage(selectedAgent?.transcript || "(Waiting for activity…)", agentPage, Math.max(1, Math.min(10, rows - 10)), Math.max(1, columns - 4));
     const detailView = detailPage(details === "tools" ? getToolCalls() ?? "No tool calls this turn." : details === "reasoning" ? getReasoning() ?? "No thinking recorded this turn." : "", detailOffset, Math.max(1, Math.min(12, rows - 9)), Math.max(1, columns - 4));
     const activity = rows >= 20 && busy && !details && !pending && !subAgentDetail && !followUps.size ? summarizeActivity(getToolActivity(), Date.now(), rows >= 30 && !agents.length ? 2 : 1) : [];
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: items, children: (item, i) => _jsx(ItemView, { item: item }, i) }), _jsxs(Box, { flexDirection: "column", height: !pending && (details || selectedAgent) ? Math.max(1, rows - 1) : undefined, overflow: "hidden", children: [live !== null && !details && !pending && !selectedAgent && (_jsxs(Box, { marginTop: rows >= 20 ? 1 : 0, flexDirection: "row", children: [_jsx(Text, { color: "green", children: "\u23FA " }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { children: live === "" ? chalk.dim("…") : liveTail(live, rows, columns, followUps.size > 0) }) })] })), activity.map((group, i) => (_jsxs(Box, { flexDirection: "column", marginTop: i === 0 ? 1 : 0, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: group.failed ? "yellow" : group.running ? "cyan" : "green", children: "\u25CF " }), _jsx(Text, { bold: true, children: group.title })] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u23BF ", group.detail] })] }, i))), !details && !pending && !selectedAgent && (status !== null || busy) && (_jsx(Box, { marginTop: rows >= 20 ? 1 : 0, children: _jsx(SpinnerLine, { text: status?.replace("Ctrl+C to interrupt", "Esc to interrupt") ?? (live !== null ? "Writing…" : "Working…") }) })), rows >= 20 && !details && !selectedAgent && !pending && (busy || getToolCallCount() > 0) && (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  ", getToolCallCount(), " tool calls \u00B7 Ctrl+T details \u00B7 Ctrl+R thinking", busy ? " · Esc interrupt" : ""] })), details && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [details === "tools" ? "Tool details" : "Thinking", " \u00B7 ", detailView.pages - detailView.page, "/", detailView.pages, " \u00B7 \u2191\u2193 page \u00B7 Esc close", followUps.size ? ` · ${followUps.size} queued` : ""] }), _jsx(Text, { children: detailView.text })] })), selectedAgent && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "blue", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "cyan", wrap: "truncate-end", children: [selectedAgent.name, " \u00B7 ", selectedAgent.model, " \u00B7 ", selectedAgent.status, " \u00B7 Esc main"] }), _jsxs(Box, { children: [selectedAgent.status === "running" && _jsx(Spinner, {}), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [" ", selectedAgent.activity, " \u00B7 ", selectedAgent.toolCalls, " tools \u00B7 PgUp/PgDn details"] })] }), _jsx(Text, { children: agentDetailView.text })] })), pending?.kind === "select" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: pending.header }), pending.body && _jsx(Box, { marginY: 1, children: _jsx(Text, { children: pending.body }) }), _jsx(Text, { children: renderMenu(pending.options, menuSel) }), _jsx(Text, { children: MENU_HINT })] })), pending?.kind === "form" && formState && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: renderForm(pending.questions, formState) }) })), pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Type a follow-up \u00B7 Enter sends text; empty input selects \u00B7 Esc cancels" }), !details && !selectedAgent && !pending && followUps.size > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: rows >= 20 ? 1 : 0, children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Messages queued for the next tool boundary \u00B7 Esc / Ctrl+Enter interrupt and send" }), followUps.pending.slice(rows >= 20 ? -2 : -1).map((message, i) => _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u21B3 ", message.displayText ?? message.text] }, i)), followUps.size > 2 && _jsxs(Text, { dimColor: true, children: ["  \u2026 ", followUps.size - 2, " earlier messages queued"] })] })), _jsx(Box, { borderStyle: "round", borderColor: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan", paddingX: 1, marginTop: rows >= 20 ? 1 : 0, flexDirection: "column", flexShrink: 0, children: (() => {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: items, children: (item, i) => _jsx(ItemView, { item: item }, i) }), _jsxs(Box, { flexDirection: "column", height: !pending && (details || selectedAgent) ? Math.max(1, rows - 1) : undefined, overflow: "hidden", children: [live !== null && !details && !pending && !selectedAgent && (_jsxs(Box, { marginTop: rows >= 20 ? 1 : 0, flexDirection: "row", children: [_jsx(Text, { color: "green", children: "\u23FA " }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { children: live === "" ? chalk.dim("…") : liveTail(live, rows, columns, followUps.size > 0) }) })] })), activity.map((group, i) => (_jsxs(Box, { flexDirection: "column", marginTop: i === 0 ? 1 : 0, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: group.failed ? "yellow" : group.running ? "cyan" : "green", children: "\u25CF " }), _jsx(Text, { bold: true, children: group.title })] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u23BF ", group.detail] })] }, i))), !details && !pending && !selectedAgent && (status !== null || busy) && (_jsx(Box, { marginTop: rows >= 20 ? 1 : 0, children: _jsx(SpinnerLine, { text: status?.replace("Ctrl+C to interrupt", "Esc to interrupt") ?? (live !== null ? "Writing…" : "Working…") }) })), rows >= 20 && !details && !selectedAgent && !pending && (busy || getToolCallCount() > 0) && (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  ", getToolCallCount(), " tool calls \u00B7 Ctrl+T details \u00B7 Ctrl+R thinking", busy ? " · Esc interrupt" : ""] })), details && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [details === "tools" ? "Tool details" : "Thinking", " \u00B7 ", detailView.pages - detailView.page, "/", detailView.pages, " \u00B7 \u2191\u2193 page \u00B7 Esc close", followUps.size ? ` · ${followUps.size} queued` : ""] }), _jsx(Text, { children: detailView.text })] })), selectedAgent && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "blue", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "cyan", wrap: "truncate-end", children: [selectedAgent.name, " \u00B7 ", selectedAgent.model, " \u00B7 ", selectedAgent.status, " \u00B7 Esc main"] }), _jsxs(Box, { children: [selectedAgent.status === "running" && _jsx(Spinner, {}), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [" ", selectedAgent.activity, " \u00B7 ", selectedAgent.toolCalls, " tools \u00B7 PgUp/PgDn details"] })] }), _jsx(Text, { children: agentDetailView.text })] })), pending?.kind === "select" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: pending.header }), pending.body && _jsx(Box, { marginY: 1, children: _jsx(Text, { children: pending.body }) }), _jsx(Text, { children: renderMenu(pending.options, menuSel) }), _jsx(Text, { children: MENU_HINT })] })), pending?.kind === "skills" && (_jsx(SkillsPanel, { skills: everySkill(), maxRows: Math.max(3, rows - 14), onClose: (summary) => { setPending(null); note(chalk.dim(summary)); } })), pending?.kind === "form" && formState && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: renderForm(pending.questions, formState) }) })), pending && pending.kind !== "skills" && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Type a follow-up \u00B7 Enter sends text; empty input selects \u00B7 Esc cancels" }), !details && !selectedAgent && !pending && followUps.size > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: rows >= 20 ? 1 : 0, children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Messages queued for the next tool boundary \u00B7 Esc / Ctrl+Enter interrupt and send" }), followUps.pending.slice(rows >= 20 ? -2 : -1).map((message, i) => _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u21B3 ", message.displayText ?? message.text] }, i)), followUps.size > 2 && _jsxs(Text, { dimColor: true, children: ["  \u2026 ", followUps.size - 2, " earlier messages queued"] })] })), pending?.kind !== "skills" && (_jsx(Box, { borderStyle: "round", borderColor: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan", paddingX: 1, marginTop: rows >= 20 ? 1 : 0, flexDirection: "column", flexShrink: 0, children: (() => {
                             const prompt = "❯ ";
                             const promptColor = planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan";
                             const cols = columns;
@@ -941,6 +962,7 @@ export function App({ session, runTurn, clipboard }) {
                             const firstW = Math.max(1, innerWidth - promptW);
                             // Build visual lines display-width-aware (CJK, emoji = 2 cols).
                             const lines = [""];
+                            const lineStarts = [0]; // code-unit offset where each visual line begins (for skill highlighting)
                             let row = 0;
                             let col = 0;
                             // Cursor tracking: map code-unit offset → (line, display-column).
@@ -960,6 +982,7 @@ export function App({ session, runTurn, clipboard }) {
                                     row++;
                                     col = 0;
                                     lines[row] = "";
+                                    lineStarts[row] = cu;
                                 }
                                 lines[row] += ch;
                                 col += cw;
@@ -974,9 +997,35 @@ export function App({ session, runTurn, clipboard }) {
                             if (cursorCol >= edge) {
                                 cursorLine++;
                                 cursorCol = 0;
-                                if (lines.length <= cursorLine)
+                                if (lines.length <= cursorLine) {
                                     lines.push("");
+                                    lineStarts.push(cu);
+                                }
                             }
+                            // "/<skill>" tokens anywhere in the draft are painted — the typeahead
+                            // only opens at the start, but a real skill name lights up wherever
+                            // it is. paint() splits a slice of a line into plain and lit runs.
+                            const lit = commandTokenRanges(input, commandNames({ skills: liveSkills() }));
+                            const isLit = (at) => lit.some(([a, b]) => at >= a && at < b);
+                            const paint = (text, from, keyBase) => {
+                                const runs = [];
+                                let run = "";
+                                let runLit = false;
+                                let at = from;
+                                const flush = () => { if (run)
+                                    runs.push(_jsx(Text, { color: runLit ? SKILL_COLOR : undefined, children: run }, `${keyBase}${runs.length}`)); run = ""; };
+                                for (const ch of text) {
+                                    const l = isLit(at);
+                                    if (l !== runLit) {
+                                        flush();
+                                        runLit = l;
+                                    }
+                                    run += ch;
+                                    at += ch.length;
+                                }
+                                flush();
+                                return runs;
+                            };
                             // Map display-column back to code-unit offset within the target line.
                             const cursorLineText = lines[cursorLine] ?? "";
                             let cuOff = 0; // code-unit offset into cursorLineText that matches cursorCol
@@ -997,9 +1046,10 @@ export function App({ session, runTurn, clipboard }) {
                                     const before = line.slice(0, cuOff);
                                     const at = line.slice(cuOff, cuOff + 1) || " ";
                                     const after = line.slice(cuOff + 1);
-                                    return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: before }), _jsx(Text, { inverse: true, children: at }), _jsx(Text, { children: after })] }, i));
+                                    const base = lineStarts[i] ?? 0;
+                                    return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: paint(before, base, "b") }), _jsx(Text, { inverse: true, color: isLit(base + cuOff) ? SKILL_COLOR : undefined, children: ghost ? ghost.suffix[0] : at }), _jsx(Text, { children: paint(after, base + cuOff + at.length, "a") }), ghost && _jsx(Text, { dimColor: true, children: ghost.suffix.slice(1) })] }, i));
                                 }
-                                return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: line })] }, i));
+                                return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: paint(line, lineStarts[i] ?? 0, "l") })] }, i));
                             });
-                        })() }), completion.view, rows >= 20 && busy && !details && !selectedAgent && !pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Enter queue follow-up \u00B7 Ctrl+Enter interrupt and send now" }), rows >= 20 && !details && !selectedAgent && !pending && !completion.visible && _jsx(AgentList, { agents: agents, focus: subAgentFocus, viewing: subAgentDetail, mainBusy: busy, maxRows: Math.max(2, Math.min(3, rows - 24)) }), _jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, children: _jsx(StatusBar, { model: CONFIG.model, dir: dir, branch: branch, status: getStatus() }) }), _jsx(McpBadge, {})] }), (planMode || autoEnabled || CONFIG.bypassPermissions) && (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : "yellow", children: planMode ? "⏸ plan mode on" : CONFIG.bypassPermissions ? "▶▶ bypass permissions on" : "▶▶ auto mode on" }), _jsx(Text, { dimColor: true, children: planMode ? " (/plan to toggle)" : CONFIG.bypassPermissions ? " (this run)" : " (/auto to toggle)" })] }))] })] }));
+                        })() })), completion.view, rows >= 20 && busy && !details && !selectedAgent && !pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Enter queue follow-up \u00B7 Ctrl+Enter interrupt and send now" }), rows >= 20 && !details && !selectedAgent && !pending && !completion.visible && _jsx(AgentList, { agents: agents, focus: subAgentFocus, viewing: subAgentDetail, mainBusy: busy, maxRows: Math.max(2, Math.min(3, rows - 24)) }), _jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, children: _jsx(StatusBar, { model: CONFIG.model, dir: dir, branch: branch, status: getStatus() }) }), _jsx(McpBadge, {})] }), (planMode || autoEnabled || CONFIG.bypassPermissions) && (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : "yellow", children: planMode ? "⏸ plan mode on" : CONFIG.bypassPermissions ? "▶▶ bypass permissions on" : "▶▶ auto mode on" }), _jsx(Text, { dimColor: true, children: planMode ? " (/plan to toggle)" : CONFIG.bypassPermissions ? " (this run)" : " (/auto to toggle)" })] }))] })] }));
 }

package/dist/ink/commands.js

@@ -39,7 +39,7 @@ export const SESSION_HELP = `commands:
   /undo      revert the most recent file write (write_file / edit_file) this session
   /diff      show every file changed this session, as a diff from where it started
   /resume    list recent sessions in this project and continue one of them
-  /skills    list the reusable skills available in this project
+  /skills    manage skills: turn each on, off, or user-only (search with /, sort with t)
   /skill <name> [args]  run a skill yourself (works even for user-only skills); /<name> [args] works too
   exit       leave (Ctrl+C does the same)
 

package/dist/ink/completion.js

@@ -1,18 +1,19 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
 import { slashCompletions } from "../completion.js";
 // Keep the full list in state, but render only a window around the selection.
 // Long lists must never grow Ink's redraw region beyond the terminal height.
-export function useSlashCompletion(input, enabled, context, maxRows) {
+export function useSlashCompletion(input, enabled, context, maxRows, columns = 80) {
     const [selection, setSelection] = useState({ input: "", index: 0 });
     const [dismissed, setDismissed] = useState(null);
     useEffect(() => { setDismissed(null); }, [input]);
     const menu = enabled && dismissed !== input ? slashCompletions(input, context) : null;
     const items = menu?.items ?? [];
     const selected = Math.min(selection.input === input ? selection.index : 0, Math.max(0, items.length - 1));
-    const count = Math.max(1, Math.min(8, maxRows));
+    const count = Math.max(1, Math.min(6, maxRows)); // Claude Code shows at most 6, centred on the selection
     const start = Math.max(0, Math.min(selected - Math.floor(count / 2), items.length - count));
+    const nameWidth = Math.min(Math.max(0, ...items.map((item) => item.value.length)) + 2, Math.floor(columns * 0.4));
     return {
         visible: menu !== null,
         handleKey: (key, replace) => {
@@ -30,14 +31,21 @@ export function useSlashCompletion(input, enabled, context, maxRows) {
             }
             if (key.tab || (key.return && !key.ctrl && !key.meta)) {
                 const item = items[selected];
+                // Tab always just fills it in. Enter runs it — unless it takes
+                // arguments (a skill with `arguments`, or a command with sub-choices),
+                // then it fills "/name " so you can type them. (Claude Code's rule.)
                 if (key.tab || item.children)
-                    replace(item.value + (item.children ? " " : ""));
+                    replace(item.value + " ");
                 else
                     return { handled: true, submit: item.value };
                 return { handled: true };
             }
             return { handled: false };
         },
-        view: menu && (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [items.slice(start, start + count).map((item, i) => (_jsxs(Text, { color: start + i === selected ? "cyan" : undefined, bold: start + i === selected, wrap: "truncate-end", children: [start + i === selected ? "› " : "  ", item.value, "  ", _jsx(Text, { dimColor: true, children: item.description.replace(/\s+/g, " ") })] }, item.value))), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: items.length ? `↑↓ choose · Tab complete · Enter select · Esc close · ${selected + 1}/${items.length}` : menu.hint || "No matching commands" })] })),
+        view: menu && (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [items.slice(start, start + count).map((item, i) => {
+                    const on = start + i === selected;
+                    // Names in one column (at most 40% of the width); the description is one line, cut to fit.
+                    return (_jsxs(Text, { color: on ? "#B1B9F9" : undefined, dimColor: !on, wrap: "truncate-end", children: [on ? "› " : "  ", item.value.padEnd(nameWidth), item.description.replace(/\s+/g, " ")] }, item.value));
+                }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: items.length ? `↑↓ choose · Tab complete · Enter select · Esc close · ${selected + 1}/${items.length}` : menu.hint || "No matching commands" })] })),
     };
 }

package/dist/ink/setup.js

@@ -14,7 +14,7 @@ import { Judge } from "../judge.js";
 import { AutoMode } from "../auto.js";
 import { registerExternalTool } from "../tools.js";
 import { rememberTool, readMemory } from "../memory.js";
-import { currentSkills } from "../skills.js";
+import { allSkills, currentSkills } from "../skills.js";
 import { killAllBackground } from "../background.js";
 import { killAllSubAgents } from "../loop.js";
 import { loadDurableJobs, startCronScheduler, stopCronScheduler, listJobs } from "../cron.js"; // cron scheduler (Day s14)
@@ -107,6 +107,7 @@ export async function buildInkSession(opts = {}) {
         startedAt,
         costMeter,
         skills: () => currentSkills(),
+        allSkills: () => allSkills(),
         judge,
         autoMode,
         model: CONFIG.model,

package/dist/ink/skills-panel.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { nextSkillMode, nextSkillSort, setSkillMode, skillListingTokens, skillLocked, skillMode, skillPanelRows, skillSource } from "../skills.js";
+// /skills — Claude Code's skill manager. One row per skill on disk:
+//   ❯ ✔ on         grill-me · user · ~20 tok
+//     🔒 user-only  deploy · project · ~30 tok · locked by author
+// Enter/space cycles on → user-only → off (saved at once, live on the next
+// model call), "/" searches, "t" changes the sort, Esc closes. The panel owns
+// its keys while it is open; the app's main handler stands aside.
+const LAVENDER = "#B1B9F9";
+const SORT_LABEL = { name: "name", tokens: "tokens", source: "source" };
+function ModeCell({ mode, locked }) {
+    if (locked)
+        return _jsx(Text, { dimColor: true, children: "🔒 user-only " });
+    if (mode === "on")
+        return _jsx(Text, { color: "green", children: "✔ on        " });
+    if (mode === "user-only")
+        return _jsx(Text, { color: "yellow", children: "◐ user-only " });
+    return _jsx(Text, { dimColor: true, children: "○ off       " });
+}
+export function SkillsPanel({ skills, maxRows, onClose }) {
+    const [cursor, setCursor] = useState(0);
+    const [query, setQuery] = useState("");
+    const [searching, setSearching] = useState(false);
+    const [sort, setSort] = useState("name");
+    const [, setVersion] = useState(0); // re-render after a mode change (modes live in CONFIG)
+    const initial = useRef(new Map(skills.map((s) => [s.name, skillMode(s)]))).current; // for the summary on close
+    const rows = skillPanelRows(skills, query, sort);
+    const at = Math.min(cursor, Math.max(0, rows.length - 1));
+    useInput((char, key) => {
+        if (searching) {
+            if (key.escape || key.return) {
+                setSearching(false);
+                if (key.escape)
+                    setQuery("");
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setQuery((q) => q.slice(0, -1));
+                setCursor(0);
+                return;
+            }
+            if (key.upArrow || key.downArrow) {
+                setSearching(false);
+            } // fall through to navigation
+            else if (char === "/")
+                return; // skill names never contain "/": a second "/" press must not become the query
+            else if (char && !key.ctrl && !key.meta) {
+                setQuery((q) => q + char);
+                setCursor(0);
+                return;
+            }
+            else
+                return;
+        }
+        if (key.escape) {
+            const changes = skills.filter((s) => initial.get(s.name) !== skillMode(s)).map((s) => `${s.name} → ${skillMode(s)}`);
+            return onClose(changes.length ? `Skills updated: ${changes.join(", ")}` : "No changes");
+        }
+        if (key.upArrow)
+            return setCursor((c) => (rows.length ? (Math.min(c, rows.length - 1) - 1 + rows.length) % rows.length : 0));
+        if (key.downArrow)
+            return setCursor((c) => (rows.length ? (Math.min(c, rows.length - 1) + 1) % rows.length : 0));
+        if (char === "/")
+            return setSearching(true);
+        if (char === "t")
+            return setSort((s) => nextSkillSort(s));
+        if (key.return || char === " ") {
+            const s = rows[at];
+            if (!s || skillLocked(s))
+                return; // the author pinned it — nothing to cycle
+            setSkillMode(s.name, nextSkillMode(skillMode(s)));
+            setVersion((v) => v + 1);
+        }
+    });
+    // A window of rows around the cursor, so a long list never outgrows the terminal.
+    const count = Math.max(3, Math.min(rows.length, maxRows));
+    const start = Math.max(0, Math.min(at - Math.floor(count / 2), rows.length - count));
+    const shown = rows.slice(start, start + count);
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, color: LAVENDER, children: "Skills" }), _jsxs(Text, { dimColor: true, children: [skills.length, " skill", skills.length === 1 ? "" : "s", " \u00B7 ", searching ? "type to filter, ↑↓ to pick, Enter/Esc when done" : `enter/space to cycle, / to search, t to sort (${SORT_LABEL[sort]}), Esc to close`] }), _jsxs(Box, { borderStyle: "round", borderColor: searching ? LAVENDER : "gray", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: searching ? LAVENDER : undefined, dimColor: !searching, children: "Search: " }), _jsx(Text, { dimColor: !query && !searching, children: query || (searching ? "" : "press / to search skills…") }), searching && _jsx(Text, { inverse: true, children: " " })] }), start > 0 && _jsxs(Text, { dimColor: true, children: ["  \u2191 ", start, " more above"] }), shown.map((s, i) => {
+                const selected = start + i === at;
+                const locked = skillLocked(s);
+                return (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: LAVENDER, children: selected ? "❯ " : "  " }), _jsx(ModeCell, { mode: skillMode(s), locked: locked }), _jsxs(Text, { bold: !selected, color: selected ? LAVENDER : undefined, children: [" ", s.name] }), _jsxs(Text, { dimColor: true, children: [" \u00B7 ", skillSource(s), " \u00B7 ~", skillListingTokens(s), " tok", locked ? " · locked by author" : ""] })] }, s.path || s.name));
+            }), !rows.length && _jsxs(Text, { dimColor: true, children: ["  ", skills.length ? `No skills match "${query}"` : "No skills — add one at .mini-agent/skills/<name>/SKILL.md or ~/.config/mini-agent/skills/"] }), start + count < rows.length && _jsxs(Text, { dimColor: true, children: ["  \u2193 ", rows.length - start - count, " more below"] })] }));
+}

package/dist/skills.js

@@ -1,7 +1,7 @@
 import fs from "node:fs"; // discover and read SKILL.md files
 import os from "node:os"; // the global skills dir
 import path from "node:path"; // path resolution
-import { CONFIG } from "./config.js"; // the context window sizes the listing budget
+import { CONFIG, saveGlobalSetting } from "./config.js"; // the listing budget + /skills on/off choices
 import { registerExternalTool, tools, unregisterExternalTool } from "./tools.js"; // a skill is exposed to the model as a tool
 // Project skills win over global ones with the same name.
 function skillDirs() {
@@ -37,6 +37,7 @@ export function parseSkill(raw, fallbackName, filePath = "") {
             .filter(Boolean),
         disableModelInvocation: /^true$/i.test(fm.disableModelInvocation || fm["disable-model-invocation"] || ""),
         argumentHint: fm["argument-hint"] || "",
+        argNames: (fm.arguments || "").replace(/^\[|\]$/g, "").split(/[\s,]+/).map((a) => a.replace(/^["']|["']$/g, "")).filter(Boolean), // "a, b" or "[a, b]"
         body,
         path: filePath,
         dir: filePath ? path.dirname(filePath) : "",
@@ -100,19 +101,111 @@ function fingerprint(dirs) {
     }
     return parts.join("|");
 }
-// The live skill set: reloaded from disk only when a SKILL.md was added,
-// edited, or removed since the last call. `dirs` is injectable for tests.
-export function currentSkills(dirs = skillDirs()) {
+// Every skill on disk, whatever its /skills setting: reloaded only when a
+// SKILL.md was added, edited, or removed since the last call. `dirs` is
+// injectable for tests. The /skills panel lists these.
+export function allSkills(dirs = skillDirs()) {
     const key = dirs.join("\n");
     const fp = fingerprint(dirs);
     if (!cache || cache.key !== key || cache.fingerprint !== fp)
         cache = { key, fingerprint: fp, skills: loadSkills(dirs) };
     return cache.skills;
 }
+// The skills in effect — what the listing, the skill tool and /skill see.
+// The /skills choices apply here: "off" skills vanish entirely, "user-only"
+// ones stay runnable by the user but are hidden from the model.
+export function currentSkills(dirs = skillDirs()) {
+    return allSkills(dirs)
+        .filter((s) => skillMode(s) !== "off")
+        .map((s) => (skillMode(s) === "user-only" && !s.disableModelInvocation ? { ...s, disableModelInvocation: true } : s));
+}
+export const skillLocked = (s) => s.disableModelInvocation;
+export function skillMode(s) {
+    if (skillLocked(s))
+        return "user-only";
+    return CONFIG.skillOverrides[s.name] ?? "on";
+}
+// Enter/space in the panel: on → user-only → off → on.
+export const nextSkillMode = (m) => (m === "on" ? "user-only" : m === "user-only" ? "off" : "on");
+// Apply and persist a choice. "on" is the default, so it removes the entry
+// rather than storing it — the settings file only lists exceptions.
+export function setSkillMode(name, mode, persist = true) {
+    const next = { ...CONFIG.skillOverrides };
+    if (mode === "on")
+        delete next[name];
+    else
+        next[name] = mode;
+    CONFIG.skillOverrides = next;
+    if (persist)
+        saveGlobalSetting("skillOverrides", next);
+}
+// One panel row's facts: where it lives and what it costs the model to know
+// about it (its listing line, ~4 bytes per token — the same estimate as context.ts).
+export function skillSource(s) {
+    return s.path.startsWith(path.resolve(".mini-agent", "skills")) ? "project" : "user";
+}
+export const skillListingTokens = (s) => Math.ceil(Buffer.byteLength(listingEntry(s)) / 4);
+export const nextSkillSort = (s) => (s === "name" ? "tokens" : s === "tokens" ? "source" : "name");
+// The panel's list: filtered by the search box, sorted.
+// Matching is about the NAME: any part of it ("pul" finds co_dev_pulse). The
+// description only counts for a real word — 3+ characters that start one of
+// its words ("standup", "pulse") — and those rows come after the name matches.
+// A plain substring over descriptions matched everything: a single "a" is in
+// almost every sentence.
+export function skillPanelRows(skills, query, sort) {
+    const q = query.trim().toLowerCase();
+    const byName = (a, b) => a.name.localeCompare(b.name);
+    const order = (rows) => sort === "tokens" ? rows.sort((a, b) => skillListingTokens(b) - skillListingTokens(a) || byName(a, b))
+        : sort === "source" ? rows.sort((a, b) => skillSource(a).localeCompare(skillSource(b)) || byName(a, b))
+            : rows.sort(byName);
+    if (!q)
+        return order([...skills]);
+    const inName = skills.filter((s) => s.name.toLowerCase().includes(q));
+    const inWords = q.length >= 3 ? skills.filter((s) => !inName.includes(s) && s.description.toLowerCase().split(/[^a-z0-9]+/).some((w) => w.startsWith(q))) : [];
+    return [...order(inName), ...order(inWords)];
+}
 export function findSkill(skills, name) {
     const n = name.trim().replace(/^\//, "").toLowerCase(); // "/deploy" and "deploy" both work, like Claude Code
     return skills.find((s) => s.name.toLowerCase() === n);
 }
+// ---- usage: what the "/" typeahead puts first -----------------------------------------
+// Claude Code ranks a bare "/" by how much you use each skill: every run you
+// start yourself (/name or /skill name) counts, and old use fades — the score
+// halves every 7 days, never below a tenth. Kept in its own small file (not in
+// settings.json, which is for choices, not counters).
+// MINI_AGENT_SKILL_USAGE relocates it (tests point it at a scratch file).
+const usagePath = () => process.env.MINI_AGENT_SKILL_USAGE || path.join(os.homedir(), ".config", "mini-agent", "skill-usage.json");
+function readUsage() {
+    try {
+        return JSON.parse(fs.readFileSync(usagePath(), "utf8"));
+    }
+    catch {
+        return {}; // none yet, or unreadable — ranking just falls back to groups + names
+    }
+}
+export function recordSkillUsage(name, now = Date.now()) {
+    const usage = readUsage();
+    usage[name] = { usageCount: (usage[name]?.usageCount ?? 0) + 1, lastUsedAt: now };
+    try {
+        fs.mkdirSync(path.dirname(usagePath()), { recursive: true });
+        fs.writeFileSync(usagePath(), JSON.stringify(usage, null, 2) + "\n");
+    }
+    catch {
+        /* a counter is never worth failing a skill run over */
+    }
+}
+// One read of the usage file, scored per name — for the typeahead, which asks about every skill per keystroke.
+export function skillUsageScores(now = Date.now()) {
+    const usage = readUsage();
+    return (name) => skillUsageScore(name, now, usage);
+}
+export function skillUsageScore(name, now = Date.now(), usage = readUsage()) {
+    const u = usage[name];
+    if (!u)
+        return 0;
+    const days = (now - u.lastUsedAt) / 86_400_000;
+    return u.usageCount * Math.max(0.5 ** (days / 7), 0.1);
+}
 // ---- the listing, as a <system-reminder> ------------------------------------------
 export const wrapInSystemReminder = (content) => `<system-reminder>\n${content}\n</system-reminder>`;
 const LISTING_HEADER = "The following skills are available for use with the skill tool:"; // Claude Code's wording, our tool name

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-from-zero",
-  "version": "0.35.2",
+  "version": "0.35.3",
   "type": "module",
   "bin": {
     "mini-agent": "dist/agent.js"
@@ -26,6 +26,7 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
+    "fuse.js": "^7.5.0",
     "ink": "^5.2.1",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",