claude-agent-skills 1.5.1 → 1.5.3

package/commands/hub.js

@@ -2,10 +2,9 @@ import updateNotifier from 'update-notifier';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import ansis from 'ansis';
-import { showIntro } from '../lib/banner.js';
+import { showIntro, showIntroStatic } from '../lib/banner.js';
 import { CliCancel } from '../lib/prompts.js';
-import { brand, muted, white } from '../lib/theme.js';
+import { brand, muted } from '../lib/theme.js';
 import { inlineSelect } from '../lib/inlineSelect.js';
 
 const req = createRequire(import.meta.url);
@@ -31,30 +30,61 @@ const MENU = [
   { value: 'quit',   label: 'Quit' },
 ];
 
-function printCompactHeader() {
-  const silver = s => ansis.rgb(190, 190, 190)(s);
-  process.stdout.write('\n');
-  process.stdout.write(brand('◈ CLAUDE SKILLS') + '  ' + silver('Agent Skills for Claude Code') + '\n');
-  process.stdout.write('\n');
-}
-
 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() {
-  // Enter alternate screen buffer — isolated viewport with no scrollback accumulation.
-  // Original terminal content is restored when we exit (same as vim/less/claude-code).
+  // Alternate screen buffer — isolated viewport, no scrollback. Restored on exit like vim/less.
   process.stdout.write('\x1b[?1049h\x1b[2J\x1b[H');
-  process.on('exit', restoreScreen); // covers Ctrl+C, process.exit(), uncaught errors
+  process.on('exit', restoreScreen);
 
-  await showIntro();
+  await showIntro(); // animated banner on first load
 
   let first = true;
   for (;;) {
     if (!first) {
       process.stdout.write('\x1b[2J\x1b[H');
-      printCompactHeader();
+      await showIntroStatic(); // static banner — always visible on return to menu
     }
     first = false;
 
@@ -65,10 +95,7 @@ export async function runHub() {
         options: MENU,
       });
 
-      if (choice === 'quit') {
-        restoreScreen();
-        return;
-      }
+      if (choice === 'quit') { restoreScreen(); return; }
 
       if (choice === 'add')    await runAdd(SKIP);
       if (choice === 'update') await runUpdate(SKIP);
@@ -76,12 +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) {                    // hub menu ESC → quit
-        restoreScreen();
-        return;
-      }
+      if (e instanceof CliCancel) continue; // ESC from sub-step → back to menu immediately
+      if (e?.isCancel) { restoreScreen(); return; }
       restoreScreen();
       throw e;
     }

package/lib/banner.js

@@ -89,6 +89,13 @@ async function renderStatic() {
   renderFrame(staticColor);
 }
 
+function printSubtitle() {
+  const silver = s => ansis.rgb(190, 190, 190)(s);
+  process.stdout.write('\n');
+  process.stdout.write(silver('Agent Skills for Claude Code by Pavithran Francis') + '\n\n');
+  process.stdout.write(muted('Repository: ') + silver(REPO) + '\n\n');
+}
+
 /**
  * showIntro()              — full two-sweep entrance + subtitle (call ONCE at startup)
  * showIntro({ skip:true }) — no-op (used inside sub-commands called from hub)
@@ -100,10 +107,14 @@ export async function showIntro({ skip = false } = {}) {
 
   await runSweep({ step: 3, fps: 55 }); // first sweep  (~0.8 s)
   await runSweep({ step: 3, fps: 55 }); // second sweep (~0.8 s)
-  await renderStatic();                  // settle to metallic pride
+  await renderStatic();                  // settle to metallic state
 
-  const silver = s => ansis.rgb(190, 190, 190)(s);
-  process.stdout.write('\n');
-  process.stdout.write(silver('Agent Skills for Claude Code by Pavithran Francis') + '\n\n');
-  process.stdout.write(muted('Repository: ') + silver(REPO) + '\n\n');
+  printSubtitle();
+}
+
+/** Static banner with no animation — used on hub loop iterations after the first. */
+export async function showIntroStatic() {
+  process.stdout.write('\n'.repeat(ART.length));
+  await renderStatic();
+  printSubtitle();
 }

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.1",
+  "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.1",
+  "version": "1.5.3",
   "skills": [
     "ask-matt",
     "brainstorming",