@harshitj183/ai-skills 2.2.5 → 2.2.8

package/skills/react_best_practices.md

@@ -1,13 +1,16 @@
----
-name: "React & Next.js Best Practices Master"
-description: "Vercel's official guidelines for React Server Components, Suspense, and Composition."
----
-
-# React Server Components (RSC)
-1. **Default to Server:** Every component without `useState`, `useEffect`, or DOM events should remain a Server Component.
-2. **Client Boundaries:** Push `"use client"` as low down the component tree as possible. Only wrap interactive islands, never the entire page layout.
-3. **Data Fetching:** Fetch data on the Server Component level and pass it down as props. Do not use `useEffect` for data fetching unless absolutely necessary for infinite polling.
-
-# Composition Patterns
-- **Do not drill props excessively:** If passing props more than 3 levels deep, use React Context or Composition (passing `children` or JSX slots).
-- **Suspense Wrappers:** Always wrap async Server Components with `<Suspense fallback={<Skeleton />}>` to prevent blocking the entire UI stream.
+---
+name: "React & Next.js Best Practices Master"
+description: "Vercel's official guidelines for React Server Components, Suspense, and Composition."
+---
+
+# React Server Components (RSC)
+1. **Default to Server:** Every component without `useState`, `useEffect`, or DOM events should remain a Server Component.
+2. **Client Boundaries:** Push `"use client"` as low down the component tree as possible. Only wrap interactive islands, never the entire page layout.
+3. **Data Fetching:** Fetch data on the Server Component level and pass it down as props. Do not use `useEffect` for data fetching unless absolutely necessary for infinite polling.
+
+# Composition Patterns
+- **Do not drill props excessively:** If passing props more than 3 levels deep, use React Context or Composition (passing `children` or JSX slots).
+- **Suspense Wrappers:** Always wrap async Server Components with `<Suspense fallback={<Skeleton />}>` to prevent blocking the entire UI stream.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/react_native_performance.md

@@ -1,13 +1,16 @@
----
-name: "React Native Performance"
-description: "Rules for Expo, React Native upgrades, and mobile UI rendering."
----
-
-# Rendering Optimization
-1. **Avoid Anonymous Functions in Renders:** Pass memoized functions down to child components to prevent excessive re-rendering.
-2. **Lists:** Use `@shopify/flash-list` over standard `FlatList` for massive performance gains in large lists.
-3. **Images:** Pre-fetch and cache images robustly using `expo-image` over native Image.
-
-# Upgrading Guidelines
-- Never upgrade React Native manually by directly editing `package.json` blindly. Always consult the official React Native Upgrade Helper for native iOS/Android code changes.
-- In Expo, strictly follow `npx expo install --fix` policies.
+---
+name: "React Native Performance"
+description: "Rules for Expo, React Native upgrades, and mobile UI rendering."
+---
+
+# Rendering Optimization
+1. **Avoid Anonymous Functions in Renders:** Pass memoized functions down to child components to prevent excessive re-rendering.
+2. **Lists:** Use `@shopify/flash-list` over standard `FlatList` for massive performance gains in large lists.
+3. **Images:** Pre-fetch and cache images robustly using `expo-image` over native Image.
+
+# Upgrading Guidelines
+- Never upgrade React Native manually by directly editing `package.json` blindly. Always consult the official React Native Upgrade Helper for native iOS/Android code changes.
+- In Expo, strictly follow `npx expo install --fix` policies.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/sanity_architecture.md

