diff --git a/README.md b/README.md
index 83d7f928..02c34742 100644
--- a/README.md
+++ b/README.md
@@ -3,107 +3,227 @@
-
+
+
+### *One skill. Every agent. 45 of them.*
+
+
+
+[](https://www.npmjs.com/package/skillkit)
+[](https://www.npmjs.com/package/skillkit)
+[](https://github.com/rohitg00/skillkit/stargazers)
+[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
+[](LICENSE)
+
+
+
+
+
+
+
+
+
+
-[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
-[](https://www.npmjs.com/package/skillkit)
-[](https://www.npmjs.com/package/skillkit)
-[](https://github.com/rohitg00/skillkit/stargazers)
-[](https://opensource.org/licenses/Apache-2.0)
+
+
+
+
+
+
+Tags are SVGs under /assets/tags/. Fork and remix.
+
+
-**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **45 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 39 more. No rewrites. 400K+ skills across registries.
+### Quick nav
-[Website](https://skillkit.sh) · [Docs](https://skillkit.sh/docs) · [API Explorer](https://skillkit.sh/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
+[**Quick start**](#quick-start) · [**Install**](#install) · [**Commands**](#commands) · [**Agents**](#supported-agents) · [**Sources**](#skill-sources) · [**API**](#programmatic-api) · [**Website**](https://skillkit.sh)
---
+
+
+
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
-Skills make AI coding agents smarter. But every agent uses a different format:
+
+
+## The problem
+
+Every AI coding agent wants skills. Every agent invented a different format.
+
+
+
+
Agent
+
Format
+
Directory
+
+
Claude Code
SKILL.md
.claude/skills/
+
Cursor
.mdc
.cursor/skills/
+
Copilot
Markdown
.github/skills/
+
Windsurf
Markdown
.windsurf/skills/
+
... 41 more
+
-| Agent | Format | Directory |
-|-------|--------|-----------|
-| Claude Code | `SKILL.md` | `.claude/skills/` |
-| Cursor | `.mdc` | `.cursor/skills/` |
-| Copilot | Markdown | `.github/skills/` |
-| Windsurf | Markdown | `.windsurf/skills/` |
+You rewrite the same skill for each agent. Or you lock in to one.
-You end up rewriting the same skill for each agent, or locking into one platform.
+## The fix
-**SkillKit fixes this.** Install from 400K+ skills across registries, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 41 more.
+SkillKit is the package manager for AI agent skills. Install from 400K+ skills across 31 sources. Auto-translate between formats. Persist session learnings. Ship to 45 agents at once.
```bash
-npx skillkit@latest
+npx skillkit add anthropics/skills
```
-## See It In Action
+That is the whole first-run. Pick your agent (your detected agent is pre-selected), confirm, done.
-
+## Quick start
+
+```bash
+npx skillkit init # detect agent, create dirs
+skillkit recommend # stack-aware suggestions
+skillkit add anthropics/skills # install from marketplace
+skillkit sync # deploy to agent config
+```
-
+Four commands. Your agent now has PDF processing, code review, auth patterns, and whatever you need.
-
+### What the first install looks like
-> **New in v1.20.0:** Live download progress, sparse checkout for monorepos (~1.4s for large repos), and `skillkit remove --source` to bulk-remove by repo.
+```
+$ npx skillkit add anthropics/skills
+
+ ◇ Detected 32 agents
+ │
+ ◆ Install to
+ │ ● Just Claude Code (detected) claude-code
+ │ ○ Select specific agents space to toggle
+ │ ○ All supported agents 32 agents, writes to every adapter
+ └
+
+ ◇ Cloning anthropics/skills
+ ◇ Security scan: 42/42 skills pass
+ ◇ Installed 42 skills to Claude Code
+ │
+ └ Done in 3.1s. Run `skillkit list` to see them.
+```
+
+## Install
-## Quick Start
+Pick one. All three do the same thing.
```bash
-npx skillkit@latest init # Detect agents, create dirs
-skillkit recommend # Get smart suggestions
-skillkit install anthropics/skills # Install from marketplace
-skillkit sync # Deploy to your agents
+npm install -g skillkit # npm
+pnpm add -g skillkit # pnpm
+bun add -g skillkit # bun
```
-Four commands. Your agents now have skills for PDF processing, code review, and more.
+Both `skillkit` and `sk` work as the binary name.
+
+### Full vs slim
+
+Four features ship as optional packages so a bare CLI stays small. The default install pulls everything. Add `--omit=optional` if you only want the core.
+
+| Feature | Package | Command |
+| :-------------- | :--------------------- | :--------------- |
+| Terminal UI | `@skillkit/tui` | `skillkit ui` |
+| REST server | `@skillkit/api` | `skillkit serve` |
+| Peer mesh | `@skillkit/mesh` | `skillkit mesh` |
+| Agent messaging | `@skillkit/messaging` | `skillkit message` |
+
+Cold install numbers on a fresh npm cache:
-## What Can You Do?
+
+
+
+
+
-### Install skills from anywhere
+| Mode | Packages | Time | Vulns (crit/high) |
+| :---------------------------------- | -------: | :--: | ----------------: |
+| `npm i -g skillkit` | 418 | 18s | 0/0 |
+| `npm i -g skillkit --omit=optional` | 118 | 9s | 0/0 |
+
+Skipped optional? Add just the one you want later:
```bash
-skillkit install anthropics/skills # GitHub
-skillkit install gitlab:team/skills # GitLab
-skillkit install ./my-local-skills # Local path
+npm i -g @skillkit/tui # enables: skillkit ui
+npm i -g @skillkit/api # enables: skillkit serve
+npm i -g @skillkit/mesh # enables: skillkit mesh
+npm i -g @skillkit/messaging # enables: skillkit message
```
-### Translate between agents
+The CLI catches missing optional packages and prints a one-line hint. No stack trace.
+
+### Using `npx`
-Write for Claude, deploy to Cursor:
+`npx skillkit add ` works with zero install. First call caches the package under `~/.npm/_npx/`. Every run after that is instant until a new version ships.
+
+```bash
+npx skillkit add anthropics/skills # full
+npx --omit=optional skillkit add anthropics/skills # slim
+```
+
+If you reach for `npx skillkit` more than twice, switch to a global install. Kills the prompt-to-proceed and the per-release refetch.
+
+## What you can do
+
+
+Install from anywhere
+
+```bash
+skillkit add anthropics/skills # GitHub
+skillkit add gitlab:team/skills # GitLab
+skillkit add ./my-local-skills # local path
+skillkit add https://gist.github.com/... # gist
+```
+
+
+
+Translate between agents
+
+Write once for Claude, ship everywhere:
```bash
skillkit translate my-skill --to cursor
-skillkit translate --all --to windsurf
+skillkit translate --all --to windsurf,codex
+skillkit translate my-skill --to copilot --dry-run
```
+
-### Get smart recommendations
+
+Stack-aware recommendations
-SkillKit reads your project, detects your stack, and suggests relevant skills:
+SkillKit reads your repo, spots your stack, ranks skills:
```bash
-skillkit recommend
-# 92% vercel-react-best-practices
-# 87% tailwind-v4-patterns
-# 85% nextjs-app-router
+$ skillkit recommend
+
+ 92% vercel-react-best-practices
+ 87% tailwind-v4-patterns
+ 85% nextjs-app-router
+ 81% shadcn-ui-components
```
+
-### Discover skills at runtime
+
+Runtime skill discovery (REST)
-Start an API server and let agents find skills on demand:
+Start the server, let agents fetch skills on demand:
```bash
skillkit serve
-# Server running at http://localhost:3737
+# http://localhost:3737
curl "http://localhost:3737/search?q=react+performance"
```
-Or use MCP for native agent integration:
+Or wire it up with MCP:
```json
{
@@ -113,11 +233,7 @@ Or use MCP for native agent integration:
}
```
-Or use Python:
-
-```bash
-pip install skillkit-client
-```
+Or call from Python:
```python
from skillkit import SkillKitClient
@@ -126,53 +242,47 @@ async with SkillKitClient() as client:
results = await client.search("react performance", limit=5)
```
-[REST API docs](https://skillkit.sh/docs/rest-api) · [MCP Server docs](https://skillkit.sh/docs/mcp-server) · [Python Client docs](https://skillkit.sh/docs/python-client) · [Interactive API explorer](https://skillkit.sh/api)
+[REST docs](https://skillkit.sh/docs/rest-api) · [MCP docs](https://skillkit.sh/docs/mcp-server) · [Python client](https://skillkit.sh/docs/python-client)
+
-### Auto-generate agent instructions
+
+Auto-generate agent instructions
-Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
+Analyze the codebase and write CLAUDE.md, `.cursorrules`, AGENTS.md, and friends:
```bash
skillkit primer --all-agents
```
+
-### Session memory
+
+Session memory
-Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
+AI agents learn during a session, then forget. SkillKit captures what they learned:
```bash
skillkit memory compress
skillkit memory search "auth patterns"
skillkit memory export auth-patterns
```
+
-### AI skill generation
+
+AI skill generation
-Generate skills from natural language with multi-source context:
+Generate skills from plain English with multi-source context:
```bash
skillkit generate
-# Interactive wizard with 4 context sources:
-# - Documentation (via Context7)
-# - Your codebase patterns
-# - 400K+ marketplace skills
-# - Memory (your corrections)
```
-Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
+Pulls context from four places: Context7 docs, your codebase, 400K marketplace skills, your memory. Works with Claude, GPT-4, Gemini, Ollama (local), or any OpenRouter model.
+
-### Mesh network
+
+Team collaboration
-Distribute agents across machines with encrypted P2P:
-
-```bash
-skillkit mesh init
-skillkit mesh discover
-```
-
-### Team collaboration
-
-Share skills via a Git-committable `.skills` manifest:
+Share skills via a committable `.skills` manifest:
```bash
skillkit manifest init
@@ -180,125 +290,156 @@ skillkit manifest add anthropics/skills
git commit -m "add team skills"
```
-Team members run `skillkit manifest install` and they're in sync.
+Everyone else runs `skillkit manifest install` and matches state.
+
+
+
+Mesh network
-### Chrome Extension
+Distribute agents across machines with encrypted P2P:
-Save any webpage as a skill directly from your browser.
+```bash
+skillkit mesh init
+skillkit mesh discover
+```
+
-1. Build: `pnpm --filter @skillkit/extension build`
-2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
-3. Click the extension icon or right-click → "Save page as Skill"
+
+Chrome extension
-The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
+Save any webpage as a skill from the browser. Click the extension, the page round-trips through the SkillKit API (Turndown, 5-source tag detection, GitHub URL support), the `SKILL.md` downloads, then run `skillkit add ~/Downloads/skillkit-skills/`.
[Extension docs](https://skillkit.sh/docs/chrome-extension)
+
-### Interactive TUI
+
+Interactive TUI
```bash
skillkit ui
```
-`h` Home · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `q` Quit
+h home · m marketplace · r recommend · t translate · i installed · s sync · q quit
-
+
-## Supported Agents (45)
-
-| Agent | Format | Directory |
-|-------|--------|-----------|
-| **Claude Code** | SKILL.md | `.claude/skills/` |
-| **Cursor** | .mdc | `.cursor/skills/` |
-| **Codex** | SKILL.md | `.codex/skills/` |
-| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
-| **OpenCode** | SKILL.md | `.opencode/skills/` |
-| **GitHub Copilot** | Markdown | `.github/skills/` |
-| **Windsurf** | Markdown | `.windsurf/skills/` |
-| **Devin** | Markdown | `.devin/skills/` |
-| **Aider** | SKILL.md | `.aider/skills/` |
-| **Sourcegraph Cody** | SKILL.md | `.cody/skills/` |
-| **Amazon Q** | SKILL.md | `.amazonq/skills/` |
-
-Plus 34 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
-
-[Full agent details](https://skillkit.sh/docs/agents)
+
## Commands
-### Core
+
+Core
```bash
-skillkit install # Install skills (with live progress)
-skillkit remove # Remove skills
-skillkit remove --source org/repo # Remove all skills from a source
-skillkit remove --all # Remove all installed skills
-skillkit update # Update skills (with change detection)
-skillkit check # Check for updates, quality, and activity
-skillkit translate --to # Translate between agents
-skillkit sync # Deploy to agent config
-skillkit recommend # Smart recommendations
-skillkit generate # AI skill generation wizard
-skillkit serve # Start REST API server
-skillkit publish submit # Publish to marketplace via CLI
+skillkit add # install skills (live progress)
+skillkit remove # remove
+skillkit remove --source org/repo # bulk by source
+skillkit remove --all # remove everything
+skillkit update # update (change detection)
+skillkit check # updates, quality, activity
+skillkit translate --to # agent format conversion
+skillkit sync # deploy to agent config
+skillkit recommend # smart recommendations
+skillkit generate # AI skill wizard
+skillkit serve # REST API server
+skillkit publish submit # publish to marketplace
```
+
-### Discovery & Security
+
+Discovery & security
```bash
-skillkit marketplace # Browse skills
-skillkit tree # Hierarchical taxonomy
-skillkit find # Quick search
-skillkit scan # Security scan for skills
+skillkit marketplace # browse
+skillkit tree # taxonomy
+skillkit find # quick search
+skillkit scan # security scan
```
+
-### Custom Sources
+
+Custom sources
```bash
-skillkit tap add owner/repo # Add custom skill source
-skillkit tap list # List custom sources
-skillkit tap remove owner/repo # Remove custom source
+skillkit tap add owner/repo
+skillkit tap list
+skillkit tap remove owner/repo
```
+
-### Issue Planner
+
+Issue planner
```bash
-skillkit issue plan "#42" # Plan from GitHub Issue
-skillkit issue plan owner/repo#42 # Cross-repo plan
-skillkit issue list # List open issues
+skillkit issue plan "#42"
+skillkit issue plan owner/repo#42
+skillkit issue list
```
+
-### Session Intelligence
+
+Session intelligence
```bash
-skillkit timeline # Unified event stream
-skillkit session handoff # Agent-to-agent context
-skillkit lineage # Skill impact graph
-skillkit session explain # Human-readable summary
-skillkit activity # Skill activity log
+skillkit timeline # unified event stream
+skillkit session handoff # agent-to-agent context
+skillkit lineage # skill impact graph
+skillkit session explain # human summary
+skillkit activity # activity log
```
+
-### Advanced
+
+Advanced
```bash
-skillkit primer --all-agents # Generate agent instructions
-skillkit memory compress # Capture session learnings
-skillkit mesh init # Multi-machine distribution
-skillkit message send # Inter-agent messaging
-skillkit workflow run # Run workflows
-skillkit test # Test skills
+skillkit primer --all-agents # agent instruction files
+skillkit memory compress # capture session learnings
+skillkit mesh init # multi-machine distribution
+skillkit message send # inter-agent messaging
+skillkit workflow run # run workflows
+skillkit test # test skills
skillkit cicd init # CI/CD templates
```
+
[Full command reference](https://skillkit.sh/docs/commands)
-## Creating Skills
+## Supported agents
+
+
+Top 11
+
+| Agent | Format | Directory |
+| :----------------- | :--------- | :----------------- |
+| **Claude Code** | `SKILL.md` | `.claude/skills/` |
+| **Cursor** | `.mdc` | `.cursor/skills/` |
+| **Codex** | `SKILL.md` | `.codex/skills/` |
+| **Gemini CLI** | `SKILL.md` | `.gemini/skills/` |
+| **OpenCode** | `SKILL.md` | `.opencode/skills/`|
+| **GitHub Copilot** | Markdown | `.github/skills/` |
+| **Windsurf** | Markdown | `.windsurf/skills/`|
+| **Devin** | Markdown | `.devin/skills/` |
+| **Aider** | `SKILL.md` | `.aider/skills/` |
+| **Cody** | `SKILL.md` | `.cody/skills/` |
+| **Amazon Q** | `SKILL.md` | `.amazonq/skills/` |
+
+
+
+Plus 34 more
+
+Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
+
+
+[Full agent details](https://skillkit.sh/docs/agents)
+
+## Creating skills
```bash
skillkit create my-skill
```
-Or manually create a `SKILL.md`:
+Or author a `SKILL.md` by hand:
```markdown
---
@@ -309,20 +450,20 @@ license: MIT
# My Skill
-Instructions for the AI agent.
+Instructions for the agent.
-## When to Use
-- Scenario 1
-- Scenario 2
+## When to use
+- scenario 1
+- scenario 2
## Steps
-1. First step
-2. Second step
+1. first
+2. second
```
## Programmatic API
-```typescript
+```ts
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
const skill = await translateSkill(content, 'cursor');
@@ -332,114 +473,53 @@ const engine = new RecommendationEngine();
const recs = await engine.recommend(profile);
```
-```typescript
+```ts
import { startServer } from '@skillkit/api';
await startServer({ port: 3737, skills: [...] });
```
-```typescript
+```ts
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
const ranker = new RelevanceRanker();
const results = ranker.rank(skills, 'react performance');
```
-## Skill Sources
+## Skill sources
-SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
+All original creators credited. Licenses preserved. PRs welcome.
-### Official Partners
+### Official partners
-| Repository | Description |
-|------------|-------------|
+| Repository | What |
+|:-----------|:-----|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
-| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
-| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
-| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
-| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
-| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
+| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React |
+| [expo/skills](https://github.com/expo/skills) | Expo mobile |
+| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video |
+| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth |
+| [stripe/ai](https://github.com/stripe/ai) | Payments |
### Community
-[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
-
-**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
-
-## Install
-
-```bash
-npm install -g skillkit # npm
-pnpm add -g skillkit # pnpm
-yarn global add skillkit # yarn
-bun add -g skillkit # bun
-npx skillkit # no install
-```
-
-### Install sizes
-
-Core commands — `install`, `list`, `find`, `translate`, `recommend`, `publish` —
-ship in the default package. Four power features are shipped as **optional
-dependencies** so a bare CLI install stays small:
-
-| Feature | Package | Command |
-| ------------------------ | -------------------- | --------------------------- |
-| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
-| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
-| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
-| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
+[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
-```bash
-# Full install — every feature, everything works out of the box (default):
-npm install -g skillkit
-
-# Slim install — core commands only, ~75% smaller, no native addons:
-npm install -g skillkit --omit=optional
-pnpm add -g skillkit --prod --no-optional
-```
-
-Cold `npm install` measurements on a fresh cache:
+**Want your skills listed?** [Submit your repo](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md).
-| Install mode | Packages | Time | Deprecations |
-| --------------------- | -------- | ---- | ------------ |
-| `skillkit` | 475 | 18 s | 3 |
-| `skillkit --omit=optional` | 118 | 9 s | 0 |
+## Contributing
-If you skipped optional deps and later want the UI, server, mesh, or
-messaging, add just the one you need:
-
-```bash
-npm install -g @skillkit/tui # skillkit ui
-npm install -g @skillkit/api # skillkit serve
-npm install -g @skillkit/mesh # skillkit mesh
-npm install -g @skillkit/messaging # skillkit message
-```
+Issues and PRs land fast. See [CONTRIBUTING.md](CONTRIBUTING.md) for the short version.
-### Using `npx` (no install)
-
-`npx skillkit add ` is the fastest way to try it. First run
-downloads the package into the npx cache (`~/.npm/_npx/`); every run
-after that is instant.
-
-```bash
-# Full (defaults to installing optional features):
-npx skillkit add anthropics/skills
-
-# Slim — core commands only, ~75% fewer packages, 0 warnings:
-npx --omit=optional skillkit add anthropics/skills
-```
+## License
-Run `npx skillkit` a few times and you will want the global install —
-it skips the prompt-to-proceed and kills the per-release cache refetch:
+Apache 2.0. See [LICENSE](LICENSE).
-```bash
-npm install -g skillkit --omit=optional # 9 s, 118 packages, one time
-skillkit add anthropics/skills # instant every run
-```
+
-## License
+
-Apache License 2.0 — see [LICENSE](LICENSE).
+[**Docs**](https://skillkit.sh/docs) · [**Website**](https://skillkit.sh) · [**API Explorer**](https://skillkit.sh/api) · [**npm**](https://www.npmjs.com/package/skillkit) · [**GitHub**](https://github.com/rohitg00/skillkit)
-## Links
+Built for agents. Written by humans.
-[Documentation](https://skillkit.sh/docs) · [Website](https://skillkit.sh) · [API Explorer](https://skillkit.sh/api) · [npm](https://www.npmjs.com/package/skillkit) · [GitHub](https://github.com/rohitg00/skillkit)
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+Tags are SVGs under 
+ 
+ 
+
-## Supported Agents (45)
-
-| Agent | Format | Directory |
-|-------|--------|-----------|
-| **Claude Code** | SKILL.md | `.claude/skills/` |
-| **Cursor** | .mdc | `.cursor/skills/` |
-| **Codex** | SKILL.md | `.codex/skills/` |
-| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
-| **OpenCode** | SKILL.md | `.opencode/skills/` |
-| **GitHub Copilot** | Markdown | `.github/skills/` |
-| **Windsurf** | Markdown | `.windsurf/skills/` |
-| **Devin** | Markdown | `.devin/skills/` |
-| **Aider** | SKILL.md | `.aider/skills/` |
-| **Sourcegraph Cody** | SKILL.md | `.cody/skills/` |
-| **Amazon Q** | SKILL.md | `.amazonq/skills/` |
-
-Plus 34 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
-
-[Full agent details](https://skillkit.sh/docs/agents)
+