rohitg00 · rohitg00 · Feb 4, 2026 · Feb 4, 2026 · Feb 4, 2026
diff --git a/docs/fumadocs/content/docs/index.mdx b/docs/fumadocs/content/docs/index.mdx
@@ -1,116 +1,76 @@
 ---
-title: SkillKit Documentation
-description: Universal CLI for managing AI agent skills across 32 coding platforms
+title: SkillKit
+description: Universal skill management for AI coding agents
 ---
 
 # SkillKit
 
-SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across **32 AI coding platforms**.
+Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
 
-**Current Version:** v1.12.0
+SkillKit fixes this. Write a skill once, deploy it to all 32 agents.
 
-## The Problem
-
-Each AI coding agent uses different skill formats and directory structures:
-- Claude Code uses `.claude/skills/` with SKILL.md
-- Cursor uses `.cursor/skills/` with .mdc format
-- GitHub Copilot uses `.github/skills/`
-
-Without SkillKit, you either rewrite skills for each agent, lock into one platform, or abandon skills entirely.
-
-## The Solution
-
-SkillKit provides a **"write once, deploy everywhere"** platform. Maintain a single skill definition that automatically translates across all 32 platforms.
-
-## Quick Install
+## Get Started
 
 ```bash
-# Run instantly with npx (no install required)
 npx skillkit@latest
+```
+
+That's it. No global install needed. Or if you prefer:
 
-# Or install globally for frequent use
+```bash
 npm install -g skillkit
 skillkit init
 skillkit install anthropics/skills
 skillkit sync
 ```
 
-## Core Features
-
-| Feature | Description |
-|---------|-------------|
-| **Cross-Platform Translation** | Automatic conversion between 32 agent formats |
-| **Smart Recommendations** | AI-powered skill suggestions based on your tech stack |
-| **Session Memory** | Persistent learning that survives across sessions |
-| **Primer** | Auto-generate agent instructions from your codebase |
-| **Mesh Network** | Multi-machine agent distribution with encrypted P2P |
-| **Inter-Agent Messaging** | Send messages between AI agents across your network |
-| **Team Collaboration** | Git-based `.skills` manifest for sharing |
-| **Workflow Orchestration** | Compose skills into multi-step automated workflows |
-| **Skill Testing** | Built-in test framework with assertions |
-| **CI/CD Integration** | GitHub Actions, GitLab CI, and pre-commit hooks |
-| **REST API Server** | Runtime skill discovery via HTTP on port 3737 |
-| **MCP Server** | Agent-native discovery for Claude Desktop, Cursor |
-| **Python Client** | Async Python SDK for the REST API |
-| **TypeScript API** | Full programmatic access to all features |
-| **Interactive TUI** | Beautiful terminal interface with real-time updates |
-
-## Advanced Capabilities
+Four commands. Your agents now have skills for PDF processing, code review, and more.
 
-### Session Memory System
+## What Can You Do?
 
-Your AI agents learn patterns during sessions—then forget everything. SkillKit captures these learnings and makes them permanent.
+### Install skills from anywhere
 
 ```bash
-skillkit memory compress      # Compress learnings
-skillkit memory search auth   # Search knowledge
-skillkit memory export auth-patterns  # Export as skill
+skillkit install anthropics/skills          # GitHub
+skillkit install gitlab:team/skills         # GitLab
+skillkit install ./my-local-skills          # Local
 ```
 
-[Learn more →](/docs/memory)
+### Translate between agents
 
-### Primer - Auto-Generate Instructions
-
-Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase.
+Write for Claude, deploy to Cursor:
 
 ```bash
-skillkit primer                # Analyze project
-skillkit primer --all-agents   # Generate for all 32 agents
+skillkit translate my-skill --to cursor
+skillkit translate --all --to windsurf      # All skills at once
 ```
 
-[Learn more →](/docs/primer)
-
-### Mesh Network
+### Get smart recommendations
 
-Run agents across multiple machines with encrypted P2P communication.
+SkillKit reads your `package.json`, detects your stack, and suggests relevant skills:
 
 ```bash
-skillkit mesh init       # Initialize mesh node
-skillkit mesh discover   # Find peers on LAN
-skillkit mesh security init  # Setup Ed25519 encryption
+skillkit recommend
+# 92% vercel-react-best-practices
+# 87% tailwind-v4-patterns
+# 85% nextjs-app-router
 ```
 
-[Learn more →](/docs/mesh)
+### Discover skills at runtime
 
-### Inter-Agent Messaging
-
-Send messages between AI agents across your mesh network.
+Start an API server and let agents find skills on demand:
 
 ```bash
-skillkit message send    # Send to another agent
-skillkit message inbox   # Check your inbox
+skillkit serve
+# Server running at http://localhost:3737
 ```
 
