claude-agent-skills 1.5.0 → 1.5.2

package/commands/hub.js

@@ -2,10 +2,8 @@ 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 { inlineSelect } from '../lib/inlineSelect.js';
 
 const req = createRequire(import.meta.url);
@@ -22,31 +20,32 @@ import { runCheck }  from './check.js';
 const SKIP = { skipIntro: true };
 
 const MENU = [
-  { value: 'add',    label: 'Add Skill(s)',               hint: 'install new skills' },
-  { value: 'update', label: 'Update Existing Skill(s)',   hint: 'pull latest versions' },
-  { value: 'remove', label: 'Remove Existing Skill(s)',   hint: 'uninstall skills' },
-  { value: 'list',   label: 'List Installed Skill(s)',    hint: 'show what\'s installed' },
-  { value: 'sync',   label: 'Sync/Restore from Lockfile', hint: 'restore from claude-skills-lock.json' },
-  { value: 'check',  label: 'Check Skill(s)',             hint: 'verify hashes & lockfile' },
+  { value: 'add',    label: 'Add Skill(s)',                hint: 'install new skills' },
+  { value: 'update', label: 'Update Existing Skill(s)',    hint: 'pull latest versions' },
+  { value: 'remove', label: 'Remove Existing Skill(s)',    hint: 'uninstall skills' },
+  { value: 'list',   label: 'List Installed Skill(s)',     hint: "show what's installed" },
+  { value: 'sync',   label: 'Sync/Restore from Lockfile',  hint: 'restore from claude-skills-lock.json' },
+  { value: 'check',  label: 'Check Skill(s)',              hint: 'verify hashes & lockfile' },
   { 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');
 }
 
 export async function runHub() {
-  await showIntro();
+  // 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);
+
+  await showIntro(); // animated banner on first load
 
   let first = true;
   for (;;) {
     if (!first) {
-      // Clear entire screen and show compact header instead of re-running the banner
+      // Clear alt screen and re-render the static banner so it's always visible
       process.stdout.write('\x1b[2J\x1b[H');
-      printCompactHeader();
+      await showIntroStatic();
     }
     first = false;
 
@@ -57,10 +56,7 @@ export async function runHub() {
         options: MENU,
       });
 
-      if (choice === 'quit') {
-        process.stdout.write('\n' + muted('Goodbye.') + '\n');
-        return;
-      }
+      if (choice === 'quit') { restoreScreen(); return; }
 
       if (choice === 'add')    await runAdd(SKIP);
       if (choice === 'update') await runUpdate(SKIP);
@@ -70,10 +66,8 @@ export async function runHub() {
       if (choice === 'check')  await runCheck(SKIP);
     } catch (e) {
       if (e instanceof CliCancel) continue; // sub-command ESC → back to menu
-      if (e?.isCancel) {                    // hub menu ESC → quit
-        process.stdout.write('\n' + muted('Goodbye.') + '\n');
-        return;
-      }
+      if (e?.isCancel) { restoreScreen(); return; } // hub menu ESC → quit
+      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/picker.js

@@ -157,7 +157,9 @@ export async function skillPicker({ message, options }) {
       if (key === KEY.ENTER) {
         if (!sel.size) return;
         cleanup();
-        process.stdout.write('\x1b[2K' + success('◆') + '  ' +
+        // Clear entire picker block then write compact confirmation
+        if (lastLines > 0) process.stdout.write(`\x1b[${lastLines}A\x1b[0J`);
+        process.stdout.write(success('◆') + '  ' +
           white(`${sel.size} skill(s) selected`) + '\n');
         resolve([...sel].sort((a, b) => a - b).map(i => options[i].value));
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-skills",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "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.0",
+  "version": "1.5.2",
   "skills": [
     "ask-matt",
     "brainstorming",