rohitg00 · rohitg00 · Feb 2, 2026 · Feb 2, 2026
diff --git a/README.md b/README.md
@@ -142,8 +142,25 @@ Filter by task, category, or minimum score:
 skillkit recommend --search "auth"        # Task-based search
 skillkit recommend --category security    # Category filter
 skillkit recommend --min-score 80         # Quality threshold
+skillkit recommend --explain              # Show WHY skills match
+skillkit recommend --reasoning            # Use LLM-based search
 ```
 
+### Hierarchical Skill Tree
+
+Browse skills organized in a navigable taxonomy:
+
+```bash
+skillkit tree                             # Show full tree
+skillkit tree Frontend                    # Show Frontend subtree
+skillkit tree "Frontend > React"          # Navigate to subcategory
+skillkit tree --generate                  # Generate tree from index
+skillkit tree --stats                     # Show tree statistics
+skillkit tree --depth 2                   # Limit display depth
+```
+
+**Categories:** Development, Frontend, Backend, Mobile, DevOps, Testing, Security, AI/ML, Database, Tooling, Documentation, Performance
+
 ### Session Memory System
 
 Your AI agents learn, but that knowledge dies with the session. SkillKit captures learnings and makes them persistent:
@@ -190,7 +207,7 @@ skillkit ui
 skillkit
 ```
 
-**Navigation:** `h` Home | `b` Browse | `r` Recommend | `t` Translate | `c` Context | `l` List | `s` Sync | `q` Quit
+**Navigation:** `h` Home | `m` Marketplace | `b` Browse | `v` Tree View | `r` Recommend | `t` Translate | `c` Context | `l` List | `s` Sync | `q` Quit
 
 ### Skill Testing Framework
 
@@ -298,6 +315,10 @@ skillkit status               # Show skill and agent status
 
 ```bash
 skillkit recommend            # Get smart recommendations
+skillkit recommend --explain  # Show reasoning for matches
+skillkit recommend --reasoning # Use LLM-based discovery
+skillkit tree                 # Browse hierarchical taxonomy
+skillkit tree --generate      # Generate tree from index
 skillkit marketplace          # Browse skill marketplace
 skillkit marketplace search   # Search marketplace
 skillkit find <query>         # Quick skill search
@@ -511,8 +532,29 @@ import {
 
   // Recommendations
   RecommendationEngine,
+  ReasoningRecommendationEngine,
   analyzeProject,
 
+  // Tree & Taxonomy
+  TreeGenerator,
+  generateSkillTree,
+  loadTree,
+  buildSkillGraph,
+  getRelatedSkills,
+
+  // Reasoning Engine
+  ReasoningEngine,
+  createReasoningEngine,
+
+  // Connectors (Tool-Agnostic Placeholders)
+  detectPlaceholders,
+  replacePlaceholders,
+  suggestMappingsFromMcp,
+
+  // Execution Flow
+  ExecutionManager,
+  detectExecutionMode,
+
   // Context
   ContextManager,
   syncToAllAgents,
@@ -536,10 +578,20 @@ import {
 const skill = await translateSkill(skillContent, 'cursor');
 console.log(skill.content);
 
-// Example: Get recommendations
-const engine = new RecommendationEngine();
+// Example: Get recommendations with reasoning
+const engine = new ReasoningRecommendationEngine();
+await engine.initReasoning();
 const profile = await analyzeProject('./my-project');
-const recs = engine.recommend(profile);
+const recs = await engine.recommendWithReasoning(profile, { reasoning: true });
+
+// Example: Browse skill tree
+const tree = generateSkillTree(skills);
+console.log(tree.rootNode.children); // Categories
+
+// Example: Detect execution mode
+const mode = detectExecutionMode();
+console.log(mode.mode); // 'standalone' or 'enhanced'
+console.log(mode.capabilities); // Available MCP capabilities
 ```
 
 ## Skill Sources & Attribution

