@botskill/cli 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botskill/cli",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "CLI tool for BotSkill - AI agent skills platform",
   "main": "src/index.js",
   "bin": {

package/src/commands/get.js

@@ -25,7 +25,8 @@ getCommand
   .option('-o, --output <dir>', 'Output directory (default: current directory)')
   .option('--dry-run', 'Show what would be downloaded without actually downloading')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (specifier, options) => {
+  .action(async (specifier, options, command) => {
+    const apiUrl = command.optsWithGlobals().apiUrl;
     const { name, version } = parseSpecifier(specifier);
     const outputDir = path.resolve(options.output || process.cwd());
 
@@ -42,7 +43,7 @@ getCommand
     }
 
     try {
-      const api = createApiClient(options.apiUrl);
+      const api = createApiClient(apiUrl);
 
       const fullSpec = version ? `${name}@${version}` : name;
       console.log(`Downloading skill: ${fullSpec}`);

package/src/commands/info.js

@@ -17,7 +17,7 @@ infoCommand
   .description('Show skill details from BotSkill')
   .argument('<specifier>', 'Skill name or name@version')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (specifier, options = {}) => {
+  .action(async (specifier, options, command) => {
     const { name, version } = parseSpecifier(specifier);
 
     if (!name) {
@@ -25,8 +25,9 @@ infoCommand
       process.exit(1);
     }
 
+    const apiUrl = command.optsWithGlobals().apiUrl;
     try {
-      const api = createApiClient(options.apiUrl);
+      const api = createApiClient(apiUrl);
       const fullSpec = version ? `${name}@${version}` : name;
 
       const resolveRes = await api.get(`/skills/by-name/${encodeURIComponent(fullSpec)}`);

package/src/commands/init.js

@@ -3,22 +3,25 @@ import path from 'path';
 import fs from 'fs-extra';
 import inquirer from 'inquirer';
 
+function toSkillName(raw) {
+  const s = String(raw || 'my-skill').trim();
+  return s.toLowerCase()
+    .replace(/\s+/g, '-')
+    .replace(/[^a-z0-9-]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '') || 'my-skill';
+}
+
 const initCommand = new Command('init');
 initCommand
   .description('Initialize a new skill project')
+  .argument('[path]', 'Target directory: "." or path for current/specified dir; omit to create skill-named directory')
   .option('-n, --name <name>', 'Project/skill name')
   .option('-d, --description <description>', 'Skill description')
   .option('-c, --category <category>', 'Category: ai, data, web, devops, security, tools')
   .option('-y, --yes', 'Use defaults without prompting')
-  .action(async (options) => {
+  .action(async (pathArg, options) => {
     const cwd = process.cwd();
-    const configPath = path.join(cwd, 'skill.config.json');
-
-    if (await fs.pathExists(configPath)) {
-      console.error('skill.config.json already exists in this directory.');
-      process.exit(1);
-    }
-
     const validCategories = ['ai', 'data', 'web', 'devops', 'security', 'tools'];
     let answers = {};
 
@@ -68,6 +71,25 @@ initCommand
       ]);
     }
 
+    const skillName = toSkillName(answers.name);
+    let targetDir;
+
+    if (pathArg && pathArg !== '.') {
+      targetDir = path.resolve(cwd, pathArg);
+      await fs.ensureDir(targetDir);
+    } else if (pathArg === '.') {
+      targetDir = cwd;
+    } else {
+      targetDir = path.join(cwd, skillName);
+      await fs.ensureDir(targetDir);
+    }
+
+    const configPath = path.join(targetDir, 'skill.config.json');
+    if (await fs.pathExists(configPath)) {
+      console.error(`skill.config.json already exists in ${targetDir}`);
+      process.exit(1);
+    }
+
     const config = {
       name: answers.name,
       description: answers.description,
@@ -82,12 +104,6 @@ initCommand
 
     await fs.writeJson(configPath, config, { spaces: 2 });
 
-    // Agent Skills spec: https://agentskills.io/specification
-    // name: required, 1-64 chars, lowercase + hyphens
-    // description: required, max 1024 chars
-    // metadata.version, metadata.author: optional
-    const rawName = String(answers.name || 'my-skill').trim();
-    const skillName = rawName.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '').replace(/-+/g, '-').replace(/^-|-$/g, '') || 'my-skill';
     const skillMd = `---
 name: ${skillName}
 description: ${answers.description}
@@ -115,10 +131,13 @@ Add your usage documentation here. The Markdown body contains skill instructions
 \`\`\`
 `;
 
-    const skillMdPath = path.join(cwd, 'SKILL.md');
+    const skillMdPath = path.join(targetDir, 'SKILL.md');
     await fs.writeFile(skillMdPath, skillMd, 'utf-8');
 
     console.log('Created skill.config.json and SKILL.md');
+    if (targetDir !== cwd) {
+      console.log(`Location: ${targetDir}`);
+    }
     console.log('\nNext steps:');
     console.log('1. Edit SKILL.md to add documentation (the content below the frontmatter)');
     console.log('2. Run "skm login" to authenticate');

package/src/commands/list.js

@@ -8,7 +8,9 @@ function formatSkillDisplay(skill) {
   const downloads = skill.downloads ?? 0;
   const category = skill.category || '—';
   const status = skill.status || '—';
-  return { name, version, downloads, category, status };
+  const desc = (skill.description || '').trim();
+  const description = desc.length > 80 ? desc.slice(0, 77) + '...' : desc || '—';
+  return { name, version, downloads, category, status, description };
 }
 
 const listCommand = new Command('list');
@@ -21,8 +23,9 @@ listCommand
   .option('-l, --limit <number>', 'Maximum number of results (default: 20)', '20')
   .option('-p, --page <number>', 'Page number for pagination (default: 1)', '1')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (options) => {
-    const api = createApiClient(options.apiUrl);
+  .action(async (options, command) => {
+    const apiUrl = command.optsWithGlobals().apiUrl;
+    const api = createApiClient(apiUrl);
     const limit = parseInt(options.limit, 10) || 20;
     const page = parseInt(options.page, 10) || 1;
 
@@ -59,9 +62,10 @@ listCommand
       console.log(`\nFound ${pagination.totalSkills ?? skills.length} skill(s):`);
       console.log('─'.repeat(60));
       skills.forEach((skill) => {
-        const { name, version, downloads, category, status } = formatSkillDisplay(skill);
+        const { name, version, downloads, category, status, description } = formatSkillDisplay(skill);
         const statusStr = options.mine ? ` | ${status}` : '';
         console.log(`  ${name}`);
+        console.log(`    ${description}`);
         console.log(`    Version: ${version} | Downloads: ${downloads} | Category: ${category}${statusStr}`);
       });
       if (pagination.totalPages > 1) {

package/src/commands/login.js

@@ -12,8 +12,8 @@ loginCommand
   .option('-p, --password <password>', 'Password')
   .option('-t, --token <token>', 'Use access token directly (from web)')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (options) => {
-    const apiUrl = normalizeApiUrl(options.apiUrl || getApiUrl());
+  .action(async (options, command) => {
+    const apiUrl = normalizeApiUrl(command.optsWithGlobals().apiUrl || getApiUrl());
 
     if (options.token) {
       setAuth({ token: options.token });

package/src/commands/logout.js

@@ -6,8 +6,8 @@ const logoutCommand = new Command('logout');
 logoutCommand
   .description('Logout from BotSkill')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (options) => {
-    const apiUrl = normalizeApiUrl(options.apiUrl || getApiUrl());
+  .action(async (options, command) => {
+    const apiUrl = normalizeApiUrl(command.optsWithGlobals().apiUrl || getApiUrl());
     const refreshToken = getRefreshToken();
     if (refreshToken) {
       try {

package/src/commands/publish.js

@@ -11,7 +11,8 @@ publishCommand
   .option('-f, --file <path>', 'Path to SKILL.md, .zip, or .tar.gz')
   .option('--dry-run', 'Validate without uploading')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (options) => {
+  .action(async (options, command) => {
+    const apiUrl = command.optsWithGlobals().apiUrl;
     if (!getToken()) {
       console.error('Not logged in. Run: skm login');
       process.exit(1);
@@ -38,7 +39,7 @@ publishCommand
 
     console.log(`Publishing skill from ${path.basename(filePath)}...`);
     try {
-      const skill = await uploadSkillFile(filePath, { apiUrl: options.apiUrl });
+      const skill = await uploadSkillFile(filePath, { apiUrl });
       console.log('Skill published successfully!');
       console.log(`Name: ${skill?.name}`);
       console.log(`Version: ${skill?.version || (skill?.versions?.[0]?.version)}`);

package/src/commands/push.js

@@ -11,7 +11,8 @@ pushCommand
   .option('-f, --file <path>', 'Path to SKILL.md, .zip, or .tar.gz')
   .option('--dry-run', 'Validate without uploading')
   .option('--api-url <url>', 'API base URL')
-  .action(async (options) => {
+  .action(async (options, command) => {
+    const apiUrl = command.optsWithGlobals().apiUrl;
     if (!getToken()) {
       console.error('Not logged in. Run: skm login');
       process.exit(1);
@@ -38,7 +39,7 @@ pushCommand
 
     console.log(`Pushing skill from ${path.basename(filePath)}...`);
     try {
-      const skill = await uploadSkillFile(filePath, { apiUrl: options.apiUrl });
+      const skill = await uploadSkillFile(filePath, { apiUrl });
       console.log('Skill uploaded successfully!');
       console.log(`Name: ${skill?.name}`);
       console.log(`Version: ${skill?.version || (skill?.versions?.[0]?.version)}`);

package/src/commands/search.js

@@ -9,7 +9,9 @@ function formatSkillDisplay(skill) {
   const version = skill.version || (skill.versions?.[0]?.version) || '—';
   const downloads = skill.downloads ?? 0;
   const category = skill.category || '—';
-  return { displayName, version, downloads, category };
+  const desc = (skill.description || '').trim();
+  const description = desc.length > 80 ? desc.slice(0, 77) + '...' : desc || '—';
+  return { displayName, version, downloads, category, description };
 }
 
 const searchCommand = new Command('search');
@@ -20,8 +22,9 @@ searchCommand
   .option('-l, --limit <number>', 'Maximum number of results (default: 20)', '20')
   .option('-p, --page <number>', 'Page number for pagination (default: 1)', '1')
   .option('--api-url <url>', 'API base URL (overrides config for this command)')
-  .action(async (query, options) => {
-    const api = createApiClient(options.apiUrl);
+  .action(async (query, options, command) => {
+    const apiUrl = command.optsWithGlobals().apiUrl;
+    const api = createApiClient(apiUrl);
     const limit = parseInt(options.limit, 10) || 20;
     const page = parseInt(options.page, 10) || 1;
 
@@ -41,8 +44,9 @@ searchCommand
       console.log(`\nFound ${pagination.totalSkills ?? skills.length} skill(s) for "${query}":`);
       console.log('─'.repeat(60));
       skills.forEach((skill) => {
-        const { displayName, version, downloads, category } = formatSkillDisplay(skill);
+        const { displayName, version, downloads, category, description } = formatSkillDisplay(skill);
         console.log(`  ${displayName}`);
+        console.log(`    ${description}`);
         console.log(`    Version: ${version} | Downloads: ${downloads} | Category: ${category}`);
       });
       if (pagination.totalPages > 1) {

package/src/index.js

@@ -28,7 +28,8 @@ const program = new Command();
 program
   .name('skm')
   .description('CLI tool for managing BotSkill - a platform for AI agent skills')
-  .version(version);
+  .version(version)
+  .option('--api-url <url>', 'API base URL (overrides config for this command)');
 
 program.addCommand(initCommand);
 program.addCommand(loginCommand);