Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
145bf80342 | ||
|
|
49bcd85abf | ||
|
|
2843bd3c5c | ||
|
|
aea3b3ba32 | ||
|
|
97ee4b9a43 | ||
|
|
c8d0bbc844 | ||
|
|
ae8c7a1abb | ||
|
|
196a959569 | ||
|
|
23d1c8932a | ||
|
|
0c82c58905 | ||
|
|
1ce9751797 | ||
|
|
6485745295 | ||
|
|
e9014e130c | ||
|
|
9e50c8abe1 | ||
|
|
49fcc532d2 | ||
|
|
ecead6585c | ||
|
|
cc2eb2504c | ||
|
|
5d7ca0cd8e | ||
|
|
eda488c960 | ||
|
|
559b760202 | ||
|
|
ebd26b7c84 | ||
|
|
8ec5b9d8f2 | ||
|
|
0cba1be49c |
@@ -0,0 +1,87 @@
|
||||
# SkillKit GitHub Action
|
||||
|
||||
A reusable composite action to install, scan, and manage AI agent skills in CI/CD pipelines.
|
||||
|
||||
## Usage
|
||||
|
||||
```yaml
|
||||
# Install skills
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: install
|
||||
source: anthropics/skills
|
||||
|
||||
# Security scan
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: scan
|
||||
source: ./skills
|
||||
|
||||
# Check for updates
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: check
|
||||
```
|
||||
|
||||
## Inputs
|
||||
|
||||
| Input | Description | Required | Default |
|
||||
|-------|-------------|----------|---------|
|
||||
| `command` | SkillKit command to run (`install`, `scan`, `check`, `sync`) | Yes | |
|
||||
| `source` | Skill source for install (e.g. `owner/repo`) | No | |
|
||||
| `args` | Additional arguments | No | `''` |
|
||||
| `node-version` | Node.js version | No | `20` |
|
||||
| `agent` | Target agent (e.g. `claude-code`, `cursor`) | No | `claude-code` |
|
||||
|
||||
## Examples
|
||||
|
||||
### Install and sync skills
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
setup-skills:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: install
|
||||
source: anthropics/skills
|
||||
agent: cursor
|
||||
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: sync
|
||||
```
|
||||
|
||||
### Security scan on PR
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
scan-skills:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: scan
|
||||
source: ./skills
|
||||
args: '--fail-on high'
|
||||
```
|
||||
|
||||
### Check for updates
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
check-updates:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: rohitg00/skillkit/.github/actions/skillkit@main
|
||||
with:
|
||||
command: check
|
||||
args: '--json'
|
||||
```
|
||||
@@ -0,0 +1,65 @@
|
||||
name: 'SkillKit'
|
||||
description: 'Install, scan, and manage AI agent skills in CI/CD'
|
||||
inputs:
|
||||
command:
|
||||
description: 'SkillKit command to run (install, scan, check, sync)'
|
||||
required: true
|
||||
source:
|
||||
description: 'Skill source for install (e.g. owner/repo)'
|
||||
required: false
|
||||
args:
|
||||
description: 'Additional arguments'
|
||||
required: false
|
||||
default: ''
|
||||
node-version:
|
||||
description: 'Node.js version'
|
||||
required: false
|
||||
default: '20'
|
||||
agent:
|
||||
description: 'Target agent (e.g. claude-code, cursor)'
|
||||
required: false
|
||||
default: 'claude-code'
|
||||
|
||||
runs:
|
||||
using: 'composite'
|
||||
steps:
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: ${{ inputs.node-version }}
|
||||
|
||||
- name: Install SkillKit
|
||||
shell: bash
|
||||
run: npm install -g skillkit@latest
|
||||
|
||||
- name: Run SkillKit
|
||||
shell: bash
|
||||
env:
|
||||
SK_COMMAND: ${{ inputs.command }}
|
||||
SK_SOURCE: ${{ inputs.source }}
|
||||
SK_AGENT: ${{ inputs.agent }}
|
||||
SK_ARGS: ${{ inputs.args }}
|
||||
run: |
|
||||
case "${SK_COMMAND}" in
|
||||
install)
|
||||
if [ -n "${SK_SOURCE}" ]; then
|
||||
skillkit install "${SK_SOURCE}" --agent "${SK_AGENT}" --yes --json ${SK_ARGS}
|
||||
else
|
||||
echo "Error: source is required for install" >&2; exit 1
|
||||
fi
|
||||
;;
|
||||
scan)
|
||||
if [ -n "${SK_SOURCE}" ]; then
|
||||
skillkit scan "${SK_SOURCE}" --json ${SK_ARGS}
|
||||
else
|
||||
echo "Error: source is required for scan" >&2; exit 1
|
||||
fi
|
||||
;;
|
||||
check|sync|list|update)
|
||||
skillkit "${SK_COMMAND}" ${SK_ARGS}
|
||||
;;
|
||||
*)
|
||||
echo "Error: unsupported command '${SK_COMMAND}'. Use: install, scan, check, sync, list, update" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
@@ -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/>
|
||||
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](LICENSE)
|
||||
|
||||
**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) · [Docs](https://skillkit.sh/docs) · [API Explorer](https://skillkit.sh/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
<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">
|
||||
|
||||

|
||||
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) · [MCP Server docs](https://skillkit.sh/docs/mcp-server) · [Python Client docs](https://skillkit.sh/docs/python-client) · [Interactive API explorer](https://skillkit.sh/api)
|
||||
[REST docs](https://skillkit.sh/docs/rest-api) · [MCP docs](https://skillkit.sh/docs/mcp-server) · [Python client](https://skillkit.sh/docs/python-client)
|
||||
</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 · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `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>
|
||||
|
||||