-[Learn more →](/docs/messaging)
-
-### Runtime Skill Discovery
-
-Start a REST API or MCP server for runtime skill discovery by agents and applications.
-
 ```bash
-skillkit serve               # REST API on :3737
+curl "http://localhost:3737/search?q=react+performance"
 ```
 
+Or use MCP for native agent integration:
+
 ```json
 {
   "mcpServers": {
@@ -119,55 +79,75 @@ skillkit serve               # REST API on :3737
 }
 ```
 
-[REST API →](/docs/rest-api) · [MCP Server →](/docs/mcp-server) · [Python Client →](/docs/python-client)
+[REST API](/docs/rest-api) | [MCP Server](/docs/mcp-server) | [Python Client](/docs/python-client)
 
-## Architecture
+## How It Works
 
-| Tier | Components |
-|------|------------|
-| **User Interfaces** | CLI (Clipanion v4), TUI (OpenTUI/Solid.js), Documentation |
-| **APIs** | @skillkit/api (REST/Hono), @skillkit/mcp (MCP/stdio) |
-| **Business Logic** | @skillkit/core, @skillkit/agents (32 adapters) |
-| **Data Layer** | @skillkit/memory (CozoDB), @skillkit/mesh (WebSocket/UDP) |
-| **External Systems** | GitHub/GitLab, Marketplace (15,000+ skills) |
+SkillKit sits between your skills and your agents. It handles format translation, discovery, and synchronization automatically.
 
-## Supported Agents (32)
+| Layer | What It Does |
+|-------|-------------|
+| **CLI + TUI** | Install, translate, recommend, sync |
+| **APIs** | REST server on :3737, MCP via stdio |
+| **Core** | Translation engine, relevance ranker, skill parser |
+| **Data** | 15,000+ skills from 31 curated sources |
 
-Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo Code, Kiro CLI, Roo Code, Trae, Cline, CodeBuddy, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder, CommandCode, Universal
+## Supported Agents
 
-[Full agent details →](/docs/agents)
+32 agents and counting:
 
-## Popular Skill Sources
+**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
 
-| Repository | Skills |
-|------------|--------|
-| anthropics/skills | PDF, XLSX, DOCX processing |
-| vercel-labs/agent-skills | React/Next.js best practices |
-| nextlevelbuilder/ui-ux-pro-max-skill | UI/UX design patterns |
-| superdesigndev/superdesign-skill | Modern design systems |
+[Full agent details](/docs/agents)
 
-## Get Started
+## Beyond Basic Skills
+
+### Session Memory
+
+Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings and makes them permanent.
+
+```bash
+skillkit memory compress
+skillkit memory search "auth patterns"
+skillkit memory export auth-patterns
+```
+
+### Primer
+
+Auto-generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase:
+
+```bash
+skillkit primer --all-agents
+```
+
+### Mesh Network
+
+Distribute agents across machines with encrypted P2P:
+
+```bash
+skillkit mesh init
+skillkit mesh discover
+```
+
+### Team Collaboration
+
+Share skills via a Git-committable `.skills` manifest:
+
+```bash
+skillkit manifest init
+skillkit manifest add anthropics/skills
+git commit -m "add team skills"
+```
+
+Team members run `skillkit manifest install` and they're in sync.
+
+## Next Steps
+
+- [Installation](/docs/installation) — Install and configure
+- [Quick Start](/docs/quickstart) — First project setup
+- [Commands](/docs/commands) — Full CLI reference
+- [REST API](/docs/rest-api) — Runtime discovery server
+- [MCP Server](/docs/mcp-server) — Agent-native discovery
+- [Python Client](/docs/python-client) — Python SDK
 
-1. [Installation](/docs/installation) - Install and initialize
-2. [Quick Start](/docs/quickstart) - 5-minute guide
-3. [Commands](/docs/commands) - Full CLI reference
-4. [Skills](/docs/skills) - Skill format and lifecycle
-5. [API Reference](/docs/api-reference) - Programmatic access
-6. [REST API](/docs/rest-api) - Runtime discovery server
-7. [MCP Server](/docs/mcp-server) - Agent-native discovery
-8. [Python Client](/docs/python-client) - Python SDK
-
-## Use Cases
-
-- **Multi-Agent Developer** - Write skills once, use across Claude, Cursor, Windsurf, and more
-- **Team Lead** - Share skills via Git-based manifest, ensure team alignment
-- **New Project Starter** - Auto-generate agent instructions with Primer
-- **Enterprise Architect** - Distribute agents across multiple machines with Mesh Network
-
-## Enterprise Features
-
-- **Private Registries** - Host internal skills in private repos
-- **Git-Based Sync** - Skills live in your repo, push to share
-- **CI/CD Integration** - Auto-validate and deploy skills on every commit
-- **TypeScript API** - Full programmatic access for custom workflows
-- **Security** - Ed25519 encryption, XChaCha20-Poly1305, TLS 1.3
+**Current version:** v1.12.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0