@polterware/polter 0.4.0 → 0.4.2

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   allCommands,
   applyActions,
   commandExists,
+  createIpcServer,
   detectPkgManager,
   executePipeline,
   features,
@@ -21,6 +22,9 @@ import {
   getOrCreateProjectConfig,
   getProcessOutput,
   getProjectConfigPath,
+  getSkillContent,
+  getSkillPath,
+  getSocketPath,
   getToolDisplayName,
   getToolInfo,
   getToolLinkInfo,
@@ -30,6 +34,7 @@ import {
   mcpStatus,
   parsePolterYaml,
   planChanges,
+  registerForegroundProcess,
   removeMcpServer,
   removeMcpServerSilent,
   removeProcess,
@@ -38,18 +43,20 @@ import {
   runInteractiveCommand,
   runSupabaseCommand,
   savePipeline,
+  setupSkill,
+  setupSkillCli,
   startProcess,
   stopProcess,
   translateCommand,
   writeProjectConfig
-} from "./chunk-YNOZDU75.js";
+} from "./chunk-CWBIXRZP.js";
 
 // src/index.tsx
-import React28 from "react";
+import React29 from "react";
 import { render } from "ink";
 
 // src/app.tsx
-import { Box as Box29, Text as Text33, useApp } from "ink";
+import { Box as Box30, Text as Text34, useApp } from "ink";
 
 // src/hooks/useNavigation.ts
 import { useState, useCallback } from "react";
@@ -914,6 +921,13 @@ function buildHomeItems({
     hint: "Free-form args",
     kind: "action"
   });
+  items.push({
+    id: "action-skill-setup",
+    value: "__action_skill_setup__",
+    label: "Skill Setup",
+    hint: "Install Claude Code skill",
+    kind: "action"
+  });
   items.push({
     id: "action-update",
     value: "__action_update__",
@@ -1028,6 +1042,9 @@ function Home({
       case "__action_config__":
         onNavigate("project-config");
         break;
+      case "__action_skill_setup__":
+        onNavigate("skill-setup");
+        break;
       case "__action_update__":
         onNavigate("self-update");
         break;
@@ -1659,26 +1676,11 @@ function FlagSelection({
 
 // src/screens/CommandExecution.tsx
 import { useState as useState12, useEffect as useEffect9 } from "react";
-import { Box as Box13, Text as Text17, useInput as useInput8 } from "ink";
-
-// src/components/Spinner.tsx
-import { Text as Text12 } from "ink";
-import InkSpinner from "ink-spinner";
-import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
-function Spinner({
-  label = "Running...",
-  color = inkColors.accent
-}) {
-  return /* @__PURE__ */ jsxs11(Text12, { children: [
-    /* @__PURE__ */ jsx12(Text12, { color, children: /* @__PURE__ */ jsx12(InkSpinner, { type: "dots" }) }),
-    " ",
-    /* @__PURE__ */ jsx12(Text12, { children: label })
-  ] });
-}
+import { Box as Box13, Text as Text15, useInput as useInput8 } from "ink";
 
 // src/components/ConfirmPrompt.tsx
-import { Box as Box11, Text as Text13, useInput as useInput6 } from "ink";
-import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
+import { Box as Box11, Text as Text12, useInput as useInput6 } from "ink";
+import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 function ConfirmPrompt({
   message,
   defaultValue = true,
@@ -1704,16 +1706,16 @@ function ConfirmPrompt({
       onConfirm(defaultValue);
     }
   }, { isActive: isInputActive });
-  return /* @__PURE__ */ jsxs12(Box11, { gap: 1, children: [
-    /* @__PURE__ */ jsx13(Text13, { color: inkColors.accent, bold: true, children: "?" }),
-    /* @__PURE__ */ jsx13(Text13, { children: message }),
-    /* @__PURE__ */ jsx13(Text13, { dimColor: true, children: defaultValue ? "(Y/n)" : "(y/N)" })
+  return /* @__PURE__ */ jsxs11(Box11, { gap: 1, children: [
+    /* @__PURE__ */ jsx12(Text12, { color: inkColors.accent, bold: true, children: "?" }),
+    /* @__PURE__ */ jsx12(Text12, { children: message }),
+    /* @__PURE__ */ jsx12(Text12, { dimColor: true, children: defaultValue ? "(Y/n)" : "(y/N)" })
   ] });
 }
 
 // src/components/Divider.tsx
-import { Text as Text14 } from "ink";
-import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Text as Text13 } from "ink";
+import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 function Divider({
   label,
   width
@@ -1724,7 +1726,7 @@ function Divider({
     const sideLen = Math.max(2, Math.floor((effectiveWidth - labelLen) / 2));
     const left = "\u2500".repeat(sideLen);
     const right = "\u2500".repeat(sideLen);
-    return /* @__PURE__ */ jsxs13(Text14, { dimColor: true, children: [
+    return /* @__PURE__ */ jsxs12(Text13, { dimColor: true, children: [
       left,
       " ",
       label,
@@ -1732,16 +1734,13 @@ function Divider({
       right
     ] });
   }
-  return /* @__PURE__ */ jsx14(Text14, { dimColor: true, children: "\u2500".repeat(effectiveWidth) });
+  return /* @__PURE__ */ jsx13(Text13, { dimColor: true, children: "\u2500".repeat(effectiveWidth) });
 }
 
-// src/components/CommandOutput.tsx
-import { Text as Text16 } from "ink";
-
 // src/components/ScrollableBox.tsx
 import { useState as useState10, useEffect as useEffect6, useRef } from "react";
-import { Box as Box12, Text as Text15, useInput as useInput7 } from "ink";
-import { jsx as jsx15, jsxs as jsxs14 } from "react/jsx-runtime";
+import { Box as Box12, Text as Text14, useInput as useInput7 } from "ink";
+import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
 function ScrollableBox({
   height,
   isActive = true,
@@ -1780,42 +1779,10 @@ function ScrollableBox({
   const showScrollUp = scrollOffset > 0;
   const showScrollDown = scrollOffset + visibleCount < totalItems;
   const visible = children.slice(scrollOffset, scrollOffset + visibleCount);
-  return /* @__PURE__ */ jsxs14(Box12, { flexDirection: "column", height, children: [
-    showScrollUp && /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "  \u2191 more" }),
+  return /* @__PURE__ */ jsxs13(Box12, { flexDirection: "column", height, children: [
+    showScrollUp && /* @__PURE__ */ jsx14(Text14, { dimColor: true, children: "  \u2191 more" }),
     visible,
-    showScrollDown && /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "  \u2193 more" })
-  ] });
-}
-
-// src/lib/ansi.ts
-var ANSI_RE = (
-  // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI stripping
-  /[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[-a-zA-Z\d/#&.:=?%@~_]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g
-);
-function stripAnsi(text) {
-  return text.replace(ANSI_RE, "");
-}
-
-// src/components/CommandOutput.tsx
-import { jsx as jsx16 } from "react/jsx-runtime";
-function cleanLines(raw) {
-  const stripped = stripAnsi(raw);
-  return stripped.replace(/\r/g, "").split("\n").filter((line) => line.length > 0);
-}
-function CommandOutput({
-  stdout,
-  stderr,
-  height,
-  isActive = false
-}) {
-  const outLines = stdout ? cleanLines(stdout) : [];
-  const errLines = stderr ? cleanLines(stderr) : [];
-  if (outLines.length === 0 && errLines.length === 0) {
-    return null;
-  }
-  return /* @__PURE__ */ jsx16(ScrollableBox, { height: Math.max(3, height), isActive, children: [
-    ...outLines.map((line, i) => /* @__PURE__ */ jsx16(Text16, { children: line }, `o-${i}`)),
-    ...errLines.map((line, i) => /* @__PURE__ */ jsx16(Text16, { color: "red", children: line }, `e-${i}`))
+    showScrollDown && /* @__PURE__ */ jsx14(Text14, { dimColor: true, children: "  \u2193 more" })
   ] });
 }
 
@@ -1857,6 +1824,12 @@ function useCommand(execution = "supabase", cwd = process.cwd(), options) {
     const runOpts = { quiet: options?.quiet, onData };
     const handle = runCommand(resolvedExecution, args, cwd, runOpts);
     abortRef.current = handle.abort;
+    const cmdStr = typeof resolvedExecution === "string" ? resolvedExecution : resolvedExecution.command;
+    const processId = generateProcessId(cmdStr, args);
+    try {
+      registerForegroundProcess(processId, cmdStr, args, cwd, handle.child);
+    } catch {
+    }
     const res = await handle.promise;
     abortRef.current = null;
     setResult(res);
@@ -1945,6 +1918,15 @@ async function copyToClipboard(text) {
   });
 }
 
+// src/lib/ansi.ts
+var ANSI_RE = (
+  // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI stripping
+  /[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[-a-zA-Z\d/#&.:=?%@~_]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g
+);
+function stripAnsi(text) {
+  return text.replace(ANSI_RE, "");
+}
+
 // src/lib/errorSuggestions.ts
 var KNOWN_TOOLS = ["supabase", "gh", "vercel", "git"];
 var BACKTICK_CMD = /(?:try\s+)?(?:run(?:ning)?|use|execute)\s+`([^`]+)`/gi;
@@ -1991,7 +1973,7 @@ ${stderr}`);
 }
 
 // src/screens/CommandExecution.tsx
-import { jsx as jsx17, jsxs as jsxs15 } from "react/jsx-runtime";
+import { jsx as jsx15, jsxs as jsxs14 } from "react/jsx-runtime";
 function CommandExecution({
   args: initialArgs,
   tool = "supabase",
@@ -2016,27 +1998,38 @@ function CommandExecution({
   const { runInteractive } = useInteractiveRun();
   const [outputFocused, setOutputFocused] = useState12(false);
   const [copyMessage, setCopyMessage] = useState12();
+  const [feedback, setFeedback] = useState12();
+  const [aborting, setAborting] = useState12(false);
   const cmdDisplay = rawCommand ? `${rawCommand} ${currentArgs.join(" ")}`.trim() : `${getToolDisplayName(tool)} ${currentArgs.join(" ")}`;
   const runCommand2 = currentArgs.join(" ");
   useInput8(
-    (_input, key) => {
+    (input2, key) => {
       if (key.escape) {
         abort();
         onBack();
+        return;
+      }
+      if (input2 === "x" && !aborting) {
+        abort();
+        setAborting(true);
+        setFeedback("Aborting...");
+        return;
+      }
+      if (input2 === "c") {
+        const output2 = [partialStdout, partialStderr].filter(Boolean).join("\n");
+        copyToClipboard(output2).then(() => setFeedback("Copied to clipboard"));
+        return;
       }
     },
     { isActive: isInputActive && phase === "running" }
   );
   useInput8(
-    (input2, key) => {
-      if (input2 === "o" && !outputFocused) {
-        setOutputFocused(true);
-      }
-      if (key.escape && outputFocused) {
-        setOutputFocused(false);
+    (input2, _key) => {
+      if (input2 === "/") {
+        setOutputFocused((prev) => !prev);
       }
     },
-    { isActive: isInputActive && phase === "error-menu" }
+    { isActive: isInputActive && (phase === "error-menu" || phase === "success") }
   );
   useEffect9(() => {
     if (phase === "background-started") {
@@ -2070,6 +2063,12 @@ function CommandExecution({
       setPhase("error-menu");
     }
   }, [phase, runCommand2, status]);
+  useEffect9(() => {
+    if (feedback) {
+      const timer = setTimeout(() => setFeedback(void 0), 2e3);
+      return () => clearTimeout(timer);
+    }
+  }, [feedback]);
   if (phase === "confirm") {
     const pinned = isPinnedRun(runCommand2);
     const confirmItems = [
@@ -2086,17 +2085,17 @@ function CommandExecution({
       },
       { value: "cancel", label: "\u2190 Cancel" }
     ];
-    const confirmContent = /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsxs15(Box13, { marginBottom: 1, gap: 1, children: [
-        /* @__PURE__ */ jsxs15(Text17, { color: inkColors.accent, bold: true, children: [
+    const confirmContent = /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, gap: 1, children: [
+        /* @__PURE__ */ jsxs14(Text15, { color: inkColors.accent, bold: true, children: [
           "\u25B6",
           " ",
           cmdDisplay
         ] }),
-        /* @__PURE__ */ jsx17(ToolBadge, { tool })
+        /* @__PURE__ */ jsx15(ToolBadge, { tool })
       ] }),
-      pinMessage && /* @__PURE__ */ jsx17(Box13, { marginBottom: 1, children: /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: pinMessage }) }),
-      /* @__PURE__ */ jsx17(
+      pinMessage && /* @__PURE__ */ jsx15(Box13, { marginBottom: 1, children: /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, children: pinMessage }) }),
+      /* @__PURE__ */ jsx15(
         SelectList,
         {
           items: confirmItems,
@@ -2139,7 +2138,7 @@ function CommandExecution({
         }
       )
     ] });
-    return /* @__PURE__ */ jsx17(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: panelMode ? /* @__PURE__ */ jsx17(
+    return /* @__PURE__ */ jsx15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: panelMode ? /* @__PURE__ */ jsx15(
       Box13,
       {
         flexDirection: "column",
@@ -2152,54 +2151,71 @@ function CommandExecution({
     ) : confirmContent });
   }
   if (phase === "background-started") {
-    return /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
-      /* @__PURE__ */ jsxs15(Box13, { marginY: 1, gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: "#3ECF8E", bold: true, children: "\u2713" }),
-        /* @__PURE__ */ jsx17(Text17, { color: "#3ECF8E", bold: true, children: "Started in background" })
+    return /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+      /* @__PURE__ */ jsxs14(Box13, { marginY: 1, gap: 1, children: [
+        /* @__PURE__ */ jsx15(Text15, { color: "#3ECF8E", bold: true, children: "\u2713" }),
+        /* @__PURE__ */ jsx15(Text15, { color: "#3ECF8E", bold: true, children: "Started in background" })
       ] }),
-      /* @__PURE__ */ jsxs15(Box13, { children: [
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Command: " }),
-        /* @__PURE__ */ jsx17(Text17, { children: cmdDisplay })
+      /* @__PURE__ */ jsxs14(Box13, { children: [
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Command: " }),
+        /* @__PURE__ */ jsx15(Text15, { children: cmdDisplay })
       ] })
     ] });
   }
   if (phase === "running") {
-    const hasPartialOutput = partialStdout.length > 0 || partialStderr.length > 0;
-    const streamOutputHeight = Math.max(3, height - 10);
-    return /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
-      /* @__PURE__ */ jsx17(Divider, { width: panelMode ? width - 4 : width }),
-      /* @__PURE__ */ jsxs15(Box13, { marginY: 1, gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, bold: true, children: "\u25B6" }),
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Running:" }),
-        /* @__PURE__ */ jsx17(Text17, { children: cmdDisplay }),
-        /* @__PURE__ */ jsx17(ToolBadge, { tool })
+    const outputText = [partialStdout, partialStderr].filter(Boolean).join("\n");
+    const outputLines = outputText ? stripAnsi(outputText).split("\n") : [];
+    const logBoxHeight = Math.max(3, height - 7);
+    const cardWidth = Math.max(30, (panelMode ? width - 4 : width) - 2);
+    return /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+      /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, gap: 1, children: [
+        /* @__PURE__ */ jsxs14(Text15, { color: inkColors.accent, bold: true, children: [
+          "\u25B6",
+          " ",
+          cmdDisplay
+        ] }),
+        /* @__PURE__ */ jsx15(ToolBadge, { tool }),
+        /* @__PURE__ */ jsxs14(Text15, { color: aborting ? "yellow" : "green", children: [
+          "\u25CF ",
+          aborting ? "aborting" : "running"
+        ] })
       ] }),
-      /* @__PURE__ */ jsx17(Divider, { width: panelMode ? width - 4 : width }),
-      /* @__PURE__ */ jsx17(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx17(Spinner, { label: `Executing ${cmdDisplay}...` }) }),
-      hasPartialOutput && /* @__PURE__ */ jsx17(
-        CommandOutput,
+      /* @__PURE__ */ jsx15(
+        Box13,
         {
-          stdout: partialStdout,
-          stderr: partialStderr,
-          height: streamOutputHeight,
-          isActive: false
+          flexDirection: "column",
+          borderStyle: "round",
+          borderColor: inkColors.accent,
+          paddingX: 1,
+          width: cardWidth,
+          children: /* @__PURE__ */ jsx15(
+            ScrollableBox,
+            {
+              height: logBoxHeight,
+              isActive: isInputActive,
+              autoScrollToBottom: true,
+              children: outputLines.length === 0 ? [/* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Waiting for output..." }, "empty")] : outputLines.map((line, i) => /* @__PURE__ */ jsx15(Text15, { wrap: "truncate", children: line }, i))
+            }
+          )
         }
       ),
-      /* @__PURE__ */ jsxs15(Box13, { marginTop: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Press " }),
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: "Esc" }),
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: " to abort" })
+      feedback && /* @__PURE__ */ jsx15(Box13, { children: /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, children: feedback }) }),
+      /* @__PURE__ */ jsxs14(Box13, { marginTop: 1, gap: 2, children: [
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "\u2191\u2193:scroll" }),
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "x:abort" }),
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "c:copy" }),
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Esc:back" })
       ] })
     ] });
   }
   if (phase === "success-pin-offer") {
-    return /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
-      /* @__PURE__ */ jsx17(Divider, { width: panelMode ? width - 4 : width }),
-      /* @__PURE__ */ jsxs15(Box13, { marginY: 1, gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, bold: true, children: "\u2713" }),
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, bold: true, children: "Command completed successfully!" })
+    return /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+      /* @__PURE__ */ jsx15(Divider, { width: panelMode ? width - 4 : width }),
+      /* @__PURE__ */ jsxs14(Box13, { marginY: 1, gap: 1, children: [
+        /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, bold: true, children: "\u2713" }),
+        /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, bold: true, children: "Command completed successfully!" })
       ] }),
-      /* @__PURE__ */ jsx17(
+      /* @__PURE__ */ jsx15(
         ConfirmPrompt,
         {
           message: "Pin this exact command?",
@@ -2222,24 +2238,49 @@ function CommandExecution({
     const successItems = [
       { value: "__back__", label: "\u2190 Back to menu" }
     ];
-    const outputHeight = Math.max(3, height - 12);
-    return /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
-      /* @__PURE__ */ jsx17(Divider, { width: panelMode ? width - 4 : width }),
-      /* @__PURE__ */ jsxs15(Box13, { marginY: 1, gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, bold: true, children: "\u2713" }),
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, bold: true, children: "Command completed successfully!" })
+    const successOutput = [result?.stdout, result?.stderr].filter(Boolean).join("\n");
+    const successLines = successOutput ? stripAnsi(successOutput).split("\n") : [];
+    const successLogHeight = Math.max(3, height - 9 - (pinMessage ? 1 : 0));
+    const successCardWidth = Math.max(30, (panelMode ? width - 4 : width) - 2);
+    return /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+      /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, gap: 1, children: [
+        /* @__PURE__ */ jsxs14(Text15, { color: inkColors.accent, bold: true, children: [
+          "\u2713",
+          " ",
+          cmdDisplay
+        ] }),
+        /* @__PURE__ */ jsx15(ToolBadge, { tool }),
+        /* @__PURE__ */ jsx15(Text15, { color: "green", children: "\u25CF completed" })
       ] }),
-      pinMessage && /* @__PURE__ */ jsx17(Box13, { marginBottom: 1, children: /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: pinMessage }) }),
-      /* @__PURE__ */ jsx17(
-        CommandOutput,
+      pinMessage && /* @__PURE__ */ jsx15(Box13, { marginBottom: 1, children: /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, children: pinMessage }) }),
+      /* @__PURE__ */ jsx15(
+        Box13,
         {
-          stdout: result?.stdout,
-          stderr: result?.stderr,
-          height: outputHeight,
-          isActive: isInputActive
+          flexDirection: "column",
+          borderStyle: "round",
+          borderColor: outputFocused ? inkColors.accent : panel.borderDim,
+          paddingX: 1,
+          width: successCardWidth,
+          children: /* @__PURE__ */ jsx15(
+            ScrollableBox,
+            {
+              height: successLogHeight,
+              isActive: isInputActive && outputFocused,
+              autoScrollToBottom: true,
+              children: successLines.length === 0 ? [/* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "No output" }, "empty")] : successLines.map((line, i) => /* @__PURE__ */ jsx15(Text15, { wrap: "truncate", children: line }, i))
+            }
+          )
         }
       ),
-      /* @__PURE__ */ jsx17(
+      /* @__PURE__ */ jsxs14(Box13, { marginTop: 1, gap: 2, children: [
+        /* @__PURE__ */ jsxs14(Text15, { dimColor: true, children: [
+          "/:",
+          outputFocused ? "menu" : "scroll"
+        ] }),
+        outputFocused && /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "\u2191\u2193:scroll" }),
+        /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Esc:back" })
+      ] }),
+      /* @__PURE__ */ jsx15(
         SelectList,
         {
           items: successItems,
@@ -2247,10 +2288,10 @@ function CommandExecution({
           onCancel: onHome ?? onBack,
           width: panelMode ? Math.max(20, width - 4) : width,
           maxVisible: panelMode ? Math.max(6, height - 6) : void 0,
-          isInputActive,
+          isInputActive: isInputActive && !outputFocused,
           arrowNavigation: panelMode,
           boxedSections: panelMode,
-          panelFocused: isInputActive
+          panelFocused: isInputActive && !outputFocused
         }
       )
     ] });
@@ -2313,65 +2354,67 @@ function CommandExecution({
     value: "menu",
     label: "\u2190 Back to menu"
   });
-  return /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
-    /* @__PURE__ */ jsx17(Divider, { width: panelMode ? width - 4 : width }),
-    result?.spawnError ? /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", marginY: 1, children: [
-      /* @__PURE__ */ jsxs15(Box13, { gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: "red", bold: true, children: "\u2717" }),
-        /* @__PURE__ */ jsx17(Text17, { color: "red", bold: true, children: "Failed to start command" })
-      ] }),
-      /* @__PURE__ */ jsxs15(Box13, { marginLeft: 2, marginTop: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Error: " }),
-        /* @__PURE__ */ jsx17(Text17, { color: "red", children: result.spawnError })
-      ] }),
-      (result.spawnError.includes("ENOENT") || result.spawnError.includes("not found")) && /* @__PURE__ */ jsx17(Box13, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: /* @__PURE__ */ jsxs15(Text17, { color: inkColors.accent, bold: true, children: [
-        "\u{1F4A1}",
+  const errorOutput = [result?.stdout, result?.stderr].filter(Boolean).join("\n");
+  const errorLines = errorOutput ? stripAnsi(errorOutput).split("\n") : [];
+  const errorLogHeight = Math.max(3, height - 8 - Math.min(errorItems.length, 6) - (copyMessage ? 1 : 0));
+  const errorCardWidth = Math.max(30, (panelMode ? width - 4 : width) - 2);
+  const errorStatusLabel = result?.spawnError ? "spawn error" : `exit ${result?.exitCode}`;
+  return /* @__PURE__ */ jsxs14(Box13, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+    /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, gap: 1, children: [
+      /* @__PURE__ */ jsxs14(Text15, { color: "red", bold: true, children: [
+        "\u2717",
         " ",
+        cmdDisplay
+      ] }),
+      /* @__PURE__ */ jsx15(ToolBadge, { tool }),
+      /* @__PURE__ */ jsxs14(Text15, { color: "red", children: [
+        "\u25CF ",
+        errorStatusLabel
+      ] })
+    ] }),
+    result?.spawnError && /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Error: " }),
+      /* @__PURE__ */ jsx15(Text15, { color: "red", children: result.spawnError }),
+      (result.spawnError.includes("ENOENT") || result.spawnError.includes("not found")) && /* @__PURE__ */ jsxs14(Text15, { color: inkColors.accent, children: [
+        " \u2014 ",
         tool,
         " CLI not found in this repository or PATH"
-      ] }) })
-    ] }) : /* @__PURE__ */ jsxs15(Box13, { flexDirection: "column", marginY: 1, children: [
-      /* @__PURE__ */ jsxs15(Box13, { gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: "red", bold: true, children: "\u2717" }),
-        /* @__PURE__ */ jsx17(Text17, { color: "red", children: "Command failed " }),
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "(exit code " }),
-        /* @__PURE__ */ jsx17(Text17, { color: "red", bold: true, children: String(result?.exitCode) }),
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: ")" })
-      ] }),
-      /* @__PURE__ */ jsxs15(Box13, { marginLeft: 2, marginTop: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Command: " }),
-        /* @__PURE__ */ jsx17(Text17, { children: cmdDisplay })
-      ] }),
-      !hasDebug && /* @__PURE__ */ jsxs15(Box13, { marginLeft: 2, marginTop: 1, gap: 1, children: [
-        /* @__PURE__ */ jsxs15(Text17, { dimColor: true, children: [
-          "\u{1F4A1}",
-          " Tip: retry with"
-        ] }),
-        /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: "--debug" }),
-        /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "to see detailed logs" })
       ] })
     ] }),
