omni-skills-forge 2.0.0 → 2.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 ihtisham
+Copyright (c) 2024-2026 Ihtisham
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,14 +1,12 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/ihtisham/omni-skills-forge/main/assets/banner.png" alt="Omni Skills Forge" width="100%" />
-
 # ⚡ Omni Skills Forge
 
 ### *The World's Largest AI Agent Skill Library — 50,000+ Expert Skills*
 
 [![npm version](https://img.shields.io/npm/v/omni-skills-forge?style=for-the-badge&color=FF6B6B&logo=npm&logoColor=white)](https://www.npmjs.com/package/omni-skills-forge)
 [![npm downloads](https://img.shields.io/npm/dm/omni-skills-forge?style=for-the-badge&color=4ECDC4&logo=npm&logoColor=white)](https://www.npmjs.com/package/omni-skills-forge)
-[![GitHub Stars](https://img.shields.io/github/stars/ihtisham/omni-skills-forge?style=for-the-badge&color=FFE66D&logo=github&logoColor=black)](https://github.com/ihtisham/omni-skills-forge)
+[![GitHub Stars](https://img.shields.io/github/stars/theihtisham/omni-skills-forge?style=for-the-badge&color=FFE66D&logo=github&logoColor=black)](https://github.com/theihtisham/omni-skills-forge)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](https://opensource.org/licenses/MIT)
 [![Node Version](https://img.shields.io/node/v/omni-skills-forge?style=for-the-badge&color=68D391&logo=node.js&logoColor=white)](https://nodejs.org)
 
@@ -81,14 +79,20 @@ Auto-detects Claude Code, Kilo, Cline, Opencode, Cursor, and Windsurf. No config
 ### 🌐 Universal Compatibility
 Skills are plain Markdown with YAML frontmatter — readable by every AI coding tool in existence.
 
-### 📊 Live Registry
-A `master-registry.json` index provides instant lookup, statistics, and filtering without scanning files.
+### 🖥️ Visual Dashboard
+```bash
+osf dashboard
+```
+Generates a stunning interactive HTML dashboard with search, categories, tags, and difficulty charts.
 
-### 🎨 Beautiful CLI
-Gradient banners, progress bars, spinners, interactive menus — a CLI experience that feels premium.
+### 🩺 Environment Doctor
+```bash
+osf doctor
+```
+Diagnoses your setup — checks Node.js, npm, all 6 AI tool installations, and recommends fixes.
 
-### 🔄 Auto-Updates
-Built-in update notifier keeps your skill library fresh with the latest additions.
+### 📦 Export & Uninstall
+Export skills to JSON/CSV/Markdown. Uninstall with one command.
 
 </td>
 </tr>
@@ -118,7 +122,8 @@ Launches the interactive TUI where you can:
 - Browse skills by category
 - Search by keyword
 - Filter by difficulty or tag
-- Select specific skills with checkboxes
+- Open visual dashboard
+- Run environment doctor
 
 ---
 
@@ -132,11 +137,13 @@ osf install --all
 osf list --category ai-ml
 osf search "vector database"
 osf info postgresql-performance-tuning-expert
+osf dashboard
+osf doctor
 ```
 
 ---
 
-### Option 4 — Category Install
+### Option 4 — Category / Tag / Difficulty Install
 
 ```bash
 # Install only backend skills
@@ -145,8 +152,14 @@ npx omni-skills-forge install --category backend
 # Install only AI/ML skills
 npx omni-skills-forge install --category ai-ml
 
+# Install by tag
+osf install --tag react
+
+# Install by difficulty
+osf install --difficulty expert
+
 # Install only cloud skills for a specific tool
-npx omni-skills-forge install --category cloud --tool cursor
+osf install --category cloud --tool cursor
 ```
 
 ---
@@ -338,31 +351,32 @@ Usage: osf [command] [options]
 
 Commands:
   install [options]     Install skills to your AI tools         [default]
+  uninstall [options]   Remove installed skills from AI tools
   list [options]        List available skills with filtering
-  search <query>        Fuzzy search across all 50,000+ skills
+  search <query>        Search across all 50,000+ skills
   info <skill-name>     Show detailed info about a specific skill
   categories            Browse all skill categories
   stats                 Show library statistics dashboard
+  dashboard             Generate & open interactive visual dashboard
+  doctor                Diagnose your environment and tool installations
+  export [options]      Export skills to JSON, CSV, or Markdown
   update                Update to the latest skill library
   generate              Regenerate the skill library locally
 
-Options for `install`:
+Install Options:
   --all                   Install all 50,000+ skills
   --category <name>       Install skills from a specific category
   --skill <name>          Install a single specific skill
+  --tag <tag>             Install all skills matching a tag
+  --difficulty <level>    Install skills by difficulty (beginner/intermediate/advanced/expert)
   --tool <name>           Target a specific tool (auto-detects if omitted)
-  --tag <tag>             Filter by tag (e.g., --tag performance)
-  --difficulty <level>    Filter by difficulty (beginner/intermediate/advanced/expert)
   --dir <path>            Custom install directory
   --force                 Overwrite existing skills
-  --dry-run               Preview what would be installed
+  --dry-run               Preview without writing files
 
-Options for `list`:
-  --category <name>       Filter by category
-  --tag <tag>             Filter by tag
-  --difficulty <level>    Filter by difficulty
-  --tool <tool>           Filter by compatible tool
-  --json                  Output raw JSON
+Export Options:
+  --format <type>         Export format: json, csv, md (default: json)
+  --output <path>         Output file path
 
 Examples:
   osf install --all                              # Install everything
@@ -370,6 +384,10 @@ Examples:
   osf install --tag performance --tool cursor
   osf search "websocket real-time"
   osf info rust-async-tokio-systems-expert
+  osf dashboard                                  # Open visual dashboard
+  osf doctor                                     # Check environment
+  osf export --format csv                        # Export skills
+  osf uninstall --tool cursor                    # Remove skills
   osf list --category backend --difficulty advanced
   osf stats
 ```
@@ -394,7 +412,7 @@ Examples:
 ## 💡 Programmatic Usage
 
 ```javascript
-import { OmniInstaller } from 'omni-skills-forge';
+import { OmniInstaller, OmniDashboard, OmniDoctor } from 'omni-skills-forge';
 
 const installer = new OmniInstaller();
 
@@ -405,11 +423,21 @@ await installer.installAll({ force: true });
 await installer.installCategory('ai-ml', { tool: 'claude-code' });
 
 // Search skills
-const results = await installer.searchSkills('vector database');
-console.log(results);
+await installer.searchSkills('vector database');
 
 // Get stats
-const stats = await installer.showStats();
+await installer.showStats();
+
+// Uninstall
+await installer.uninstall({ tool: 'cursor' });
+
+// Export to CSV
+await installer.exportSkills({ format: 'csv', output: './skills.csv' });
+
+// Generate dashboard
+const registry = await installer._loadRegistry();
+const dashboard = new OmniDashboard(registry);
+await dashboard.generate({ output: './my-dashboard.html' });
 ```
 
 ---
@@ -432,6 +460,25 @@ const stats = await installer.showStats();
 
 ---
 
+## 🔄 Auto-Update via GitHub
+
+Omni Skills Forge uses **GitHub Actions CI/CD** to automatically publish to npm whenever a new version tag is pushed:
+
+```bash
+# Bump version in package.json
+# Then tag and push:
+git tag v2.1.0
+git push origin v2.1.0
+# GitHub Actions automatically publishes to npm
+```
+
+Users can stay up-to-date:
+```bash
+npm update -g omni-skills-forge
+```
+
+---
+
 ## 🤝 Contributing
 
 Contributions are welcome! Here's how to add new skills:
@@ -492,28 +539,30 @@ Open a pull request with your new skills. Every accepted skill earns you a spot
 
 ## 🗺️ Roadmap
 
-- [ ] **v1.1** — Web UI dashboard for browsing and installing skills
-- [ ] **v1.2** — Skill rating and community feedback system  
-- [ ] **v1.3** — Auto-skill suggestions based on your current project stack
-- [ ] **v2.0** — AI-generated skills tailored to your codebase
-- [ ] **v2.1** — Team skill sharing and private skill registries
-- [ ] **v2.2** — VS Code extension with one-click install from sidebar
+- [x] ~~**v1.0** — 50,000+ skills, CLI, single-click install~~
+- [x] ~~**v1.1** — Tag/difficulty filters, enhanced TUI~~
+- [x] ~~**v2.0** — Visual dashboard, doctor, uninstall, export~~
+- [ ] **v2.1** — Skill rating and community feedback system
+- [ ] **v2.2** — Auto-skill suggestions based on your project stack
+- [ ] **v3.0** — AI-generated skills tailored to your codebase
+- [ ] **v3.1** — Team skill sharing and private skill registries
+- [ ] **v3.2** — VS Code extension with one-click install from sidebar
 
 ---
 
 ## 📜 License
 
-MIT © [ihtisham](https://github.com/ihtisham)
+MIT © [Ihtisham](https://github.com/theihtisham)
 
 ---
 
 <div align="center">
 
-**Built with ❤️ by [ihtisham](https://github.com/ihtisham)**
+**Built by [Ihtisham](https://github.com/theihtisham)**
 
 *If Omni Skills Forge saved you time, give it a ⭐ on GitHub!*
 
-[![Star on GitHub](https://img.shields.io/github/stars/ihtisham/omni-skills-forge?style=social)](https://github.com/ihtisham/omni-skills-forge)
-[![Follow on GitHub](https://img.shields.io/github/followers/ihtisham?style=social)](https://github.com/ihtisham)
+[![Star on GitHub](https://img.shields.io/github/stars/theihtisham/omni-skills-forge?style=social)](https://github.com/theihtisham/omni-skills-forge)
+[![Follow on GitHub](https://img.shields.io/github/followers/theihtisham?style=social)](https://github.com/theihtisham)
 
 </div>

package/bin/cli.js

@@ -15,7 +15,7 @@ import open from 'open';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = path.resolve(__dirname, '..');
 
-const VERSION = '2.0.0';
+const VERSION = '2.1.0';
 
 function showBanner() {
   const banner = gradient.rainbow.multiline(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-skills-forge",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "50,000+ expert AI agent skills for Claude Code, Kilo, Cline, Opencode, Cursor & Windsurf — visual dashboard, single-click install, doctor, export",
   "main": "src/index.js",
   "bin": {
@@ -41,16 +41,16 @@
     "ai-tools",
     "agentic"
   ],
-  "author": "ihtisham",
+  "author": "Ihtisham <ihtisham@users.noreply.github.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ihtisham/omni-skills-forge.git"
+    "url": "git+https://github.com/theihtisham/omni-skills-forge.git"
   },
   "bugs": {
-    "url": "https://github.com/ihtisham/omni-skills-forge/issues"
+    "url": "https://github.com/theihtisham/omni-skills-forge/issues"
   },
-  "homepage": "https://github.com/ihtisham/omni-skills-forge#readme",
+  "homepage": "https://github.com/theihtisham/omni-skills-forge#readme",
   "engines": {
     "node": ">=18.0.0"
   },

package/registry/master-registry.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "totalSkills": 50009,
-  "builtAt": "2026-04-12T14:18:04.864Z",
+  "builtAt": "2026-04-12T14:45:08.689Z",
   "categories": [
     "ai-ml/agents",
     "ai-ml/computer-vision",

package/src/dashboard.js

@@ -326,7 +326,7 @@ body{background:var(--bg);color:var(--text);font-family:'Segoe UI',system-ui,-ap
 
   <!-- Footer -->
   <div class="footer">
-    <p>Omni Skills Forge v2.0.0 · Built with ❤️ by <a href="https://github.com/theihtisham">ihtisham</a></p>
+    <p>Omni Skills Forge v2.1.0 · Built with ❤️ by <a href="https://github.com/theihtisham">theihtisham</a></p>
     <p style="margin-top:8px"><a href="https://www.npmjs.com/package/omni-skills-forge">npm</a> · <a href="https://github.com/theihtisham/omni-skills-forge">GitHub</a> · Generated ${data.generatedAt}</p>
   </div>
 </div>

package/src/index.js

@@ -8,5 +8,5 @@ export { OmniUI } from './ui.js';
 export { OmniDashboard } from './dashboard.js';
 export { OmniDoctor } from './doctor.js';
 
-export const VERSION = '2.0.0';
+export const VERSION = '2.1.0';
 export const SUPPORTED_TOOLS = ['claude-code', 'kilo', 'cline', 'opencode', 'cursor', 'windsurf'];

package/src/installer.js

@@ -63,7 +63,7 @@ export class OmniInstaller {
       }
     };
     walkDir(this._skillsDir);
-    return { version: '2.0.0', totalSkills: skills.length, builtAt: new Date().toISOString(), categories: [...categories], skills };
+    return { version: '2.1.0', totalSkills: skills.length, builtAt: new Date().toISOString(), categories: [...categories], skills };
   }
 
   _parseFrontmatter(content) {