Compare commits

...
Author SHA1 Message Date
Rohit Ghumare 145bf80342 chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags
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:11:44 +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
Rohit Ghumare ae8c7a1abb chore: bump version to 1.22.1 2026-04-12 20:38:10 +01:00
Rohit Ghumare 196a959569 Merge pull request #109 from rohitg00/feat/json-spinners-remaining
feat: complete --json and spinners for all remaining commands
2026-04-12 20:21:14 +01:00
Rohit Ghumare 23d1c8932a fix: run agent install in save --json mode, include agents in output 2026-04-12 20:16:44 +01:00
Rohit Ghumare 0c82c58905 feat(cli): add --json output and loading spinners to remaining commands
Add --json flag with structured JSON output to: create, enable, disable,
eval, sync, tap (add/remove/list), translate, save, read.

Add loading spinners to: audit, fix, test, plugin, team, methodology,
hook, remove. Commands that already had spinners get --json-aware no-op
spinners when --json is active to suppress visual output.
2026-04-12 12:02:38 +01:00
62 changed files with 1217 additions and 4194 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.0",
"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.0",
"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.0",
"version": "1.23.0",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.22.0",
"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.0",
"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.0",
"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.0",
"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",
+18 -2
View File
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { promises as fs } from 'fs';
import path from 'path';
import { colors, warn, success } from '../onboarding/index.js';
import { colors, warn, success, spinner } from '../onboarding/index.js';
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
export class AuditCommand extends Command {
@@ -114,8 +114,11 @@ export class AuditCommand extends Command {
}
private async handleLog(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Querying audit log');
const query = this.buildQuery();
const events = await logger.query(query);
s.stop('Query complete');
if (this.json) {
console.log(JSON.stringify(events, null, 2));
@@ -163,10 +166,13 @@ export class AuditCommand extends Command {
}
private async handleExport(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const format = (this.format as 'json' | 'csv' | 'text') || 'json';
const query = this.buildQuery();
s.start('Exporting audit log');
const content = await logger.export({ format, query });
s.stop('Export complete');
if (this.output) {
const outputPath = resolve(this.output);
@@ -180,7 +186,10 @@ export class AuditCommand extends Command {
}
private async handleStats(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Computing statistics');
const stats = await logger.stats();
s.stop('Statistics computed');
if (this.json) {
console.log(JSON.stringify(stats, null, 2));
@@ -237,9 +246,16 @@ export class AuditCommand extends Command {
const cutoffDate = new Date();
cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Clearing old entries');
const cleared = await logger.clear(cutoffDate);
s.stop('Clear complete');
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
if (this.json) {
console.log(JSON.stringify({ success: true, cleared, days: daysAgo }));
} else {
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
}
return 0;
}
+45 -19
View File
@@ -1,6 +1,6 @@
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { colors, success, error, step } from '../onboarding/index.js';
import { colors, success, error, step, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
export class CreateCommand extends Command {
@@ -37,12 +37,21 @@ export class CreateCommand extends Command {
description: 'Parent directory to create skill in (default: current directory)',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const skillName = this.name.toLowerCase();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Invalid skill name' }));
} else {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
}
return 1;
}
@@ -50,11 +59,17 @@ export class CreateCommand extends Command {
const skillDir = join(parentDir, skillName);
if (existsSync(skillDir)) {
error(`Directory already exists: ${skillDir}`);
if (this.json) {
console.log(JSON.stringify({ success: false, error: `Directory already exists: ${skillDir}` }));
} else {
error(`Directory already exists: ${skillDir}`);
}
return 1;
}
try {
s.start('Creating skill');
mkdirSync(skillDir, { recursive: true });
const skillMd = generateSkillMd(skillName);
@@ -78,24 +93,35 @@ export class CreateCommand extends Command {
writeFileSync(join(assetsDir, '.gitkeep'), '');
}
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
s.stop('Skill created');
if (this.json) {
console.log(JSON.stringify({ success: true, name: skillName, path: skillDir }));
} else {
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
}
return 0;
} catch (err) {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
s.stop('Failed');
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+43 -11
View File
@@ -1,4 +1,4 @@
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { setSkillEnabled, findSkill } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -16,37 +16,53 @@ export class EnableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Enabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (skill.enabled) {
console.log(colors.muted(`Already enabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already enabled: ${skillName}`));
results.push({ name: skillName, enabled: true, success: true });
continue;
}
const result = setSkillEnabled(skill.path, true);
if (result) {
success(`Enabled: ${skillName}`);
if (!this.json) success(`Enabled: ${skillName}`);
results.push({ name: skillName, enabled: true, success: true });
successCount++;
} else {
error(`Failed to enable: ${skillName}`);
if (!this.json) error(`Failed to enable: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Enabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
@@ -67,37 +83,53 @@ export class DisableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Disabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (!skill.enabled) {
console.log(colors.muted(`Already disabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already disabled: ${skillName}`));
results.push({ name: skillName, enabled: false, success: true });
continue;
}
const result = setSkillEnabled(skill.path, false);
if (result) {
warn(`Disabled: ${skillName}`);
if (!this.json) warn(`Disabled: ${skillName}`);
results.push({ name: skillName, enabled: false, success: true });
successCount++;
} else {
error(`Failed to disable: ${skillName}`);
if (!this.json) error(`Failed to disable: ${skillName}`);
results.push({ name: skillName, enabled: true, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Disabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
+14 -4
View File
@@ -75,6 +75,10 @@ export class EvalCommand extends Command {
description: 'Timeout in seconds for each tier',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const targetPath = resolve(this.skillPath);
@@ -133,8 +137,8 @@ export class EvalCommand extends Command {
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
engine.registerEvaluator(new CommunitySignalsEvaluator());
const isJson = this.format === 'json';
const s = isJson ? { start: () => {}, stop: () => {} } : spinner();
const isJson = this.json || this.format === 'json';
const s = isJson ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Evaluating skill...');
let result;
try {
@@ -145,12 +149,18 @@ export class EvalCommand extends Command {
throw err;
}
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
if (this.json) {
console.log(JSON.stringify(result));
} else {
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
}
if (this.minScore) {
const threshold = parseInt(this.minScore, 10);
if (result.overallScore < threshold) {
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
if (!this.json) {
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
}
return 1;
}
}
+4
View File
@@ -15,6 +15,7 @@ import {
error,
header,
confirm,
spinner,
} from '../onboarding/index.js';
interface FixSuggestion {
@@ -209,6 +210,7 @@ export class FixCommand extends Command {
let totalFixes = 0;
let filesFixed = 0;
const s = spinner();
for (const target of this.targets) {
const resolved = resolve(target);
@@ -256,8 +258,10 @@ export class FixCommand extends Command {
continue;
}
s.start(`Evaluating ${skillName}`);
const content = readFileSync(filePath, 'utf-8');
const quality = evaluateSkillFile(filePath);
s.stop(`Evaluated ${skillName}`);
if (!quality) {
warn(`Could not evaluate: ${target}`);
+4 -1
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
import {
getHookTemplates,
@@ -239,7 +239,10 @@ export class HookCommand extends Command {
}
const agent = this.agent || 'claude-code';
const s = spinner();
s.start(`Generating hooks for ${agent}`);
const generated = manager.generateAgentHooks(agent as any);
s.stop('Hooks generated');
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
+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 };
}
+17 -9
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createMethodologyManager, createMethodologyLoader } from '@skillkit/core';
export class MethodologyCommand extends Command {
@@ -61,8 +61,11 @@ export class MethodologyCommand extends Command {
}
private async listPacks(): Promise<number> {
const s = spinner();
s.start('Loading methodology packs');
const loader = createMethodologyLoader();
const packs = await loader.loadAllPacks();
s.stop('Packs loaded');
if (packs.length === 0) {
this.context.stdout.write('No methodology packs available.\n');
@@ -91,15 +94,16 @@ export class MethodologyCommand extends Command {
if (this.target) {
// Check if it's a skill ID (pack/skill) or pack name
if (this.target.includes('/')) {
// Install single skill
this.context.stdout.write(`Installing skill: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
this.context.stdout.write(colors.warning('[dry-run] Would install skill.\n'));
return 0;
}
s.start(`Installing skill: ${this.target}`);
const result = await manager.installSkill(this.target);
s.stop('Install complete');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Skill installed: ${this.target}\n`));
@@ -110,8 +114,7 @@ export class MethodologyCommand extends Command {
return 1;
}
} else {
// Install single pack
this.context.stdout.write(`Installing pack: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
const pack = await loader.loadPack(this.target);
@@ -121,7 +124,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start(`Installing pack: ${this.target}`);
const result = await manager.installPack(this.target);
s.stop('Pack installed');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Pack "${this.target}" installed!\n`));
@@ -138,8 +143,7 @@ export class MethodologyCommand extends Command {
}
}
} else {
// Install all packs
this.context.stdout.write('Installing all methodology packs...\n\n');
const s = spinner();
if (this.dryRun) {
const packs = await loader.loadAllPacks();
@@ -152,7 +156,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start('Installing all methodology packs');
const result = await manager.installAllPacks();
s.stop('Installation complete');
if (result.success) {
this.context.stdout.write(colors.success('\n✓ All methodology packs installed!\n'));
@@ -195,15 +201,17 @@ export class MethodologyCommand extends Command {
private async syncSkills(projectPath: string): Promise<number> {
const manager = createMethodologyManager({ projectPath, autoSync: false });
this.context.stdout.write('Syncing methodology skills to detected agents...\n\n');
if (this.dryRun) {
const installed = manager.listInstalledSkills();
this.context.stdout.write(colors.warning(`[dry-run] Would sync ${installed.length} skills.\n`));
return 0;
}
const s = spinner();
s.start('Syncing methodology skills');
const result = await manager.syncAll();
s.stop('Sync complete');
if (result.synced.length > 0) {
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
+10 -5
View File
@@ -8,7 +8,7 @@ import { Command, Option } from 'clipanion';
import { join, isAbsolute, resolve, sep } from 'node:path';
import { homedir } from 'node:os';
import { existsSync, mkdirSync, copyFileSync, cpSync, rmSync } from 'node:fs';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createPluginManager, loadPlugin, loadPluginsFromDirectory } from '@skillkit/core';
export class PluginCommand extends Command {
@@ -149,7 +149,8 @@ export class PluginCommand extends Command {
? join(homedir(), this.source.slice(1))
: this.source;
this.context.stdout.write(`Installing plugin from ${this.source}...\n`);
const s = spinner();
s.start(`Installing plugin from ${this.source}`);
const plugin = await loadPlugin(resolvedSource);
@@ -222,6 +223,8 @@ export class PluginCommand extends Command {
await pluginManager.register(plugin);
s.stop('Plugin installed');
this.context.stdout.write(colors.success(`✓ Plugin "${plugin.metadata.name}" installed!\n`));
this.context.stdout.write(` Version: ${plugin.metadata.version}\n`);
if (plugin.metadata.description) {
@@ -254,9 +257,10 @@ export class PluginCommand extends Command {
return 1;
}
await pluginManager.unregister(this.name);
const s = spinner();
s.start(`Uninstalling plugin ${this.name}`);
// Remove plugin files from disk
await pluginManager.unregister(this.name);
const projectPath = this.global
? join(homedir(), '.skillkit')
: process.cwd();
@@ -275,9 +279,10 @@ export class PluginCommand extends Command {
if (existsSync(pluginDir)) {
rmSync(pluginDir, { recursive: true, force: true });
this.context.stdout.write(colors.muted(` Removed ${pluginDir}\n`));
}
s.stop('Plugin uninstalled');
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" uninstalled.\n`));
return 0;
}
+40 -15
View File
@@ -21,6 +21,10 @@ export class ReadCommand extends Command {
description: 'Show additional information',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
@@ -30,26 +34,35 @@ export class ReadCommand extends Command {
.filter(s => s.length > 0);
if (skillNames.length === 0) {
error('No skill names provided');
if (this.json) {
console.log(JSON.stringify({ error: 'No skill names provided' }));
} else {
error('No skill names provided');
}
return 1;
}
let exitCode = 0;
const jsonResults: Array<{ name: string; content: string; path: string }> = [];
for (const skillName of skillNames) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
if (!this.json) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
}
exitCode = 1;
continue;
}
if (!skill.enabled) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
if (!this.json) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
}
exitCode = 1;
continue;
}
@@ -57,20 +70,32 @@ export class ReadCommand extends Command {
const content = readSkillContent(skill.path);
if (!content) {
error(`Could not read SKILL.md for: ${skillName}`);
if (!this.json) error(`Could not read SKILL.md for: ${skillName}`);
exitCode = 1;
continue;
}
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (this.json) {
jsonResults.push({ name: skillName, content, path: skill.path });
} else {
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
}
}
}
if (this.json) {
if (jsonResults.length === 1) {
console.log(JSON.stringify(jsonResults[0]));
} else {
console.log(JSON.stringify(jsonResults));
}
}
+5 -1
View File
@@ -1,6 +1,6 @@
import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
import { join, dirname, basename } from 'node:path';
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator, removeSkillFromLock } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -89,6 +89,8 @@ export class RemoveCommand extends Command {
let failed = 0;
const removedNames: string[] = [];
const failedNames: string[] = [];
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Removing skills');
for (const { name: skillName, path: skillPath } of skillsToRemove) {
if (!existsSync(skillPath)) {
@@ -116,6 +118,8 @@ export class RemoveCommand extends Command {
}
}
s.stop(`Removed ${removed} skill(s)`);
if (removed > 0) {
try {
const agentsMdPath = join(process.cwd(), 'AGENTS.md');
+39 -16
View File
@@ -43,14 +43,26 @@ export class SaveCommand extends Command {
description: 'Local file path to save as a skill',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const sources = [this.url, this.text, this.file].filter(Boolean);
if (sources.length === 0) {
console.log(colors.error('Provide a URL, --text, or --file'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Provide a URL, --text, or --file' }));
} else {
console.log(colors.error('Provide a URL, --text, or --file'));
}
return 1;
}
if (sources.length > 1) {
console.log(colors.error('Provide only one of: URL, --text, or --file'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Provide only one of: URL, --text, or --file' }));
} else {
console.log(colors.error('Provide only one of: URL, --text, or --file'));
}
return 1;
}
@@ -58,7 +70,7 @@ export class SaveCommand extends Command {
const generator = new SkillGenerator();
const tagger = new AutoTagger();
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
try {
s.start('Extracting content');
@@ -82,15 +94,9 @@ export class SaveCommand extends Command {
global: this.global,
});
s.stop(colors.success('Skill saved'));
console.log('');
console.log(colors.bold(' Name: ') + colors.cyan(result.name));
console.log(colors.bold(' Path: ') + colors.muted(result.skillPath));
if (tags.length > 0) {
console.log(colors.bold(' Tags: ') + tags.map(t => colors.warning(t)).join(', '));
}
s.stop('Skill saved');
const installedAgents: string[] = [];
if (this.agent) {
const agents = this.agent.split(',').map(a => a.trim()).filter(Boolean);
const skillDir = dirname(result.skillPath);
@@ -101,18 +107,35 @@ export class SaveCommand extends Command {
const targetDir = join(adapter.skillsDir, result.name);
mkdirSync(targetDir, { recursive: true });
cpSync(skillDir, targetDir, { recursive: true });
console.log(colors.success(` Installed to ${agentName}: `) + colors.muted(targetDir));
installedAgents.push(agentName);
if (!this.json) {
console.log(colors.success(` Installed to ${agentName}: `) + colors.muted(targetDir));
}
} catch (err) {
warn(` Skipped ${agentName}: ${err instanceof Error ? err.message : String(err)}`);
if (!this.json) warn(` Skipped ${agentName}: ${err instanceof Error ? err.message : String(err)}`);
}
}
}
console.log('');
if (this.json) {
console.log(JSON.stringify({ success: true, name: result.name, path: result.skillPath, agents: installedAgents }));
} else {
console.log('');
console.log(colors.bold(' Name: ') + colors.cyan(result.name));
console.log(colors.bold(' Path: ') + colors.muted(result.skillPath));
if (tags.length > 0) {
console.log(colors.bold(' Tags: ') + tags.map(t => colors.warning(t)).join(', '));
}
console.log('');
}
return 0;
} catch (err) {
s.stop(colors.error('Failed'));
console.log(colors.error(err instanceof Error ? err.message : String(err)));
s.stop('Failed');
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
console.log(colors.error(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+33 -20
View File
@@ -53,16 +53,20 @@ export class SyncCommand extends Command {
description: 'Minimal output',
});
async execute(): Promise<number> {
const isInteractive = process.stdin.isTTY && !this.yes;
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
if (!this.quiet) {
async execute(): Promise<number> {
const isInteractive = process.stdin.isTTY && !this.yes && !this.json;
if (!this.quiet && !this.json) {
header('Sync Skills');
}
try {
let agentType: AgentType;
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (this.agent) {
agentType = this.agent as AgentType;
@@ -107,13 +111,16 @@ export class SyncCommand extends Command {
}
if (skills.length === 0) {
warn('No skills found to sync');
console.log(colors.muted('Install skills with: skillkit install <source>'));
if (this.json) {
console.log(JSON.stringify({ success: true, skills: 0, agent: agentType, configPath: '' }));
} else {
warn('No skills found to sync');
console.log(colors.muted('Install skills with: skillkit install <source>'));
}
return 0;
}
// Show skills to sync
if (!this.quiet) {
if (!this.quiet && !this.json) {
console.log('');
console.log(colors.bold(`Syncing ${skills.length} skill(s) for ${adapter.name}:`));
console.log('');
@@ -128,8 +135,7 @@ export class SyncCommand extends Command {
console.log('');
}
// Confirm sync
if (isInteractive && !this.yes) {
if (isInteractive && !this.yes && !this.json) {
const confirmResult = await confirm({
message: `Sync ${skills.length} skill(s) to ${outputPath}?`,
initialValue: true,
@@ -167,21 +173,28 @@ export class SyncCommand extends Command {
s.stop('Config generated');
// Show summary
showSyncSummary({
skillCount: skills.length,
agentType,
configPath: outputPath,
});
if (this.json) {
console.log(JSON.stringify({ success: true, skills: skills.length, agent: agentType, configPath: outputPath }));
} else {
showSyncSummary({
skillCount: skills.length,
agentType,
configPath: outputPath,
});
if (!this.quiet) {
outro('Sync complete!');
if (!this.quiet) {
outro('Sync complete!');
}
}
return 0;
} catch (err) {
console.log(colors.error('Sync failed'));
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
console.log(colors.error('Sync failed'));
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+47 -6
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import { colors, symbols, step, success, warn } from '../onboarding/index.js';
import { colors, symbols, step, success, warn, spinner } from '../onboarding/index.js';
import { loadTaps, saveTaps } from '../helpers.js';
export class TapAddCommand extends Command {
@@ -19,15 +19,26 @@ export class TapAddCommand extends Command {
description: 'Display name for the tap',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const taps = loadTaps();
const exists = taps.taps.some((t) => t.source === this.source);
if (exists) {
warn(`Tap already exists: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
warn(`Tap already exists: ${this.source}`);
}
return 0;
}
s.start('Adding tap');
taps.taps.push({
source: this.source,
name: this.name,
@@ -35,8 +46,14 @@ export class TapAddCommand extends Command {
});
saveTaps(taps);
success(`Added tap: ${this.source}${this.name ? ` (${this.name})` : ''}`);
console.log(colors.muted('Skills from this source will appear in search results'));
s.stop('Tap added');
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
success(`Added tap: ${this.source}${this.name ? ` (${this.name})` : ''}`);
console.log(colors.muted('Skills from this source will appear in search results'));
}
return 0;
}
}
@@ -53,19 +70,34 @@ export class TapRemoveCommand extends Command {
source = Option.String({ required: true });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const taps = loadTaps();
const idx = taps.taps.findIndex((t) => t.source === this.source);
if (idx === -1) {
warn(`Tap not found: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
warn(`Tap not found: ${this.source}`);
}
return 0;
}
s.start('Removing tap');
taps.taps.splice(idx, 1);
saveTaps(taps);
s.stop('Tap removed');
success(`Removed tap: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
success(`Removed tap: ${this.source}`);
}
return 0;
}
}
@@ -80,9 +112,18 @@ export class TapListCommand extends Command {
],
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const taps = loadTaps();
if (this.json) {
console.log(JSON.stringify({ taps: taps.taps }));
return 0;
}
if (taps.taps.length === 0) {
step('No custom taps configured');
console.log(colors.muted('Add one with: skillkit tap add owner/repo'));
+16 -2
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createTeamManager, createSkillBundle, exportBundle, importBundle } from '@skillkit/core';
import { join } from 'node:path';
@@ -82,10 +82,13 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Initializing team');
const config = await teamManager.init({
teamName: this.name,
registryUrl: this.registry,
});
s.stop('Team initialized');
this.context.stdout.write(colors.success('✓ Team initialized!\n'));
this.context.stdout.write(` Team ID: ${config.teamId}\n`);
@@ -105,11 +108,14 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Sharing skill');
const shared = await teamManager.shareSkill({
skillName: this.name,
description: this.description,
tags: this.tags?.split(',').map((t) => t.trim()),
});
s.stop('Skill shared');
this.context.stdout.write(colors.success('✓ Skill shared!\n'));
this.context.stdout.write(` Name: ${shared.name}\n`);
@@ -130,10 +136,13 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Importing skill');
const result = await teamManager.importSkill(this.name, {
overwrite: this.overwrite,
dryRun: this.dryRun,
});
s.stop('Import complete');
if (!result.success) {
this.context.stderr.write(colors.error(`✗ ${result.error}\n`));
@@ -184,9 +193,11 @@ export class TeamCommand extends Command {
return 1;
}
this.context.stdout.write(`Syncing with ${config.registryUrl}...\n`);
const s = spinner();
s.start(`Syncing with ${config.registryUrl}`);
const result = await teamManager.sync();
s.stop('Sync complete');
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
if (result.added.length > 0) {
@@ -335,7 +346,10 @@ export class TeamCommand extends Command {
return 0;
}
const s = spinner();
s.start('Importing bundle');
const result = importBundle(this.source, skillsDir, { overwrite: this.overwrite });
s.stop('Import complete');
if (!result.success && result.imported.length === 0) {
this.context.stderr.write(colors.error('✗ Failed to import bundle:\n'));
+5 -3
View File
@@ -1,7 +1,7 @@
import { Command, Option } from 'clipanion';
import { resolve, join } from 'node:path';
import { existsSync, readFileSync, readdirSync } from 'node:fs';
import { colors, warn, success, error, step } from '../onboarding/index.js';
import { colors, warn, success, error, step, spinner } from '../onboarding/index.js';
import {
runTestSuite,
createTestSuiteFromFrontmatter,
@@ -105,16 +105,16 @@ export class TestCommand extends Command {
return 1;
}
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!this.json) {
console.log(colors.bold('Running skill tests...\n'));
}
// Parse tags
const tags = this.tags?.split(',').map((t) => t.trim());
const skipTags = this.skipTags?.split(',').map((t) => t.trim());
const timeout = this.timeout ? parseInt(this.timeout, 10) : undefined;
// Run tests for each skill
const results: TestSuiteResult[] = [];
let allPassed = true;
@@ -128,6 +128,7 @@ export class TestCommand extends Command {
if (!this.json) {
step(`Testing: ${suite.skillName}`);
}
s.start(`Running ${suite.skillName}`);
const result = await runTestSuite(suite, {
cwd: targetPath,
@@ -162,6 +163,7 @@ export class TestCommand extends Command {
},
});
s.stop(`Completed ${suite.skillName}`);
results.push(result);
if (!result.passed) {
+61 -36
View File
@@ -89,6 +89,10 @@ export class TranslateCommand extends Command {
description: 'Show compatibility info between agents',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
// List supported agents
if (this.list) {
@@ -218,15 +222,21 @@ export class TranslateCommand extends Command {
const skills = findAllSkills(searchDirs);
if (skills.length === 0) {
warn('No skills found to translate');
if (this.json) {
console.log(JSON.stringify({ success: true, translated: 0, agent: targetAgent }));
} else {
warn('No skills found to translate');
}
return 0;
}
console.log(colors.bold(`\nTranslating ${skills.length} skill(s) to ${targetAgent}...\n`));
if (!this.json) {
console.log(colors.bold(`\nTranslating ${skills.length} skill(s) to ${targetAgent}...\n`));
}
let successCount = 0;
let failed = 0;
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
for (const skill of skills) {
const skillMdPath = join(skill.path, 'SKILL.md');
@@ -289,8 +299,12 @@ export class TranslateCommand extends Command {
}
}
console.log();
console.log(colors.bold(`Translated: ${successCount}, Failed: ${failed}`));
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, translated: successCount, agent: targetAgent }));
} else {
console.log();
console.log(colors.bold(`Translated: ${successCount}, Failed: ${failed}`));
}
return failed > 0 ? 1 : 0;
}
@@ -336,8 +350,7 @@ export class TranslateCommand extends Command {
}
}
// Read and translate
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start(`Translating to ${targetAgent}...`);
const content = readFileSync(sourcePath!, 'utf-8');
@@ -349,39 +362,45 @@ export class TranslateCommand extends Command {
s.stop(`Translation complete`);
if (!result.success) {
error('Translation failed:');
for (const item of result.incompatible) {
console.log(colors.muted(` ${item}`));
if (this.json) {
console.log(JSON.stringify({ success: false, translated: 0, agent: targetAgent }));
} else {
error('Translation failed:');
for (const item of result.incompatible) {
console.log(colors.muted(` ${item}`));
}
}
return 1;
}
// Show warnings
if (result.warnings.length > 0) {
warn('\nWarnings:');
for (const warning of result.warnings) {
console.log(colors.warning(` • ${warning}`));
if (!this.json) {
if (result.warnings.length > 0) {
warn('\nWarnings:');
for (const warning of result.warnings) {
console.log(colors.warning(` • ${warning}`));
}
}
if (result.incompatible.length > 0) {
console.log(colors.muted('\nIncompatible features:'));
for (const item of result.incompatible) {
console.log(colors.muted(` • ${item}`));
}
}
}
// Show incompatible features
if (result.incompatible.length > 0) {
console.log(colors.muted('\nIncompatible features:'));
for (const item of result.incompatible) {
console.log(colors.muted(` • ${item}`));
}
}
// Dry run - just show preview
if (this.dryRun) {
console.log(colors.bold(`\nTranslated content (${result.filename}):\n`));
console.log(colors.muted('─'.repeat(60)));
console.log(result.content);
console.log(colors.muted('─'.repeat(60)));
if (this.json) {
console.log(JSON.stringify({ success: true, translated: 1, agent: targetAgent }));
} else {
console.log(colors.bold(`\nTranslated content (${result.filename}):\n`));
console.log(colors.muted('─'.repeat(60)));
console.log(result.content);
console.log(colors.muted('─'.repeat(60)));
}
return 0;
}
// Determine output path
let outputPath: string;
if (this.output) {
outputPath = this.output;
@@ -396,14 +415,16 @@ export class TranslateCommand extends Command {
outputPath = join(outputDir, result.filename);
}
// Check for existing file
if (existsSync(outputPath) && !this.force) {
error(`${outputPath} already exists`);
console.log(colors.muted('Use --force to overwrite'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: `${outputPath} already exists` }));
} else {
error(`${outputPath} already exists`);
console.log(colors.muted('Use --force to overwrite'));
}
return 1;
}
// Write output
const outputDir = dirname(outputPath);
if (!existsSync(outputDir)) {
mkdirSync(outputDir, { recursive: true });
@@ -411,9 +432,13 @@ export class TranslateCommand extends Command {
writeFileSync(outputPath, result.content, 'utf-8');
success(`\n✓ Translated to ${outputPath}`);
console.log(colors.muted(` Format: ${result.targetFormat}`));
console.log(colors.muted(` Agent: ${result.targetAgent}`));
if (this.json) {
console.log(JSON.stringify({ success: true, translated: 1, agent: targetAgent }));
} else {
success(`\n✓ Translated to ${outputPath}`);
console.log(colors.muted(` Format: ${result.targetFormat}`));
console.log(colors.muted(` Agent: ${result.targetAgent}`));
}
return 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.0",
"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.0",
"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/mcp",
"version": "1.22.0",
"version": "1.22.1",
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/memory",
"version": "1.22.0",
"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.0",
"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.0",
"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.0",
"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.0",
"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}`);
}