ma-agents 1.2.0 → 1.3.0

package/bin/cli.js

@@ -22,6 +22,7 @@ ${chalk.bold('Usage:')}
   ${chalk.cyan(`npx ${NAME} help`)}                         Show this help
 
 ${chalk.bold('Install options:')}
+  ${chalk.cyan('--global')}        Install to global/user-level paths (default: project-level)
   ${chalk.cyan('--path <dir>')}    Custom installation directory
 
 ${chalk.bold('Examples:')}
@@ -104,20 +105,24 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
     selectedAgentIds = chosen;
   }
 
-  // Step 3: Custom path (optional)
+  // Step 3: Installation scope (project vs global)
   let installPath = customPath || '';
+  let installScope = 'project';
   if (!installPath) {
     const { pathChoice } = await prompts({
       type: 'select',
       name: 'pathChoice',
-      message: 'Installation path:',
+      message: 'Installation scope:',
       choices: [
-        { title: 'Default (agent-specific paths)', value: 'default' },
+        { title: 'Project level (current directory)', value: 'project' },
+        { title: 'Global (user-level settings)', value: 'global' },
         { title: 'Custom path...', value: 'custom' }
       ]
     });
 
-    if (pathChoice === 'custom') {
+    if (pathChoice === 'global') {
+      installScope = 'global';
+    } else if (pathChoice === 'custom') {
       const { customDir } = await prompts({
         type: 'text',
         name: 'customDir',
@@ -133,7 +138,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
   console.log(chalk.bold('  Summary:'));
   console.log(chalk.cyan('  Skills:  ') + selectedSkillIds.join(', '));
   console.log(chalk.cyan('  Agents:  ') + selectedAgentIds.join(', '));
-  console.log(chalk.cyan('  Path:    ') + (installPath || 'default'));
+  console.log(chalk.cyan('  Path:    ') + (installPath || (installScope === 'global' ? 'global (user-level)' : 'project (current directory)')));
   console.log('');
 
   const { confirmed } = await prompts({
@@ -151,7 +156,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
   // Step 5: Install each skill
   for (const skillId of selectedSkillIds) {
     try {
-      await installSkill(skillId, selectedAgentIds, installPath);
+      await installSkill(skillId, selectedAgentIds, installPath, installScope);
     } catch (error) {
       console.error(chalk.red(`\n Failed to install ${skillId}:`), error.message);
     }
@@ -162,14 +167,17 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath) {
 
 async function handleInstall(args) {
   const pathIdx = args.indexOf('--path');
+  const globalFlag = args.includes('--global');
   let customPath = '';
-  let positional = [...args];
+  let positional = [...args].filter(a => a !== '--global');
 
   if (pathIdx !== -1) {
-    customPath = args[pathIdx + 1] || '';
-    positional.splice(pathIdx, 2);
+    customPath = positional[positional.indexOf('--path') + 1] || '';
+    const pIdx = positional.indexOf('--path');
+    positional.splice(pIdx, 2);
   }
 
+  const scope = globalFlag ? 'global' : 'project';
   const skillId = positional[0];
   const agentIds = positional.slice(1);
 
@@ -185,9 +193,9 @@ async function handleInstall(args) {
     return;
   }
 
-  // Full args → direct install
+  // Full args → direct install (defaults to project-level)
   try {
-    await installSkill(skillId, agentIds, customPath);
+    await installSkill(skillId, agentIds, customPath, scope);
     console.log(chalk.bold.green('\n Installation complete!\n'));
   } catch (error) {
     console.error(chalk.red('\n Installation failed:'), error.message);

package/lib/agents.js

@@ -7,7 +7,8 @@ const path = require('path');
  * - id: unique identifier
  * - name: display name
  * - description: brief description
- * - getSkillsPath: function that returns the default skills directory
+ * - getProjectPath: function that returns the project-level skills directory (relative to cwd)
+ * - getGlobalPath: function that returns the global/user-level skills directory
  * - fileExtension: the file extension for skill files
  * - template: the template type to use for this agent
  */
@@ -17,7 +18,8 @@ const agents = [
     id: 'claude-code',
     name: 'Claude Code',
     description: 'Anthropic Claude Code CLI',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.claude', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'skills');
@@ -34,7 +36,8 @@ const agents = [
     id: 'gemini',
     name: 'Google Gemini',
     description: 'Google Gemini Code Assist',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.gemini', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Gemini', 'skills');
@@ -51,7 +54,8 @@ const agents = [
     id: 'copilot',
     name: 'GitHub Copilot',
     description: 'GitHub Copilot Agent Mode',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.github', 'copilot', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'GitHub Copilot', 'skills');
@@ -68,7 +72,8 @@ const agents = [
     id: 'kilocode',
     name: 'Kilocode',
     description: 'Kilocode AI Assistant',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.kilocode', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Kilocode', 'skills');
@@ -85,7 +90,8 @@ const agents = [
     id: 'cline',
     name: 'Cline',
     description: 'Cline AI Assistant',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.cline', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'skills');
@@ -102,7 +108,8 @@ const agents = [
     id: 'cursor',
     name: 'Cursor',
     description: 'Cursor AI Editor',
-    getSkillsPath: () => {
+    getProjectPath: () => path.join(process.cwd(), '.cursor', 'skills'),
+    getGlobalPath: () => {
       const platform = os.platform();
       if (platform === 'win32') {
         return path.join(os.homedir(), 'AppData', 'Roaming', 'Cursor', 'User', 'skills');

package/lib/installer.js

@@ -42,7 +42,7 @@ function listAgents() {
 /**
  * Install a skill for specified agents
  */
-async function installSkill(skillId, agentIds, customPath = '') {
+async function installSkill(skillId, agentIds, customPath = '', scope = 'project') {
   const skills = listSkills();
   const skill = skills.find(s => s.id === skillId);
 
@@ -64,7 +64,7 @@ async function installSkill(skillId, agentIds, customPath = '') {
 
     try {
       // Determine installation path
-      const installPath = customPath || agent.getSkillsPath();
+      const installPath = customPath || (scope === 'global' ? agent.getGlobalPath() : agent.getProjectPath());
 
       // Ensure the skills directory exists
       await fs.ensureDir(installPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ma-agents",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "NPX tool to install skills for AI coding agents (Claude Code, Gemini, Copilot, Kilocode, Cline, Cursor)",
   "main": "index.js",
   "bin": {