Compare commits

..
7 Commits
Author SHA1 Message Date
Rohit Ghumare 821e9f714b chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags (#116)
Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.

Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.

Measured on a fresh npm cache (overrides-pinned file: tarballs):
  before:   475 pkgs / 18s / 3 deprecation warnings
  1.23.0:   418 pkgs / 18s / 2 deprecation warnings
  slim:     118 pkgs /  9s / 0 deprecation warnings
The two remaining warnings are upstream:
  - prebuild-install@7.1.3 from better-sqlite3 (must stay)
  - glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver

README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.

Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
2026-04-21 00:25:55 +01:00
Rohit Ghumare 7e6612d424 Merge pull request #115 from rohitg00/slim-install-deps
chore: slim CLI install by making heavy deps optional
2026-04-20 23:54:37 +01:00
Rohit Ghumare 49bcd85abf docs: add npx usage guidance for add command
npx skillkit add <owner/repo> is the most common first-touch path,
so call it out explicitly. Cover:

- Full vs slim invocation (npx skillkit add vs npx --omit=optional
  skillkit add), with the same 118/9s slim numbers.
- How the npx cache at ~/.npm/_npx/ makes subsequent runs instant
  until a new version ships.
- When to graduate to a global install: skips the prompt-to-proceed
  and kills the per-release refetch cost.

Updated in all four install-docs surfaces: root README, apps/skillkit
README (npm landing), docs/fumadocs/content/docs/installation.mdx,
and the Documentation.tsx components used on the website and the
fumadocs mirror.
2026-04-20 22:11:42 +01:00
Rohit Ghumare 2843bd3c5c fix(install): address CodeRabbit review on agent picker wording
Two nits from CodeRabbit on the first-user picker:

1. detectAgent() returns 'universal' as a fallback when no concrete
   adapter is detected. Passing that through to quickAgentSelect made
   the picker show "Just Universal (detected)" even when no real
   agent was found — misleading. Treat 'universal' as "not detected"
   and fall through to the plain select/all options instead.

2. The "All detected agents" label on the bottom option was wrong:
   agents at the call site is getAllAdapters() (all supported
   adapters), not only detected ones. Rename to "All supported
   agents" and change the hint to "writes to every adapter" so
   users aren't tricked into thinking this is a safe detected-only
   install.
2026-04-20 22:06:15 +01:00
Rohit Ghumare aea3b3ba32 fix(index): lazy-import @skillkit/tui + document optional deps
Devin review caught a hard bug: apps/skillkit/src/index.ts had a
static re-export of startTUI from @skillkit/tui. Now that tui is an
optional dependency, importing the skillkit package would crash with
ERR_MODULE_NOT_FOUND whenever the optional dep was skipped
(--omit=optional). Convert the re-export to an async wrapper that
dynamically imports @skillkit/tui on call. The error is surfaced
naturally with a clear Cannot-find-package message.

Docs updates so users understand the new split:

- README.md: add "Install sizes" section with full vs slim table,
  cold-install measurements (475 pkgs / 18 s vs 118 / 9 s),
  per-feature package mapping, and how to add a single optional
  package later.
- apps/skillkit/README.md (npm landing): add "What's optional"
  table + install mode guidance.
- docs/fumadocs/content/docs/installation.mdx: add "Full vs slim
  install" section covering all four optional features.
- docs/skillkit/components/Documentation.tsx +
  docs/fumadocs/src/components/Documentation.tsx: add "Optional
  Features" block to the Quick Start step on the website.

Verified: after `npm install --omit=optional`, `import('skillkit')`
succeeds with 622 exports loaded, and `await startTUI()` fails with
a clean "Cannot find package '@skillkit/tui'" message instead of
crashing at module-load time.
2026-04-20 22:04:08 +01:00
Rohit Ghumare 97ee4b9a43 fix(install): safer agent selection for first-time users
Before: first-time users (no history) saw "All detected agents"
as the first option in the agent picker. Mashing Enter would
install to all 32 agents, writing files across every adapter's
config dir. Selecting "Select specific agents" also pre-ticked
all 32 agents, requiring the user to un-tick by hand.

After:
- Default option is "Just <detected> (detected)" — one agent,
  low blast radius.
- "Select specific agents" moves above "All detected agents"
  and pre-ticks only the detected agent.
- "All detected agents" gets a second confirm gate
  ("Install to all N agents?") with initialValue: false.
- Hint text on "All" warns "use only if you know".

Returning users still see "Same as last time (Recommended)" as
the first option; their flow is unchanged.

Non-TTY path is unchanged (still auto-detects a single agent).

Wire detectAgent() through quickAgentSelect so the picker can
label and pre-select the detected agent. Empty selection from
the confirm gate is treated as cancellation.
2026-04-20 21:58:44 +01:00
Rohit Ghumare c8d0bbc844 chore: slim CLI install by making heavy deps optional
Move @skillkit/api, @skillkit/tui, @skillkit/mesh, @skillkit/messaging
to optionalDependencies. Drop @skillkit/memory entirely — the CLI
never imported it (only @skillkit/mcp-memory consumes it).

Killing @skillkit/memory removes cozo-node (native Rust) and
@xenova/transformers (~300MB ML stack) from the critical install
path. Making @skillkit/tui optional removes @opentui/core's
prebuild-install toolchain, which was the source of the
inflight/gauge/npmlog/tar/glob deprecation warnings.

Add skipNodeModulesBundle + platform=node + target=node18 to
apps/skillkit tsup config so optional deps stay external.

All TUI/mesh/messaging/api commands already lazy-import via
dynamic import() with surrounding try/catch, so missing optional
deps surface as a graceful error rather than a crash.

Measured impact (npm i skillkit in a clean cache):

  Scenario            Packages  Time   Deprecations  Vulns (crit/high)
  main                544       37s    10            33 (5/5)
  slim (default)      475       18s    3             25 (0/0)
  slim --omit=optional 118      9s     0             0

Core commands (list, find, translate, recommend, install, --help,
--version) smoke-tested in all three scenarios. Optional commands
(ui, mesh, message, serve) confirmed to degrade with a clean
"Cannot find package" error under --omit=optional.
2026-04-20 21:46:46 +01:00
45 changed files with 815 additions and 4043 deletions
+327 -186
View File
@@ -3,107 +3,227 @@
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
<img alt="SkillKit - One Skill. Every Agent." src="docs/img/banner.svg" width="100%">
<img alt="SkillKit. One skill. Every agent." src="docs/img/banner.svg" width="100%">
</picture>
<br/>
### *One skill. Every agent. 45 of them.*
<br/>
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/skillkit.svg?style=flat-square&color=3b82f6)](https://www.npmjs.com/package/skillkit)
[![npm downloads](https://img.shields.io/npm/dm/skillkit.svg?style=flat-square)](https://www.npmjs.com/package/skillkit)
[![GitHub stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=flat-square)](https://github.com/rohitg00/skillkit/stargazers)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
[![npm](https://img.shields.io/npm/v/skillkit?style=for-the-badge&logo=npm&logoColor=white&labelColor=0D1117&color=CB3837)](https://www.npmjs.com/package/skillkit)
[![downloads](https://img.shields.io/npm/dm/skillkit?style=for-the-badge&logo=npm&logoColor=white&labelColor=0D1117&color=FF8B94)](https://www.npmjs.com/package/skillkit)
[![stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=for-the-badge&logo=github&logoColor=white&labelColor=0D1117&color=FFC75F)](https://github.com/rohitg00/skillkit/stargazers)
[![CI](https://img.shields.io/github/actions/workflow/status/rohitg00/skillkit/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&labelColor=0D1117&color=6BCB77)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![license](https://img.shields.io/badge/License-Apache_2.0-4D96FF?style=for-the-badge&labelColor=0D1117)](LICENSE)
**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.
<br/>
[Website](https://skillkit.sh) &middot; [Docs](https://skillkit.sh/docs) &middot; [API Explorer](https://skillkit.sh/api) &middot; [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) &middot; [npm](https://www.npmjs.com/package/skillkit)
<a href="https://skillkit.sh"><img src="assets/tags/skills.svg" alt="400K+ skills"></a>
<a href="#supported-agents"><img src="assets/tags/agents.svg" alt="45 agents"></a>
<a href="#skill-sources"><img src="assets/tags/sources.svg" alt="31 sources"></a>
<img src="assets/tags/tests.svg" alt="757 tests">
<a href="LICENSE"><img src="assets/tags/license.svg" alt="Apache 2.0"></a>
<a href="CONTRIBUTING.md"><img src="assets/tags/prs-welcome.svg" alt="PRs welcome"></a>
<br/>
<a href="#full-vs-slim"><img src="assets/tags/slim-install.svg" alt="slim install"></a>
<a href="https://github.com/rohitg00/skillkit/releases/latest"><img src="assets/tags/v1.23.0.svg" alt="v1.23.0"></a>
<img src="assets/tags/new.svg" alt="new">
<img src="assets/tags/one-skill.svg" alt="one skill">
<img src="assets/tags/every-agent.svg" alt="every agent">
<sub>Tags are SVGs under <a href="assets/tags/"><code>/assets/tags/</code></a>. Fork and remix.</sub>
<br/>
### Quick nav
[**Quick start**](#quick-start) · [**Install**](#install) · [**Commands**](#commands) · [**Agents**](#supported-agents) · [**Sources**](#skill-sources) · [**API**](#programmatic-api) · [**Website**](https://skillkit.sh)
</div>
---
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
Skills make AI coding agents smarter. But every agent uses a different format:
| Agent | Format | Directory |
|-------|--------|-----------|
| Claude Code | `SKILL.md` | `.claude/skills/` |
| Cursor | `.mdc` | `.cursor/skills/` |
| Copilot | Markdown | `.github/skills/` |
| Windsurf | Markdown | `.windsurf/skills/` |
You end up rewriting the same skill for each agent, or locking into one platform.
**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.
```bash
npx skillkit@latest
```
## See It In Action
<div align="center">
![SkillKit vs skills CLI](docs/img/inital-command.png)
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
</div>
> **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.
## The problem
## Quick Start
Every AI coding agent wants skills. Every agent invented a different format.
<table>
<tr>
<th>Agent</th>
<th>Format</th>
<th>Directory</th>
</tr>
<tr><td>Claude Code</td><td><code>SKILL.md</code></td><td><code>.claude/skills/</code></td></tr>
<tr><td>Cursor</td><td><code>.mdc</code></td><td><code>.cursor/skills/</code></td></tr>
<tr><td>Copilot</td><td>Markdown</td><td><code>.github/skills/</code></td></tr>
<tr><td>Windsurf</td><td>Markdown</td><td><code>.windsurf/skills/</code></td></tr>
<tr><td colspan="3"><i>... 41 more</i></td></tr>
</table>
You rewrite the same skill for each agent. Or you lock in to one.
## The fix
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 init # Detect agents, create dirs
skillkit recommend # Get smart suggestions
skillkit install anthropics/skills # Install from marketplace
skillkit sync # Deploy to your agents
npx skillkit add anthropics/skills
```
Four commands. Your agents now have skills for PDF processing, code review, and more.
That is the whole first-run. Pick your agent (your detected agent is pre-selected), confirm, done.
## What Can You Do?
### Install skills from anywhere
## Quick start
```bash
skillkit install anthropics/skills # GitHub
skillkit install gitlab:team/skills # GitLab
skillkit install ./my-local-skills # Local path
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
```
### Translate between agents
Four commands. Your agent now has PDF processing, code review, auth patterns, and whatever you need.
Write for Claude, deploy to Cursor:
### What the first install looks like
```
$ 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
Pick one. All three do the same thing.
```bash
npm install -g skillkit # npm
pnpm add -g skillkit # pnpm
bun add -g skillkit # bun
```
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:
<p align="center">
<img src="assets/tags/packages.svg" alt="118 packages">
<img src="assets/tags/install.svg" alt="9s install">
<img src="assets/tags/vulns.svg" alt="0 vulnerabilities">
</p>
| 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
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
```
The CLI catches missing optional packages and prints a one-line hint. No stack trace.
### Using `npx`
`npx skillkit add <owner/repo>` 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
<details open>
<summary><b>Install from anywhere</b></summary>
```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
```
</details>
<details>
<summary><b>Translate between agents</b></summary>
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
```
</details>
### Get smart recommendations
<details>
<summary><b>Stack-aware recommendations</b></summary>
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
```
</details>
### Discover skills at runtime
<details>
<summary><b>Runtime skill discovery (REST)</b></summary>
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) &middot; [MCP Server docs](https://skillkit.sh/docs/mcp-server) &middot; [Python Client docs](https://skillkit.sh/docs/python-client) &middot; [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)
</details>
### Auto-generate agent instructions
<details>
<summary><b>Auto-generate agent instructions</b></summary>
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
```
</details>
### Session memory
<details>
<summary><b>Session memory</b></summary>
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
```
</details>
### AI skill generation
<details>
<summary><b>AI skill generation</b></summary>
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.
</details>
### Mesh network
<details>
<summary><b>Team collaboration</b></summary>
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.
</details>
### Chrome Extension
<details>
<summary><b>Mesh network</b></summary>
Save any webpage as a skill directly from your browser.
Distribute agents across machines with encrypted P2P:
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"
```bash
skillkit mesh init
skillkit mesh discover
```
</details>
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.
<details>
<summary><b>Chrome extension</b></summary>
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/<name>`.
[Extension docs](https://skillkit.sh/docs/chrome-extension)
</details>
### Interactive TUI
<details>
<summary><b>Interactive TUI</b></summary>
```bash
skillkit ui
```
`h` Home &middot; `m` Marketplace &middot; `r` Recommend &middot; `t` Translate &middot; `i` Installed &middot; `s` Sync &middot; `q` Quit
<sub><code>h</code> home · <code>m</code> marketplace · <code>r</code> recommend · <code>t</code> translate · <code>i</code> installed · <code>s</code> sync · <code>q</code> quit</sub>
![SkillKit Interactive CLI](docs/img/inital-command.png)
<img src="docs/img/skillkit-ui.png" width="100%" alt="SkillKit interactive TUI">
## 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)
</details>
## Commands
### Core
<details open>
<summary><b>Core</b></summary>
```bash
skillkit install <source> # Install skills (with live progress)
skillkit remove <skills> # 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 <skill> --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 <source> # install skills (live progress)
skillkit remove <skills> # 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 <skill> --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
```
</details>
### Discovery & Security
<details>
<summary><b>Discovery & security</b></summary>
```bash
skillkit marketplace # Browse skills
skillkit tree # Hierarchical taxonomy
skillkit find <query> # Quick search
skillkit scan <path> # Security scan for skills
skillkit marketplace # browse
skillkit tree # taxonomy
skillkit find <query> # quick search
skillkit scan <path> # security scan
```
</details>
### Custom Sources
<details>
<summary><b>Custom sources</b></summary>
```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
```
</details>
### Issue Planner
<details>
<summary><b>Issue planner</b></summary>
```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
```
</details>
### Session Intelligence
<details>
<summary><b>Session intelligence</b></summary>
```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
```
</details>
### Advanced
<details>
<summary><b>Advanced</b></summary>
```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 <name> # 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 <name> # run workflows
skillkit test # test skills
skillkit cicd init # CI/CD templates
```
</details>
[Full command reference](https://skillkit.sh/docs/commands)
## Creating Skills
## Supported agents
<details open>
<summary><b>Top 11</b></summary>
| 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/` |
</details>
<details>
<summary><b>Plus 34 more</b></summary>
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.
</details>
[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,53 +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) &middot; [obra/superpowers](https://github.com/obra/superpowers) &middot; [wshobson/agents](https://github.com/wshobson/agents) &middot; [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) &middot; [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) &middot; [langgenius/dify](https://github.com/langgenius/dify) &middot; [better-auth/skills](https://github.com/better-auth/skills) &middot; [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) &middot; [elysiajs/skills](https://github.com/elysiajs/skills) &middot; [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) &middot; [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) &middot; [dimillian/skills](https://github.com/dimillian/skills) &middot; [waynesutton/convexskills](https://github.com/waynesutton/convexskills) &middot; [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) &middot; [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) &middot; [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
[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)
**Want your skills listed?** [Submit your repo](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md).
## Install
## Contributing
```bash
npm install -g skillkit # npm
pnpm add -g skillkit # pnpm
yarn global add skillkit # yarn
bun add -g skillkit # bun
npx skillkit <command> # no install
```
Issues and PRs land fast. See [CONTRIBUTING.md](CONTRIBUTING.md) for the short version.
## License
Apache License 2.0 — see [LICENSE](LICENSE).
Apache 2.0. See [LICENSE](LICENSE).
## Links
<br/>
[Documentation](https://skillkit.sh/docs) &middot; [Website](https://skillkit.sh) &middot; [API Explorer](https://skillkit.sh/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
<div align="center">
[**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)
<sub>Built for agents. Written by humans.</sub>
</div>
+38
View File
@@ -5,7 +5,45 @@ Universal skills manager for AI coding agents. Install, manage, and sync skills
## Installation
```bash
# Full install (default) — every feature, everything works:
npm install -g skillkit
# Slim install — core commands only, ~75% smaller, no native addons:
npm install -g skillkit --omit=optional
```
### What's optional
Four power features ship as **optional dependencies** so the core CLI
stays lean. They install automatically with `npm install -g skillkit`,
and are skipped with `--omit=optional`:
| 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 …` |
Add one later with `npm install -g @skillkit/tui` (or `api` / `mesh` / `messaging`).
### Using `npx`
`npx skillkit add <owner/repo>` works with zero install. First run pulls
the package into the npx cache (`~/.npm/_npx/`); every subsequent run
from the same cache is instant.
```bash
npx skillkit add anthropics/skills # full
npx --omit=optional skillkit add anthropics/skills # slim, 118 pkgs, 9 s
```
Running `npx` more than a couple of times? Install globally — no
prompt-to-proceed, no refetch on each release:
```bash
npm install -g skillkit --omit=optional
skillkit add anthropics/skills
```
## Quick Start
+7 -6
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.22.1",
"version": "1.23.0",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 41 more",
"type": "module",
"bin": {
@@ -53,16 +53,17 @@
"node": ">=18.0.0"
},
"dependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/core": "workspace:*",
"@skillkit/agents": "workspace:*",
"@skillkit/cli": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/memory": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*",
"clipanion": "^4.0.0-rc.4"
},
"optionalDependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*"
},
"devDependencies": {
"@types/node": "^22.10.5",
"tsup": "^8.3.5",
+4 -3
View File
@@ -1,6 +1,7 @@
// Re-export all public APIs from packages
export * from '@skillkit/core';
export * from '@skillkit/agents';
// Re-export TUI entry point
export { startTUI } from '@skillkit/tui';
export async function startTUI(...args: unknown[]): Promise<unknown> {
const mod = await import('@skillkit/tui');
return mod.startTUI(...(args as Parameters<typeof mod.startTUI>));
}
+3
View File
@@ -7,4 +7,7 @@ export default defineConfig({
splitting: false,
sourcemap: true,
clean: true,
platform: 'node',
target: 'node18',
skipNodeModulesBundle: true,
});
+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="56" height="28" fill="#18181b"/>
<rect x="56" width="28" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">agents</text>
<text x="70" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">45</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#a78bfa"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">community</text>
</svg>

After

Width:  |  Height:  |  Size: 454 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#06b6d4"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">curated</text>
</svg>

After

Width:  |  Height:  |  Size: 452 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="119" height="28" viewBox="0 0 119 28" role="img">
<clipPath id="c"><rect width="119" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="98" height="28" fill="#18181b"/>
<rect x="98" width="21" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="118" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="49" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">deprecations</text>
<text x="108.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 813 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">every agent</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="28" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">install</text>
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">9s</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="147" height="28" viewBox="0 0 147 28" role="img">
<clipPath id="c"><rect width="147" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="84" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="146" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">license</text>
<text x="105" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">Apache-2.0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 820 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="50" height="28" viewBox="0 0 50 28" role="img">
<rect x="0.5" y="0.5" width="49" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">new</text>
</svg>

After

Width:  |  Height:  |  Size: 448 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="42" height="28" fill="#18181b"/>
<rect x="42" width="42" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="21" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">node</text>
<text x="63" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">>=18</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 804 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="86" height="28" viewBox="0 0 86 28" role="img">
<rect x="0.5" y="0.5" width="85" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#f59e0b"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">official</text>
</svg>

After

Width:  |  Height:  |  Size: 453 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">one skill</text>
</svg>

After

Width:  |  Height:  |  Size: 454 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#f472b6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">open source</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="70" height="28" fill="#18181b"/>
<rect x="70" width="35" height="28" fill="#3b82f6"/>
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="35" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">packages</text>
<text x="87.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fff" letter-spacing="0.3">118</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 810 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">PRs welcome</text>
</svg>

After

Width:  |  Height:  |  Size: 459 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="56" height="28" fill="#18181b"/>
<rect x="56" width="49" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">skills</text>
<text x="80.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">400K+</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 813 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="114" height="28" viewBox="0 0 114 28" role="img">
<rect x="0.5" y="0.5" width="113" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">slim install</text>
</svg>

After

Width:  |  Height:  |  Size: 460 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="63" height="28" fill="#18181b"/>
<rect x="63" width="28" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">sources</text>
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">31</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 807 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="49" height="28" fill="#18181b"/>
<rect x="49" width="35" height="28" fill="#09090b"/>
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">tests</text>
<text x="66.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">757</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 808 B

+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">v1.23.0</text>
</svg>

After

Width:  |  Height:  |  Size: 452 B

+10
View File
@@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="70" height="28" viewBox="0 0 70 28" role="img">
<clipPath id="c"><rect width="70" height="28" rx="4" ry="4"/></clipPath>
<g clip-path="url(#c)">
<rect width="49" height="28" fill="#18181b"/>
<rect x="49" width="21" height="28" fill="#22c55e"/>
<rect x="0.5" y="0.5" width="69" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">vulns</text>
<text x="59.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 803 B

@@ -33,6 +33,61 @@ bun add -g skillkit
Both `skillkit` and `sk` work as command aliases.
## Full vs slim install
SkillKit ships four power features as **optional dependencies** so the
core install stays small. The default `npm install -g skillkit` installs
every feature; `--omit=optional` installs only the core CLI.
| 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 …` |
```bash
# Full (default) — every feature works out of the box:
npm install -g skillkit
# Slim — core commands only, ~75% smaller, no native addons, 0 deprecation warnings:
npm install -g skillkit --omit=optional
```
Add one later:
```bash
npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message
```
The CLI catches a missing optional feature and prints a one-line hint,
so you'll never see an unhandled stack trace.
## Using `npx`
`npx skillkit add <owner/repo>` runs without a global install. First run
downloads into the npx cache (`~/.npm/_npx/`); every call after that is
instant until the cache expires or a new version ships.
```bash
# Full — every feature works:
npx skillkit add anthropics/skills
# Slim — core commands only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills
```
If you use `npx skillkit` more than a couple of times, install globally
to skip the prompt-to-proceed and avoid the per-release cache refetch:
```bash
npm install -g skillkit --omit=optional
skillkit add anthropics/skills
```
## Verify
```bash
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.22.1",
"version": "1.23.0",
"private": true,
"scripts": {
"build": "next build",
+33 -5
View File
@@ -61,14 +61,42 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
<CodeBlock>{`# Full install — every feature works out of the box (default):
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
npm install -g skillkit --omit=optional
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
# Or use npx directly:
npx skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
<p className="text-zinc-300 text-sm">
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
dependencies. They install by default, or add later à la carte:
</p>
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
<p className="text-zinc-300 text-sm">
<code className="text-zinc-200">npx skillkit add &lt;owner/repo&gt;</code> runs with zero install.
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
run after that is instant until a new version ships.
</p>
<CodeBlock>{`# Full (default):
npx skillkit add anthropics/skills
# Slim — core only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
<p className="text-zinc-300 text-sm">
Using npx more than a couple times? Install globally to skip the
prompt-to-proceed and avoid the per-release cache refetch:
</p>
<CodeBlock>{`npm install -g skillkit --omit=optional
skillkit add anthropics/skills`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
+33 -5
View File
@@ -60,14 +60,42 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
<CodeBlock>{`# Install globally via npm
<CodeBlock>{`# Full install — every feature works out of the box (default):
npm install -g skillkit
# Or use npx directly
npx skillkit --help
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
npm install -g skillkit --omit=optional
# Or install via pnpm
pnpm add -g skillkit`}</CodeBlock>
# Or use npx directly:
npx skillkit --help`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
<p className="text-zinc-300 text-sm">
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
dependencies. They install by default, or add later à la carte:
</p>
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
npm install -g @skillkit/api # enables: skillkit serve
npm install -g @skillkit/mesh # enables: skillkit mesh
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
<p className="text-zinc-300 text-sm">
<code className="text-zinc-200">npx skillkit add &lt;owner/repo&gt;</code> runs with zero install.
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
run after that is instant until a new version ships.
</p>
<CodeBlock>{`# Full (default):
npx skillkit add anthropics/skills
# Slim — core only, 75% fewer packages, 0 warnings:
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
<p className="text-zinc-300 text-sm">
Using npx more than a couple times? Install globally to skip the
prompt-to-proceed and avoid the per-release cache refetch:
</p>
<CodeBlock>{`npm install -g skillkit --omit=optional
skillkit add anthropics/skills`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
<CodeBlock>{`skillkit --version
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.22.1",
"version": "1.23.0",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.22.1",
"version": "1.23.0",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 45 coding agents",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.22.1",
"version": "1.23.0",
"description": "Agent adapters for SkillKit - supports 45 AI coding agents",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.22.1",
"version": "1.23.0",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+7 -6
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.22.1",
"version": "1.23.0",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -22,14 +22,9 @@
},
"dependencies": {
"@clack/prompts": "^0.11.0",
"@skillkit/api": "workspace:*",
"@skillkit/core": "workspace:*",
"@skillkit/agents": "workspace:*",
"@skillkit/resources": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/memory": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*",
"chalk": "^5.3.0",
"clipanion": "^4.0.0-rc.4",
"got": "^14.4.1",
@@ -38,6 +33,12 @@
"picocolors": "^1.1.1",
"yaml": "^2.7.0"
},
"optionalDependencies": {
"@skillkit/api": "workspace:*",
"@skillkit/tui": "workspace:*",
"@skillkit/mesh": "workspace:*",
"@skillkit/messaging": "workspace:*"
},
"devDependencies": {
"@types/node": "^22.10.5",
"tsup": "^8.3.5",
+7
View File
@@ -357,6 +357,8 @@ export class InstallCommand extends Command {
if (isInteractive) {
const allAgentTypes = getAllAdapters().map((a) => a.type);
const lastAgents = getLastAgents();
const rawDetected = await detectAgent().catch(() => undefined);
const detectedAgent = rawDetected && rawDetected !== 'universal' ? rawDetected : undefined;
step(`Detected ${allAgentTypes.length} agents`);
@@ -364,6 +366,7 @@ export class InstallCommand extends Command {
message: "Install to",
agents: allAgentTypes,
lastSelected: lastAgents,
detected: detectedAgent,
});
if (isCancel(agentResult)) {
@@ -372,6 +375,10 @@ export class InstallCommand extends Command {
}
const targetAgents = (agentResult as { agents: string[] }).agents as AgentType[];
if (targetAgents.length === 0) {
cancel("Installation cancelled");
return { agents: null, exitCode: 0 };
}
saveLastAgents(targetAgents);
return { agents: targetAgents, exitCode: 0 };
}
+38 -11
View File
@@ -117,9 +117,11 @@ export async function quickAgentSelect(options: {
message?: string;
agents: string[];
lastSelected?: string[];
}): Promise<{ agents: string[]; method: 'last' | 'all' | 'select' } | symbol> {
const { agents, lastSelected = [] } = options;
detected?: string;
}): Promise<{ agents: string[]; method: 'last' | 'all' | 'select' | 'detected' } | symbol> {
const { agents, lastSelected = [], detected } = options;
const hasLast = lastSelected.length > 0 && lastSelected.some(a => agents.includes(a));
const hasDetected = !!detected && agents.includes(detected);
const selectOptions: Array<{ value: string; label: string; hint?: string }> = [];
@@ -130,21 +132,29 @@ export async function quickAgentSelect(options: {
selectOptions.push({
value: 'last',
label: `Same as last time (Recommended)`,
label: 'Same as last time (Recommended)',
hint: `${agentList}${more}`,
});
}
selectOptions.push({
value: 'all',
label: 'All detected agents',
hint: `${agents.length} agent${agents.length !== 1 ? 's' : ''}`,
});
if (hasDetected) {
selectOptions.push({
value: 'detected',
label: `Just ${formatAgent(detected!)} (detected)`,
hint: detected,
});
}
selectOptions.push({
value: 'select',
label: 'Select specific agents',
hint: 'Choose manually',
hint: 'Choose manually, spacebar to toggle',
});
selectOptions.push({
value: 'all',
label: 'All supported agents',
hint: `${agents.length} agent${agents.length !== 1 ? 's' : ''} — writes to every adapter`,
});
const result = await clack.select({
@@ -156,20 +166,37 @@ export async function quickAgentSelect(options: {
return result;
}
const method = result as 'last' | 'all' | 'select';
const method = result as 'last' | 'all' | 'select' | 'detected';
if (method === 'last') {
return { agents: lastSelected.filter(a => agents.includes(a)), method };
}
if (method === 'detected') {
return { agents: [detected!], method };
}
if (method === 'all') {
const confirmed = await clack.confirm({
message: `Install to all ${agents.length} agents?`,
initialValue: false,
});
if (clack.isCancel(confirmed) || !confirmed) {
return clack.isCancel(confirmed) ? confirmed : { agents: [], method: 'all' };
}
return { agents, method };
}
const initialValues = lastSelected.length > 0
? lastSelected.filter(a => agents.includes(a))
: hasDetected ? [detected!] : [];
const selected = await agentMultiselect({
message: 'Select agents',
agents,
initialValues: lastSelected.length > 0 ? lastSelected : agents,
initialValues,
});
if (clack.isCancel(selected)) {
+1 -5
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.22.1",
"version": "1.23.0",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
@@ -60,12 +60,8 @@
"zod": "^3.24.1"
},
"optionalDependencies": {
"@anthropic-ai/sdk": "^0.39.0",
"@google/genai": "^1.0.0",
"better-sqlite3": "^12.0.0",
"node-llama-cpp": "^3.15.0",
"ollama": "^0.5.0",
"openai": "^4.0.0",
"sqlite-vec": "^0.1.6"
},
"devDependencies": {
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp-memory",
"version": "1.22.1",
"version": "1.23.0",
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/memory",
"version": "1.22.1",
"version": "1.23.0",
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mesh",
"version": "1.22.1",
"version": "1.23.0",
"description": "Peer mesh network for multi-machine agent distribution",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/messaging",
"version": "1.22.1",
"version": "1.23.0",
"description": "Inter-agent messaging system for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/resources",
"version": "1.22.1",
"version": "1.23.0",
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "1.22.1",
"version": "1.23.0",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+28 -3805
View File
File diff suppressed because it is too large Load Diff
+73
View File
@@ -0,0 +1,73 @@
#!/usr/bin/env node
import { writeFileSync, mkdirSync } from 'node:fs';
import { resolve, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const outDir = resolve(root, 'assets/tags');
mkdirSync(outDir, { recursive: true });
const FONT = 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace';
const PAD_X = 14;
const H = 28;
const R = 4;
const CHAR_W = 7.2;
const BADGE_CHAR_W = 7.0;
function pill({ text, fg = '#fafafa', bg = '#09090b', stroke = '#3f3f46', accent }) {
const w = Math.round(text.length * CHAR_W + PAD_X * 2);
const accentBar = accent
? `<rect x="0" y="0" width="4" height="${H}" fill="${accent}"/>`
: '';
return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${H}" viewBox="0 0 ${w} ${H}" role="img">
<rect x="0.5" y="0.5" width="${w - 1}" height="${H - 1}" rx="${R}" ry="${R}" fill="${bg}" stroke="${stroke}"/>
${accentBar}
<text x="${accent ? PAD_X + 4 : w / 2}" y="18" text-anchor="${accent ? 'start' : 'middle'}" font-family="${FONT}" font-size="12" font-weight="600" fill="${fg}" letter-spacing="0.3">${text}</text>
</svg>`;
}
function splitPill({ label, value, labelBg = '#18181b', valueBg = '#09090b', labelFg = '#a1a1aa', valueFg = '#fafafa', stroke = '#3f3f46' }) {
const lw = Math.round(label.length * BADGE_CHAR_W + PAD_X);
const vw = Math.round(value.length * BADGE_CHAR_W + PAD_X);
const w = lw + vw;
return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${H}" viewBox="0 0 ${w} ${H}" role="img">
<clipPath id="c"><rect width="${w}" height="${H}" rx="${R}" ry="${R}"/></clipPath>
<g clip-path="url(#c)">
<rect width="${lw}" height="${H}" fill="${labelBg}"/>
<rect x="${lw}" width="${vw}" height="${H}" fill="${valueBg}"/>
<rect x="0.5" y="0.5" width="${w - 1}" height="${H - 1}" fill="none" stroke="${stroke}" rx="${R}" ry="${R}"/>
<text x="${lw / 2}" y="18" text-anchor="middle" font-family="${FONT}" font-size="12" font-weight="500" fill="${labelFg}" letter-spacing="0.3">${label}</text>
<text x="${lw + vw / 2}" y="18" text-anchor="middle" font-family="${FONT}" font-size="12" font-weight="700" fill="${valueFg}" letter-spacing="0.3">${value}</text>
</g>
</svg>`;
}
const tags = [
{ name: 'slim-install.svg', svg: pill({ text: 'slim install', accent: '#3b82f6' }) },
{ name: 'new.svg', svg: pill({ text: 'new', accent: '#22c55e' }) },
{ name: 'v1.23.0.svg', svg: pill({ text: 'v1.23.0', accent: '#3b82f6' }) },
{ name: 'official.svg', svg: pill({ text: 'official', accent: '#f59e0b' }) },
{ name: 'community.svg', svg: pill({ text: 'community', accent: '#a78bfa' }) },
{ name: 'curated.svg', svg: pill({ text: 'curated', accent: '#06b6d4' }) },
{ name: 'open-source.svg', svg: pill({ text: 'open source', accent: '#f472b6' }) },
{ name: 'prs-welcome.svg', svg: pill({ text: 'PRs welcome', accent: '#22c55e' }) },
{ name: 'one-skill.svg', svg: pill({ text: 'one skill', accent: '#3b82f6' }) },
{ name: 'every-agent.svg', svg: pill({ text: 'every agent', accent: '#3b82f6' }) },
{ name: 'agents.svg', svg: splitPill({ label: 'agents', value: '45' }) },
{ name: 'skills.svg', svg: splitPill({ label: 'skills', value: '400K+' }) },
{ name: 'sources.svg', svg: splitPill({ label: 'sources', value: '31' }) },
{ name: 'tests.svg', svg: splitPill({ label: 'tests', value: '757' }) },
{ name: 'install.svg', svg: splitPill({ label: 'install', value: '9s', valueBg: '#22c55e', valueFg: '#000' }) },
{ name: 'packages.svg', svg: splitPill({ label: 'packages', value: '118', valueBg: '#3b82f6', valueFg: '#fff' }) },
{ name: 'deprecations.svg', svg: splitPill({ label: 'deprecations', value: '0', valueBg: '#22c55e', valueFg: '#000' }) },
{ name: 'vulns.svg', svg: splitPill({ label: 'vulns', value: '0', valueBg: '#22c55e', valueFg: '#000' }) },
{ name: 'license.svg', svg: splitPill({ label: 'license', value: 'Apache-2.0' }) },
{ name: 'node.svg', svg: splitPill({ label: 'node', value: '>=18' }) },
];
for (const { name, svg } of tags) {
writeFileSync(resolve(outDir, name), svg);
console.log(`wrote assets/tags/${name}`);
}