@@ -1,13 +1,16 @@
----
-name: "Sanity CMS Architect"
-description: "Guidelines for scalable content modeling, GROQ, and Answer Engine Optimization (AEO)."
----
-
-# Content Modeling
-1. **Never use deep nesting for core content:** Break massive documents down into discrete `document` types and link them with `reference` types to maximize query flexibility.
-2. **GROQ Projections:** Never use raw `*[_type == "post"]` without projections. Always map out specifically what the frontend needs: `*[_type == "post"] { title, slug, "authorName": author->name }`.
-3. **Draft States:** Account for draft filtering. By default, ensure `!(_id in path("drafts.**"))` is applied to production API endpoint fetchers unless explicit Preview modes are active.
-
-# SEO & AEO Patterns
-- Embed rich schemas (JSON-LD) dynamically based on structured portable text arrays.
-- Precompute image dimensions and `.lqip` blur hashes directly in GROQ so the UI never experiences Cumulative Layout Shift (CLS).
+---
+name: "Sanity CMS Architect"
+description: "Guidelines for scalable content modeling, GROQ, and Answer Engine Optimization (AEO)."
+---
+
+# Content Modeling
+1. **Never use deep nesting for core content:** Break massive documents down into discrete `document` types and link them with `reference` types to maximize query flexibility.
+2. **GROQ Projections:** Never use raw `*[_type == "post"]` without projections. Always map out specifically what the frontend needs: `*[_type == "post"] { title, slug, "authorName": author->name }`.
+3. **Draft States:** Account for draft filtering. By default, ensure `!(_id in path("drafts.**"))` is applied to production API endpoint fetchers unless explicit Preview modes are active.
+
+# SEO & AEO Patterns
+- Embed rich schemas (JSON-LD) dynamically based on structured portable text arrays.
+- Precompute image dimensions and `.lqip` blur hashes directly in GROQ so the UI never experiences Cumulative Layout Shift (CLS).
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/stripe_integration.md

@@ -1,14 +1,17 @@
----
-name: "Stripe Integrator"
-description: "Stripe payments and webhook best practices."
----
-
-# Webhook Handling
-1. **Verification:** Always verify webhook signatures using `stripe.webhooks.constructEvent(RawBody, Signature, Secret)`. Never trust unverified payloads.
-2. **Idempotency:** Implement idempotency keys for all charge or subscription mutations. 
-3. **Status Checks:** Assume webhooks can arrive out of order. Validate timestamps.
-
-# Integration Rules
-- Use Stripe Checkout instead of custom card elements unless highly specific UI is needed.
-- Listen for `checkout.session.completed` for fulfillment.
-- Manage subscriptions via `customer.subscription.updated` / `deleted`. Do not rely solely on the success return URL.
+---
+name: "Stripe Integrator"
+description: "Stripe payments and webhook best practices."
+---
+
+# Webhook Handling
+1. **Verification:** Always verify webhook signatures using `stripe.webhooks.constructEvent(RawBody, Signature, Secret)`. Never trust unverified payloads.
+2. **Idempotency:** Implement idempotency keys for all charge or subscription mutations. 
+3. **Status Checks:** Assume webhooks can arrive out of order. Validate timestamps.
+
+# Integration Rules
+- Use Stripe Checkout instead of custom card elements unless highly specific UI is needed.
+- Listen for `checkout.session.completed` for fulfillment.
+- Manage subscriptions via `customer.subscription.updated` / `deleted`. Do not rely solely on the success return URL.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/supabase_architect.md

@@ -1,14 +1,17 @@
----
-name: "Supabase Architect"
-description: "Supabase & PostgreSQL security, migrations, and best practices."
----
-
-# Database Guidelines
-1. **Migrations First:** Never execute destructive raw SQL via editors. Always use `supabase migration new` and apply via `supabase db push`.
-2. **Row Level Security (RLS):** Every table MUST have `ENABLE ROW LEVEL SECURITY`. Default to denying all access, then specify explicit `CREATE POLICY` for `SELECT`, `INSERT`, `UPDATE`, `DELETE`.
-3. **Indexing:** Add indices for any column used frequently in `WHERE` clauses, foreign keys, or `ORDER BY`.
-
-# Edge Functions
-- Always use standard Deno environments for Edge Functions. 
-- Validate JWTs heavily (use `verify_jwt: true` default).
-- Don't deploy bloated dependencies; prefer standard libraries.
+---
+name: "Supabase Architect"
+description: "Supabase & PostgreSQL security, migrations, and best practices."
+---
+
+# Database Guidelines
+1. **Migrations First:** Never execute destructive raw SQL via editors. Always use `supabase migration new` and apply via `supabase db push`.
+2. **Row Level Security (RLS):** Every table MUST have `ENABLE ROW LEVEL SECURITY`. Default to denying all access, then specify explicit `CREATE POLICY` for `SELECT`, `INSERT`, `UPDATE`, `DELETE`.
+3. **Indexing:** Add indices for any column used frequently in `WHERE` clauses, foreign keys, or `ORDER BY`.
+
+# Edge Functions
+- Always use standard Deno environments for Edge Functions. 
+- Validate JWTs heavily (use `verify_jwt: true` default).
+- Don't deploy bloated dependencies; prefer standard libraries.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/systematic_debugging.md

