@harshitj183/ai-skills 2.0.0 → 2.2.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,24 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci || npm install
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -3,7 +3,7 @@
   <h1>Smart Instructions Library of AI Skill</h1>
 
   <p>
-    <a href="https://www.npmjs.com/package/@harshitj183/ai-skill"><img src="https://img.shields.io/npm/v/@harshitj183/ai-skill.svg?style=for-the-badge&color=blue" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/@harshitj183/ai-skills"><img src="https://img.shields.io/npm/v/@harshitj183/ai-skills.svg?style=for-the-badge&color=blue" alt="npm version"></a>
     <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge" alt="License: MIT"></a>
     <a href="http://makeapullrequest.com"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge" alt="PRs Welcome"></a>
   </p>
@@ -17,15 +17,21 @@ This library gives your AI agents extreme precision, bypassing general hallucina
 
 ---
 
-## <img src="https://cdn.simpleicons.org/npm" width="24" align="center" /> Quickstart: The Installer
+## <img src="https://cdn.simpleicons.org/npm" width="24" align="center" /> Quickstart: The Smart CLI
 
-Run our zero-dependency official installer inside any project directory (Next.js, Python, React Native, etc.) to instantly deploy the full library to your workspace.
+Our interactive CLI module gives you absolute control over what skills are deployed and auto-configures your IDE.
 
 ```bash
-npx @harshitj183/ai-skill init
+npx @harshitj183/ai-skills <command>
 ```
 
-> **Note for Cursor IDE users:** Move `smart-instructions/SKILL.md` to your project root and rename it to `.cursorrules` to automatically enforce global project rules across all your IDE chats.
+### Available Commands:
+1. **`init`** – Installs the full library quietly by default (perfect for letting your AI agent select skills dynamically).
+   - `npx @harshitj183/ai-skills init -i` (Interactive picker)
+   - `npx @harshitj183/ai-skills init -r frontend_expert.md -s react_best_practices.md` (CLI filtering)
+2. **`configure`** – Auto-detects and writes the rules file for your specific IDE (`.cursorrules`, `.windsurfrules`, `CLAUDE.md`, etc.).
+3. **`update`** – Safely pulls the newest official skills from the registry without overwriting your custom skills.
+4. **`create <skill_name>`** – Scaffolds a new highly-optimized custom Mega-Skill inside `smart-instructions/custom/`.
 
 ---
 
@@ -65,24 +71,97 @@ Give your AI absolute technical dominance over specific frameworks.
 
 ## <img src="https://cdn.simpleicons.org/github" width="24" align="center" /> Usage Across AI Platforms
 
-You can natively feed this library into major LLM workspace interfaces:
+Run the installer once in your project root, then configure your preferred AI tool:
+
+```bash
+npx @harshitj183/ai-skills init
+```
+
+This places all files inside `smart-instructions/` in your project. Your `.gitignore` is automatically updated.
+
+---
 
 ### <img src="https://cdn.simpleicons.org/visualstudiocode" width="18" align="center" /> 1. Cursor IDE
-- **Globally:** Run the `npx` command, then rename `SKILL.md` to `.cursorrules`.
-- **Surgically:** Type `@` in chat and select what you need.  
-  Example Prompt: *"@frontend_expert.md @react_best_practices.md implement a new dashboard navigation."*
+Rename `smart-instructions/SKILL.md` to `.cursorrules` at your project root. Every Cursor chat will automatically follow the rules.
+```
+mv smart-instructions/SKILL.md .cursorrules
+```
+Or reference individual skills surgically:
+> *"@react_best_practices.md implement a new dashboard."*
+
+---
+
+### <img src="https://cdn.simpleicons.org/anthropic" width="18" align="center" /> 2. Claude Code (CLI)
+Claude Code auto-reads `CLAUDE.md` from your root. Copy the contents:
+```bash
+cp smart-instructions/SKILL.md CLAUDE.md
+```
+Or tell Claude directly: *"Read `smart-instructions/SKILL.md` as your core directive."*
+
+---
+
+### <img src="https://cdn.simpleicons.org/openai" width="18" align="center" /> 3. ChatGPT (Web / Custom GPT)
+**Option A — Custom Instructions:**
+- Go to Settings → Custom Instructions → paste contents of `SKILL.md`
 
