mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 12:23:29 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
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
|
||||
@@ -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.1",
|
||||
"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.1",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.1",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.1",
|
||||
"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.1",
|
||||
"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.1",
|
||||
"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.1",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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);
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
|
||||
@@ -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}`);
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.21.0",
|
||||
"version": "1.22.1",
|
||||
"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.1",
|
||||
"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}` }],
|
||||
|
||||
+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.1",
|
||||
"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.1",
|
||||
"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.1",
|
||||
"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.1",
|
||||
"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.1",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
Reference in New Issue
Block a user