@@ -0,0 +1,34 @@
+---
+name: "Systematic Debugging"
+description: "Expert-level problem isolation and precision debugging methodologies."
+---
+
+# 1. The Wolf-Fence Algorithm
+Search for bugs by bisecting the system:
+
+```mermaid
+graph TD;
+    A[Identify Symptom] --> B[Draw Boundary];
+    B --> C{Bug Is Here?};
+    C -- Yes --> D[Divide and Conquer (Repeat)];
+    C -- No --> E[Widen Scope];
+    D --> F[Identify Root Cause];
+    F --> G[Verify Fix];
+```
+
+# 2. Precision Mapping
+- **Log Mining**: Capture and analyze application and environment logs.
+- **Trace Analysis**: Trace data flow step-by-step from input to error.
+- **Isolated Testing**: Create a minimal reproduction environment (MRE) that exists outside the main project context.
+
+# 3. Delta Debugging
+1. **Identify**: Find a "good" state and a "bad" state.
+2. **Minimize**: Find the smallest set of changes (code, data, config) that transformed "good" into "bad".
+3. **Isolate**: Correct the specific delta without affecting unrelated logic.
+
+# 4. Anti-Regression Protocol
+- Every bug fix **MUST** be accompanied by a regression test that would have caught it.
+- Re-run the entire test suite before proposing the final fix.
+
+---
+⚡ Smart AI Skills Library | v2.2.8 | Active

package/skills/tdd_mastery.md

@@ -0,0 +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.8 | Active

package/skills/vercel_cloudflare_deploy.md

@@ -1,14 +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.
+---
+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

@@ -0,0 +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.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,294 +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.5');
-
-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.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));
-        });
-    }
-
-    // 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 = {
-        'history.md': `# 📖 Project History & Context\n\nWelcome to your project's AI history hub. This system is designed to provide context for AI agents working on this project.\n\n### 📂 Modules\n| Module | Description | Link |\n| :--- | :--- | :--- |\n| **[AI Activity Log](ai_activity_log.md)** | Record of AI agent contributions. | [View Log](ai_activity_log.md) |\n| **[Project Timeline](project_timeline.md)** | Roadmap and milestones. | [View Timeline](project_timeline.md) |\n| **[Version History](version_history.md)** | Detailed release logs. | [View Versions](version_history.md) |\n\n---\n*Maintained by: AI Skills History System*`,
-        'ai_activity_log.md': `# 🤖 AI Activity Log\n\nThis log tracks specific contributions and tasks performed by AI agents in this project.\n\n---\n\n## 🏃 Active Session (Initial Setup)\n- **Task**: Initialized Smart AI Skills Library (v${program.version()}).\n- **Objective**: Established base AI context and roles library.\n\n---\n*Last updated by: AI Assistant (init)*`,
-        'project_timeline.md': `# 📅 Project Timeline\n\nMajor milestones and timeline of this project.\n\n---\n\n### ${new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' })}\n- **Initialized**: AI Skills Library integrated into the project.\n\n---\n*Last updated by: AI Assistant (init)*`,
-        'version_history.md': `# 📦 Version History\n\nVersion tracking for this specific project.\n\n---\n- **v0.1.0** (${new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' })}): Initial setup with Smart AI Skills Library.\n\n---\n*Last updated by: AI Assistant (init)*`,
-        'milestones.md': `# 🏆 Project Milestones\n\nTracking the breakthrough moments of this project.\n\n---\n- **Initialization**: Integrated AI Skills Library (v${program.version()}).\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));
-    }
-
-    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`);
-    
-    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 hDir = path.join(sourceDir, 'history');
-        const targetHistoryDir = path.join(targetDir, 'smart-instructions', 'history');
-        if (fs.existsSync(hDir)) {
-            // Only update the guide, preserving consumer logs
-            const guide = 'history.md';
-            fs.ensureDirSync(targetHistoryDir);
-            if (fs.existsSync(path.join(hDir, guide))) fs.copyFileSync(path.join(hDir, guide), path.join(targetHistoryDir, guide));
-        }
-
-        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);