-    /* @__PURE__ */ jsx17(
-      CommandOutput,
+    !result?.spawnError && !hasDebug && /* @__PURE__ */ jsxs14(Box13, { marginBottom: 1, gap: 1, children: [
+      /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "\u{1F4A1} Tip: retry with" }),
+      /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, children: "--debug" }),
+      /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "to see detailed logs" })
+    ] }),
+    /* @__PURE__ */ jsx15(
+      Box13,
       {
-        stdout: result?.stdout,
-        stderr: result?.stderr,
-        height: Math.max(3, height - 14 - errorItems.length - (suggestions.length > 0 ? suggestions.length + 4 : 0) - (copyMessage ? 1 : 0)),
-        isActive: isInputActive && outputFocused
+        flexDirection: "column",
+        borderStyle: "round",
+        borderColor: outputFocused ? "red" : panel.borderDim,
+        paddingX: 1,
+        width: errorCardWidth,
+        children: /* @__PURE__ */ jsx15(
+          ScrollableBox,
+          {
+            height: errorLogHeight,
+            isActive: isInputActive && outputFocused,
+            autoScrollToBottom: true,
+            children: errorLines.length === 0 ? [/* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "No output" }, "empty")] : errorLines.map((line, i) => /* @__PURE__ */ jsx15(Text15, { wrap: "truncate", children: line }, i))
+          }
+        )
       }
     ),
