skills-atlas-cli 0.3.0 → 0.3.1

package/README.md

@@ -47,6 +47,7 @@ skills-atlas info brainstorming
 skills-atlas install brainstorming             # → ~/.claude/skills/   (default, all projects)
 skills-atlas install brainstorming --project   # → ./.claude/skills/   (this project only)
 skills-atlas install brainstorming --chain     # install the whole ⛓ workflow it belongs to
+skills-atlas use brainstorming                 # install AND activate now — prints SKILL.md, no restart
 skills-atlas install brainstorming --dry-run   # preview the files, write nothing
 
 # 🗂️ Manage what you've installed   (like a package manager)

package/bin/skills.js

@@ -13,7 +13,9 @@ const update = require('../src/commands/update');
 const { categories, list } = require('../src/commands/categories');
 
 const VERSION = require('../package.json').version;
-const commands = { search, info, install, installed, upgrade, remove, outdated, doctor, update, categories, list };
+// `use` = install + activate inline (emit the SKILL.md so an agent follows it now).
+const use = argv => install([...argv, '--inline']);
+const commands = { search, info, install, use, installed, upgrade, remove, outdated, doctor, update, categories, list };
 
 const HELP = `skills-atlas — search, install & manage AI agent skills
 
@@ -23,6 +25,7 @@ find & install:
   search <query>     find skills (filters: -c category, -p persona, -t type, --chain)
   info <skill>       show description, usage guidance, sources & install command
   install <skill>    download into .claude/skills/ (--chain for the whole workflow)
+  use <skill>        install AND activate it for the current session now (inline)
 
 manage what you've installed:
   installed          list installed skills (global + project)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills-atlas-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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/args.js

@@ -20,6 +20,7 @@ const ALL = {
   en: { type: 'boolean' },
   zh: { type: 'boolean' },
   all: { type: 'boolean' },
+  inline: { type: 'boolean' },
   help: { type: 'boolean', short: 'h' },
 };
 

package/src/commands/install.js

@@ -1,7 +1,12 @@
 'use strict';
 
+const fs = require('fs');
 const path = require('path');
 const { parse } = require('../args');
+
+const readSkillMd = dest => {
+  try { return fs.readFileSync(path.join(dest, 'SKILL.md'), 'utf8'); } catch { return null; }
+};
 const { loadData } = require('../data');
 const { buildIndices, vendorsFor, suggestSkills, skillDocPath } = require('../index-build');
 const { listSkillFiles } = require('../github');
@@ -81,7 +86,7 @@ async function installChain({ row, vendor, src, targetRoot, values }) {
 
 module.exports = async function install(argv) {
   const { values, positionals } = parse(argv,
-    ['global', 'project', 'source', 'force', 'yes', 'chain', 'dry-run', 'json']);
+    ['global', 'project', 'source', 'force', 'yes', 'chain', 'inline', 'dry-run', 'json']);
   if (values.help) { console.log(HELP); return; }
 
   const name = positionals[0];
@@ -241,10 +246,12 @@ module.exports = async function install(argv) {
   }
 
   if (values.json) {
-    console.log(JSON.stringify({
+    const out = {
       skill, mode: 'folder', source: src.name,
       dest: result.dest, files: result.fileCount, scripts: result.scripts.length, branch: result.branchUsed,
-    }));
+    };
+    if (values.inline) out.skillMd = readSkillMd(result.dest);
+    console.log(JSON.stringify(out));
     return;
   }
 
@@ -264,5 +271,16 @@ module.exports = async function install(argv) {
     ? infoForRow(skill, chosen.row, data.vendors)
     : buildInfo(skill, { skillIndex: idx.skillIndex, vendors: data.vendors });
   console.log(renderInfo(guide, { en: !values.zh, all: true }));
-  console.log(dim('\nStart a new Claude Code session to load the skill, then invoke it by name.'));
+
+  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(body.trim());
+      console.log(dim('─── end SKILL.md ───'));
+    }
+    console.log(dim('\n(the folder is also installed for future sessions)'));
+  } else {
+    console.log(dim('\nStart a new Claude Code session to load the skill, then invoke it by name.'));
+  }
 };