claude-agent-skills 1.5.2 → 1.5.3

package/commands/hub.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { showIntro, showIntroStatic } from '../lib/banner.js';
 import { CliCancel } from '../lib/prompts.js';
+import { brand, muted } from '../lib/theme.js';
 import { inlineSelect } from '../lib/inlineSelect.js';
 
 const req = createRequire(import.meta.url);
@@ -33,6 +34,45 @@ function restoreScreen() {
   process.stdout.write('\x1b[?1049l');
 }
 
+/** Show a live countdown then return — lets the user read command output before menu clears. */
+async function pauseBeforeReturn(seconds = 5) {
+  let remaining = seconds;
+  const render = () => process.stdout.write(
+    `\r\x1b[2K  ${brand('◂')} ${muted(`returning to menu in ${remaining}s  ·  press any key`)}`
+  );
+
+  process.stdout.write('\n');
+  render();
+
+  return new Promise(resolve => {
+    let done = false;
+    function cleanup() {
+      if (done) return;
+      done = true;
+      clearInterval(tick);
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeAllListeners('data');
+      process.stdout.write('\n');
+    }
+
+    const tick = setInterval(() => {
+      remaining--;
+      if (remaining <= 0) { cleanup(); resolve(); }
+      else render();
+    }, 1000);
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', key => {
+      if (key === '\x03') { cleanup(); process.exit(0); }
+      cleanup();
+      resolve();
+    });
+  });
+}
+
 export async function runHub() {
   // Alternate screen buffer — isolated viewport, no scrollback. Restored on exit like vim/less.
   process.stdout.write('\x1b[?1049h\x1b[2J\x1b[H');
@@ -43,9 +83,8 @@ export async function runHub() {
   let first = true;
   for (;;) {
     if (!first) {
-      // Clear alt screen and re-render the static banner so it's always visible
       process.stdout.write('\x1b[2J\x1b[H');
-      await showIntroStatic();
+      await showIntroStatic(); // static banner — always visible on return to menu
     }
     first = false;
 
@@ -64,9 +103,12 @@ export async function runHub() {
       if (choice === 'list')   await runList(SKIP);
       if (choice === 'sync')   await runSync(SKIP);
       if (choice === 'check')  await runCheck(SKIP);
+
+      // Pause so user can read command output before the screen clears
+      await pauseBeforeReturn();
     } catch (e) {
-      if (e instanceof CliCancel) continue; // sub-command ESC → back to menu
-      if (e?.isCancel) { restoreScreen(); return; } // hub menu ESC → quit
+      if (e instanceof CliCancel) continue; // ESC from sub-step → back to menu immediately
+      if (e?.isCancel) { restoreScreen(); return; }
       restoreScreen();
       throw e;
     }

package/lib/inlineSelect.js

@@ -13,13 +13,21 @@ const KEY = {
   ESC:    '\x1b',
 };
 
+function formatHints(str) {
+  return '  ' + brand('►► ') + str.split(' · ').map(part => {
+    const [key, ...rest] = part.trim().split(' ');
+    return ansis.bold(ansis.white(key)) + (rest.length ? muted(' ' + rest.join(' ')) : '');
+  }).join(muted('  ·  '));
+}
+
 export async function inlineSelect({ message, hint = '↑↓ navigate · enter select · esc back', options }) {
   let cursor = 0;
   let lastLines = 0;
 
   function renderLines() {
     const out = [];
-    out.push(brand('◆') + '  ' + ansis.bold(white(message)) + '  ' + muted(hint));
+    // Title line — no hints here (moved to footer bar)
+    out.push(brand('◆') + '  ' + ansis.bold(white(message)));
     out.push(muted('│'));
     for (let i = 0; i < options.length; i++) {
       const focused = i === cursor;
@@ -31,6 +39,8 @@ export async function inlineSelect({ message, hint = '↑↓ navigate · enter s
       out.push(muted('│') + '  ' + arrow + ' ' + label + desc);
     }
     out.push(muted('│'));
+    // Dedicated hint footer bar
+    out.push(formatHints(hint));
     return out;
   }
 

package/lib/picker.js

@@ -3,7 +3,14 @@
  * Navigation: ↑↓←→  space=toggle  a=all  enter=confirm  esc=back
  */
 import ansis from 'ansis';
-import { skillColor, white, muted, success, brand, warn } from './theme.js';
+import { skillColor, white, muted, success, brand } from './theme.js';
+
+function formatHints(str) {
+  return '  ' + brand('►► ') + str.split(' · ').map(part => {
+    const [key, ...rest] = part.trim().split(' ');
+    return ansis.bold(ansis.white(key)) + (rest.length ? muted(' ' + rest.join(' ')) : '');
+  }).join(muted('  ·  '));
+}
 
 const KEY = {
   UP:     '\x1b[A',
@@ -52,12 +59,13 @@ export async function skillPicker({ message, options }) {
     return Math.max(0, Math.min(options.length - 1, c));
   }
 
+  const HINT = '↑↓←→ navigate · space toggle · a=all · enter confirm · esc back';
+
   function renderGrid() {
     const lines = [];
 
-    // Header
-    lines.push(brand('◆') + '  ' + ansis.bold(white(message)) +
-      muted('  ↑↓←→ navigate · space toggle · a=all · enter confirm · esc back'));
+    // Header — title only, hints moved to footer bar
+    lines.push(brand('◆') + '  ' + ansis.bold(white(message)));
     lines.push(muted('│'));
 
     // Grid rows
@@ -94,12 +102,13 @@ export async function skillPicker({ message, options }) {
       lines.push(muted('│ ') + white(line));
     }
 
-    // Footer
+    // Footer — count + hint bar
     const selCount = sel.size;
     lines.push(
       '  ' + (selCount > 0 ? success(`${selCount} selected`) : muted('0 selected')) +
       muted(`  ·  ${cursor + 1} of ${options.length}`)
     );
+    lines.push(formatHints(HINT));
 
     return lines;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-skills",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Install and manage Pavi's Claude Code agent skills",
   "license": "MIT",
   "type": "module",

package/skills.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "name": "claude-agent-skills",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "skills": [
     "ask-matt",
     "brainstorming",