-    copyMessage && /* @__PURE__ */ jsx17(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: copyMessage }) }),
-    outputFocused ? /* @__PURE__ */ jsxs15(Box13, { marginTop: 1, children: [
-      /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "j/k scroll \xB7 " }),
-      /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: "Esc" }),
-      /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: " back to menu" })
-    ] }) : /* @__PURE__ */ jsxs15(Box13, { marginTop: 1, marginBottom: 1, children: [
-      /* @__PURE__ */ jsx17(Text17, { bold: true, children: "What would you like to do?" }),
-      /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "  (press " }),
-      /* @__PURE__ */ jsx17(Text17, { color: inkColors.accent, children: "o" }),
-      /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: " to scroll output)" })
+    copyMessage && /* @__PURE__ */ jsx15(Box13, { children: /* @__PURE__ */ jsx15(Text15, { color: inkColors.accent, children: copyMessage }) }),
+    /* @__PURE__ */ jsxs14(Box13, { marginTop: 1, gap: 2, children: [
+      /* @__PURE__ */ jsxs14(Text15, { dimColor: true, children: [
+        "/:",
+        outputFocused ? "menu" : "scroll"
+      ] }),
+      outputFocused && /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "\u2191\u2193:scroll" }),
+      /* @__PURE__ */ jsx15(Text15, { dimColor: true, children: "Esc:back" })
     ] }),