|
||||
<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) · [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)
|
||||
[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) · [Website](https://skillkit.sh) · [API Explorer](https://skillkit.sh/api) · [npm](https://www.npmjs.com/package/skillkit) · [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>
|
||||
|
||||
@@ -1,11 +1,49 @@
|
||||
# SkillKit
|
||||
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 32 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 45 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
|
||||
## 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
|
||||
@@ -150,11 +188,11 @@ skillkit memory compress
|
||||
skillkit memory export auth-insight --output auth-skill.md
|
||||
```
|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents (45)
|
||||
|
||||
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
**Primary (18):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
|
||||
**Extended (15):** Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
|
||||
**Extended (27):** Aider, Amazon Q, Augment Code, Bolt, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Devin, Factory, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode Agent, Qoder, Qwen, Replit Agent, Sourcegraph Cody, Tabby, Tabnine, Vercel, Zencoder
|
||||
|
||||
## Usage Examples
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.21.0",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"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": {
|
||||
"skillkit": "./dist/cli.js",
|
||||
@@ -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",
|
||||
|
||||
@@ -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>));
|
||||
}
|
||||
|
||||
@@ -7,4 +7,7 @@ export default defineConfig({
|
||||
splitting: false,
|
||||
sourcemap: true,
|
||||
clean: true,
|
||||
platform: 'node',
|
||||
target: 'node18',
|
||||
skipNodeModulesBundle: true,
|
||||
});
|
||||
|
||||
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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 |
@@ -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,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -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 <owner/repo></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
|
||||
|
||||
@@ -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 <owner/repo></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,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 45 coding agents",
|
||||
"type": "module",
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[](https://www.npmjs.com/package/@skillkit/agents)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**Agent adapters for SkillKit** - configuration and detection for 32 AI coding agents.
|
||||
**Agent adapters for SkillKit** - configuration and detection for 45 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
npm install @skillkit/agents
|
||||
```
|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents (45)
|
||||
|
||||
| Agent | Config Format | Project Skills | Global Skills |
|
||||
|-------|--------------|----------------|---------------|
|
||||
@@ -23,11 +23,14 @@ npm install @skillkit/agents
|
||||
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
|
||||
| Amp | SKILL.md | `.amp/skills/` | - |
|
||||
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
|
||||
| OpenClaw | SKILL.md | `skills/` | - |
|
||||
| Cline | SKILL.md | `.cline/skills/` | - |
|
||||
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
|
||||
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
|
||||
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
|
||||
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
|
||||
| Crush | SKILL.md | `.crush/skills/` | - |
|
||||
| Devin | SKILL.md | `.devin/skills/` | - |
|
||||
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
|
||||
| Factory | SKILL.md | `.factory/skills/` | - |
|
||||
| GitHub Copilot | Markdown | `.github/skills/` | - |
|
||||
@@ -39,6 +42,7 @@ npm install @skillkit/agents
|
||||
| Neovate | SKILL.md | `.neovate/skills/` | - |
|
||||
| OpenHands | SKILL.md | `.openhands/skills/` | - |
|
||||
| Pi | SKILL.md | `.pi/skills/` | - |
|
||||
| PlayCode Agent | SKILL.md | `.playcode/skills/` | - |
|
||||
| Qoder | SKILL.md | `.qoder/skills/` | - |
|
||||
| Qwen | SKILL.md | `.qwen/skills/` | - |
|
||||
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
|
||||
@@ -46,6 +50,15 @@ npm install @skillkit/agents
|
||||
| Vercel | SKILL.md | `.vercel/skills/` | - |
|
||||
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
|
||||
| Zencoder | SKILL.md | `.zencoder/skills/` | - |
|
||||
| Aider | SKILL.md | `.aider/skills/` | - |
|
||||
| Amazon Q | SKILL.md | `.amazonq/skills/` | - |
|
||||
| Augment Code | SKILL.md | `.augment/skills/` | - |
|
||||
| Bolt | SKILL.md | `.bolt/skills/` | - |
|
||||
| Lovable | SKILL.md | `.lovable/skills/` | - |
|
||||
| Replit Agent | SKILL.md | `.replit/skills/` | - |
|
||||
| Sourcegraph Cody | SKILL.md | `.cody/skills/` | - |
|
||||
| Tabby | SKILL.md | `.tabby/skills/` | - |
|
||||
| Tabnine | SKILL.md | `.tabnine/skills/` | - |
|
||||
| Universal | SKILL.md | `skills/` | - |
|
||||
|
||||
## Usage
|
||||
@@ -170,11 +183,14 @@ type AgentType =
|
||||
| 'antigravity'
|
||||
| 'amp'
|
||||
| 'clawdbot'
|
||||
| 'openclaw'
|
||||
| 'cline'
|
||||
| 'codebuddy'
|
||||
| 'codegpt'
|
||||
| 'commandcode'
|
||||
| 'continue'
|
||||
| 'crush'
|
||||
| 'devin'
|
||||
| 'droid'
|
||||
| 'factory'
|
||||
| 'github-copilot'
|
||||
@@ -186,6 +202,7 @@ type AgentType =
|
||||
| 'neovate'
|
||||
| 'openhands'
|
||||
| 'pi'
|
||||
| 'playcode-agent'
|
||||
| 'qoder'
|
||||
| 'qwen'
|
||||
| 'roo'
|
||||
@@ -193,6 +210,15 @@ type AgentType =
|
||||
| 'vercel'
|
||||
| 'windsurf'
|
||||
| 'zencoder'
|
||||
| 'aider'
|
||||
| 'amazon-q'
|
||||
| 'augment-code'
|
||||
| 'bolt'
|
||||
| 'lovable'
|
||||
| 'replit-agent'
|
||||
| 'sourcegraph-cody'
|
||||
| 'tabby'
|
||||
| 'tabnine'
|
||||
| 'universal';
|
||||
```
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.21.0",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"version": "1.23.0",
|
||||
"description": "Agent adapters for SkillKit - supports 45 AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/api",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[](https://www.npmjs.com/package/@skillkit/cli)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 45 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -264,7 +264,7 @@ const recs = await recommendCommand({
|
||||
| Gemini CLI | SKILL.md |
|
||||
| Windsurf | Markdown |
|
||||
| GitHub Copilot | Markdown |
|
||||
| + 26 more | SKILL.md |
|
||||
| + 39 more | SKILL.md |
|
||||
|
||||
## Documentation
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.21.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",
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
@@ -52,11 +52,15 @@ export class CheckCommand extends Command {
|
||||
description: 'Minimal output',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
const s = spinner();
|
||||
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
|
||||
if (!this.quiet) {
|
||||
if (!this.quiet && !this.json) {
|
||||
header('Check Updates');
|
||||
}
|
||||
|
||||
@@ -85,7 +89,7 @@ export class CheckCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (!this.quiet) {
|
||||
if (!this.quiet && !this.json) {
|
||||
step(`Checking ${skillsToCheck.length} skill(s) for updates...`);
|
||||
console.log('');
|
||||
}
|
||||
@@ -195,6 +199,19 @@ export class CheckCommand extends Command {
|
||||
}
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
skills: results.map((r) => ({
|
||||
name: r.name,
|
||||
hasUpdate: r.hasUpdate,
|
||||
quality: r.qualityScore ?? null,
|
||||
stars: r.stars ?? null,
|
||||
})),
|
||||
updatesAvailable,
|
||||
}));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
const withUpdates = results.filter(r => r.hasUpdate);
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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'));
|
||||
}
|
||||
|
||||
|
||||
@@ -12,6 +12,7 @@ import {
|
||||
CommunitySignalsEvaluator,
|
||||
} from '@skillkit/core';
|
||||
import type { EvalTier, EvalOptions } from '@skillkit/core';
|
||||
import { spinner } from '../onboarding/index.js';
|
||||
|
||||
export class EvalCommand extends Command {
|
||||
static override paths = [['eval']];
|
||||
@@ -74,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);
|
||||
|
||||
@@ -132,14 +137,30 @@ export class EvalCommand extends Command {
|
||||
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
|
||||
engine.registerEvaluator(new CommunitySignalsEvaluator());
|
||||
|
||||
const result = await engine.evaluate(targetPath, options);
|
||||
const isJson = this.json || this.format === 'json';
|
||||
const s = isJson ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
s.start('Evaluating skill...');
|
||||
let result;
|
||||
try {
|
||||
result = await engine.evaluate(targetPath, options);
|
||||
s.stop(`Evaluation complete (score: ${result.overallScore})`);
|
||||
} catch (err) {
|
||||
s.stop('Evaluation failed');
|
||||
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;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -65,11 +65,15 @@ export class FindCommand extends Command {
|
||||
hidden: true,
|
||||
});
|
||||
|
||||
json = Option.Boolean("--json", false, {
|
||||
description: "Output as JSON",
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const s = spinner();
|
||||
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
const limit = parseInt(this.limit, 10) || 10;
|
||||
|
||||
if (!this.quiet) {
|
||||
if (!this.quiet && !this.json) {
|
||||
header("Find Skills");
|
||||
}
|
||||
|
||||
@@ -117,7 +121,7 @@ export class FindCommand extends Command {
|
||||
)
|
||||
.slice(0, limit);
|
||||
|
||||
if (!this.quiet) {
|
||||
if (!this.quiet && !this.json) {
|
||||
step("Showing featured skills");
|
||||
}
|
||||
} else if (this.query) {
|
||||
@@ -138,7 +142,7 @@ export class FindCommand extends Command {
|
||||
|
||||
s.stop(`Found ${results.length} skill(s)`);
|
||||
} else {
|
||||
if (!this.quiet) {
|
||||
if (!this.quiet && !this.json) {
|
||||
step("Enter a search term or browse featured skills");
|
||||
}
|
||||
|
||||
@@ -252,6 +256,18 @@ export class FindCommand extends Command {
|
||||
}
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
results: results.map((r) => ({
|
||||
name: r.name,
|
||||
description: r.description || "",
|
||||
source: r.source,
|
||||
})),
|
||||
total: results.length,
|
||||
}));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(colors.muted("No skills found matching your search"));
|
||||
console.log("");
|
||||
|
||||
@@ -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}`);
|
||||
|
||||
@@ -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`));
|
||||
|
||||
|
||||
@@ -133,14 +133,18 @@ export class InstallCommand extends Command {
|
||||
description: "Run security scan before installing (default: true)",
|
||||
});
|
||||
|
||||
json = Option.Boolean("--json", false, {
|
||||
description: "Output as JSON",
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const isInteractive =
|
||||
process.stdin.isTTY && !this.skills && !this.all && !this.yes;
|
||||
const s = spinner();
|
||||
process.stdin.isTTY && !this.skills && !this.all && !this.yes && !this.json;
|
||||
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
let cloneResult: Awaited<ReturnType<typeof this.resolveSource>>["cloneResult"] = null;
|
||||
|
||||
try {
|
||||
if (process.stdin.isTTY && !this.quiet) {
|
||||
if (process.stdin.isTTY && !this.quiet && !this.json) {
|
||||
welcome();
|
||||
}
|
||||
|
||||
@@ -182,8 +186,12 @@ export class InstallCommand extends Command {
|
||||
|
||||
return 0;
|
||||
} catch (err) {
|
||||
s.stop(colors.error("Installation 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 {
|
||||
s.stop(colors.error("Installation failed"));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
}
|
||||
return 1;
|
||||
} finally {
|
||||
if (cloneResult) this.cleanupTemp(cloneResult);
|
||||
@@ -349,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`);
|
||||
|
||||
@@ -356,6 +366,7 @@ export class InstallCommand extends Command {
|
||||
message: "Install to",
|
||||
agents: allAgentTypes,
|
||||
lastSelected: lastAgents,
|
||||
detected: detectedAgent,
|
||||
});
|
||||
|
||||
if (isCancel(agentResult)) {
|
||||
@@ -364,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 };
|
||||
}
|
||||
@@ -657,6 +672,16 @@ export class InstallCommand extends Command {
|
||||
providerAdapter: ReturnType<typeof detectProvider>,
|
||||
isInteractive: boolean,
|
||||
): Promise<void> {
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
success: true,
|
||||
installed: installResults.map((r) => r.skillName),
|
||||
agents: targetAgents,
|
||||
total: installResults.length,
|
||||
}));
|
||||
return;
|
||||
}
|
||||
|
||||
if (installResults.length > 0) {
|
||||
if (isInteractive) {
|
||||
showInstallSummary({
|
||||
|
||||
@@ -59,7 +59,14 @@ export class ListCommand extends Command {
|
||||
: skills.map(s => ({ ...s, quality: null as number | null }));
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(skillsWithQuality, null, 2));
|
||||
console.log(JSON.stringify({
|
||||
skills: skillsWithQuality.map((s) => ({
|
||||
name: s.name,
|
||||
enabled: s.enabled,
|
||||
path: s.path,
|
||||
})),
|
||||
total: skillsWithQuality.length,
|
||||
}));
|
||||
return 0;
|
||||
}
|
||||
|
||||
|
||||
@@ -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'));
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
@@ -13,6 +13,7 @@ import {
|
||||
success,
|
||||
error,
|
||||
step,
|
||||
spinner,
|
||||
formatQualityBadge,
|
||||
getQualityGradeFromScore,
|
||||
} from "../onboarding/index.js";
|
||||
@@ -146,10 +147,13 @@ export class PublishCommand extends Command {
|
||||
const basePath = this.skillPath || process.cwd();
|
||||
const outputDir = this.output || basePath;
|
||||
|
||||
step("Generating well-known skills structure...\n");
|
||||
const s = spinner();
|
||||
s.start("Generating well-known skills structure...");
|
||||
|
||||
const discoveredSkills = this.discoverSkills(basePath);
|
||||
|
||||
s.stop(`Discovered ${discoveredSkills.length} skill(s)`);
|
||||
|
||||
if (discoveredSkills.length === 0) {
|
||||
error("No skills found");
|
||||
console.error(
|
||||
@@ -453,6 +457,10 @@ export class PublishSubmitCommand extends Command {
|
||||
description: "Show what would be submitted",
|
||||
});
|
||||
|
||||
json = Option.Boolean("--json", false, {
|
||||
description: "Output as JSON",
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const skillPath = this.skillPath || process.cwd();
|
||||
const skillMdPath = this.findSkillMd(skillPath);
|
||||
@@ -465,7 +473,7 @@ export class PublishSubmitCommand extends Command {
|
||||
return 1;
|
||||
}
|
||||
|
||||
step("Submitting skill to SkillKit marketplace...\n");
|
||||
if (!this.json) step("Submitting skill to SkillKit marketplace...\n");
|
||||
|
||||
const content = readFileSync(skillMdPath, "utf-8");
|
||||
const frontmatter = this.parseFrontmatter(content);
|
||||
@@ -508,26 +516,28 @@ export class PublishSubmitCommand extends Command {
|
||||
tags: frontmatter.tags || ["general"],
|
||||
};
|
||||
|
||||
console.log(colors.primary("Skill details:"));
|
||||
console.log(colors.muted(` ID: ${skillEntry.id}`));
|
||||
console.log(colors.muted(` Name: ${skillEntry.name}`));
|
||||
console.log(colors.muted(` Description: ${skillEntry.description}`));
|
||||
console.log(colors.muted(` Source: ${skillEntry.source}`));
|
||||
console.log(colors.muted(` Tags: ${skillEntry.tags.join(", ")}`));
|
||||
console.log(colors.muted(` Quality: ${qualityBadge}${qualityScore !== null ? ` (${qualityScore}/100)` : ""}`));
|
||||
if (activity) {
|
||||
const stars = formatCount(activity.stars);
|
||||
const pushed = activity.pushedAt ? timeAgo(activity.pushedAt) : "unknown";
|
||||
console.log(colors.muted(` Stars: ${stars}`));
|
||||
console.log(colors.muted(` Last push: ${pushed}`));
|
||||
}
|
||||
if (quality && quality.warnings.length > 0) {
|
||||
console.log(colors.warning(` Warnings:`));
|
||||
for (const w of quality.warnings.slice(0, 3)) {
|
||||
console.log(colors.muted(` - ${w}`));
|
||||
if (!this.json) {
|
||||
console.log(colors.primary("Skill details:"));
|
||||
console.log(colors.muted(` ID: ${skillEntry.id}`));
|
||||
console.log(colors.muted(` Name: ${skillEntry.name}`));
|
||||
console.log(colors.muted(` Description: ${skillEntry.description}`));
|
||||
console.log(colors.muted(` Source: ${skillEntry.source}`));
|
||||
console.log(colors.muted(` Tags: ${skillEntry.tags.join(", ")}`));
|
||||
console.log(colors.muted(` Quality: ${qualityBadge}${qualityScore !== null ? ` (${qualityScore}/100)` : ""}`));
|
||||
if (activity) {
|
||||
const stars = formatCount(activity.stars);
|
||||
const pushed = activity.pushedAt ? timeAgo(activity.pushedAt) : "unknown";
|
||||
console.log(colors.muted(` Stars: ${stars}`));
|
||||
console.log(colors.muted(` Last push: ${pushed}`));
|
||||
}
|
||||
if (quality && quality.warnings.length > 0) {
|
||||
console.log(colors.warning(` Warnings:`));
|
||||
for (const w of quality.warnings.slice(0, 3)) {
|
||||
console.log(colors.muted(` - ${w}`));
|
||||
}
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
console.log();
|
||||
|
||||
if (this.dryRun) {
|
||||
warn("Dry run - not submitting");
|
||||
@@ -566,6 +576,15 @@ export class PublishSubmitCommand extends Command {
|
||||
},
|
||||
).trim();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
success: true,
|
||||
source: `${repoInfo.owner}/${repoInfo.repo}`,
|
||||
quality: qualityScore,
|
||||
issueUrl: result || "",
|
||||
}));
|
||||
return 0;
|
||||
}
|
||||
success("Submission created!");
|
||||
if (result) {
|
||||
console.log(colors.muted(` ${result}`));
|
||||
|
||||
@@ -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));
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -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';
|
||||
@@ -33,6 +33,10 @@ export class RemoveCommand extends Command {
|
||||
description: 'Skip confirmation',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
|
||||
@@ -51,22 +55,30 @@ export class RemoveCommand extends Command {
|
||||
return meta?.source?.includes(this.source!) ?? false;
|
||||
}).map((s) => ({ name: s.name, path: s.path }));
|
||||
if (skillsToRemove.length === 0) {
|
||||
warn(`No skills found from source: ${this.source}`);
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ success: true, removed: [], failed: [], total: 0 }));
|
||||
} else {
|
||||
warn(`No skills found from source: ${this.source}`);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
} else {
|
||||
skillsToRemove = allSkills.map((s) => ({ name: s.name, path: s.path }));
|
||||
if (skillsToRemove.length === 0) {
|
||||
warn('No installed skills found');
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ success: true, removed: [], failed: [], total: 0 }));
|
||||
} else {
|
||||
warn('No installed skills found');
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
console.log(colors.muted(`Found ${skillsToRemove.length} skill(s) to remove`));
|
||||
if (!this.json) console.log(colors.muted(`Found ${skillsToRemove.length} skill(s) to remove`));
|
||||
} else {
|
||||
for (const skillName of this.skills) {
|
||||
const skill = findSkill(skillName, searchDirs);
|
||||
if (!skill) {
|
||||
warn(`Skill not found: ${skillName}`);
|
||||
if (!this.json) warn(`Skill not found: ${skillName}`);
|
||||
continue;
|
||||
}
|
||||
skillsToRemove.push({ name: skill.name, path: skill.path });
|
||||
@@ -75,6 +87,10 @@ export class RemoveCommand extends Command {
|
||||
|
||||
let removed = 0;
|
||||
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)) {
|
||||
@@ -89,15 +105,21 @@ export class RemoveCommand extends Command {
|
||||
if (existsSync(metaSibling)) rmSync(metaSibling);
|
||||
}
|
||||
removeSkillFromLock(skillName);
|
||||
success(`Removed: ${skillName}`);
|
||||
removedNames.push(skillName);
|
||||
if (!this.json) success(`Removed: ${skillName}`);
|
||||
removed++;
|
||||
} catch (err) {
|
||||
error(`Failed to remove: ${skillName}`);
|
||||
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
failedNames.push(skillName);
|
||||
if (!this.json) {
|
||||
error(`Failed to remove: ${skillName}`);
|
||||
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
}
|
||||
failed++;
|
||||
}
|
||||
}
|
||||
|
||||
s.stop(`Removed ${removed} skill(s)`);
|
||||
|
||||
if (removed > 0) {
|
||||
try {
|
||||
const agentsMdPath = join(process.cwd(), 'AGENTS.md');
|
||||
@@ -115,7 +137,19 @@ export class RemoveCommand extends Command {
|
||||
warn('Warning: Failed to update AGENTS.md');
|
||||
console.error(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
}
|
||||
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
|
||||
if (!this.json) {
|
||||
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
|
||||
}
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({
|
||||
success: failed === 0,
|
||||
removed: removedNames,
|
||||
failed: failedNames,
|
||||
total: removed + failed,
|
||||
}));
|
||||
return failed > 0 ? 1 : 0;
|
||||
}
|
||||
|
||||
return failed > 0 ? 1 : 0;
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import { existsSync } from 'node:fs';
|
||||
import { SkillScanner, formatResult, Severity } from '@skillkit/core';
|
||||
import { error } from '../onboarding/index.js';
|
||||
import { error, spinner } from '../onboarding/index.js';
|
||||
|
||||
const SEVERITY_MAP: Record<string, Severity> = {
|
||||
critical: Severity.CRITICAL,
|
||||
@@ -47,6 +47,10 @@ export class ScanCommand extends Command {
|
||||
description: 'Comma-separated rule IDs or categories to skip',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const targetPath = resolve(this.skillPath);
|
||||
|
||||
@@ -77,7 +81,21 @@ export class ScanCommand extends Command {
|
||||
skipRules,
|
||||
});
|
||||
|
||||
const result = await scanner.scan(targetPath);
|
||||
const s = this.json ? { start: () => {}, stop: () => {} } : spinner();
|
||||
s.start('Scanning for vulnerabilities...');
|
||||
let result;
|
||||
try {
|
||||
result = await scanner.scan(targetPath);
|
||||
s.stop(`Scan complete (${result.findings.length} finding(s))`);
|
||||
} catch (err) {
|
||||
s.stop('Scan failed');
|
||||
throw err;
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
this.context.stdout.write(formatResult(result, 'json') + '\n');
|
||||
return result.verdict === 'fail' ? 1 : 0;
|
||||
}
|
||||
|
||||
this.context.stdout.write(formatResult(result, this.format) + '\n');
|
||||
|
||||
|
||||
@@ -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;
|
||||
@@ -91,8 +95,9 @@ export class SyncCommand extends Command {
|
||||
|
||||
agentType = agentResult as AgentType;
|
||||
} else {
|
||||
// Non-interactive: always detect, don't rely on default config
|
||||
s.start('Detecting agent...');
|
||||
agentType = await detectAgent();
|
||||
s.stop(`Detected: ${formatAgent(agentType)}`);
|
||||
}
|
||||
|
||||
const adapter = getAdapter(agentType);
|
||||
@@ -106,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('');
|
||||
@@ -127,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,
|
||||
@@ -166,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;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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'));
|
||||
|
||||
@@ -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'));
|
||||
|
||||
@@ -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) {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
|
||||
import { join, basename, dirname } from 'node:path';
|
||||
import { colors, warn, success, error } from '../onboarding/index.js';
|
||||
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
|
||||
import {
|
||||
type AgentType,
|
||||
translateSkill,
|
||||
@@ -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,14 +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 = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
|
||||
for (const skill of skills) {
|
||||
const skillMdPath = join(skill.path, 'SKILL.md');
|
||||
@@ -235,10 +246,14 @@ export class TranslateCommand extends Command {
|
||||
continue;
|
||||
}
|
||||
|
||||
s.start(`Translating ${skill.name}...`);
|
||||
|
||||
const result = translateSkillFile(skillMdPath, targetAgent, {
|
||||
addMetadata: this.metadata,
|
||||
});
|
||||
|
||||
s.stop(`Translated ${skill.name}`);
|
||||
|
||||
if (result.success) {
|
||||
if (this.dryRun) {
|
||||
success(` ✓ ${skill.name} → ${result.filename} (dry run)`);
|
||||
@@ -284,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;
|
||||
}
|
||||
@@ -331,47 +350,57 @@ export class TranslateCommand extends Command {
|
||||
}
|
||||
}
|
||||
|
||||
// Read and translate
|
||||
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
s.start(`Translating to ${targetAgent}...`);
|
||||
|
||||
const content = readFileSync(sourcePath!, 'utf-8');
|
||||
const result = translateSkill(content, targetAgent, {
|
||||
addMetadata: this.metadata,
|
||||
sourceFilename: basename(sourcePath!),
|
||||
});
|
||||
|
||||
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;
|
||||
@@ -386,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 });
|
||||
@@ -401,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;
|
||||
}
|
||||
|
||||
@@ -23,8 +23,12 @@ export class UpdateCommand extends Command {
|
||||
description: 'Force update even if local changes exist',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const s = spinner();
|
||||
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||
const searchDirs = getSearchDirs();
|
||||
|
||||
let skillsToUpdate;
|
||||
@@ -35,7 +39,7 @@ export class UpdateCommand extends Command {
|
||||
.filter((s): s is NonNullable<typeof s> => s !== null);
|
||||
|
||||
const notFound = this.skills.filter(name => !findSkill(name, searchDirs));
|
||||
if (notFound.length > 0) {
|
||||
if (notFound.length > 0 && !this.json) {
|
||||
warn(`Skills not found: ${notFound.join(', ')}`);
|
||||
}
|
||||
} else {
|
||||
@@ -43,11 +47,15 @@ export class UpdateCommand extends Command {
|
||||
}
|
||||
|
||||
if (skillsToUpdate.length === 0) {
|
||||
warn('No skills to update');
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ updated: 0, skipped: 0, failed: 0 }));
|
||||
} else {
|
||||
warn('No skills to update');
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
step(`Updating ${skillsToUpdate.length} skill(s)...`);
|
||||
if (!this.json) step(`Updating ${skillsToUpdate.length} skill(s)...`);
|
||||
|
||||
let updated = 0;
|
||||
let skipped = 0;
|
||||
@@ -57,7 +65,7 @@ export class UpdateCommand extends Command {
|
||||
const metadata = loadSkillMetadata(skill.path);
|
||||
|
||||
if (!metadata) {
|
||||
console.log(colors.muted(`Skipping ${skill.name} (no metadata, reinstall needed)`));
|
||||
if (!this.json) console.log(colors.muted(`Skipping ${skill.name} (no metadata, reinstall needed)`));
|
||||
skipped++;
|
||||
continue;
|
||||
}
|
||||
@@ -172,11 +180,16 @@ export class UpdateCommand extends Command {
|
||||
}
|
||||
} catch (err) {
|
||||
s.stop(colors.error(`Failed to update ${skill.name}`));
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
if (!this.json) console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
failed++;
|
||||
}
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify({ updated, skipped, failed }));
|
||||
return failed > 0 ? 1 : 0;
|
||||
}
|
||||
|
||||
console.log();
|
||||
step(`Updated: ${updated}, Skipped: ${skipped}, Failed: ${failed}`);
|
||||
|
||||
|
||||
@@ -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,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.21.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": {
|
||||
|
||||
@@ -11,33 +11,45 @@ export const SKILL_DISCOVERY_PATHS = [
|
||||
'agents',
|
||||
'.agents/skills',
|
||||
'.agent/skills',
|
||||
'.aider/skills',
|
||||
'.amazonq/skills',
|
||||
'.amp/skills',
|
||||
'.antigravity/skills',
|
||||
'.augment/skills',
|
||||
'.bolt/skills',
|
||||
'.claude/skills',
|
||||
'.cline/skills',
|
||||
'.clawdbot/skills',
|
||||
'.codebuddy/skills',
|
||||
'.codegpt/skills',
|
||||
'.codex/skills',
|
||||
'.cody/skills',
|
||||
'.commandcode/skills',
|
||||
'.continue/skills',
|
||||
'.copilot/skills',
|
||||
'.crush/skills',
|
||||
'.cursor/skills',
|
||||
'.devin/skills',
|
||||
'.factory/skills',
|
||||
'.gemini/skills',
|
||||
'.github/skills',
|
||||
'.goose/skills',
|
||||
'.kilocode/skills',
|
||||
'.kiro/skills',
|
||||
'.lovable/skills',
|
||||
'.mcpjam/skills',
|
||||
'.mux/skills',
|
||||
'.neovate/skills',
|
||||
'.opencode/skills',
|
||||
'.openhands/skills',
|
||||
'.pi/skills',
|
||||
'.playcode/skills',
|
||||
'.qoder/skills',
|
||||
'.qwen/skills',
|
||||
'.replit/skills',
|
||||
'.roo/skills',
|
||||
'.tabby/skills',
|
||||
'.tabnine/skills',
|
||||
'.trae/skills',
|
||||
'.vercel/skills',
|
||||
'.windsurf/skills',
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp-memory",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.1",
|
||||
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,9 +1,13 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
||||
import {
|
||||
handleSearchSkills,
|
||||
handleGetSkill,
|
||||
handleRecommendSkills,
|
||||
handleListCategories,
|
||||
handleSkillkitCatalog,
|
||||
handleSkillkitLoad,
|
||||
handleSkillkitResource,
|
||||
getLocalSkillDirs,
|
||||
} from '../tools.js';
|
||||
import type { SkillEntry } from '../tools.js';
|
||||
|
||||
@@ -82,3 +86,153 @@ describe('handleListCategories', () => {
|
||||
expect(react?.count).toBe(1);
|
||||
});
|
||||
});
|
||||
|
||||
vi.mock('@skillkit/core', async (importOriginal) => {
|
||||
const actual = await importOriginal<typeof import('@skillkit/core')>();
|
||||
return {
|
||||
...actual,
|
||||
findAllSkills: vi.fn(),
|
||||
findSkill: vi.fn(),
|
||||
readSkillContent: vi.fn(),
|
||||
};
|
||||
});
|
||||
|
||||
vi.mock('node:fs', async (importOriginal) => {
|
||||
const actual = await importOriginal<typeof import('node:fs')>();
|
||||
return {
|
||||
...actual,
|
||||
existsSync: vi.fn(actual.existsSync),
|
||||
readFileSync: vi.fn(actual.readFileSync),
|
||||
};
|
||||
});
|
||||
|
||||
import { findAllSkills, findSkill, readSkillContent } from '@skillkit/core';
|
||||
import { existsSync, readFileSync } from 'node:fs';
|
||||
|
||||
const mockFindAllSkills = vi.mocked(findAllSkills);
|
||||
const mockFindSkill = vi.mocked(findSkill);
|
||||
const mockReadSkillContent = vi.mocked(readSkillContent);
|
||||
const mockExistsSync = vi.mocked(existsSync);
|
||||
const mockReadFileSync = vi.mocked(readFileSync);
|
||||
|
||||
describe('handleSkillkitCatalog', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks();
|
||||
});
|
||||
|
||||
it('returns minimal catalog entries', () => {
|
||||
mockFindAllSkills.mockReturnValue([
|
||||
{ name: 'my-skill', description: 'A test skill', path: '/home/user/.claude/skills/my-skill', location: 'global', enabled: true },
|
||||
{ name: 'other-skill', description: 'Another skill', path: '/project/skills/other-skill', location: 'project', enabled: true },
|
||||
]);
|
||||
const result = handleSkillkitCatalog({});
|
||||
const data = JSON.parse(result.content[0].text);
|
||||
expect(data.total).toBe(2);
|
||||
expect(data.skills[0]).toEqual({ name: 'my-skill', description: 'A test skill', source: 'global' });
|
||||
expect(data.skills[1]).toEqual({ name: 'other-skill', description: 'Another skill', source: 'project' });
|
||||
});
|
||||
|
||||
it('returns empty array when no skills found', () => {
|
||||
mockFindAllSkills.mockReturnValue([]);
|
||||
const result = handleSkillkitCatalog({});
|
||||
const data = JSON.parse(result.content[0].text);
|
||||
expect(data.total).toBe(0);
|
||||
expect(data.skills).toEqual([]);
|
||||
});
|
||||
});
|
||||
|
||||
describe('handleSkillkitLoad', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks();
|
||||
});
|
||||
|
||||
it('returns full skill content', () => {
|
||||
mockFindSkill.mockReturnValue({
|
||||
name: 'my-skill',
|
||||
description: 'A test skill',
|
||||
path: '/home/user/.claude/skills/my-skill',
|
||||
location: 'global',
|
||||
enabled: true,
|
||||
});
|
||||
mockReadSkillContent.mockReturnValue('# My Skill\n\nFull content here');
|
||||
const result = handleSkillkitLoad({ name: 'my-skill' });
|
||||
expect(result.content[0].text).toBe('# My Skill\n\nFull content here');
|
||||
expect((result as Record<string, unknown>).isError).toBeUndefined();
|
||||
});
|
||||
|
||||
it('returns error for missing skill', () => {
|
||||
mockFindSkill.mockReturnValue(null);
|
||||
const result = handleSkillkitLoad({ name: 'nonexistent' });
|
||||
expect((result as Record<string, unknown>).isError).toBe(true);
|
||||
expect(result.content[0].text).toContain('Skill not found');
|
||||
});
|
||||
|
||||
it('returns error when content unreadable', () => {
|
||||
mockFindSkill.mockReturnValue({
|
||||
name: 'broken-skill',
|
||||
description: 'Broken',
|
||||
path: '/home/user/.claude/skills/broken-skill',
|
||||
location: 'global',
|
||||
enabled: true,
|
||||
});
|
||||
mockReadSkillContent.mockReturnValue(null);
|
||||
const result = handleSkillkitLoad({ name: 'broken-skill' });
|
||||
expect((result as Record<string, unknown>).isError).toBe(true);
|
||||
expect(result.content[0].text).toContain('Could not read');
|
||||
});
|
||||
});
|
||||
|
||||
describe('handleSkillkitResource', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks();
|
||||
});
|
||||
|
||||
it('returns file content', () => {
|
||||
mockFindSkill.mockReturnValue({
|
||||
name: 'my-skill',
|
||||
description: 'A test skill',
|
||||
path: '/home/user/.claude/skills/my-skill',
|
||||
location: 'global',
|
||||
enabled: true,
|
||||
});
|
||||
mockExistsSync.mockReturnValue(true);
|
||||
mockReadFileSync.mockReturnValue('reference content' as never);
|
||||
const result = handleSkillkitResource({ name: 'my-skill', file: 'references/api.md' });
|
||||
expect(result.content[0].text).toBe('reference content');
|
||||
expect((result as Record<string, unknown>).isError).toBeUndefined();
|
||||
});
|
||||
|
||||
it('returns error for missing skill', () => {
|
||||
mockFindSkill.mockReturnValue(null);
|
||||
const result = handleSkillkitResource({ name: 'nonexistent', file: 'references/api.md' });
|
||||
expect((result as Record<string, unknown>).isError).toBe(true);
|
||||
expect(result.content[0].text).toContain('Skill not found');
|
||||
});
|
||||
|
||||
it('blocks path traversal', () => {
|
||||
mockFindSkill.mockReturnValue({
|
||||
name: 'my-skill',
|
||||
description: 'A test skill',
|
||||
path: '/home/user/.claude/skills/my-skill',
|
||||
location: 'global',
|
||||
enabled: true,
|
||||
});
|
||||
const result = handleSkillkitResource({ name: 'my-skill', file: '../../etc/passwd' });
|
||||
expect((result as Record<string, unknown>).isError).toBe(true);
|
||||
expect(result.content[0].text).toContain('Path traversal denied');
|
||||
});
|
||||
|
||||
it('returns error for missing file', () => {
|
||||
mockFindSkill.mockReturnValue({
|
||||
name: 'my-skill',
|
||||
description: 'A test skill',
|
||||
path: '/home/user/.claude/skills/my-skill',
|
||||
location: 'global',
|
||||
enabled: true,
|
||||
});
|
||||
mockExistsSync.mockReturnValue(false);
|
||||
const result = handleSkillkitResource({ name: 'my-skill', file: 'references/missing.md' });
|
||||
expect((result as Record<string, unknown>).isError).toBe(true);
|
||||
expect(result.content[0].text).toContain('File not found');
|
||||
});
|
||||
});
|
||||
|
||||
@@ -13,6 +13,9 @@ import {
|
||||
handleGetSkill,
|
||||
handleRecommendSkills,
|
||||
handleListCategories,
|
||||
handleSkillkitCatalog,
|
||||
handleSkillkitLoad,
|
||||
handleSkillkitResource,
|
||||
} from './tools.js';
|
||||
import type { SkillEntry } from './tools.js';
|
||||
import { getTrendingResource, getCategoriesResource } from './resources.js';
|
||||
@@ -55,7 +58,7 @@ async function loadSkills(): Promise<SkillEntry[]> {
|
||||
const server = new Server(
|
||||
{
|
||||
name: 'skillkit-discovery',
|
||||
version: '1.17.0',
|
||||
version: '1.21.0',
|
||||
},
|
||||
{
|
||||
capabilities: {
|
||||
@@ -125,6 +128,39 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
|
||||
properties: {},
|
||||
},
|
||||
},
|
||||
{
|
||||
name: 'skillkit_catalog',
|
||||
description: 'List all installed skills with name and description. Use this first to see what skills are available. Each entry costs ~50 tokens.',
|
||||
inputSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
agent: { type: 'string', description: 'Filter by agent type (e.g. claude-code, cursor)' },
|
||||
},
|
||||
},
|
||||
},
|
||||
{
|
||||
name: 'skillkit_load',
|
||||
description: 'Load the full content of a specific installed skill. Call this only when you need the detailed instructions for a skill found via skillkit_catalog.',
|
||||
inputSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
name: { type: 'string', description: 'Skill name from the catalog' },
|
||||
},
|
||||
required: ['name'],
|
||||
},
|
||||
},
|
||||
{
|
||||
name: 'skillkit_resource',
|
||||
description: 'Load a specific reference file from within a skill directory. Use when a skill references external files.',
|
||||
inputSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
name: { type: 'string', description: 'Skill name' },
|
||||
file: { type: 'string', description: 'Relative file path within the skill (e.g. references/api.md)' },
|
||||
},
|
||||
required: ['name', 'file'],
|
||||
},
|
||||
},
|
||||
],
|
||||
};
|
||||
});
|
||||
@@ -142,6 +178,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
||||
return handleRecommendSkills(skills, args);
|
||||
case 'list_categories':
|
||||
return handleListCategories(skills);
|
||||
case 'skillkit_catalog':
|
||||
return handleSkillkitCatalog(args);
|
||||
case 'skillkit_load':
|
||||
return handleSkillkitLoad(args);
|
||||
case 'skillkit_resource':
|
||||
return handleSkillkitResource(args);
|
||||
default:
|
||||
return {
|
||||
content: [{ type: 'text', text: `Unknown tool: ${name}` }],
|
||||
|
||||
@@ -1,8 +1,21 @@
|
||||
import { RelevanceRanker } from '@skillkit/core';
|
||||
import {
|
||||
RelevanceRanker,
|
||||
findAllSkills,
|
||||
findSkill,
|
||||
readSkillContent,
|
||||
isPathInside,
|
||||
SKILL_DISCOVERY_PATHS,
|
||||
} from '@skillkit/core';
|
||||
import { homedir } from 'node:os';
|
||||
import { join, resolve } from 'node:path';
|
||||
import { existsSync, readFileSync, realpathSync } from 'node:fs';
|
||||
import {
|
||||
SearchSkillsInputSchema,
|
||||
GetSkillInputSchema,
|
||||
RecommendSkillsInputSchema,
|
||||
SkillkitCatalogInputSchema,
|
||||
SkillkitLoadInputSchema,
|
||||
SkillkitResourceInputSchema,
|
||||
} from './types.js';
|
||||
|
||||
export interface SkillEntry {
|
||||
@@ -167,3 +180,170 @@ export function handleListCategories(skills: SkillEntry[]) {
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
const AGENT_DIR_MAP: Record<string, string[]> = {
|
||||
'claude-code': ['.claude/skills'], 'cursor': ['.cursor/skills'], 'codex': ['.codex/skills'],
|
||||
'gemini-cli': ['.gemini/skills'], 'opencode': ['.opencode/skills', '.config/opencode/skills'],
|
||||
'antigravity': ['.antigravity/skills'], 'amp': ['.amp/skills'], 'clawdbot': ['.clawdbot/skills'],
|
||||
'openclaw': ['skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'],
|
||||
'kilo': ['.kilocode/skills'], 'kiro-cli': ['.kiro/skills'], 'roo': ['.roo/skills'],
|
||||
'trae': ['.trae/skills'], 'windsurf': ['.windsurf/skills', '.codeium/windsurf/skills'],
|
||||
'universal': ['skills'], 'droid': ['.factory/skills'], 'factory': ['.factory/skills'],
|
||||
'cline': ['.cline/skills'], 'codebuddy': ['.codebuddy/skills'], 'codegpt': ['.codegpt/skills'],
|
||||
'commandcode': ['.commandcode/skills'], 'continue': ['.continue/skills'],
|
||||
'crush': ['.crush/skills'], 'devin': ['.devin/skills'], 'mcpjam': ['.mcpjam/skills'],
|
||||
'mux': ['.mux/skills'], 'neovate': ['.neovate/skills'], 'openhands': ['.openhands/skills'],
|
||||
'pi': ['.pi/skills'], 'playcode-agent': ['.playcode/skills'], 'qoder': ['.qoder/skills'],
|
||||
'qwen': ['.qwen/skills'], 'vercel': ['.vercel/skills'], 'zencoder': ['.zencoder/skills'],
|
||||
'aider': ['.aider/skills'], 'amazon-q': ['.amazonq/skills'], 'augment-code': ['.augment/skills'],
|
||||
'bolt': ['.bolt/skills'], 'lovable': ['.lovable/skills'], 'replit-agent': ['.replit/skills'],
|
||||
'sourcegraph-cody': ['.cody/skills'], 'tabby': ['.tabby/skills'], 'tabnine': ['.tabnine/skills'],
|
||||
};
|
||||
|
||||
export function getLocalSkillDirs(agentFilter?: string): string[] {
|
||||
const dirs: string[] = [];
|
||||
const home = homedir();
|
||||
const roots = [process.cwd(), home];
|
||||
|
||||
let allowedPaths: Set<string> | null = null;
|
||||
if (agentFilter) {
|
||||
const agentDirs = AGENT_DIR_MAP[agentFilter] ?? [];
|
||||
allowedPaths = new Set(['skills', 'agents', '.agents/skills', '.agent/skills', ...agentDirs]);
|
||||
}
|
||||
|
||||
for (const root of roots) {
|
||||
for (const rel of SKILL_DISCOVERY_PATHS) {
|
||||
if (allowedPaths && !allowedPaths.has(rel)) continue;
|
||||
const full = join(root, rel);
|
||||
if (existsSync(full) && !dirs.includes(full)) {
|
||||
dirs.push(full);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (agentFilter) {
|
||||
const agentDirs = AGENT_DIR_MAP[agentFilter] ?? [];
|
||||
for (const rel of agentDirs) {
|
||||
if (!SKILL_DISCOVERY_PATHS.includes(rel)) {
|
||||
const full = join(home, rel);
|
||||
if (existsSync(full) && !dirs.includes(full)) {
|
||||
dirs.push(full);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return dirs;
|
||||
}
|
||||
|
||||
export function handleSkillkitCatalog(args: unknown) {
|
||||
const input = SkillkitCatalogInputSchema.parse(args);
|
||||
const dirs = getLocalSkillDirs(input.agent);
|
||||
const skills = findAllSkills(dirs);
|
||||
|
||||
const catalog = skills.map((s) => ({
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
source: s.location,
|
||||
}));
|
||||
|
||||
return {
|
||||
content: [
|
||||
{
|
||||
type: 'text' as const,
|
||||
text: JSON.stringify({ skills: catalog, total: catalog.length }, null, 2),
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
export function handleSkillkitLoad(args: unknown) {
|
||||
const input = SkillkitLoadInputSchema.parse(args);
|
||||
const dirs = getLocalSkillDirs();
|
||||
const skill = findSkill(input.name, dirs);
|
||||
|
||||
if (!skill) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Skill not found: ${input.name}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
const content = readSkillContent(skill.path);
|
||||
if (!content) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Could not read skill content: ${input.name}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
return {
|
||||
content: [
|
||||
{
|
||||
type: 'text' as const,
|
||||
text: content,
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
export function handleSkillkitResource(args: unknown) {
|
||||
const input = SkillkitResourceInputSchema.parse(args);
|
||||
const dirs = getLocalSkillDirs();
|
||||
const skill = findSkill(input.name, dirs);
|
||||
|
||||
if (!skill) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Skill not found: ${input.name}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
const filePath = resolve(join(skill.path, input.file));
|
||||
if (!isPathInside(filePath, skill.path)) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Path traversal denied: ${input.file}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
if (!existsSync(filePath)) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `File not found: ${input.file}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
let realPath: string;
|
||||
let realSkillDir: string;
|
||||
try {
|
||||
realPath = realpathSync(filePath);
|
||||
realSkillDir = realpathSync(skill.path);
|
||||
} catch {
|
||||
realPath = filePath;
|
||||
realSkillDir = resolve(skill.path);
|
||||
}
|
||||
if (!isPathInside(realPath, realSkillDir)) {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Path traversal denied: ${input.file}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
|
||||
try {
|
||||
const content = readFileSync(realPath, 'utf-8');
|
||||
return {
|
||||
content: [
|
||||
{
|
||||
type: 'text' as const,
|
||||
text: content,
|
||||
},
|
||||
],
|
||||
};
|
||||
} catch {
|
||||
return {
|
||||
content: [{ type: 'text' as const, text: `Could not read file: ${input.file}` }],
|
||||
isError: true,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
@@ -31,6 +31,22 @@ export const RecommendSkillsInputSchema = z.object({
|
||||
|
||||
export const ListCategoriesInputSchema = z.object({});
|
||||
|
||||
export const SkillkitCatalogInputSchema = z.object({
|
||||
agent: z.string().optional().describe('Filter by agent type (e.g. claude-code, cursor)'),
|
||||
});
|
||||
|
||||
export const SkillkitLoadInputSchema = z.object({
|
||||
name: z.string().describe('Skill name from the catalog'),
|
||||
});
|
||||
|
||||
export const SkillkitResourceInputSchema = z.object({
|
||||
name: z.string().describe('Skill name'),
|
||||
file: z.string().describe('Relative file path within the skill (e.g. references/api.md)'),
|
||||
});
|
||||
|
||||
export type SearchSkillsInput = z.infer<typeof SearchSkillsInputSchema>;
|
||||
export type GetSkillInput = z.infer<typeof GetSkillInputSchema>;
|
||||
export type RecommendSkillsInput = z.infer<typeof RecommendSkillsInputSchema>;
|
||||
export type SkillkitCatalogInput = z.infer<typeof SkillkitCatalogInputSchema>;
|
||||
export type SkillkitLoadInput = z.infer<typeof SkillkitLoadInputSchema>;
|
||||
export type SkillkitResourceInput = z.infer<typeof SkillkitResourceInputSchema>;
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/memory",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mesh",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "Peer mesh network for multi-machine agent distribution",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/messaging",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "Inter-agent messaging system for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/resources",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/tui",
|
||||
"version": "1.21.0",
|
||||
"version": "1.23.0",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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}`);
|
||||
}
|
||||