mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 12:23:29 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
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
|
||||
@@ -1,6 +1,6 @@
|
||||
# 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
|
||||
|
||||
@@ -150,11 +150,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.22.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",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.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.22.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.22.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.22.0",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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']];
|
||||
@@ -132,7 +133,17 @@ export class EvalCommand extends Command {
|
||||
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
|
||||
engine.registerEvaluator(new CommunitySignalsEvaluator());
|
||||
|
||||
const result = await engine.evaluate(targetPath, options);
|
||||
const isJson = this.format === 'json';
|
||||
const s = isJson ? { start: () => {}, stop: () => {} } : 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');
|
||||
|
||||
|
||||
@@ -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("");
|
||||
|
||||
@@ -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);
|
||||
@@ -657,6 +665,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;
|
||||
}
|
||||
|
||||
|
||||
@@ -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}`));
|
||||
|
||||
@@ -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,8 @@ export class RemoveCommand extends Command {
|
||||
|
||||
let removed = 0;
|
||||
let failed = 0;
|
||||
const removedNames: string[] = [];
|
||||
const failedNames: string[] = [];
|
||||
|
||||
for (const { name: skillName, path: skillPath } of skillsToRemove) {
|
||||
if (!existsSync(skillPath)) {
|
||||
@@ -89,11 +103,15 @@ 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++;
|
||||
}
|
||||
}
|
||||
@@ -115,7 +133,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;
|
||||
|
||||
@@ -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');
|
||||
|
||||
|
||||
@@ -91,8 +91,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);
|
||||
|
||||
@@ -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,
|
||||
@@ -226,6 +226,7 @@ export class TranslateCommand extends Command {
|
||||
|
||||
let successCount = 0;
|
||||
let failed = 0;
|
||||
const s = spinner();
|
||||
|
||||
for (const skill of skills) {
|
||||
const skillMdPath = join(skill.path, 'SKILL.md');
|
||||
@@ -235,10 +236,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)`);
|
||||
@@ -332,12 +337,17 @@ export class TranslateCommand extends Command {
|
||||
}
|
||||
|
||||
// Read and translate
|
||||
const s = 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) {
|
||||
|
||||
@@ -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}`);
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.0",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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.22.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.0",
|
||||
"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}` }],
|
||||
|
||||
+181
-1
@@ -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.22.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.22.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.22.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.22.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.22.0",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
Reference in New Issue
Block a user