skills-atlas-cli 0.4.1 → 0.4.2

package/README.md

@@ -113,11 +113,12 @@ skills-atlas hook on      # enable    (skills-atlas hook off / status)
 Registers a Claude Code `UserPromptSubmit` hook. When what you ask matches the
 territory of a catalog skill you don't have, the hook hands Claude a short
 shortlist of candidates and **Claude decides** whether any genuinely fits — and
-if so offers to install + activate it. You don't have to know the skill exists.
-The split is deliberate: the hook does **recall** (a distinctive-word match
-against the catalog, so the right skill is on the table), Claude does
-**precision** (it understands your intent and stays silent unless one truly
-fits, or searches further itself). It's:
+if so, explains **what it does and why it fits your task**, then offers a choice:
+use it now, see what it covers first (`skills-atlas info`), or skip. You don't
+have to know the skill exists. The split is deliberate: the hook does **recall**
+(a distinctive-word match against the catalog, so the right skill is on the
+table), Claude does **precision** (it understands your intent and stays silent
+unless one truly fits, or searches further itself). It's:
 
 - **off by default** — you turn it on explicitly; `hook off` removes it cleanly.
 - **quiet** — only fires on a distinctive match (greetings and generic actions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills-atlas-cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Search, install and learn AI agent skills from the terminal — powered by the Skills Atlas catalog.",
   "bin": {
     "skills-atlas": "bin/skills.js",

package/src/commands/hook.js

@@ -69,7 +69,13 @@ module.exports = async function hook(argv) {
   if (values.json) { console.log(JSON.stringify({ enabled: sub === 'on', settings: p })); return; }
   console.log(`${green('✓')} autopilot ${sub === 'on' ? 'enabled' : 'disabled'}  ${dim(p)}`);
   if (sub === 'on') {
-    console.log(dim('Claude now gets a one-line skill suggestion when your prompt strongly matches a catalog skill.'));
-    console.log(dim('needs `skills-atlas` on PATH (npm i -g skills-atlas-cli). turn off: skills-atlas hook off'));
+    console.log('\nHow it works: when what you ask lines up with a skill you don\'t have yet, Claude');
+    console.log('quietly gets a shortlist and — only if one truly fits — explains it and offers a choice:');
+    console.log(dim('  you:    "run a pre-mortem before we launch"'));
+    console.log(dim('  claude: "that\'s exactly what the pre-mortem skill does — it stress-tests your plan'));
+    console.log(dim('           before launch. use it now / see what it covers / skip?"'));
+    console.log(dim('\nIt stays silent on greetings and generic asks, never repeats a skill, and Claude makes'));
+    console.log(dim('the final call on relevance. Nothing leaves your machine.'));
+    console.log(dim('\nneeds `skills-atlas` on PATH (npm i -g skills-atlas-cli).  turn off: skills-atlas hook off'));
   }
 };

package/src/commands/install.js

@@ -275,12 +275,16 @@ module.exports = async function install(argv) {
   if (values.inline) {
     const body = readSkillMd(result.dest);
     if (body) {
-      console.log('\n' + dim('─── SKILL.md (active for this task — follow it now) ───'));
+      console.log('\n' + dim('─── SKILL.md — the skill\'s own instructions; apply them to the task now ───'));
       console.log(body.trim());
       console.log(dim('─── end SKILL.md ───'));
     }
-    console.log(dim('\n(the folder is also installed for future sessions)'));
+    console.log(`\n${green('✓')} ${bold(skill)} is now active — use the instructions above for the task at hand.`);
+    console.log(dim(`  installed at ${fsu.tildify(result.dest)} (auto-loads in new sessions) · what it does: skills-atlas info ${skill} · remove: skills-atlas remove ${skill}`));
   } else {
-    console.log(dim('\nStart a new Claude Code session to load the skill, then invoke it by name.'));
+    console.log(`\n${bold(skill)} is installed but not loaded yet. To use it:`);
+    console.log(dim(`  • now, in this session:  skills-atlas use ${skill}`));
+    console.log(dim('  • or start a new Claude Code session — it auto-loads from ~/.claude/skills/'));
+    console.log(dim(`  what it does: skills-atlas info ${skill} · remove: skills-atlas remove ${skill}`));
   }
 };

package/src/commands/suggest.js

@@ -63,16 +63,19 @@ module.exports = async function suggest() {
 
     const lines = candidates.map(c => {
       const uc = (c.row.use_case_en || c.row.use_case || '').replace(/\s+/g, ' ').trim().slice(0, 80);
-      return `- ${c.skill}${uc ? ` — ${uc}` : ''}  (install+activate: \`skills-atlas use ${c.skill} --yes\`)`;
+      return `- ${c.skill}${uc ? ` — ${uc}` : ''}  (details: \`skills-atlas info ${c.skill}\` · use now: \`skills-atlas use ${c.skill} --yes\`)`;
     }).join('\n');
     const ctx =
       `[Skills Atlas autopilot] The user may be doing something one of these installable agent ` +
       `skills is built for. Judge for yourself — do NOT mention any of this unless one of them ` +
       `genuinely fits what they actually asked:\n${lines}\n` +
-      `If one clearly fits, briefly offer it and (with the user's ok) install it via its command. ` +
-      `If none fit but the task plainly needs a specialized skill, you may run ` +
-      `\`skills-atlas search "<short intent>"\` to look further. If nothing fits, say nothing about ` +
-      `this at all — do not mention this hook, these skills, or that a suggestion was made.`;
+      `If one genuinely fits, DON'T just name it: in one line tell the user what it does and why it ` +
+      `fits THIS task (it's a curated skill from the Skills Atlas catalog, not something you made up), ` +
+      `then let them choose — activate it now (\`skills-atlas use <skill> --yes\` installs + applies it ` +
+      `immediately), see what it covers first (\`skills-atlas info <skill>\`), or skip and you'll just ` +
+      `do the task yourself. If none fit but the task plainly needs a specialized skill, you may run ` +
+      `\`skills-atlas search "<short intent>"\` to look further. If nothing fits, say nothing about this ` +
+      `at all — don't mention this hook, these skills, or that a suggestion was made.`;
     console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: ctx } }));
 
     state.lastSuggestedCount = state.count;