-### <img src="https://cdn.simpleicons.org/anthropic" width="18" align="center" /> 2. Claude Code (Anthropic CLI)
-- Put this library in your root folder. Tell Claude Code: *"Load `SKILL.md` as your core directive."*
+**Option B — Project Knowledge (ChatGPT Plus):**
+- Create a new Project → Upload `SKILL.md` and any skill files you need
 
-### <img src="https://cdn.simpleicons.org/google" width="18" align="center" /> 3. Gemini CLI / Antigravity
-- Instruct the Antigravity agent: *"Read `SKILL.md` and act according to the Roles inside."*
+**Option C — Chat Upload:**
+- Attach `SKILL.md` directly to your conversation as a file
+
+---
 
 ### <img src="https://cdn.simpleicons.org/githubcopilot" width="18" align="center" /> 4. GitHub Copilot (VS Code)
-- Copilot chat utilizes active tabs. Keep `azure_graph_integrator.md` open in a read-only tab, and ask: *"#file:azure_graph_integrator.md build a new AD token script."*
+Copy instructions to the Copilot-specific file:
+```bash
+cp smart-instructions/SKILL.md .github/copilot-instructions.md
+```
+Or reference in chat: *"#file:smart-instructions/react_best_practices.md refactor this component."*
+
+---
 
-### <img src="https://cdn.simpleicons.org/openai" width="18" align="center" /> 5. ChatGPT / Claude Web (Pro)
-- Upload `SKILL.md` into standard "Custom Instructions" / "Project Knowledge", and attach individual mega-skill files alongside your main prompt.
+### <img src="https://cdn.simpleicons.org/google" width="18" align="center" /> 5. Gemini / Antigravity (Google)
+Tell Antigravity: *"Read `smart-instructions/SKILL.md` and act according to the Roles inside."*
+Antigravity automatically detects skill files in your workspace.
+
+---
+
+### <img src="https://cdn.simpleicons.org/codium" width="18" align="center" /> 6. Windsurf IDE (Codeium)
+Windsurf supports `.windsurfrules` file:
+```bash
+cp smart-instructions/SKILL.md .windsurfrules
+```
+
+---
+
+### <img src="https://cdn.simpleicons.org/zedindustries" width="18" align="center" /> 7. Zed Editor
+Add to Zed's AI assistant context:
+- Settings → Assistant → System Prompt → paste `SKILL.md` contents
+
+---
+
+### 8. Cline / Continue.dev (VS Code Extensions)
+Place the skill files in `.clinerules` or `.continuerules`:
+```bash
+cp smart-instructions/SKILL.md .clinerules
+```
+For Continue.dev, add to `config.json` under `systemMessage`.
+
+---
+
+### 9. Aider (Terminal AI)
+```bash
+aider --read smart-instructions/SKILL.md
+```
+
+---
+
+### 10. Any LLM API (OpenAI, Groq, Mistral, Llama)
+Paste `SKILL.md` content as your `system` message in the API call:
+```javascript
+{ role: "system", content: fs.readFileSync("smart-instructions/SKILL.md", "utf8") }
+```
 
 ---
 

package/bin/cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
+const fs = require('fs-extra');
 const path = require('path');
