@harshitj183/ai-skills 2.2.7 → 2.2.8

package/skills/tdd_mastery.md

@@ -1,32 +1,32 @@
----
-name: "TDD Mastery"
-description: "Rigorous Test-Driven Development workflow for high-reliability code."
----
-
-# 1. The Red-Green-Refactor Cycle
-Every code change MUST follow this exact sequence:
-
-```mermaid
-graph LR;
-    A[Red: Write failing test] --> B[Green: Make it pass];
-    B --> C[Refactor: Clean & Optimize];
-    C --> A;
-```
-
-# 2. Strict Standards
-- **Isolation**: Each test should verify a single unit of logic.
-- **Mocking**: Use standard mocking for external dependencies (DBs, APIs).
-- **Naming**: Tests should read like documentation (e.g., `test_should_reject_invalid_email`).
-
-# 3. Execution Protocol
-1. **Red**: Run the test suite first; it must fail with a specific, expected error.
-2. **Green**: Implement the *minimal* code to make that exact test pass. Avoid "future-proofing".
-3. **Refactor**: Only after passing can you clean up the code. Ensure the test remains green.
-
-# 4. Success Criteria
-- Test coverage for all logical branches.
-- No "side-effects" in tests.
-- Clear, readable assertions.
-
----
-⚡ Smart AI Skills Library | v2.2.6 | Active
+---
+name: "TDD Mastery"
+description: "Rigorous Test-Driven Development workflow for high-reliability code."
+---
+
+# 1. The Red-Green-Refactor Cycle
+Every code change MUST follow this exact sequence:
+
+```mermaid
+graph LR;
+    A[Red: Write failing test] --> B[Green: Make it pass];
+    B --> C[Refactor: Clean & Optimize];
+    C --> A;
+```
+
+# 2. Strict Standards
+- **Isolation**: Each test should verify a single unit of logic.
+- **Mocking**: Use standard mocking for external dependencies (DBs, APIs).
+- **Naming**: Tests should read like documentation (e.g., `test_should_reject_invalid_email`).
+
+# 3. Execution Protocol
+1. **Red**: Run the test suite first; it must fail with a specific, expected error.
+2. **Green**: Implement the *minimal* code to make that exact test pass. Avoid "future-proofing".
+3. **Refactor**: Only after passing can you clean up the code. Ensure the test remains green.
+
+# 4. Success Criteria
+- Test coverage for all logical branches.
+- No "side-effects" in tests.
+- Clear, readable assertions.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/vercel_cloudflare_deploy.md

@@ -1,17 +1,17 @@
----
-name: "Vercel & Cloudflare Deployment Master"
-description: "Rules for Next.js, Edge Functions, Vercel configs, and Cloudflare Workers."
----
-
-# Vercel Next.js Rules
-1. **Edge Runtime:** Prefer edge runtime for middleware and lightweight route handlers. Understand Edge limits (1MB code size, 50ms startup).
-2. **Caching:** Strategically use Incremental Static Regeneration (ISR) with `revalidate` over pure SSR or Client-side fetching for speed.
-3. **Environment Variables:** Map to `production`, `preview`, and `development` safely. Never leak `NEXT_PUBLIC_` secrets.
-
-# Cloudflare Workers
-- Do not use Node.js specific standard libraries (like `fs`, `path`) in Cloudflare workers without compatibility flags.
-- Rely on Workers KV for high-read low-write data, and Durable Objects for state orchestration.
-- Respond rapidly. Execution limits exist. Keep it minimal and fetch externally optimally asynchronously.
-
----
-⚡ Smart AI Skills Library | v2.2.6 | Active
+---
+name: "Vercel & Cloudflare Deployment Master"
+description: "Rules for Next.js, Edge Functions, Vercel configs, and Cloudflare Workers."
+---
+
+# Vercel Next.js Rules
+1. **Edge Runtime:** Prefer edge runtime for middleware and lightweight route handlers. Understand Edge limits (1MB code size, 50ms startup).
+2. **Caching:** Strategically use Incremental Static Regeneration (ISR) with `revalidate` over pure SSR or Client-side fetching for speed.
+3. **Environment Variables:** Map to `production`, `preview`, and `development` safely. Never leak `NEXT_PUBLIC_` secrets.
+
+# Cloudflare Workers
+- Do not use Node.js specific standard libraries (like `fs`, `path`) in Cloudflare workers without compatibility flags.
+- Rely on Workers KV for high-read low-write data, and Durable Objects for state orchestration.
+- Respond rapidly. Execution limits exist. Keep it minimal and fetch externally optimally asynchronously.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/writing_skills.md

