From d9dfb02d7de390c494d5c0491e86c2861e8558d1 Mon Sep 17 00:00:00 2001 From: Rohit Ghumare <48523873+rohitg00@users.noreply.github.com> Date: Mon, 2 Feb 2026 16:47:11 +0000 Subject: [PATCH] chore: release v1.9.0 Features: - Hierarchical skill tree with 12 categories (skillkit tree) - LLM-based reasoning engine for skill discovery - Explainable recommendations (--explain, --reasoning flags) - Connector placeholders for tool-agnostic skills (~~CRM, ~~chat, etc.) - Execution flow tracking with metrics - Standalone vs Enhanced mode detection CLI: - New `tree` command for taxonomy navigation - Enhanced `recommend` with explanation support - Fixed --skill alias and agent detection Documentation: - Added tree.mdx for Skill Tree documentation - Updated recommendations.mdx with reasoning features - Updated TUI docs with tree view mode - Updated README with new features - Updated website Features and Commands --- README.md | 60 +++++++- apps/skillkit/package.json | 2 +- docs/fumadocs/content/docs/meta.json | 1 + .../fumadocs/content/docs/recommendations.mdx | 42 ++++- docs/fumadocs/content/docs/tree.mdx | 144 ++++++++++++++++++ docs/fumadocs/content/docs/tui.mdx | 14 ++ docs/fumadocs/package.json | 2 +- docs/skillkit/components/Commands.tsx | 2 +- docs/skillkit/components/Features.tsx | 9 ++ docs/skillkit/package.json | 2 +- package.json | 2 +- packages/agents/package.json | 2 +- packages/cli/package.json | 2 +- packages/core/package.json | 2 +- packages/mcp-memory/package.json | 2 +- packages/memory/package.json | 2 +- packages/mesh/package.json | 2 +- packages/messaging/package.json | 2 +- packages/resources/package.json | 2 +- packages/tui/package.json | 2 +- 20 files changed, 279 insertions(+), 19 deletions(-) create mode 100644 docs/fumadocs/content/docs/tree.mdx diff --git a/README.md b/README.md index ccc8abec..bcc16c43 100644 --- 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 # 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 index 6b8d13db..d12355ee 100644 --- 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 index 4a02b187..a455a4f1 100644 --- 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 index 03cc54e8..2f873927 100644 --- 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 new file mode 100644 index 00000000..aaaa4c70 --- /dev/null +++ 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 index c47db346..dfb4d3da 100644 --- 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 index 75a9f56f..44d7e76f 100644 --- 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 index 57ef17d8..4a49d1ea 100644 --- a/docs/skillkit/components/Commands.tsx +++ b/docs/skillkit/components/Commands.tsx @@ -13,7 +13,7 @@ const COMMAND_GROUPS: CommandGroup[] = [ { cmd: 'install ', desc: 'Install from GitHub' }, { cmd: 'add ', desc: 'Alias for install' }, { cmd: 'recommend', desc: 'Smart suggestions' }, - { cmd: 'find ', 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 index 5902f9b4..6bf0179c 100644 --- a/docs/skillkit/components/Features.tsx +++ b/docs/skillkit/components/Features.tsx @@ -43,6 +43,15 @@ const FEATURES: Feature[] = [ ) }, + { + title: 'Skill Tree', + description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.', + icon: ( + + + + ) + }, { title: 'Workflows', description: 'Compose multi-step automated skill sequences.', diff --git a/docs/skillkit/package.json b/docs/skillkit/package.json index de541abd..6d33baf2 100644 --- 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 index d4a0ccf3..1178c867 100644 --- 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 index df21d6fc..1d1c8a3d 100644 --- 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", diff --git a/packages/cli/package.json b/packages/cli/package.json index a4077d1a..f6fa11bd 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/cli", - "version": "1.8.1", + "version": "1.9.0", "description": "CLI commands for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/core/package.json b/packages/core/package.json index 24b0b921..be4fe8de 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/core", - "version": "1.8.1", + "version": "1.9.0", "description": "Core functionality for SkillKit - skill discovery, parsing, and translation", "type": "module", "main": "./dist/index.js", diff --git a/packages/mcp-memory/package.json b/packages/mcp-memory/package.json index 28f8befa..8f9ec3ca 100644 --- a/packages/mcp-memory/package.json +++ b/packages/mcp-memory/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/mcp-memory", - "version": "1.8.1", + "version": "1.9.0", "description": "MCP (Model Context Protocol) server for SkillKit persistent memory", "type": "module", "main": "./dist/index.js", diff --git a/packages/memory/package.json b/packages/memory/package.json index ec6eaec7..c313fd4f 100644 --- a/packages/memory/package.json +++ b/packages/memory/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/memory", - "version": "1.8.1", + "version": "1.9.0", "description": "CozoDB-backed semantic memory with embeddings for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/mesh/package.json b/packages/mesh/package.json index 739356f8..36adf262 100644 --- a/packages/mesh/package.json +++ b/packages/mesh/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/mesh", - "version": "1.8.1", + "version": "1.9.0", "description": "Peer mesh network for multi-machine agent distribution", "type": "module", "main": "./dist/index.js", diff --git a/packages/messaging/package.json b/packages/messaging/package.json index 64f4802a..891a1cad 100644 --- a/packages/messaging/package.json +++ b/packages/messaging/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/messaging", - "version": "1.8.1", + "version": "1.9.0", "description": "Inter-agent messaging system for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/resources/package.json b/packages/resources/package.json index 1aeec5bc..f762f942 100644 --- a/packages/resources/package.json +++ b/packages/resources/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/resources", - "version": "1.8.1", + "version": "1.9.0", "description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks", "type": "module", "main": "./dist/index.js", diff --git a/packages/tui/package.json b/packages/tui/package.json index 139d2e22..123c5df9 100644 --- a/packages/tui/package.json +++ b/packages/tui/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/tui", - "version": "1.8.1", + "version": "1.9.0", "description": "Unified Terminal UI for SkillKit - Built on OpenTUI", "type": "module", "main": "./dist/index.js",