+const { program } = require('commander');
+const inquirer = require('inquirer');
 
 // ANSI Terminal Colors
 const colors = {
@@ -16,64 +18,251 @@ const colors = {
 
 const targetDir = process.cwd();
 const sourceDir = path.join(__dirname, '..');
+const targetDirBase = path.join(targetDir, 'smart-instructions');
 
-console.log(`${colors.bright}${colors.cyan}Initializing Smart AI Skills Library...${colors.reset}\n`);
+program
+  .name('ai-skills')
+  .description('The Ultimate AI Skill Library CLI')
+  .version('2.0.1');
 
-// Helper function to copy files and directories recursively
-function copySync(src, dest) {
-    if (!fs.existsSync(src)) return;
-    const stat = fs.statSync(src);
-    if (stat.isDirectory()) {
-        if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
-        fs.readdirSync(src).forEach(file => {
-            copySync(path.join(src, file), path.join(dest, file));
-        });
-    } else {
-        fs.copyFileSync(src, dest);
-    }
-}
+program
+  .command('init')
+  .description('Installs the Smart AI Skills Library')
+  .option('-i, --interactive', 'Run interactively to select specific roles/skills')
+  .option('-r, --roles <roles>', 'Comma-separated list of roles to install')
+  .option('-s, --skills <skills>', 'Comma-separated list of skills to install')
+  .action(async (options) => {
+    console.log(`${colors.bright}${colors.cyan}Initializing Smart AI Skills Library...${colors.reset}\n`);
 
-const targetDirBase = path.join(targetDir, 'smart-instructions');
+    const availableRoles = fs.existsSync(path.join(sourceDir, 'roles')) ? fs.readdirSync(path.join(sourceDir, 'roles')) : [];
+    const availableSkills = fs.existsSync(path.join(sourceDir, 'skills')) ? fs.readdirSync(path.join(sourceDir, 'skills')) : [];
 
-if (!fs.existsSync(targetDirBase)) {
-    fs.mkdirSync(targetDirBase, { recursive: true });
-}
+    let selectedRoles = availableRoles;
+    let selectedSkills = availableSkills;
 
-const targetRolesDir = path.join(targetDirBase, 'roles');
-const targetSkillsDir = path.join(targetDirBase, 'skills');
-const targetSkillMd = path.join(targetDirBase, 'SKILL.md');
-const gitignorePath = path.join(targetDir, '.gitignore');
+    if (options.interactive) {
+      const { installType } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'installType',
+          message: 'How would you like to install the skills?',
+          choices: [
+            'Install Everything (All 8 Roles, 17 Mega-Skills)',
+            'Custom Pick (Select specific roles and skills)'
+          ]
+        }
+      ]);
 
-try {
-    console.log(`${colors.blue}[+] Initializing 'smart-instructions' workspace...${colors.reset}`);
-    if (fs.existsSync(path.join(sourceDir, 'SKILL.md'))) {
-        fs.copyFileSync(path.join(sourceDir, 'SKILL.md'), targetSkillMd);
+      if (installType.startsWith('Custom')) {
+        const answers = await inquirer.prompt([
+          {
+            type: 'checkbox',
+            name: 'roles',
+            message: 'Select the Master Roles you need:',
+            choices: availableRoles.filter(f => f.endsWith('.md'))
+          },
+          {
+            type: 'checkbox',
+            name: 'skills',
+            message: 'Select the Mega-Skills you need:',
+            choices: availableSkills.filter(f => f.endsWith('.md'))
+          }
+        ]);
+        selectedRoles = answers.roles;
+        selectedSkills = answers.skills;
+      }
     } else {
-        console.warn(`${colors.yellow}[!] SKILL.md not found in source.${colors.reset}`);
+        if (options.roles) {
+            const rList = options.roles.split(',').map(r => r.trim());
+            selectedRoles = availableRoles.filter(r => rList.includes(r) || rList.includes(r.replace('.md', '')));
+        }
+        if (options.skills) {
+            const sList = options.skills.split(',').map(s => s.trim());
+            selectedSkills = availableSkills.filter(s => sList.includes(s) || sList.includes(s.replace('.md', '')));
+        }
     }
 
-    console.log(`${colors.blue}[+] Extracting 8 Master Roles...${colors.reset}`);
-    copySync(path.join(sourceDir, 'roles'), targetRolesDir);
+    if (!fs.existsSync(targetDirBase)) {
+        fs.mkdirSync(targetDirBase, { recursive: true });
+    }
 
-    console.log(`${colors.blue}[+] Extracting 17 Mega-Skills...${colors.reset}`);
-    copySync(path.join(sourceDir, 'skills'), targetSkillsDir);
-    
-    console.log(`${colors.blue}[+] Securing source control (.gitignore)...${colors.reset}`);
+    console.log(`\n${colors.blue}[+] Securing source control (.gitignore)...${colors.reset}`);
     const ignoreRules = "\n\n# Smart AI Skills Library (Context Only)\nsmart-instructions/\n";
+    const gitignorePath = path.join(targetDir, '.gitignore');
     if (fs.existsSync(gitignorePath)) {
         const currentIgnore = fs.readFileSync(gitignorePath, 'utf8');
         if (!currentIgnore.includes('# Smart AI Skills Library')) {
             fs.appendFileSync(gitignorePath, ignoreRules);
-            console.log(`    ${colors.cyan}-> Appended rules to existing .gitignore${colors.reset}`);
         }
     } else {
         fs.writeFileSync(gitignorePath, ignoreRules.trim() + "\n");
-        console.log(`    ${colors.cyan}-> Created new .gitignore file${colors.reset}`);
+    }
+
+    console.log(`${colors.blue}[+] Copying SKILL.md Master Rulebook...${colors.reset}`);
+    const targetSkillMd = path.join(targetDirBase, 'SKILL.md');
+    if (fs.existsSync(path.join(sourceDir, 'SKILL.md'))) {
+        fs.copyFileSync(path.join(sourceDir, 'SKILL.md'), targetSkillMd);
+    }
+    
+    if (selectedRoles.length > 0) {
+        console.log(`${colors.blue}[+] Extracting ${selectedRoles.length} Master Roles...${colors.reset}`);
+        fs.ensureDirSync(path.join(targetDirBase, 'roles'));
+        selectedRoles.forEach(role => {
+            fs.copyFileSync(path.join(sourceDir, 'roles', role), path.join(targetDirBase, 'roles', role));
+        });
+    }
+
+    if (selectedSkills.length > 0) {
+        console.log(`${colors.blue}[+] Extracting ${selectedSkills.length} Mega-Skills...${colors.reset}`);
+        fs.ensureDirSync(path.join(targetDirBase, 'skills'));
+        selectedSkills.forEach(skill => {
+            fs.copyFileSync(path.join(sourceDir, 'skills', skill), path.join(targetDirBase, 'skills', skill));
+        });
     }
 
     console.log(`\n${colors.bright}${colors.green}[Success] The 'smart-instructions' folder has been added to your project!${colors.reset}`);
-    console.log(`${colors.yellow}Notice for Cursor IDE:${colors.reset} Move 'smart-instructions/SKILL.md' to the root of your project and rename it to '.cursorrules'\n`);
+    console.log(`${colors.yellow}Tip: Let your AI Agent pick skills natively, or run 'npx ai-skills configure' to setup your IDE!${colors.reset}\n`);
+  });
+
+program
+  .command('configure')
+  .description('Auto-configures your IDE to use the skills')
+  .action(async () => {
+    console.log(`${colors.bright}${colors.cyan}IDE Auto-Configuration${colors.reset}\n`);
+    
+    const targetSkillMd = path.join(targetDir, 'smart-instructions', 'SKILL.md');
+    if (!fs.existsSync(targetSkillMd)) {
+        console.error(`${colors.red}[Error] 'smart-instructions/SKILL.md' not found. Please run 'npx ai-skills init' first.${colors.reset}`);
+        return;
+    }
+
+    const { ideSelection } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'ideSelection',
+        message: 'Which AI IDE or tool are you using?',
+        choices: [
+          'Cursor (.cursorrules)',
+          'Windsurf (.windsurfrules)',
+          'Claude Code (CLAUDE.md)',
+          'GitHub Copilot (.github/copilot-instructions.md)',
+          'Cline (.clinerules)',
+          'Cancel'
+        ]
+      }
+    ]);
+
+    let destPath = '';
+    if (ideSelection.startsWith('Cursor')) destPath = '.cursorrules';
+    else if (ideSelection.startsWith('Windsurf')) destPath = '.windsurfrules';
+    else if (ideSelection.startsWith('Claude')) destPath = 'CLAUDE.md';
+    else if (ideSelection.startsWith('GitHub')) destPath = '.github/copilot-instructions.md';
+    else if (ideSelection.startsWith('Cline')) destPath = '.clinerules';
+    else {
+        console.log(`${colors.yellow}Configuration cancelled.${colors.reset}`);
+        return;
+    }
+
+    const fullDestPath = path.join(targetDir, destPath);
+    if (destPath.includes('/')) {
+        fs.ensureDirSync(path.dirname(fullDestPath));
+    }
+
+    const ruleContent = fs.readFileSync(targetSkillMd, 'utf8');
+
+    if (fs.existsSync(fullDestPath)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: `${destPath} already exists. Do you want to overwrite it?`,
+                default: false
+            }
+        ]);
+        if (!overwrite) {
+            console.log(`${colors.yellow}Configuration skipped.${colors.reset}`);
+            return;
+        }
+    }
+
+    fs.writeFileSync(fullDestPath, ruleContent);
+    console.log(`\n${colors.bright}${colors.green}[Success] ${destPath} has been successfully configured!${colors.reset}\n`);
+  });
+
+program
+  .command('create <skill_name>')
+  .description('Scaffolds a new custom Mega-Skill')
+  .action(async (skillName) => {
+    console.log(`${colors.bright}${colors.cyan}Custom Skill Scaffolding${colors.reset}\n`);
     
-} catch (error) {
-    console.error(`\n${colors.red}[Error] Failed to construct library structure: ${error.message}${colors.reset}\n`);
+    const { audience, format } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'audience',
+        message: 'Who is this skill for? (e.g., Frontend React Devs, Backend Node Devs):',
+      },
+      {
+         type: 'confirm',
+         name: 'format',
+         message: 'Include strict JSON formatting rules?',
+         default: true
+      }
+    ]);
+
+    const customDir = path.join(targetDir, 'smart-instructions', 'custom');
+    fs.ensureDirSync(customDir);
+
+    const destFile = path.join(customDir, `${skillName.replace('.md', '')}.md`);
+
+    const template = `# ${skillName} Mega-Skill\n\n## Objective\nProvide expert-level instructions for ${audience}.\n\n## Rules\n- Always prioritize clarity and performance.\n- Write modern, maintainable code.\n${format ? '- ALWAYS output responses in strict JSON format when requested.\n' : ''}\n## Architecture Guidelines\n1. Keep functions small and focused.\n2. Ensure rigorous error handling.\n`;
+
+    fs.writeFileSync(destFile, template);
+    console.log(`\n${colors.bright}${colors.green}[Success] Scaffolded new custom skill at ${destFile}!${colors.reset}\n`);
+  });
+
+program
+  .command('update')
+  .description('Updates the official skills without overwriting custom ones in /custom/')
+  .action(async () => {
+    console.log(`${colors.bright}${colors.cyan}Updating Official Skills${colors.reset}\n`);
+    const { proceed } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'proceed',
+        message: 'This will safely copy the latest official skills into smart-instructions/ overriding existing ones. Custom folders will be preserved. Proceed?',
+        default: true
+      }
+    ]);
+
+    if (!proceed) {
+        console.log(`${colors.yellow}Update cancelled.${colors.reset}`);
+        return;
+    }
+
+    try {
+        fs.ensureDirSync(path.join(targetDir, 'smart-instructions', 'roles'));
+        fs.ensureDirSync(path.join(targetDir, 'smart-instructions', 'skills'));
+        
+        const rDir = path.join(sourceDir, 'roles');
+        if (fs.existsSync(rDir)) fs.copySync(rDir, path.join(targetDir, 'smart-instructions', 'roles'));
+        
+        const sDir = path.join(sourceDir, 'skills');
+        if (fs.existsSync(sDir)) fs.copySync(sDir, path.join(targetDir, 'smart-instructions', 'skills'));
+
+        const targetSkillMd = path.join(targetDir, 'smart-instructions', 'SKILL.md');
+        if (fs.existsSync(path.join(sourceDir, 'SKILL.md'))) {
+            fs.copyFileSync(path.join(sourceDir, 'SKILL.md'), targetSkillMd);
+        }
+
+        console.log(`\n${colors.bright}${colors.green}[Success] Official library updated!${colors.reset}\n`);
+    } catch (e) {
+        console.error(`${colors.red}[Error] Update failed: ${e.message}${colors.reset}`);
+    }
+  });
+
+// Handle no arguments gracefully
+if (process.argv.length === 2) {
+    process.argv.push('--help');
 }
+
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harshitj183/ai-skills",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "The Ultimate 17 Mega-Skills & 8 Roles Library for AI Agents (Cursor, Claude Code, Copilot, Antigravity)",
   "main": "bin/cli.js",
   "bin": {
@@ -34,9 +34,14 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/harshitj183/ai-skill.git"
+    "url": "https://github.com/harshitj183/ai-skills.git"
   },
   "bugs": {
-    "url": "https://github.com/harshitj183/ai-skill/issues"
+    "url": "https://github.com/harshitj183/ai-skills/issues"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.4",
+    "inquirer": "^8.2.7"
   }
-}
+}