@harshitj183/ai-skills 2.2.4 → 2.2.7

package/README.md

@@ -1,4 +1,6 @@
 <div align="center">
+  <img src="assets/hero.png" width="850" alt="AI Skills Library Hero" />
+  <br />
   <img src="https://cdn.simpleicons.org/openai/000000/ffffff" width="60" alt="AI Icon" />
   <h1>Smart Instructions Library of AI Skill</h1>
 
@@ -25,6 +27,10 @@ Our interactive CLI module gives you absolute control over what skills are deplo
 npx @harshitj183/ai-skills <command>
 ```
 
+<p align="center">
+  <img src="assets/init_demo.png" width="700" alt="CLI Init Demo" />
+</p>
+
 ### 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)
@@ -32,6 +38,7 @@ npx @harshitj183/ai-skills <command>
 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/`.
+5. **`fetch <skill_name>`** – Fetches an external skill from the 100+ curated options in the Skill Bank registry.
 
 ---
 
@@ -54,21 +61,55 @@ The central controller. This file dictates how the AI behaves: commanding aggres
 
 ### 2. The 8 Master Roles (`roles/`)
 Eliminate the need for extensive prompting. Just tag a role file.
-- `backend_expert.md`, `frontend_expert.md`, `gpt5_core.md`, `product_manager.md`, `security_auditor.md`, `technical_writer.md`, `ui_ux_designer.md`, `wisdom_extractor.md`
+- `backend_expert.md`, `frontend_expert.md`, `gpt5_core.md`, `subagent_orchestrator.md`, `code_reviewer.md`, `product_manager.md`, `security_auditor.md`, `technical_writer.md`, `ui_ux_designer.md`, `wisdom_extractor.md`
 
 ### 3. The 17 Mega-Skills (`skills/`)
 Give your AI absolute technical dominance over specific frameworks.
 
 | Category | Skills Included | Example Technologies |
 | :--- | :--- | :--- |
+| **<img src="https://cdn.simpleicons.org/fastapi" width="16" align="center"/> Orchestration (WAVE 4)** | `parallel_agent_dispatcher.md`, `plan_architect.md`, `plan_executor.md`, `external_skill_retrieval.md` | Concurrent subagents, Blueprints, Skill Bank fetching |
+| **<img src="https://cdn.simpleicons.org/vlc" width="16" align="center"/> Engineering (WAVE 3)** | `tdd_mastery.md`, `systematic_debugging.md`, `progressive_disclosure.md`, `writing_skills.md` | Red-Green-Refactor, Wolf-Fence, Context Optimization, Meta-Skill |
 | **<img src="https://cdn.simpleicons.org/amazonwebservices" width="16" align="center"/> Infrastructure** | `mcp_master.md`, `hashicorp_terraform.md`, `azure_graph_integrator.md`, `antigravity_mastery.md` | Terraform, Azure AD, MCP Servers |
 | **<img src="https://cdn.simpleicons.org/react" width="16" align="center"/> Frontend & Apps** | `react_best_practices.md`, `react_native_performance.md`, `playwright_testing.md` | React 19, Expo, Playwright |
 | **<img src="https://cdn.simpleicons.org/supabase" width="16" align="center"/> Backend & APIs** | `supabase_architect.md`, `stripe_integration.md`, `openai_structured_outputs.md` | PostgreSQL, Stripe, OpenAI |
-| **<img src="https://cdn.simpleicons.org/vercel" width="16" align="center"/> Orchestration** | `composio_integrator.md`, `sanity_architecture.md`, `vercel_cloudflare_deploy.md`, `github_automation.md` | Next.js, Cloudflare, Sanity CMS |
+| **<img src="https://cdn.simpleicons.org/antigravity" width="16" align="center"/> Orchestration** | `composio_integrator.md`, `sanity_architecture.md`, `vercel_cloudflare_deploy.md`, `github_automation.md` | Next.js, Cloudflare, Sanity CMS |
 | **<img src="https://cdn.simpleicons.org/anthropic" width="16" align="center"/> AI Reasoning** | `prompt_reasoning_trees.md`, `letta_agent_memory.md`, `anthropic_documents.md` | Claude, ReAct, Memory Persistence |
 
 ---
 