diff --git a/apps/skillkit/package.json b/apps/skillkit/package.json
@@ -1,6 +1,6 @@
 {
   "name": "skillkit",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
   "type": "module",
   "bin": {

diff --git a/docs/fumadocs/content/docs/meta.json b/docs/fumadocs/content/docs/meta.json
@@ -9,6 +9,7 @@
     "agents",
     "translation",
     "marketplace",
+    "tree",
     "recommendations",
     "primer",
     "memory",

diff --git a/docs/fumadocs/content/docs/recommendations.mdx b/docs/fumadocs/content/docs/recommendations.mdx
@@ -32,6 +32,33 @@ skillkit recommend --category security
 skillkit recommend --min-score 80
 ```
 
+## Explainable Recommendations
+
+See WHY skills match your project:
+
+```bash
+skillkit recommend --explain
+```
+
+Output:
+
+```
+vercel-react-best-practices (Score: 92)
+├── Matched: React, TypeScript, Next.js
+├── Your stack: Next.js 14, React 18
+└── Path: Frontend > React > Best Practices
+```
+
+## LLM-Based Reasoning
+
+Use reasoning-based discovery for complex queries:
+
+```bash
+skillkit recommend --reasoning
+```
+
+This uses an LLM to traverse the skill taxonomy and find the most relevant skills based on semantic understanding.
+
 ## How It Works
 
 The engine analyzes:
@@ -50,9 +77,22 @@ Scores based on:
 ## Programmatic API
 
 ```typescript
-import { RecommendationEngine, analyzeProject } from '@skillkit/core'
+import {
+  RecommendationEngine,
+  ReasoningRecommendationEngine,
+  analyzeProject
+} from '@skillkit/core'
 
+// Basic recommendations
 const engine = new RecommendationEngine()
 const profile = await analyzeProject('./my-project')
 const recs = engine.recommend(profile)
+
+// With reasoning and explanations
+const reasoningEngine = new ReasoningRecommendationEngine()
+await reasoningEngine.initReasoning()
+const explained = await reasoningEngine.recommendWithReasoning(profile, {
+  reasoning: true,
+  explain: true
+})
 ```
diff --git a/docs/fumadocs/content/docs/tree.mdx b/docs/fumadocs/content/docs/tree.mdx
@@ -0,0 +1,144 @@
+---
+title: Skill Tree
+description: Browse skills in a hierarchical taxonomy
+---
+
+# Skill Tree
+
+Browse and navigate skills organized in a hierarchical taxonomy structure.
+
+## Quick Start
+
+```bash
+# Show full skill tree
+skillkit tree
+
+# Navigate to a category
+skillkit tree Frontend
+
+# Navigate to subcategory
+skillkit tree "Frontend > React"
+```
+
+## Commands
+
+### Display Tree
+
+```bash
+skillkit tree                    # Full tree
+skillkit tree Development        # Specific category
+skillkit tree --depth 2          # Limit display depth
+```
+
+### Generate Tree
+
+```bash
+skillkit tree --generate         # Generate from skill index
+```
+
+This builds a hierarchical tree from the skill index based on tags and metadata.
+
+### Export Formats
+
+```bash
+skillkit tree --json             # JSON output
+skillkit tree --markdown         # Markdown output
+```
+
+### Statistics
+
+```bash
+skillkit tree --stats
+```
+
+Output:
+
+```
+Overview:
+  Total Skills: 15,064
+  Categories: 156
+  Max Depth: 4
+
+Top-Level Categories:
+  Development        4,521 skills (30.0%)
+    Frontend (1,245), Backend (1,102), Mobile (456)
+  DevOps             2,340 skills (15.5%)
+    CI/CD (890), Kubernetes (567), Docker (445)
+  AI/ML              1,890 skills (12.5%)
+    LLM Integration (756), Agents (445), RAG (312)
+```
+
+## Categories
+
+The tree organizes skills into 12 top-level categories:
+
+| Category | Description |
+|----------|-------------|
+| Development | General coding, programming patterns |
+| Frontend | React, Vue, Angular, Svelte, UI/UX |
+| Backend | Node.js, Python, Go, APIs, servers |
+| Mobile | React Native, Flutter, iOS, Android |
+| DevOps | CI/CD, Kubernetes, Docker, cloud |
+| Testing | Unit, E2E, integration, TDD |
+| Security | Auth, encryption, vulnerabilities |
+| AI/ML | LLM, agents, RAG, embeddings |
+| Database | SQL, NoSQL, ORM, migrations |
+| Tooling | Linting, formatting, bundling |
+| Documentation | API docs, guides, READMEs |
+| Performance | Optimization, caching, profiling |
+
+## TUI Tree View
+
+In the TUI, press `v` to toggle tree view in the Marketplace:
+
+- **Arrow keys** - Navigate tree
+- **Enter** - Expand category / select skill
+- **←** - Go back / collapse
+- **v** - Toggle list/tree view
+
+## Related Skills Graph
+
+Find skills related to each other:
+
+```typescript
+import { buildSkillGraph, getRelatedSkills } from '@skillkit/core'
+
+const graph = buildSkillGraph(skills)
+const related = getRelatedSkills('react-patterns', graph, skills, {
+  limit: 5,
+  types: ['similar', 'complementary']
+})
+```
+
+### Relation Types
+
+- **similar** - Shares tags and functionality
+- **complementary** - Works well together
+- **dependency** - Required by other skills
+- **alternative** - Different approach to same problem
+
+## Programmatic API
+
+```typescript
+import {
+  TreeGenerator,
+  generateSkillTree,
+  loadTree,
+  saveTree,
+  treeToMarkdown
+} from '@skillkit/core'
+
+// Generate tree from skills
+const generator = new TreeGenerator({ maxDepth: 3 })
+const tree = generator.generateTree(skills)
+
+// Or use the helper function
+const tree = generateSkillTree(skills)
+
+// Save and load
+saveTree(tree, './skill-tree.json')
+const loaded = loadTree('./skill-tree.json')
+
+// Export to markdown
+const markdown = treeToMarkdown(tree)
+```
diff --git a/docs/fumadocs/content/docs/tui.mdx b/docs/fumadocs/content/docs/tui.mdx
@@ -105,6 +105,20 @@ Browse 15,000+ skills:
 - Featured skills
 - 3-phase animation loading
 - Quality scoring
+- **Tree View** - Press `v` to toggle hierarchical navigation
+
+#### Tree View Mode
+
+Navigate skills in a hierarchical taxonomy:
+
+| Key | Action |
+|-----|--------|
+| `v` | Toggle tree/list view |
+| `→` or `Enter` | Expand category |
+| `←` | Collapse / go back |
+| `↑`/`↓` | Navigate |
+
+Categories include: Development, Frontend, Backend, Mobile, DevOps, Testing, Security, AI/ML, Database, Tooling, Documentation, Performance
 
 ### Recommend Screen
 

diff --git a/docs/fumadocs/package.json b/docs/fumadocs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "skillkit-docs",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "private": true,
   "scripts": {
     "build": "next build",

diff --git a/docs/skillkit/components/Commands.tsx b/docs/skillkit/components/Commands.tsx
@@ -13,7 +13,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
       { cmd: 'install <repo>', desc: 'Install from GitHub' },
       { cmd: 'add <repo>', desc: 'Alias for install' },
       { cmd: 'recommend', desc: 'Smart suggestions' },
-      { cmd: 'find <query>', desc: 'Search 15K+ skills' },
+      { cmd: 'tree', desc: 'Browse skill taxonomy' },
       { cmd: 'marketplace', desc: 'Browse skills' },
     ],
   },

diff --git a/docs/skillkit/components/Features.tsx b/docs/skillkit/components/Features.tsx
@@ -43,6 +43,15 @@ const FEATURES: Feature[] = [
       </svg>
     )
   },
+  {
+    title: 'Skill Tree',
+    description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.',
+    icon: (
+      <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
+      </svg>
+    )
+  },
   {
     title: 'Workflows',
     description: 'Compose multi-step automated skill sequences.',

diff --git a/docs/skillkit/package.json b/docs/skillkit/package.json
@@ -1,7 +1,7 @@
 {
   "name": "skillkit",
   "private": true,
-  "version": "1.8.1",
+  "version": "1.9.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "skillkit-monorepo",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "private": true,
   "description": "Universal skills loader for AI coding agents - Monorepo",
   "type": "module",

diff --git a/packages/agents/package.json b/packages/agents/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@skillkit/agents",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Agent adapters for SkillKit - supports 32 AI coding agents",
   "type": "module",
   "main": "./dist/index.js",