-    /* @__PURE__ */ jsx17(
+    /* @__PURE__ */ jsx15(
       SelectList,
       {
         items: errorItems,
@@ -2395,6 +2438,8 @@ function CommandExecution({
             case "retry":
               setPinMessage(void 0);
               setCopyMessage(void 0);
+              setAborting(false);
+              setFeedback(void 0);
               reset();
               setPhase("running");
               break;
@@ -2403,6 +2448,8 @@ function CommandExecution({
               setCurrentArgs(newArgs);
               setPinMessage(void 0);
               setCopyMessage(void 0);
+              setAborting(false);
+              setFeedback(void 0);
               reset();
               setPhase("running");
               break;
@@ -2441,13 +2488,54 @@ function CommandExecution({
         panelFocused: isInputActive && !outputFocused
       }
     ),
-    !panelMode && /* @__PURE__ */ jsx17(StatusBar, { width })
+    !panelMode && /* @__PURE__ */ jsx15(StatusBar, { width })
   ] });
 }
 
 // src/screens/SelfUpdate.tsx
 import { useEffect as useEffect10, useState as useState13 } from "react";
 import { Box as Box14, Text as Text18 } from "ink";
+
+// src/components/Spinner.tsx
+import { Text as Text16 } from "ink";
+import InkSpinner from "ink-spinner";
+import { jsx as jsx16, jsxs as jsxs15 } from "react/jsx-runtime";
+function Spinner({
+  label = "Running...",
+  color = inkColors.accent
+}) {
+  return /* @__PURE__ */ jsxs15(Text16, { children: [
+    /* @__PURE__ */ jsx16(Text16, { color, children: /* @__PURE__ */ jsx16(InkSpinner, { type: "dots" }) }),
+    " ",
+    /* @__PURE__ */ jsx16(Text16, { children: label })
+  ] });
+}
+
+// src/components/CommandOutput.tsx
+import { Text as Text17 } from "ink";
+import { jsx as jsx17 } from "react/jsx-runtime";
+function cleanLines(raw) {
+  const stripped = stripAnsi(raw);
+  return stripped.replace(/\r/g, "").split("\n").filter((line) => line.length > 0);
+}
+function CommandOutput({
+  stdout,
+  stderr,
+  height,
+  isActive = false
+}) {
+  const outLines = stdout ? cleanLines(stdout) : [];
+  const errLines = stderr ? cleanLines(stderr) : [];
+  if (outLines.length === 0 && errLines.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx17(ScrollableBox, { height: Math.max(3, height), isActive, children: [
+    ...outLines.map((line, i) => /* @__PURE__ */ jsx17(Text17, { children: line }, `o-${i}`)),
+    ...errLines.map((line, i) => /* @__PURE__ */ jsx17(Text17, { color: "red", children: line }, `e-${i}`))
+  ] });
+}
+
+// src/screens/SelfUpdate.tsx
 import { jsx as jsx18, jsxs as jsxs16 } from "react/jsx-runtime";
 var packageName = "@polterware/polter";
 var globalUpdateArgs = ["install", "-g", `${packageName}@latest`];
@@ -5117,8 +5205,90 @@ function ScriptPicker({
   ] });
 }
 
-// src/app.tsx
+// src/screens/SkillSetup.tsx
+import { useState as useState26 } from "react";
+import { Box as Box29, Text as Text33 } from "ink";
 import { jsx as jsx32, jsxs as jsxs31 } from "react/jsx-runtime";
+function SkillSetup({
+  onBack,
+  width = 80,
+  height = 24,
+  panelMode = false,
+  isInputActive = true
+}) {
+  const [phase, setPhase] = useState26("preview");
+  const [resultStatus, setResultStatus] = useState26(null);
+  const skillPath = getSkillPath();
+  if (phase === "preview") {
+    const content = getSkillContent();
+    const previewLines = content.split("\n").slice(0, Math.max(8, height - 12));
+    const items2 = [
+      { value: "install", label: "Install skill", kind: "action" },
+      ...!panelMode ? [{ value: "__back__", label: "\u2190 Back" }] : []
+    ];
+    const handleSelect = (value) => {
+      if (value === "install") {
+        const result = setupSkill();
+        setResultStatus(result.status);
+        setPhase("done");
+      } else {
+        onBack();
+      }
+    };
+    return /* @__PURE__ */ jsxs31(Box29, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+      /* @__PURE__ */ jsx32(Box29, { marginBottom: 1, children: /* @__PURE__ */ jsx32(Text33, { bold: true, color: inkColors.accent, children: "Preview: ~/.claude/skills/polter/SKILL.md" }) }),
+      /* @__PURE__ */ jsxs31(Box29, { flexDirection: "column", marginBottom: 1, marginLeft: panelMode ? 1 : 2, children: [
+        previewLines.map((line, i) => /* @__PURE__ */ jsx32(Text33, { dimColor: true, children: line }, i)),
+        content.split("\n").length > previewLines.length && /* @__PURE__ */ jsx32(Text33, { dimColor: true, children: "  ..." })
+      ] }),
+      /* @__PURE__ */ jsx32(Box29, { marginBottom: 1, children: /* @__PURE__ */ jsxs31(Text33, { dimColor: true, children: [
+        "Path: ",
+        skillPath
+      ] }) }),
+      /* @__PURE__ */ jsx32(
+        SelectList,
+        {
+          items: items2,
+          onSelect: handleSelect,
+          onCancel: onBack,
+          width: panelMode ? Math.max(20, width - 4) : width,
+          isInputActive,
+          arrowNavigation: panelMode,
+          panelFocused: panelMode ? isInputActive : void 0
+        }
+      ),
+      !panelMode && /* @__PURE__ */ jsx32(StatusBar, { hint: "Enter select \\u00B7 Esc back", width })
+    ] });
+  }
+  const statusMessage = resultStatus === "created" ? "\u2713 Skill installed successfully!" : resultStatus === "updated" ? "\u2713 Skill updated successfully!" : "\u2713 Skill already up to date.";
+  const items = [
+    ...!panelMode ? [{ value: "__back__", label: "\u2190 Back" }] : []
+  ];
+  return /* @__PURE__ */ jsxs31(Box29, { flexDirection: "column", paddingX: panelMode ? 1 : 0, children: [
+    /* @__PURE__ */ jsx32(Box29, { marginBottom: 1, children: /* @__PURE__ */ jsx32(Text33, { color: inkColors.accent, children: statusMessage }) }),
+    /* @__PURE__ */ jsx32(Box29, { marginBottom: 1, children: /* @__PURE__ */ jsxs31(Text33, { dimColor: true, children: [
+      "Path: ",
+      skillPath
+    ] }) }),
+    /* @__PURE__ */ jsx32(Box29, { marginBottom: 1, children: /* @__PURE__ */ jsx32(Text33, { dimColor: true, children: "Use /polter in Claude Code to activate the skill." }) }),
+    items.length > 0 && /* @__PURE__ */ jsx32(
+      SelectList,
+      {
+        items,
+        onSelect: onBack,
+        onCancel: onBack,
+        width: panelMode ? Math.max(20, width - 4) : width,
+        isInputActive,
+        arrowNavigation: panelMode,
+        panelFocused: panelMode ? isInputActive : void 0
+      }
+    ),
+    !panelMode && /* @__PURE__ */ jsx32(StatusBar, { hint: "Esc back", width })
+  ] });
+}
+
+// src/app.tsx
+import { jsx as jsx33, jsxs as jsxs32 } from "react/jsx-runtime";
 function AppClassic() {
   const { screen, params, navigate, goBack, goHome } = useNavigation();
   const { exit } = useApp();
@@ -5133,9 +5303,9 @@ function AppClassic() {
   const renderScreen = () => {
     switch (screen) {
       case "home":
-        return /* @__PURE__ */ jsx32(Home, { onNavigate: navigate, onExit: handleExit, width, height });
+        return /* @__PURE__ */ jsx33(Home, { onNavigate: navigate, onExit: handleExit, width, height });
       case "command-args":
-        return /* @__PURE__ */ jsx32(
+        return /* @__PURE__ */ jsx33(
           CommandArgs,
           {
             command: params.command ?? "",
@@ -5146,9 +5316,9 @@ function AppClassic() {
           }
         );
       case "custom-command":
-        return /* @__PURE__ */ jsx32(CustomCommand, { onNavigate: navigate, onBack: goBack, width });
+        return /* @__PURE__ */ jsx33(CustomCommand, { onNavigate: navigate, onBack: goBack, width });
       case "flag-selection":
-        return /* @__PURE__ */ jsx32(
+        return /* @__PURE__ */ jsx33(
           FlagSelection,
           {
             args: params.args ?? [],
@@ -5160,7 +5330,7 @@ function AppClassic() {
         );
       case "confirm-execute":
       case "command-execution":
-        return /* @__PURE__ */ jsx32(
+        return /* @__PURE__ */ jsx33(
           CommandExecution,
           {
             args: params.args ?? [],
@@ -5176,23 +5346,23 @@ function AppClassic() {
           }
         );
       case "self-update":
-        return /* @__PURE__ */ jsx32(SelfUpdate, { onBack: goBack, onExit: handleExit, width });
+        return /* @__PURE__ */ jsx33(SelfUpdate, { onBack: goBack, onExit: handleExit, width });
       case "tool-status":
-        return /* @__PURE__ */ jsx32(ToolStatus, { onBack: goBack, onNavigate: navigate, width });
+        return /* @__PURE__ */ jsx33(ToolStatus, { onBack: goBack, onNavigate: navigate, width });
       case "mcp-manage":
-        return /* @__PURE__ */ jsx32(McpManage, { onBack: goBack, width });
+        return /* @__PURE__ */ jsx33(McpManage, { onBack: goBack, width });
       case "process-list":
-        return /* @__PURE__ */ jsx32(ProcessList, { onNavigate: navigate, onBack: goBack, width, height });
+        return /* @__PURE__ */ jsx33(ProcessList, { onNavigate: navigate, onBack: goBack, width, height });
       case "process-logs":
-        return /* @__PURE__ */ jsx32(ProcessLogs, { processId: params.processId ?? "", onBack: goBack, width, height });
+        return /* @__PURE__ */ jsx33(ProcessLogs, { processId: params.processId ?? "", onBack: goBack, width, height });
       case "project-config":
-        return /* @__PURE__ */ jsx32(ProjectConfig, { onBack: goBack, width });
+        return /* @__PURE__ */ jsx33(ProjectConfig, { onBack: goBack, width });
       case "pipeline-list":
-        return /* @__PURE__ */ jsx32(PipelineList, { onNavigate: navigate, onBack: goBack, width });
+        return /* @__PURE__ */ jsx33(PipelineList, { onNavigate: navigate, onBack: goBack, width });
       case "pipeline-builder":
-        return /* @__PURE__ */ jsx32(PipelineBuilder, { onBack: goBack, width, height });
+        return /* @__PURE__ */ jsx33(PipelineBuilder, { onBack: goBack, width, height });
       case "pipeline-execution":
-        return /* @__PURE__ */ jsx32(
+        return /* @__PURE__ */ jsx33(
           PipelineExecution,
           {
             pipelineId: params.pipelineId ?? "",
@@ -5202,34 +5372,36 @@ function AppClassic() {
           }
         );
       case "declarative-plan":
-        return /* @__PURE__ */ jsx32(DeclarativePlan, { onBack: goBack, onNavigate: navigate, width, height });
+        return /* @__PURE__ */ jsx33(DeclarativePlan, { onBack: goBack, onNavigate: navigate, width, height });
       case "declarative-status":
-        return /* @__PURE__ */ jsx32(DeclarativeStatus, { onBack: goBack, width, height });
+        return /* @__PURE__ */ jsx33(DeclarativeStatus, { onBack: goBack, width, height });
       case "init-scaffold":
-        return /* @__PURE__ */ jsx32(InitScaffold, { onBack: goBack, onNavigate: navigate, width, height });
+        return /* @__PURE__ */ jsx33(InitScaffold, { onBack: goBack, onNavigate: navigate, width, height });
       case "script-picker":
-        return /* @__PURE__ */ jsx32(ScriptPicker, { onNavigate: navigate, onBack: goBack, width, height });
+        return /* @__PURE__ */ jsx33(ScriptPicker, { onNavigate: navigate, onBack: goBack, width, height });
+      case "skill-setup":
+        return /* @__PURE__ */ jsx33(SkillSetup, { onBack: goBack, width, height });
       default:
-        return /* @__PURE__ */ jsx32(Box29, { children: /* @__PURE__ */ jsxs31(Text33, { color: "red", children: [
+        return /* @__PURE__ */ jsx33(Box30, { children: /* @__PURE__ */ jsxs32(Text34, { color: "red", children: [
           "Unknown screen: ",
           screen
         ] }) });
     }
   };
-  return /* @__PURE__ */ jsxs31(Box29, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx32(GhostBanner, { width }),
+  return /* @__PURE__ */ jsxs32(Box30, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx33(GhostBanner, { width }),
     renderScreen()
   ] });
 }
 
 // src/appPanel.tsx
-import React27 from "react";
-import { Box as Box38, Text as Text40, useApp as useApp2, useInput as useInput13 } from "ink";
+import React28 from "react";
+import { Box as Box39, Text as Text41, useApp as useApp2, useInput as useInput13 } from "ink";
 
 // src/hooks/usePanelNavigation.ts
-import { useState as useState26, useCallback as useCallback8 } from "react";
+import { useState as useState27, useCallback as useCallback8 } from "react";
 function usePanelNavigation() {
-  const [state, setState] = useState26({
+  const [state, setState] = useState27({
     view: "pipelines",
     featureId: "database",
     innerScreen: "home",
@@ -5268,7 +5440,8 @@ function usePanelNavigation() {
       "self-update": "self-update",
       processes: "processes",
       scripts: "scripts",
-      declarative: "declarative"
+      declarative: "declarative",
+      "skill-setup": "skill-setup"
     };
     const view = viewMap[itemId];
     if (view) {
@@ -5335,9 +5508,9 @@ function usePanelNavigation() {
 }
 
 // src/hooks/usePanelFocus.ts
-import { useState as useState27, useCallback as useCallback9 } from "react";
+import { useState as useState28, useCallback as useCallback9 } from "react";
 function usePanelFocus() {
-  const [focused, setFocused] = useState27("sidebar");
+  const [focused, setFocused] = useState28("sidebar");
   const toggleFocus = useCallback9(() => {
     setFocused((prev) => prev === "sidebar" ? "main" : "sidebar");
   }, []);
@@ -5378,15 +5551,16 @@ function useSidebarItems() {
     items.push({ id: "declarative", label: "Infrastructure", icon: "\u{1F3D7}\uFE0F", type: "action", section: "system" });
     items.push({ id: "tool-status", label: "Tool Status", icon: "\u{1F527}", type: "action", section: "system" });
     items.push({ id: "config", label: "Config", icon: "\u2699\uFE0F", type: "action", section: "system" });
+    items.push({ id: "skill-setup", label: "Skill Setup", icon: "\u{1F9E0}", type: "action", section: "system" });
     items.push({ id: "self-update", label: "Update", icon: "\u2B06\uFE0F", type: "action", section: "system" });
     return items;
   }, []);
 }
 
 // src/hooks/useModal.ts
-import { useState as useState28, useCallback as useCallback10 } from "react";
+import { useState as useState29, useCallback as useCallback10 } from "react";
 function useModal() {
-  const [state, setState] = useState28(null);
+  const [state, setState] = useState29(null);
   const openModal = useCallback10((content, title) => {
     setState({ content, title });
   }, []);
@@ -5403,8 +5577,8 @@ function useModal() {
 }
 
 // src/components/PanelLayout.tsx
-import { Box as Box30 } from "ink";
-import { jsx as jsx33, jsxs as jsxs32 } from "react/jsx-runtime";
+import { Box as Box31 } from "ink";
+import { jsx as jsx34, jsxs as jsxs33 } from "react/jsx-runtime";
 function PanelLayout({
   header,
   footer,
@@ -5419,19 +5593,19 @@ function PanelLayout({
   const contentHeight = Math.max(5, height - bannerHeight - footerHeight);
   const sidebarWidth = singlePanel ? 0 : panel.sidebarWidth(width);
   const mainWidth = singlePanel ? width : width - sidebarWidth;
-  return /* @__PURE__ */ jsxs32(Box30, { flexDirection: "column", width, height, children: [
+  return /* @__PURE__ */ jsxs33(Box31, { flexDirection: "column", width, height, children: [
     header,
-    /* @__PURE__ */ jsxs32(Box30, { flexDirection: "row", height: contentHeight, children: [
-      !singlePanel && /* @__PURE__ */ jsx33(Box30, { width: sidebarWidth, height: contentHeight, children: sidebar }),
-      /* @__PURE__ */ jsx33(Box30, { width: mainWidth, height: contentHeight, children: main2 })
+    /* @__PURE__ */ jsxs33(Box31, { flexDirection: "row", height: contentHeight, children: [
+      !singlePanel && /* @__PURE__ */ jsx34(Box31, { width: sidebarWidth, height: contentHeight, children: sidebar }),
+      /* @__PURE__ */ jsx34(Box31, { width: mainWidth, height: contentHeight, children: main2 })
     ] }),
-    /* @__PURE__ */ jsx33(Box30, { height: footerHeight, children: footer })
+    /* @__PURE__ */ jsx34(Box31, { height: footerHeight, children: footer })
   ] });
 }
 
 // src/components/Panel.tsx
-import { Box as Box31, Text as Text34 } from "ink";
-import { jsx as jsx34, jsxs as jsxs33 } from "react/jsx-runtime";
+import { Box as Box32, Text as Text35 } from "ink";
+import { jsx as jsx35, jsxs as jsxs34 } from "react/jsx-runtime";
 function Panel({
   id,
   title,
@@ -5441,8 +5615,8 @@ function Panel({
   children
 }) {
   const borderColor = focused ? panel.borderFocused : panel.borderDim;
-  return /* @__PURE__ */ jsxs33(
-    Box31,
+  return /* @__PURE__ */ jsxs34(
+    Box32,
     {
       flexDirection: "column",
       width,
@@ -5451,21 +5625,21 @@ function Panel({
       borderColor,
       overflow: "hidden",
       children: [
-        title && /* @__PURE__ */ jsx34(Box31, { marginBottom: 0, children: /* @__PURE__ */ jsxs33(Text34, { color: focused ? inkColors.accent : void 0, bold: focused, dimColor: !focused, children: [
+        title && /* @__PURE__ */ jsx35(Box32, { marginBottom: 0, children: /* @__PURE__ */ jsxs34(Text35, { color: focused ? inkColors.accent : void 0, bold: focused, dimColor: !focused, children: [
           " ",
           title,
           " "
         ] }) }),
-        /* @__PURE__ */ jsx34(Box31, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children })
+        /* @__PURE__ */ jsx35(Box32, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children })
       ]
     }
   );
 }
 
 // src/components/Sidebar.tsx
-import { useEffect as useEffect19, useMemo as useMemo10, useState as useState29 } from "react";
-import { Box as Box32, Text as Text35, useInput as useInput12 } from "ink";
-import { jsx as jsx35, jsxs as jsxs34 } from "react/jsx-runtime";
+import { useEffect as useEffect19, useMemo as useMemo10, useState as useState30 } from "react";
+import { Box as Box33, Text as Text36, useInput as useInput12 } from "ink";
+import { jsx as jsx36, jsxs as jsxs35 } from "react/jsx-runtime";
 function groupSections(items) {
   const groups = [];
   let current = null;
@@ -5492,7 +5666,7 @@ function Sidebar({
     [items]
   );
   const selectedIdx = selectableItems.findIndex((item) => item.id === selectedId);
-  const [cursorIdx, setCursorIdx] = useState29(Math.max(0, selectedIdx));
+  const [cursorIdx, setCursorIdx] = useState30(Math.max(0, selectedIdx));
   const sections = useMemo10(() => groupSections(items), [items]);
   useEffect19(() => {
     const idx = selectableItems.findIndex((item) => item.id === selectedId);
@@ -5526,28 +5700,28 @@ function Sidebar({
     { isActive: isFocused }
   );
   let flatIdx = 0;
-  return /* @__PURE__ */ jsx35(Box32, { flexDirection: "column", gap: 0, children: sections.map((section) => {
+  return /* @__PURE__ */ jsx36(Box33, { flexDirection: "column", gap: 0, children: sections.map((section) => {
     const sectionStartIdx = flatIdx;
     const sectionEndIdx = sectionStartIdx + section.items.length - 1;
     const hasCursorInSection = isFocused && cursorIdx >= sectionStartIdx && cursorIdx <= sectionEndIdx;
     const hasActiveInSection = section.items.some((item) => item.id === selectedId);
     const borderColor = hasCursorInSection || hasActiveInSection ? inkColors.accent : "#555555";
-    const rendered = /* @__PURE__ */ jsxs34(
-      Box32,
+    const rendered = /* @__PURE__ */ jsxs35(
+      Box33,
       {
         flexDirection: "column",
         borderStyle: "round",
         borderColor,
         paddingX: 1,
         children: [
-          /* @__PURE__ */ jsx35(Text35, { dimColor: true, bold: true, children: section.title }),
+          /* @__PURE__ */ jsx36(Text36, { dimColor: true, bold: true, children: section.title }),
           section.items.map((item) => {
             const thisIdx = flatIdx;
             flatIdx++;
             const isCursor = isFocused && thisIdx === cursorIdx;
             const isActive = item.id === selectedId;
-            return /* @__PURE__ */ jsx35(Box32, { gap: 0, children: /* @__PURE__ */ jsxs34(
-              Text35,
+            return /* @__PURE__ */ jsx36(Box33, { gap: 0, children: /* @__PURE__ */ jsxs35(
+              Text36,
               {
                 color: isCursor ? inkColors.accent : isActive ? inkColors.accent : void 0,
                 bold: isCursor || isActive,
@@ -5570,12 +5744,12 @@ function Sidebar({
 }
 
 // src/components/PanelFooter.tsx
-import { Box as Box33, Text as Text36 } from "ink";
-import { jsx as jsx36, jsxs as jsxs35 } from "react/jsx-runtime";
+import { Box as Box34, Text as Text37 } from "ink";
+import { jsx as jsx37, jsxs as jsxs36 } from "react/jsx-runtime";
 function PanelFooter({ hints, width }) {
-  return /* @__PURE__ */ jsx36(Box33, { width, children: /* @__PURE__ */ jsx36(Box33, { gap: 1, children: hints.map((hint) => /* @__PURE__ */ jsxs35(Box33, { gap: 0, children: [
-    /* @__PURE__ */ jsx36(Text36, { color: inkColors.accent, bold: true, children: hint.key }),
-    /* @__PURE__ */ jsxs35(Text36, { dimColor: true, children: [
+  return /* @__PURE__ */ jsx37(Box34, { width, children: /* @__PURE__ */ jsx37(Box34, { gap: 1, children: hints.map((hint) => /* @__PURE__ */ jsxs36(Box34, { gap: 0, children: [
+    /* @__PURE__ */ jsx37(Text37, { color: inkColors.accent, bold: true, children: hint.key }),
+    /* @__PURE__ */ jsxs36(Text37, { dimColor: true, children: [
       ":",
       hint.action
     ] })
@@ -5583,8 +5757,8 @@ function PanelFooter({ hints, width }) {
 }
 
 // src/components/Modal.tsx
-import { Box as Box34, Text as Text37 } from "ink";
-import { jsx as jsx37, jsxs as jsxs36 } from "react/jsx-runtime";
+import { Box as Box35, Text as Text38 } from "ink";
+import { jsx as jsx38, jsxs as jsxs37 } from "react/jsx-runtime";
 function Modal({
   title,
   width,
@@ -5595,10 +5769,10 @@ function Modal({
   const modalHeight = Math.min(height - 4, 20);
   const padX = Math.max(0, Math.floor((width - modalWidth) / 2));
   const padY = Math.max(0, Math.floor((height - modalHeight) / 2));
-  return /* @__PURE__ */ jsxs36(Box34, { flexDirection: "column", width, height, children: [
-    padY > 0 && /* @__PURE__ */ jsx37(Box34, { height: padY }),
-    /* @__PURE__ */ jsx37(Box34, { marginLeft: padX, children: /* @__PURE__ */ jsxs36(
-      Box34,
+  return /* @__PURE__ */ jsxs37(Box35, { flexDirection: "column", width, height, children: [
+    padY > 0 && /* @__PURE__ */ jsx38(Box35, { height: padY }),
+    /* @__PURE__ */ jsx38(Box35, { marginLeft: padX, children: /* @__PURE__ */ jsxs37(
+      Box35,
       {
         flexDirection: "column",
         width: modalWidth,
@@ -5607,8 +5781,8 @@ function Modal({
         borderColor: inkColors.accent,
         paddingX: 1,
         children: [
-          /* @__PURE__ */ jsx37(Box34, { marginBottom: 1, children: /* @__PURE__ */ jsx37(Text37, { color: inkColors.accent, bold: true, children: title }) }),
-          /* @__PURE__ */ jsx37(Box34, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children })
+          /* @__PURE__ */ jsx38(Box35, { marginBottom: 1, children: /* @__PURE__ */ jsx38(Text38, { color: inkColors.accent, bold: true, children: title }) }),
+          /* @__PURE__ */ jsx38(Box35, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children })
         ]
       }
     ) })
@@ -5616,9 +5790,9 @@ function Modal({
 }
 
 // src/components/FeatureCommands.tsx
-import { useEffect as useEffect20, useMemo as useMemo11, useState as useState30 } from "react";
-import { Box as Box35, Text as Text38 } from "ink";
-import { jsx as jsx38, jsxs as jsxs37 } from "react/jsx-runtime";
+import { useEffect as useEffect20, useMemo as useMemo11, useState as useState31 } from "react";
+import { Box as Box36, Text as Text39 } from "ink";
+import { jsx as jsx39, jsxs as jsxs38 } from "react/jsx-runtime";
 function FeatureCommands({
   feature,
   onNavigate,
@@ -5629,9 +5803,9 @@ function FeatureCommands({
   height = 24,
   isInputActive = true
 }) {
-  const [pinnedCommands, setPinnedCommands2] = useState30(() => getPinnedCommands());
-  const [pinnedRuns, setPinnedRuns2] = useState30(() => getPinnedRuns());
-  const [pinFeedback, setPinFeedback] = useState30();
+  const [pinnedCommands, setPinnedCommands2] = useState31(() => getPinnedCommands());
+  const [pinnedRuns, setPinnedRuns2] = useState31(() => getPinnedRuns());
+  const [pinFeedback, setPinFeedback] = useState31();
   useEffect20(() => {
     if (!pinFeedback) return;
     const timeout = setTimeout(() => setPinFeedback(void 0), 1400);
@@ -5700,12 +5874,12 @@ function FeatureCommands({
       );
     }
   };
-  return /* @__PURE__ */ jsxs37(Box35, { flexDirection: "column", paddingX: 1, children: [
-    pinFeedback && /* @__PURE__ */ jsx38(Box35, { marginBottom: 1, children: /* @__PURE__ */ jsxs37(Text38, { color: inkColors.accent, children: [
+  return /* @__PURE__ */ jsxs38(Box36, { flexDirection: "column", paddingX: 1, children: [
+    pinFeedback && /* @__PURE__ */ jsx39(Box36, { marginBottom: 1, children: /* @__PURE__ */ jsxs38(Text39, { color: inkColors.accent, children: [
       "\u2713 ",
       pinFeedback
     ] }) }),
-    /* @__PURE__ */ jsx38(
+    /* @__PURE__ */ jsx39(
       SelectList,
       {
         items,
@@ -5724,9 +5898,9 @@ function FeatureCommands({
 }
 
 // src/components/PinnedCommands.tsx
-import { useEffect as useEffect21, useMemo as useMemo12, useState as useState31 } from "react";
-import { Box as Box36, Text as Text39 } from "ink";
-import { jsx as jsx39, jsxs as jsxs38 } from "react/jsx-runtime";
+import { useEffect as useEffect21, useMemo as useMemo12, useState as useState32 } from "react";
+import { Box as Box37, Text as Text40 } from "ink";
+import { jsx as jsx40, jsxs as jsxs39 } from "react/jsx-runtime";
 function PinnedCommands({
   onNavigate,
   onBack,
@@ -5735,9 +5909,9 @@ function PinnedCommands({
   height = 24,
   isInputActive = true
 }) {
-  const [pinnedCommands, setPinnedCommands2] = useState31(() => getPinnedCommands());
-  const [pinnedRuns, setPinnedRuns2] = useState31(() => getPinnedRuns());
-  const [pinFeedback, setPinFeedback] = useState31();
+  const [pinnedCommands, setPinnedCommands2] = useState32(() => getPinnedCommands());
+  const [pinnedRuns, setPinnedRuns2] = useState32(() => getPinnedRuns());
+  const [pinFeedback, setPinFeedback] = useState32();
   useEffect21(() => {
     if (!pinFeedback) return;
     const timeout = setTimeout(() => setPinFeedback(void 0), 1400);
@@ -5800,14 +5974,14 @@ function PinnedCommands({
     }
   };
   if (items.length === 0) {
-    return /* @__PURE__ */ jsx39(Box36, { flexDirection: "column", paddingX: 1, children: /* @__PURE__ */ jsx39(Text39, { color: "gray", children: "No pinned items. Press p on any command to pin it." }) });
+    return /* @__PURE__ */ jsx40(Box37, { flexDirection: "column", paddingX: 1, children: /* @__PURE__ */ jsx40(Text40, { color: "gray", children: "No pinned items. Press p on any command to pin it." }) });
   }
-  return /* @__PURE__ */ jsxs38(Box36, { flexDirection: "column", paddingX: 1, children: [
-    pinFeedback && /* @__PURE__ */ jsx39(Box36, { marginBottom: 1, children: /* @__PURE__ */ jsxs38(Text39, { color: inkColors.accent, children: [
+  return /* @__PURE__ */ jsxs39(Box37, { flexDirection: "column", paddingX: 1, children: [
+    pinFeedback && /* @__PURE__ */ jsx40(Box37, { marginBottom: 1, children: /* @__PURE__ */ jsxs39(Text40, { color: inkColors.accent, children: [
       "\u2713 ",
       pinFeedback
     ] }) }),
-    /* @__PURE__ */ jsx39(
+    /* @__PURE__ */ jsx40(
       SelectList,
       {
         items,
@@ -5827,8 +6001,8 @@ function PinnedCommands({
 
 // src/screens/DeclarativeHome.tsx
 import { useMemo as useMemo13 } from "react";
-import { Box as Box37 } from "ink";
-import { jsx as jsx40 } from "react/jsx-runtime";
+import { Box as Box38 } from "ink";
+import { jsx as jsx41 } from "react/jsx-runtime";
 var ITEMS = [
   { value: "declarative-plan", label: "Plan / Apply", hint: "Diff and apply polter.yaml", kind: "action" },
   { value: "declarative-status", label: "Infrastructure Status", hint: "Live state from CLI tools", kind: "action" },
@@ -5845,7 +6019,7 @@ function DeclarativeHome({
     () => (value) => onNavigate(value),
     [onNavigate]
   );
-  return /* @__PURE__ */ jsx40(Box37, { flexDirection: "column", paddingX: 1, children: /* @__PURE__ */ jsx40(
+  return /* @__PURE__ */ jsx41(Box38, { flexDirection: "column", paddingX: 1, children: /* @__PURE__ */ jsx41(
     SelectList,
     {
       items: ITEMS,
@@ -5861,7 +6035,7 @@ function DeclarativeHome({
 }
 
 // src/appPanel.tsx
-import { jsx as jsx41, jsxs as jsxs39 } from "react/jsx-runtime";
+import { jsx as jsx42, jsxs as jsxs40 } from "react/jsx-runtime";
 var screenLabels = {
   "command-args": "Args",
   "flag-selection": "Flags",
@@ -5880,7 +6054,8 @@ var screenLabels = {
   "declarative-plan": "Plan/Apply",
   "declarative-status": "Status",
   "init-scaffold": "Init",
-  "script-picker": "Scripts"
+  "script-picker": "Scripts",
+  "skill-setup": "Skill Setup"
 };
 function buildBreadcrumb(nav) {
   let base;
@@ -5917,6 +6092,9 @@ function buildBreadcrumb(nav) {
     case "declarative":
       base = "\u{1F3D7}\uFE0F Infrastructure";
       break;
+    case "skill-setup":
+      base = "\u{1F9E0} Skill Setup";
+      break;
     default:
       base = nav.view;
   }
@@ -5949,7 +6127,7 @@ function AppPanel() {
   const focus = usePanelFocus();
   const sidebarItems = useSidebarItems();
   const modal = useModal();
-  const refreshPins = React27.useCallback(() => {
+  const refreshPins = React28.useCallback(() => {
   }, []);
   const singlePanel = width < 60 || height < 15;
   const handleExit = () => {
@@ -5983,37 +6161,37 @@ function AppPanel() {
     }
     if (input2 === "?") {
       modal.openModal(
-        /* @__PURE__ */ jsxs39(Box38, { flexDirection: "column", children: [
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "\u2190/\u2192" }),
+        /* @__PURE__ */ jsxs40(Box39, { flexDirection: "column", children: [
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "\u2190/\u2192" }),
             "    Move between sidebar and main panel"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "Tab" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "Tab" }),
             "     Toggle sidebar / main panel"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "j/k" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "j/k" }),
             "     Navigate up/down"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "Enter" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "Enter" }),
             "   Select item"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "Esc" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "Esc" }),
             "     Go back (or return to sidebar)"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "q" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "q" }),
             "       Quit Polter"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "?" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "?" }),
             "       Show this help"
           ] }),
-          /* @__PURE__ */ jsxs39(Text40, { children: [
-            /* @__PURE__ */ jsx41(Text40, { bold: true, children: "p" }),
+          /* @__PURE__ */ jsxs40(Text41, { children: [
+            /* @__PURE__ */ jsx42(Text41, { bold: true, children: "p" }),
             "       Pin/unpin command"
           ] })
         ] }),
@@ -6043,6 +6221,8 @@ function AppPanel() {
         return "scripts";
       case "declarative":
         return "declarative";
+      case "skill-setup":
+        return "skill-setup";
       default:
         return nav.featureId;
     }
@@ -6069,7 +6249,7 @@ function AppPanel() {
     }
     switch (nav.view) {
       case "pinned":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PinnedCommands,
           {
             onNavigate: nav.navigateInner,
@@ -6083,12 +6263,12 @@ function AppPanel() {
       case "feature": {
         const feature = getFeatureById(nav.featureId);
         if (!feature) {
-          return /* @__PURE__ */ jsxs39(Text40, { color: "red", children: [
+          return /* @__PURE__ */ jsxs40(Text41, { color: "red", children: [
             "Feature not found: ",
             nav.featureId
           ] });
         }
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           FeatureCommands,
           {
             feature,
@@ -6103,7 +6283,7 @@ function AppPanel() {
         );
       }
       case "custom-command":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CustomCommand,
           {
             onNavigate: nav.navigateInner,
@@ -6115,7 +6295,7 @@ function AppPanel() {
           }
         );
       case "pipelines":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineList,
           {
             onNavigate: nav.navigateInner,
@@ -6127,7 +6307,7 @@ function AppPanel() {
           }
         );
       case "tool-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ToolStatus,
           {
             onBack: focus.focusSidebar,
@@ -6139,7 +6319,7 @@ function AppPanel() {
           }
         );
       case "processes":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessList,
           {
             onNavigate: nav.navigateInner,
@@ -6151,7 +6331,7 @@ function AppPanel() {
           }
         );
       case "scripts":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ScriptPicker,
           {
             onNavigate: nav.navigateInner,
@@ -6163,7 +6343,7 @@ function AppPanel() {
           }
         );
       case "declarative":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativeHome,
           {
             onNavigate: nav.navigateInner,
@@ -6173,8 +6353,19 @@ function AppPanel() {
             isInputActive: focus.isMainFocused
           }
         );
+      case "skill-setup":
+        return /* @__PURE__ */ jsx42(
+          SkillSetup,
+          {
+            onBack: focus.focusSidebar,
+            width: mainContentWidth - 2,
+            height: mainContentHeight,
+            panelMode: true,
+            isInputActive: focus.isMainFocused
+          }
+        );
       case "config":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProjectConfig,
           {
             onBack: focus.focusSidebar,
@@ -6185,7 +6376,7 @@ function AppPanel() {
           }
         );
       case "self-update":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           SelfUpdate,
           {
             onBack: focus.focusSidebar,
@@ -6197,7 +6388,7 @@ function AppPanel() {
           }
         );
       default:
-        return /* @__PURE__ */ jsx41(Text40, { children: "Select an item from the sidebar" });
+        return /* @__PURE__ */ jsx42(Text41, { children: "Select an item from the sidebar" });
     }
   };
   const renderInnerScreen = () => {
@@ -6205,7 +6396,7 @@ function AppPanel() {
     const w = mainContentWidth - 2;
     switch (nav.innerScreen) {
       case "command-args":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CommandArgs,
           {
             command: nav.innerParams.command ?? "",
@@ -6218,7 +6409,7 @@ function AppPanel() {
           }
         );
       case "custom-command":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CustomCommand,
           {
             onNavigate: nav.navigateInner,
@@ -6230,7 +6421,7 @@ function AppPanel() {
           }
         );
       case "flag-selection":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           FlagSelection,
           {
             args: nav.innerParams.args ?? [],
@@ -6246,7 +6437,7 @@ function AppPanel() {
         );
       case "confirm-execute":
       case "command-execution":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CommandExecution,
           {
             args: nav.innerParams.args ?? [],
@@ -6267,7 +6458,7 @@ function AppPanel() {
           `${nav.view}-${nav.innerParams.tool}-${(nav.innerParams.args ?? []).join("-")}`
         );
       case "pipeline-list":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineList,
           {
             onNavigate: nav.navigateInner,
@@ -6279,7 +6470,7 @@ function AppPanel() {
           }
         );
       case "pipeline-builder":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineBuilder,
           {
             onBack: nav.goBackInner,
@@ -6290,7 +6481,7 @@ function AppPanel() {
           }
         );
       case "pipeline-execution":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineExecution,
           {
             pipelineId: nav.innerParams.pipelineId ?? "",
@@ -6302,7 +6493,7 @@ function AppPanel() {
           }
         );
       case "self-update":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           SelfUpdate,
           {
             onBack: nav.goBackInner,
@@ -6314,7 +6505,7 @@ function AppPanel() {
           }
         );
       case "tool-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ToolStatus,
           {
             onBack: nav.goBackInner,
@@ -6326,7 +6517,7 @@ function AppPanel() {
           }
         );
       case "mcp-manage":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           McpManage,
           {
             onBack: nav.goBackInner,
@@ -6337,7 +6528,7 @@ function AppPanel() {
           }
         );
       case "process-list":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessList,
           {
             onNavigate: nav.navigateInner,
@@ -6349,7 +6540,7 @@ function AppPanel() {
           }
         );
       case "process-logs":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessLogs,
           {
             processId: nav.innerParams.processId ?? "",
@@ -6361,7 +6552,7 @@ function AppPanel() {
           }
         );
       case "project-config":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProjectConfig,
           {
             onBack: nav.goBackInner,
@@ -6372,7 +6563,7 @@ function AppPanel() {
           }
         );
       case "declarative-plan":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativePlan,
           {
             onBack: nav.goBackInner,
@@ -6384,7 +6575,7 @@ function AppPanel() {
           }
         );
       case "declarative-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativeStatus,
           {
             onBack: nav.goBackInner,
@@ -6395,7 +6586,7 @@ function AppPanel() {
           }
         );
       case "init-scaffold":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           InitScaffold,
           {
             onBack: nav.goBackInner,
@@ -6407,7 +6598,7 @@ function AppPanel() {
           }
         );
       case "script-picker":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ScriptPicker,
           {
             onNavigate: nav.navigateInner,
@@ -6418,18 +6609,29 @@ function AppPanel() {
             isInputActive: isActive
           }
         );
+      case "skill-setup":
+        return /* @__PURE__ */ jsx42(
+          SkillSetup,
+          {
+            onBack: nav.goBackInner,
+            width: w,
+            height: mainContentHeight,
+            panelMode: true,
+            isInputActive: isActive
+          }
+        );
       default:
-        return /* @__PURE__ */ jsxs39(Text40, { color: "red", children: [
+        return /* @__PURE__ */ jsxs40(Text41, { color: "red", children: [
           "Unknown screen: ",
           nav.innerScreen
         ] });
     }
   };
   if (modal.isOpen) {
-    return /* @__PURE__ */ jsx41(Box38, { flexDirection: "column", width, height, children: /* @__PURE__ */ jsx41(Modal, { title: modal.modalTitle, width, height, children: modal.modalContent }) });
+    return /* @__PURE__ */ jsx42(Box39, { flexDirection: "column", width, height, children: /* @__PURE__ */ jsx42(Modal, { title: modal.modalTitle, width, height, children: modal.modalContent }) });
   }
-  const header = /* @__PURE__ */ jsx41(GhostBanner, { width, compact: true });
-  const sidebar = /* @__PURE__ */ jsx41(
+  const header = /* @__PURE__ */ jsx42(GhostBanner, { width, compact: true });
+  const sidebar = /* @__PURE__ */ jsx42(
     Panel,
     {
       id: "sidebar",
@@ -6437,7 +6639,7 @@ function AppPanel() {
       width: Math.max(20, Math.min(35, Math.floor(width * 0.3))),
       height: Math.max(5, height - bannerHeight - 1),
       focused: focus.isSidebarFocused,
-      children: /* @__PURE__ */ jsx41(
+      children: /* @__PURE__ */ jsx42(
         Sidebar,
         {
           items: sidebarItems,
@@ -6450,7 +6652,7 @@ function AppPanel() {
       )
     }
   );
-  const main2 = /* @__PURE__ */ jsx41(
+  const main2 = /* @__PURE__ */ jsx42(
     Panel,
     {
       id: "main",
@@ -6461,8 +6663,8 @@ function AppPanel() {
       children: renderMainContent()
     }
   );
-  const footer = /* @__PURE__ */ jsx41(PanelFooter, { hints: footerHints, width });
-  return /* @__PURE__ */ jsx41(
+  const footer = /* @__PURE__ */ jsx42(PanelFooter, { hints: footerHints, width });
+  return /* @__PURE__ */ jsx42(
     PanelLayout,
     {
       header,
@@ -6527,6 +6729,9 @@ function parseCliArgs(argv) {
   if (argv_[0] === "apply") {
     return { mode: "apply", options: {} };
   }
+  if (argv_[0] === "setup") {
+    return { mode: "setup", options: {} };
+  }
   if (argv_[0] === "status") {
     return { mode: "status", options: {} };
   }
@@ -6600,6 +6805,7 @@ function printCliHelp() {
       "  polter config --edit             Open config in $EDITOR",
       "  polter plan                      Show declarative state diff",
       "  polter apply                     Apply declarative state changes",
+      "  polter setup                     Install Polter skill for Claude Code",
       "  polter status                    Show current tool status",
       "  polter mcp install               Install Polter MCP server into Claude Code (local scope)",
       "  polter mcp install --project     Install for this project only (shared via repo)",
@@ -7451,6 +7657,10 @@ async function main() {
     }
     return;
   }
+  if (parsed.mode === "setup") {
+    setupSkillCli();
+    return;
+  }
   if (parsed.mode === "app") {
     const exitCode = await runAppCli(parsed.options);
     process.exit(exitCode);
@@ -7576,13 +7786,21 @@ Apply completed with ${errors.length} error(s).
       process.exit(result.exitCode ?? 0);
     }
     const AppComponent2 = parsed.classic ? AppClassic : AppPanel;
-    const inst = render(React28.createElement(AppComponent2));
+    const socketPath2 = getSocketPath();
+    const ipc2 = socketPath2 ? createIpcServer(socketPath2) : null;
+    if (ipc2) await ipc2.start();
+    const inst = render(React29.createElement(AppComponent2));
     await inst.waitUntilExit();
+    if (ipc2) await ipc2.stop();
     process.exit(0);
   }
   const AppComponent = parsed.classic ? AppClassic : AppPanel;
-  const instance = render(React28.createElement(AppComponent));
+  const socketPath = getSocketPath();
+  const ipc = socketPath ? createIpcServer(socketPath) : null;
+  if (ipc) await ipc.start();
+  const instance = render(React29.createElement(AppComponent));
   await instance.waitUntilExit();
+  if (ipc) await ipc.stop();
   process.exit(0);
 }
 main().catch((error) => {