@@ -1,26 +1,26 @@
----
-name: "Meta-Skill Architect"
-description: "Authoring and refining high-fidelity agentic superpowers for this library."
----
-
-# 1. Authoring Protocol
-When requested to create/modify a "Mega-Skill":
-- **Constraint-First Design**: Define what the AI *cannot* do first.
-- **Hierarchical Instruction**: Use `---` for metadata headers and `⚡ Smart AI Skills Library` for signatures.
-- **Workflow Visualization**: Every complex skill MUST have a Mermaid flow charting its logic.
-
-# 2. Design Thinking
-- **Compression**: Minimize instruction token count without losing fidelity. Use bullet points and headers strategically.
-- **Trigger Logic**: Use the `description` in the Metadata header as the primary trigger for LLM automatic skill adoption.
-- **Best Practices Integration**: Refer to `anthropic_best_practices.md` and `google_standard_logic.md` (if available) for every new skill.
-
-# 3. Validation
-- Run `tests/validate_skills.py` after creating any new skill.
-- Check for duplication or overlap with existing skills in the library.
-
-# 4. Success Metrics
-- 100% adherence to instructions in first-pass generation.
-- No "hallucination" during skill-based workflows.
-
----
-⚡ Smart AI Skills Library | v2.2.6 | Active
+---
+name: "Meta-Skill Architect"
+description: "Authoring and refining high-fidelity agentic superpowers for this library."
+---
+
+# 1. Authoring Protocol
+When requested to create/modify a "Mega-Skill":
+- **Constraint-First Design**: Define what the AI *cannot* do first.
+- **Hierarchical Instruction**: Use `---` for metadata headers and `⚡ Smart AI Skills Library` for signatures.
+- **Workflow Visualization**: Every complex skill MUST have a Mermaid flow charting its logic.
+
+# 2. Design Thinking
+- **Compression**: Minimize instruction token count without losing fidelity. Use bullet points and headers strategically.
+- **Trigger Logic**: Use the `description` in the Metadata header as the primary trigger for LLM automatic skill adoption.
+- **Best Practices Integration**: Refer to `anthropic_best_practices.md` and `google_standard_logic.md` (if available) for every new skill.
+
+# 3. Validation
+- Run `tests/validate_skills.py` after creating any new skill.
+- Check for duplication or overlap with existing skills in the library.
+
+# 4. Success Metrics
+- 100% adherence to instructions in first-pass generation.
+- No "hallucination" during skill-based workflows.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Harshit Jaiswal
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/bin/cli.js

