@polterware/polter 0.4.1 → 0.4.2

package/dist/index.js

@@ -22,6 +22,8 @@ import {
   getOrCreateProjectConfig,
   getProcessOutput,
   getProjectConfigPath,
+  getSkillContent,
+  getSkillPath,
   getSocketPath,
   getToolDisplayName,
   getToolInfo,
@@ -32,6 +34,7 @@ import {
   mcpStatus,
   parsePolterYaml,
   planChanges,
+  registerForegroundProcess,
   removeMcpServer,
   removeMcpServerSilent,
   removeProcess,
@@ -40,18 +43,20 @@ import {
   runInteractiveCommand,
   runSupabaseCommand,
   savePipeline,
+  setupSkill,
+  setupSkillCli,
   startProcess,
   stopProcess,
   translateCommand,
   writeProjectConfig
-} from "./chunk-ZHVOYB5M.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";
@@ -916,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__",
@@ -1030,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;
@@ -1809,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);
@@ -5184,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();
@@ -5200,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 ?? "",
@@ -5213,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 ?? [],
@@ -5227,7 +5330,7 @@ function AppClassic() {
         );
       case "confirm-execute":
       case "command-execution":
-        return /* @__PURE__ */ jsx32(
+        return /* @__PURE__ */ jsx33(
           CommandExecution,
           {
             args: params.args ?? [],
@@ -5243,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 ?? "",
@@ -5269,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",
@@ -5335,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) {
@@ -5402,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");
   }, []);
@@ -5445,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 });
   }, []);
@@ -5470,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,
@@ -5486,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,
@@ -5508,8 +5615,8 @@ function Panel({
   children
 }) {
   const borderColor = focused ? panel.borderFocused : panel.borderDim;
-  return /* @__PURE__ */ jsxs33(
-    Box31,
+  return /* @__PURE__ */ jsxs34(
+    Box32,
     {
       flexDirection: "column",
       width,
@@ -5518,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;
@@ -5559,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);
@@ -5593,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,
@@ -5637,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
     ] })
@@ -5650,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,
@@ -5662,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,
@@ -5674,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 })
         ]
       }
     ) })
@@ -5683,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,
@@ -5696,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);
@@ -5767,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,
@@ -5791,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,
@@ -5802,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);
@@ -5867,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,
@@ -5894,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" },
@@ -5912,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,
@@ -5928,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",
@@ -5947,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;
@@ -5984,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;
   }
@@ -6016,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 = () => {
@@ -6050,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"
           ] })
         ] }),
@@ -6110,6 +6221,8 @@ function AppPanel() {
         return "scripts";
       case "declarative":
         return "declarative";
+      case "skill-setup":
+        return "skill-setup";
       default:
         return nav.featureId;
     }