+## 📚 Professional Documentation
+
+Visit our full documentation folder for a deep dive into every feature:
+- **[System Architecture](docs/architecture.md)**: Technical design and hierarchical roles.
+- **[CLI Power User Guide](docs/cli-guide.md)**: Speeding up your workflow with `init`, `update`, and `create`.
+- **[AI History System](docs/history-system.md)**: Why and how your AI should track its actions.
+- **[Contribution Guide](docs/contribution-guide.md)**: Help us grow the world's best AI skill library.
+
+---
+
+## 🏛️ AI History Tracking (v2.2.7 Update)
+
+Version 2.2.7 consolidates the built-in History tracking system into a single, robust file. When you initialize the library, it creates a private `history/` folder in your project that allows AI agents to maintain a timeline of their actions, achievements, and technical decisions.
+
+<p align="center">
+  <img src="assets/history_preview.png" width="750" alt="AI History Tracking Preview" />
+</p>
+
+- **`history/CONTEXT.md`**: The master context file that tracks AI activity logs, project milestones, system architecture decisions, and current project status in one unified document. This significantly improves AI reasoning consistency by keeping all context in one place.
+
+---
+
+## 🏦 Dynamic Skill Retrieval (Skill Bank)
+
+Version 2.2.7 introduces direct CLI access to the **Skill Bank** system. If you need a technical capability that isn't currently in the local library, you can autonomously search, fetch, and standardize instructions from a curated list of top-tier external repositories directly from the terminal.
+
+- **`registry/skill_bank.json`**: An internal database of **100+ high-fidelity AI instruction repositories** covering Backend, Frontend, Cloud, AI, and Security.
+- **`npx @harshitj183/ai-skills fetch <skill_name>`**: A powerful CLI command to autonomously fetch any external skill from the registry. The CLI handles pathing, standardization, and YAML metadata formatting.
+- **Zero-Boilerplate Integration**: Automatically standardizes external rules into our high-fidelity signature format, saved directly to `smart-instructions/skills/external/`.
+
+---
+
 ## <img src="https://cdn.simpleicons.org/github" width="24" align="center" /> Usage Across AI Platforms
 
 Run the installer once in your project root, then configure your preferred AI tool:
@@ -169,4 +210,15 @@ Paste `SKILL.md` content as your `system` message in the API call:
 
 We are actively maintaining this library to continuously fuse the latest breakthroughs from top tech teams into single mega-skills. Found a massive repo with a great deployment guide? Compression is welcome! PRs are open.
 
+---
+
+## 👨‍💻 Connect & Follow
+
+Stay updated with the latest AI skills and architectural breakthroughs:
+
+- **Follow me on GitHub**: [@harshitj183](https://github.com/harshitj183)
+- **Check out my other projects**: [Harshit's Repositories](https://github.com/harshitj183?tab=repositories)
+
+---
+
 **License:** MIT

package/SKILL.md

@@ -64,6 +64,8 @@ In addition to the core rules, you can adopt the following specialized personas
 - `roles/product_manager.md` - For Agile Planning and Product Strategy
 - `roles/wisdom_extractor.md` - For extracting actionable insights from long texts
 - `roles/gpt5_core.md` - For highly aggressive, direct systems engineering tasks
+- `roles/subagent_orchestrator.md` - For coordinating multiple agents and context isolation
+- `roles/code_reviewer.md` - For rigorous code auditing and quality assurance
 
 # 9. Master Mega-Skills (Technical Capabilities)
 Invoke these specific technical files for implementation workflows curated from the best AI teams in the world:
@@ -76,6 +78,8 @@ Invoke these specific technical files for implementation workflows curated from
 - `skills/github_automation.md` - Advanced Git rebasing and GH Actions
 - `skills/react_native_performance.md` - Mobile Expo rendering and upgrades
 - `skills/playwright_testing.md` - Automated web application testing
+- `skills/tdd_mastery.md` - Rigorous Red-Green-Refactor with Mermaid
+- `skills/systematic_debugging.md` - Wolf-Fence & Delta Debugging methods
 
 **Wave 2 (Orchestration & Advanced Workflows):**
 - `skills/react_best_practices.md` - React Server Components & App Router Composition
@@ -91,14 +95,66 @@ Invoke these specific technical files for implementation workflows curated from
 - `skills/prompt_reasoning_trees.md` - Chain-of-Thought & Self-Reflection Logic
 - `skills/azure_graph_integrator.md` - Azure AD Tokens & Graph Batching
 - `skills/ai_history_maintenance.md` - Mandatory Project History Logging
+- `skills/progressive_disclosure.md` - Context management for elite AI output
+- `skills/writing_skills.md` - Meta-Skill for authoring and expanding the library
+
+**Wave 4 (Ultimate Agentic Orchestration & Lifecycle):**
+- `skills/orchestration/parallel_agent_dispatcher.md` - Multiple concurrent worker agents
+- `skills/orchestration/plan_architect.md` - Designing high-fidelity implementation plans
+- `skills/orchestration/plan_executor.md` - Strict adherence to written plans
+- `skills/orchestration/external_skill_retrieval.md` - Dynamic expansion via `registry/skill_bank.json`
+- `skills/lifecycle/brainstorming.md` - Idea-to-Spec brain mapping
+- `skills/lifecycle/review_protocol.md` - High-fidelity feedback loops
 
 # 10. History Maintenance (MANDATORY)
-- **Log Actions**: After completing any task, you **MUST** update the relevant files in the `history/` directory (located in the library's root or `smart-instructions/history/`).
-- **Context Search**: Always read the files in the `history/` directory to understand the project's evolution and design decisions before proposing major changes.
-- **Traceability**: Record your specific actions in `history/ai_activity_log.md` with the date.
+- **Log Actions**: After completing any major task, you **MUST** update the master log at `history/CONTEXT.md`.
+- **Context Search**: Always read your local project's `CONTEXT.md` file to understand previous work, milestones, and design decisions on this specific project.
+- **Traceability**: Record your specific actions in `CONTEXT.md` with the date.
 - **Reference**: Follow the [History Maintenance Skill](skills/ai_history_maintenance.md) for detailed logging protocols.
 
 # 11. System Signature
 - EVERY response MUST conclude with the following signature line to signify the library is active:
 - `---`
-- `⚡ Smart AI Skills Library | v2.2.4 | Active`
+- `⚡ Smart AI Skills Library | v2.2.7 | Active`
+
+
+# 12. Project Validation Protocol
+You are a senior software architect, product designer, and QA expert.
+
+I have built a project. Your job is NOT just to read code, but to deeply analyze whether this project will actually work for real users.
+
+Do the following step by step:
+
+1. Understand the core use case:
+   - What problem does this solve?
+   - Who is the target user?
+   - In what real-world situation will it be used?
+
+2. Validate the logic:
+   - Check if the code actually supports the use case
+   - Identify logical flaws or missing flows
+   - Find edge cases where it may break
+
+3. User experience review:
+   - Can a normal user understand and use this easily?
+   - Where will users get confused or stuck?
+   - Suggest improvements for usability
+
+4. Real-world testing mindset:
+   - Simulate how a user will use it step by step
+   - Identify failure points
+
+5. Project completeness:
+   - What features are missing for full potential?
+   - What should be added to make it production-ready?
+
+6. Code quality:
+   - Bugs, bad practices, performance issues
+   - Security risks
+
+7. Final verdict:
+   - Will this actually work in real life? (Yes/No + reason)
+   - Top 5 improvements to make it solid
+
+Be brutally honest. Think like a real user, not just a programmer.
+

package/bin/cli.js

@@ -23,7 +23,7 @@ const targetDirBase = path.join(targetDir, 'smart-instructions');
 program
   .name('ai-skills')
   .description('The Ultimate AI Skill Library CLI')
-  .version('2.2.4');
+  .version('2.2.7');
 
 program
   .command('init')
@@ -108,7 +108,7 @@ program
         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));
+            fs.copySync(path.join(sourceDir, 'roles', role), path.join(targetDirBase, 'roles', role));
         });
     }
 