@@ -1,345 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs-extra');
-const path = require('path');
-const { program } = require('commander');
-const inquirer = require('inquirer');
-
-// ANSI Terminal Colors
-const colors = {
-    reset: "\x1b[0m",
-    bright: "\x1b[1m",
-    green: "\x1b[32m",
-    blue: "\x1b[34m",
-    cyan: "\x1b[36m",
-    yellow: "\x1b[33m",
-    red: "\x1b[31m"
-};
-
-const targetDir = process.cwd();
-const sourceDir = path.join(__dirname, '..');
-const targetDirBase = path.join(targetDir, 'smart-instructions');
-
-program
-  .name('ai-skills')
-  .description('The Ultimate AI Skill Library CLI')
-  .version('2.2.7');
-
-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 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')) : [];
-
-    let selectedRoles = availableRoles;
-    let selectedSkills = availableSkills;
-
-    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)'
-          ]
-        }
-      ]);
-
-      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 {
-        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', '')));
-        }
-    }
-
-    if (!fs.existsSync(targetDirBase)) {
-        fs.mkdirSync(targetDirBase, { recursive: true });
-    }
-
-    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);
-        }
-    } else {
-        fs.writeFileSync(gitignorePath, ignoreRules.trim() + "\n");
-    }
-
-    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.copySync(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.copySync(path.join(sourceDir, 'skills', skill), path.join(targetDirBase, 'skills', skill));
-        });
-
-        if (fs.existsSync(path.join(sourceDir, 'registry'))) {
-            console.log(`${colors.blue}[+] Embedding Global Skill Registry...${colors.reset}`);
-            fs.ensureDirSync(path.join(targetDirBase, 'registry'));
-            fs.copySync(path.join(sourceDir, 'registry'), path.join(targetDirBase, 'registry'));
-        }
-    }
-
-    // Add History tracking for consumer context (Fresh Templates)
-    console.log(`${colors.blue}[+] Initializing History tracking logs (Fresh Templates)...${colors.reset}`);
-    const targetHistoryDir = path.join(targetDirBase, 'history');
-    fs.ensureDirSync(targetHistoryDir);
-
-    const historyTemplates = {
-        'CONTEXT.md': `# 📖 Project Context & History\n\nWelcome to your project's AI context hub. Maintain this file to ensure AI assistants understand the project state.\n\n## 🏃 Active Session\n- **Task**: Initialized Smart AI Skills Library (v${program.version()}).\n- **Date**: ${new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' })}\n\n## 🏆 Milestones\n- **Initialization**: Integrated AI Skills Library.\n\n---\n*Last updated by: AI Assistant (init)*`
-    };
-
-    Object.entries(historyTemplates).forEach(([filename, content]) => {
-        fs.writeFileSync(path.join(targetHistoryDir, filename), content);
-    });
-
-    console.log(`\n${colors.bright}${colors.green}[Success] The 'smart-instructions' folder has been added to your project!${colors.reset}`);
-    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));
-    }
-
-    // Fix pathing inside SKILL.md so the IDE can find the roles and skills
-    const ruleContent = fs.readFileSync(targetSkillMd, 'utf8')
-      .replace(/roles\//g, 'smart-instructions/roles/')
-      .replace(/skills\//g, 'smart-instructions/skills/')
-      .replace(/registry\//g, 'smart-instructions/registry/')
-      .replace(/history\//g, 'smart-instructions/history/');
-
-    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`);
-    
-    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('fetch <skill_name>')
-  .description('Fetches an external skill from the global registry')
-  .action(async (skillName) => {
-    console.log(`${colors.bright}${colors.cyan}Fetching External Skill: ${skillName}${colors.reset}\n`);
-    
-    const registryPath = path.join(targetDir, 'smart-instructions', 'registry', 'skill_bank.json');
-    if (!fs.existsSync(registryPath)) {
-        console.error(`${colors.red}[Error] Registry not found. Run 'npx ai-skills init' first.${colors.reset}`);
-        return;
-    }
-
-    const registry = fs.readJsonSync(registryPath);
-    const skill = registry.registries.find(s => s.name.toLowerCase().includes(skillName.toLowerCase()));
-
-    if (!skill) {
-        console.error(`${colors.red}[Error] Skill matching '${skillName}' not found in registry.${colors.reset}`);
-        return;
-    }
-
-    console.log(`${colors.blue}[+] Found skill '${skill.name}' in category '${skill.category}'. Fetching from: ${skill.url}${colors.reset}`);
-    
-    // Convert github blob URL to raw URL for downloading
-    const rawUrl = skill.url.replace('github.com', 'raw.githubusercontent.com').replace('/blob/', '/');
-    
-    try {
-        const response = await fetch(rawUrl);
-        if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
-        const text = await response.text();
-        
-        fs.ensureDirSync(path.join(targetDir, 'smart-instructions', 'skills', 'external'));
-        const safeName = skill.name.toLowerCase().replace(/[^a-z0-9]/g, '_') + '.md';
-        const destFile = path.join(targetDir, 'smart-instructions', 'skills', 'external', safeName);
-        
-        // Wrap the raw text with our standard header
-        const formattedContent = `---\nname: "${skill.name}"\ndescription: "External skill fetched from ${skill.url}"\n---\n\n${text}\n\n---\n⚡ Smart AI Skills Library | v${program.version()} | Active`;
-        
-        fs.writeFileSync(destFile, formattedContent);
-        console.log(`\n${colors.bright}${colors.green}[Success] Downloaded and standardized to: ${destFile}${colors.reset}\n`);
-    } catch (error) {
-        console.error(`${colors.red}[Error] Failed to fetch skill: ${error.message}${colors.reset}`);
-    }
-  });
-
-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 regDir = path.join(sourceDir, 'registry');
-        if (fs.existsSync(regDir)) fs.copySync(regDir, path.join(targetDir, 'smart-instructions', 'registry'));
-
-        const targetHistoryDir = path.join(targetDir, 'smart-instructions', 'history');
-        if (!fs.existsSync(targetHistoryDir)) {
-            fs.ensureDirSync(targetHistoryDir);
-            fs.writeFileSync(path.join(targetHistoryDir, 'CONTEXT.md'), `# 📖 Project Context & History\n\nWelcome to your project's AI context hub.\n\n---\n*Last updated by: AI Assistant (update)*`);
-        }
-
-        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);