@@ -6136,7 +6249,7 @@ function AppPanel() {
     }
     switch (nav.view) {
       case "pinned":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PinnedCommands,
           {
             onNavigate: nav.navigateInner,
@@ -6150,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,
@@ -6170,7 +6283,7 @@ function AppPanel() {
         );
       }
       case "custom-command":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CustomCommand,
           {
             onNavigate: nav.navigateInner,
@@ -6182,7 +6295,7 @@ function AppPanel() {
           }
         );
       case "pipelines":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineList,
           {
             onNavigate: nav.navigateInner,
@@ -6194,7 +6307,7 @@ function AppPanel() {
           }
         );
       case "tool-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ToolStatus,
           {
             onBack: focus.focusSidebar,
@@ -6206,7 +6319,7 @@ function AppPanel() {
           }
         );
       case "processes":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessList,
           {
             onNavigate: nav.navigateInner,
@@ -6218,7 +6331,7 @@ function AppPanel() {
           }
         );
       case "scripts":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ScriptPicker,
           {
             onNavigate: nav.navigateInner,
@@ -6230,7 +6343,7 @@ function AppPanel() {
           }
         );
       case "declarative":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativeHome,
           {
             onNavigate: nav.navigateInner,
@@ -6240,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,
@@ -6252,7 +6376,7 @@ function AppPanel() {
           }
         );
       case "self-update":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           SelfUpdate,
           {
             onBack: focus.focusSidebar,
@@ -6264,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 = () => {
@@ -6272,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 ?? "",
@@ -6285,7 +6409,7 @@ function AppPanel() {
           }
         );
       case "custom-command":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CustomCommand,
           {
             onNavigate: nav.navigateInner,
@@ -6297,7 +6421,7 @@ function AppPanel() {
           }
         );
       case "flag-selection":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           FlagSelection,
           {
             args: nav.innerParams.args ?? [],
@@ -6313,7 +6437,7 @@ function AppPanel() {
         );
       case "confirm-execute":
       case "command-execution":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           CommandExecution,
           {
             args: nav.innerParams.args ?? [],
@@ -6334,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,
@@ -6346,7 +6470,7 @@ function AppPanel() {
           }
         );
       case "pipeline-builder":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineBuilder,
           {
             onBack: nav.goBackInner,
@@ -6357,7 +6481,7 @@ function AppPanel() {
           }
         );
       case "pipeline-execution":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           PipelineExecution,
           {
             pipelineId: nav.innerParams.pipelineId ?? "",
@@ -6369,7 +6493,7 @@ function AppPanel() {
           }
         );
       case "self-update":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           SelfUpdate,
           {
             onBack: nav.goBackInner,
@@ -6381,7 +6505,7 @@ function AppPanel() {
           }
         );
       case "tool-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ToolStatus,
           {
             onBack: nav.goBackInner,
@@ -6393,7 +6517,7 @@ function AppPanel() {
           }
         );
       case "mcp-manage":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           McpManage,
           {
             onBack: nav.goBackInner,
@@ -6404,7 +6528,7 @@ function AppPanel() {
           }
         );
       case "process-list":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessList,
           {
             onNavigate: nav.navigateInner,
@@ -6416,7 +6540,7 @@ function AppPanel() {
           }
         );
       case "process-logs":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProcessLogs,
           {
             processId: nav.innerParams.processId ?? "",
@@ -6428,7 +6552,7 @@ function AppPanel() {
           }
         );
       case "project-config":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ProjectConfig,
           {
             onBack: nav.goBackInner,
@@ -6439,7 +6563,7 @@ function AppPanel() {
           }
         );
       case "declarative-plan":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativePlan,
           {
             onBack: nav.goBackInner,
@@ -6451,7 +6575,7 @@ function AppPanel() {
           }
         );
       case "declarative-status":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           DeclarativeStatus,
           {
             onBack: nav.goBackInner,
@@ -6462,7 +6586,7 @@ function AppPanel() {
           }
         );
       case "init-scaffold":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           InitScaffold,
           {
             onBack: nav.goBackInner,
@@ -6474,7 +6598,7 @@ function AppPanel() {
           }
         );
       case "script-picker":
-        return /* @__PURE__ */ jsx41(
+        return /* @__PURE__ */ jsx42(
           ScriptPicker,
           {
             onNavigate: nav.navigateInner,
@@ -6485,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",
@@ -6504,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,
@@ -6517,7 +6652,7 @@ function AppPanel() {
       )
     }
   );
-  const main2 = /* @__PURE__ */ jsx41(
+  const main2 = /* @__PURE__ */ jsx42(
     Panel,
     {
       id: "main",
@@ -6528,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,
@@ -6594,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: {} };
   }
@@ -6667,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)",
@@ -7518,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);
@@ -7646,7 +7789,7 @@ Apply completed with ${errors.length} error(s).
     const socketPath2 = getSocketPath();
     const ipc2 = socketPath2 ? createIpcServer(socketPath2) : null;
     if (ipc2) await ipc2.start();
-    const inst = render(React28.createElement(AppComponent2));
+    const inst = render(React29.createElement(AppComponent2));
     await inst.waitUntilExit();
     if (ipc2) await ipc2.stop();
     process.exit(0);
@@ -7655,7 +7798,7 @@ Apply completed with ${errors.length} error(s).
   const socketPath = getSocketPath();
   const ipc = socketPath ? createIpcServer(socketPath) : null;
   if (ipc) await ipc.start();
-  const instance = render(React28.createElement(AppComponent));
+  const instance = render(React29.createElement(AppComponent));
   await instance.waitUntilExit();
   if (ipc) await ipc.stop();
   process.exit(0);