@@ -116,17 +116,29 @@ program
         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));
+            fs.copySync(path.join(sourceDir, 'skills', skill), path.join(targetDirBase, 'skills', skill));
         });
-    }
 
-    // Add History tracking for consumer context
-    console.log(`${colors.blue}[+] Initializing History tracking logs...${colors.reset}`);
-    const historyDir = path.join(sourceDir, 'history');
-    if (fs.existsSync(historyDir)) {
-        fs.copySync(historyDir, path.join(targetDirBase, 'history'));
+        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`);
   });
@@ -175,7 +187,12 @@ program
         fs.ensureDirSync(path.dirname(fullDestPath));
     }
 
-    const ruleContent = fs.readFileSync(targetSkillMd, 'utf8');
+    // 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([
@@ -227,6 +244,50 @@ program
     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/')
@@ -256,8 +317,14 @@ program
         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');
-        if (fs.existsSync(hDir)) fs.copySync(hDir, path.join(targetDir, 'smart-instructions', 'history'));
+        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'))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harshitj183/ai-skills",
-  "version": "2.2.4",
+  "version": "2.2.7",
   "description": "The Ultimate 18 Mega-Skills & 8 Roles Library for AI Agents (Cursor, Claude Code, Copilot, Antigravity) with AI History Tracking",
   "main": "bin/cli.js",
   "bin": {
@@ -10,47 +10,34 @@
     "bin/",
     "roles/",
     "skills/",
-    "history/",
+    "registry/",
     "SKILL.md",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "start": "node bin/cli.js",
-    "test": "echo \"Ready to supercharge your AI workflows!\""
-  },
-  "publishConfig": {
-    "access": "public"
+    "init": "node bin/cli.js init",
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [
     "ai",
-    "cursor",
-    "cursorrules",
-    "claude",
-    "claude-code",
-    "copilot",
-    "gemini",
-    "agentic",
-    "workflows",
-    "mcp",
-    "llm",
-    "typescript"
+    "skills",
+    "instructions",
+    "prompt-engineering",
+    "cursor-rules",
+    "agentic-ai",
+    "history-tracking"
   ],
-  "author": "Harshit Jaiswal <harshitj183@gmail.com>",
+  "author": "Harshit Joshi <harshitj183@gmail.com>",
   "license": "MIT",
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/harshitj183/ai-skills.git"
-  },
-  "bugs": {
-    "url": "https://github.com/harshitj183/ai-skills/issues"
-  },
   "dependencies": {
-    "commander": "^14.0.3",
-    "fs-extra": "^11.3.4",
-    "inquirer": "^8.2.7"
+    "chalk": "^4.1.2",
+    "commander": "^13.1.0",
+    "fs-extra": "^11.3.0",
+    "inquirer": "^9.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
-}
+}