Compare commits

...
17 Commits
Author SHA1 Message Date
Rohit Ghumare ae8c7a1abb chore: bump version to 1.22.1 2026-04-12 20:38:10 +01:00
Rohit Ghumare 196a959569 Merge pull request #109 from rohitg00/feat/json-spinners-remaining
feat: complete --json and spinners for all remaining commands
2026-04-12 20:21:14 +01:00
Rohit Ghumare 23d1c8932a fix: run agent install in save --json mode, include agents in output 2026-04-12 20:16:44 +01:00
Rohit Ghumare 0c82c58905 feat(cli): add --json output and loading spinners to remaining commands
Add --json flag with structured JSON output to: create, enable, disable,
eval, sync, tap (add/remove/list), translate, save, read.

Add loading spinners to: audit, fix, test, plugin, team, methodology,
hook, remove. Commands that already had spinners get --json-aware no-op
spinners when --json is active to suppress visual output.
2026-04-12 12:02:38 +01:00
Rohit Ghumare 1ce9751797 chore: bump version to 1.22.0 2026-04-12 11:32:58 +01:00
Rohit Ghumare 6485745295 Merge pull request #107 from rohitg00/feat/cicd-json-spinners
feat: reusable GitHub Action, --json output, loading spinners
2026-04-12 11:31:52 +01:00
Rohit Ghumare e9014e130c fix: suppress all stdout pollution in --json mode across all commands
- update: emit JSON on empty skills, gate warn/console.log on !json
- remove: emit JSON on empty results, gate warn/log on !json
- find: gate step() calls on !json
- install: emit JSON error object in catch block instead of console.log
2026-04-12 11:31:21 +01:00
Rohit Ghumare 9e50c8abe1 fix: prevent shell injection in action, suppress stdout in --json mode
- action.yml: pass inputs via env vars, whitelist allowed commands
- All --json commands: use no-op spinner to prevent stdout pollution
- remove: run AGENTS.md update before JSON output (was skipped)
- eval: gate spinner on json format, wrap in try/catch for cleanup
- scan: wrap spinner in try/catch for cleanup on failure
2026-04-12 10:56:35 +01:00
Rohit Ghumare 49fcc532d2 feat: add loading spinners to translate, sync, eval, publish, and scan commands (#88) 2026-04-12 10:41:46 +01:00
Rohit Ghumare ecead6585c feat: add --json flag to 8 CLI commands for structured output (#89) 2026-04-12 10:39:52 +01:00
Rohit Ghumare cc2eb2504c feat: add reusable GitHub Action for CI/CD skill management (#92) 2026-04-12 10:37:01 +01:00
Rohit Ghumare 5d7ca0cd8e Merge pull request #106 from rohitg00/feat/infra-v1.21
feat: progressive disclosure execution layer for MCP server
2026-04-12 00:29:07 +01:00
Rohit Ghumare eda488c960 fix: symlink escape in resource sandbox, search order, global paths
- Resolve symlinks with realpathSync before path containment check
  to prevent symlink-based directory escape in skillkit_resource
- Search project-local skills before home-level (cwd first in roots)
- AGENT_DIR_MAP now maps to arrays, includes non-standard global
  paths (opencode: .config/opencode/skills, windsurf: .codeium/...)
- Extra global dirs scanned when agent filter matches
2026-04-11 21:11:24 +01:00
Rohit Ghumare 559b760202 fix: add 13 missing agent dirs to SKILL_DISCOVERY_PATHS, fix agent filter
- Add .aider, .amazonq, .augment, .bolt, .codegpt, .cody, .devin,
  .lovable, .playcode, .replit, .tabby, .tabnine to discovery paths
- Fix agent filter in getLocalSkillDirs: use AGENT_DIR_MAP lookup
  instead of reverse-engineering from directory prefix (claude != claude-code)
- Update Agent Types code block in agents README to list all 45 agents
2026-04-11 20:32:28 +01:00
Rohit Ghumare ebd26b7c84 docs: fix agent count 32→45 in package READMEs 2026-04-11 20:25:13 +01:00
Rohit Ghumare 8ec5b9d8f2 Add progressive disclosure tools (skillkit_catalog, skillkit_load, skillkit_resource) to MCP server
Three new tools for token-efficient local skill access:
- skillkit_catalog (L1): lightweight catalog of installed skills (~50 tokens/skill)
- skillkit_load (L2): full SKILL.md content for a single skill
- skillkit_resource (L3): specific reference file with path traversal protection

Bumps server version to 1.21.0. Adds 14 new tests (18 total).
2026-04-11 20:24:20 +01:00
Rohit Ghumare 0cba1be49c docs: update package READMEs to 45 agents with full agent table 2026-04-11 19:10:19 +01:00
48 changed files with 1219 additions and 226 deletions
+87
View File
@@ -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'
```
+65
View File
@@ -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
+4 -4
View File
@@ -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
+2 -2
View File
@@ -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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.21.0",
"version": "1.22.1",
"private": true,
"scripts": {
"build": "next build",
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.21.0",
"version": "1.22.1",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -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",
+28 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/agents.svg)](https://www.npmjs.com/package/@skillkit/agents)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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';
```
+2 -2
View File
@@ -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 -1
View File
@@ -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",
+2 -2
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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 -1
View File
@@ -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",
+18 -2
View File
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { promises as fs } from 'fs';
import path from 'path';
import { colors, warn, success } from '../onboarding/index.js';
import { colors, warn, success, spinner } from '../onboarding/index.js';
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
export class AuditCommand extends Command {
@@ -114,8 +114,11 @@ export class AuditCommand extends Command {
}
private async handleLog(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Querying audit log');
const query = this.buildQuery();
const events = await logger.query(query);
s.stop('Query complete');
if (this.json) {
console.log(JSON.stringify(events, null, 2));
@@ -163,10 +166,13 @@ export class AuditCommand extends Command {
}
private async handleExport(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const format = (this.format as 'json' | 'csv' | 'text') || 'json';
const query = this.buildQuery();
s.start('Exporting audit log');
const content = await logger.export({ format, query });
s.stop('Export complete');
if (this.output) {
const outputPath = resolve(this.output);
@@ -180,7 +186,10 @@ export class AuditCommand extends Command {
}
private async handleStats(logger: AuditLogger): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Computing statistics');
const stats = await logger.stats();
s.stop('Statistics computed');
if (this.json) {
console.log(JSON.stringify(stats, null, 2));
@@ -237,9 +246,16 @@ export class AuditCommand extends Command {
const cutoffDate = new Date();
cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
s.start('Clearing old entries');
const cleared = await logger.clear(cutoffDate);
s.stop('Clear complete');
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
if (this.json) {
console.log(JSON.stringify({ success: true, cleared, days: daysAgo }));
} else {
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
}
return 0;
}
+20 -3
View File
@@ -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);
+45 -19
View File
@@ -1,6 +1,6 @@
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { colors, success, error, step } from '../onboarding/index.js';
import { colors, success, error, step, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
export class CreateCommand extends Command {
@@ -37,12 +37,21 @@ export class CreateCommand extends Command {
description: 'Parent directory to create skill in (default: current directory)',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const skillName = this.name.toLowerCase();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Invalid skill name' }));
} else {
error('Invalid skill name');
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
}
return 1;
}
@@ -50,11 +59,17 @@ export class CreateCommand extends Command {
const skillDir = join(parentDir, skillName);
if (existsSync(skillDir)) {
error(`Directory already exists: ${skillDir}`);
if (this.json) {
console.log(JSON.stringify({ success: false, error: `Directory already exists: ${skillDir}` }));
} else {
error(`Directory already exists: ${skillDir}`);
}
return 1;
}
try {
s.start('Creating skill');
mkdirSync(skillDir, { recursive: true });
const skillMd = generateSkillMd(skillName);
@@ -78,24 +93,35 @@ export class CreateCommand extends Command {
writeFileSync(join(assetsDir, '.gitkeep'), '');
}
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
s.stop('Skill created');
if (this.json) {
console.log(JSON.stringify({ success: true, name: skillName, path: skillDir }));
} else {
success(`Created skill: ${skillName}`);
console.log();
console.log(colors.muted('Structure:'));
console.log(colors.muted(` ${skillDir}/`));
console.log(colors.muted(' ├── SKILL.md'));
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
console.log();
step('Next steps:');
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
}
return 0;
} catch (err) {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
s.stop('Failed');
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
error('Failed to create skill');
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+43 -11
View File
@@ -1,4 +1,4 @@
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { setSkillEnabled, findSkill } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -16,37 +16,53 @@ export class EnableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Enabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (skill.enabled) {
console.log(colors.muted(`Already enabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already enabled: ${skillName}`));
results.push({ name: skillName, enabled: true, success: true });
continue;
}
const result = setSkillEnabled(skill.path, true);
if (result) {
success(`Enabled: ${skillName}`);
if (!this.json) success(`Enabled: ${skillName}`);
results.push({ name: skillName, enabled: true, success: true });
successCount++;
} else {
error(`Failed to enable: ${skillName}`);
if (!this.json) error(`Failed to enable: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Enabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
@@ -67,37 +83,53 @@ export class DisableCommand extends Command {
skills = Option.Rest({ required: 1 });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
let successCount = 0;
let failed = 0;
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
s.start('Disabling skills');
for (const skillName of this.skills) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
if (!this.json) error(`Skill not found: ${skillName}`);
results.push({ name: skillName, enabled: false, success: false });
failed++;
continue;
}
if (!skill.enabled) {
console.log(colors.muted(`Already disabled: ${skillName}`));
if (!this.json) console.log(colors.muted(`Already disabled: ${skillName}`));
results.push({ name: skillName, enabled: false, success: true });
continue;
}
const result = setSkillEnabled(skill.path, false);
if (result) {
warn(`Disabled: ${skillName}`);
if (!this.json) warn(`Disabled: ${skillName}`);
results.push({ name: skillName, enabled: false, success: true });
successCount++;
} else {
error(`Failed to disable: ${skillName}`);
if (!this.json) error(`Failed to disable: ${skillName}`);
results.push({ name: skillName, enabled: true, success: false });
failed++;
}
}
if (successCount > 0) {
s.stop(successCount > 0 ? `Disabled ${successCount} skill(s)` : 'Done');
if (this.json) {
console.log(JSON.stringify({ success: failed === 0, results }));
} else if (successCount > 0) {
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
}
+24 -3
View File
@@ -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;
}
}
+20 -4
View File
@@ -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("");
+4
View File
@@ -15,6 +15,7 @@ import {
error,
header,
confirm,
spinner,
} from '../onboarding/index.js';
interface FixSuggestion {
@@ -209,6 +210,7 @@ export class FixCommand extends Command {
let totalFixes = 0;
let filesFixed = 0;
const s = spinner();
for (const target of this.targets) {
const resolved = resolve(target);
@@ -256,8 +258,10 @@ export class FixCommand extends Command {
continue;
}
s.start(`Evaluating ${skillName}`);
const content = readFileSync(filePath, 'utf-8');
const quality = evaluateSkillFile(filePath);
s.stop(`Evaluated ${skillName}`);
if (!quality) {
warn(`Could not evaluate: ${target}`);
+4 -1
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
import {
getHookTemplates,
@@ -239,7 +239,10 @@ export class HookCommand extends Command {
}
const agent = this.agent || 'claude-code';
const s = spinner();
s.start(`Generating hooks for ${agent}`);
const generated = manager.generateAgentHooks(agent as any);
s.stop('Hooks generated');
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
+23 -5
View File
@@ -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({
+8 -1
View File
@@ -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;
}
+17 -9
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createMethodologyManager, createMethodologyLoader } from '@skillkit/core';
export class MethodologyCommand extends Command {
@@ -61,8 +61,11 @@ export class MethodologyCommand extends Command {
}
private async listPacks(): Promise<number> {
const s = spinner();
s.start('Loading methodology packs');
const loader = createMethodologyLoader();
const packs = await loader.loadAllPacks();
s.stop('Packs loaded');
if (packs.length === 0) {
this.context.stdout.write('No methodology packs available.\n');
@@ -91,15 +94,16 @@ export class MethodologyCommand extends Command {
if (this.target) {
// Check if it's a skill ID (pack/skill) or pack name
if (this.target.includes('/')) {
// Install single skill
this.context.stdout.write(`Installing skill: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
this.context.stdout.write(colors.warning('[dry-run] Would install skill.\n'));
return 0;
}
s.start(`Installing skill: ${this.target}`);
const result = await manager.installSkill(this.target);
s.stop('Install complete');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Skill installed: ${this.target}\n`));
@@ -110,8 +114,7 @@ export class MethodologyCommand extends Command {
return 1;
}
} else {
// Install single pack
this.context.stdout.write(`Installing pack: ${colors.cyan(this.target)}...\n`);
const s = spinner();
if (this.dryRun) {
const pack = await loader.loadPack(this.target);
@@ -121,7 +124,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start(`Installing pack: ${this.target}`);
const result = await manager.installPack(this.target);
s.stop('Pack installed');
if (result.success) {
this.context.stdout.write(colors.success(`✓ Pack "${this.target}" installed!\n`));
@@ -138,8 +143,7 @@ export class MethodologyCommand extends Command {
}
}
} else {
// Install all packs
this.context.stdout.write('Installing all methodology packs...\n\n');
const s = spinner();
if (this.dryRun) {
const packs = await loader.loadAllPacks();
@@ -152,7 +156,9 @@ export class MethodologyCommand extends Command {
return 0;
}
s.start('Installing all methodology packs');
const result = await manager.installAllPacks();
s.stop('Installation complete');
if (result.success) {
this.context.stdout.write(colors.success('\n✓ All methodology packs installed!\n'));
@@ -195,15 +201,17 @@ export class MethodologyCommand extends Command {
private async syncSkills(projectPath: string): Promise<number> {
const manager = createMethodologyManager({ projectPath, autoSync: false });
this.context.stdout.write('Syncing methodology skills to detected agents...\n\n');
if (this.dryRun) {
const installed = manager.listInstalledSkills();
this.context.stdout.write(colors.warning(`[dry-run] Would sync ${installed.length} skills.\n`));
return 0;
}
const s = spinner();
s.start('Syncing methodology skills');
const result = await manager.syncAll();
s.stop('Sync complete');
if (result.synced.length > 0) {
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
+10 -5
View File
@@ -8,7 +8,7 @@ import { Command, Option } from 'clipanion';
import { join, isAbsolute, resolve, sep } from 'node:path';
import { homedir } from 'node:os';
import { existsSync, mkdirSync, copyFileSync, cpSync, rmSync } from 'node:fs';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createPluginManager, loadPlugin, loadPluginsFromDirectory } from '@skillkit/core';
export class PluginCommand extends Command {
@@ -149,7 +149,8 @@ export class PluginCommand extends Command {
? join(homedir(), this.source.slice(1))
: this.source;
this.context.stdout.write(`Installing plugin from ${this.source}...\n`);
const s = spinner();
s.start(`Installing plugin from ${this.source}`);
const plugin = await loadPlugin(resolvedSource);
@@ -222,6 +223,8 @@ export class PluginCommand extends Command {
await pluginManager.register(plugin);
s.stop('Plugin installed');
this.context.stdout.write(colors.success(`✓ Plugin "${plugin.metadata.name}" installed!\n`));
this.context.stdout.write(` Version: ${plugin.metadata.version}\n`);
if (plugin.metadata.description) {
@@ -254,9 +257,10 @@ export class PluginCommand extends Command {
return 1;
}
await pluginManager.unregister(this.name);
const s = spinner();
s.start(`Uninstalling plugin ${this.name}`);
// Remove plugin files from disk
await pluginManager.unregister(this.name);
const projectPath = this.global
? join(homedir(), '.skillkit')
: process.cwd();
@@ -275,9 +279,10 @@ export class PluginCommand extends Command {
if (existsSync(pluginDir)) {
rmSync(pluginDir, { recursive: true, force: true });
this.context.stdout.write(colors.muted(` Removed ${pluginDir}\n`));
}
s.stop('Plugin uninstalled');
this.context.stdout.write(colors.success(`✓ Plugin "${this.name}" uninstalled.\n`));
return 0;
}
+39 -20
View File
@@ -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}`));
+40 -15
View File
@@ -21,6 +21,10 @@ export class ReadCommand extends Command {
description: 'Show additional information',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const searchDirs = getSearchDirs();
@@ -30,26 +34,35 @@ export class ReadCommand extends Command {
.filter(s => s.length > 0);
if (skillNames.length === 0) {
error('No skill names provided');
if (this.json) {
console.log(JSON.stringify({ error: 'No skill names provided' }));
} else {
error('No skill names provided');
}
return 1;
}
let exitCode = 0;
const jsonResults: Array<{ name: string; content: string; path: string }> = [];
for (const skillName of skillNames) {
const skill = findSkill(skillName, searchDirs);
if (!skill) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
if (!this.json) {
error(`Skill not found: ${skillName}`);
console.log(colors.muted('Available directories:'));
searchDirs.forEach(d => console.log(colors.muted(` - ${d}`)));
}
exitCode = 1;
continue;
}
if (!skill.enabled) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
if (!this.json) {
warn(`Skill disabled: ${skillName}`);
console.log(colors.muted('Enable with: skillkit enable ' + skillName));
}
exitCode = 1;
continue;
}
@@ -57,20 +70,32 @@ export class ReadCommand extends Command {
const content = readSkillContent(skill.path);
if (!content) {
error(`Could not read SKILL.md for: ${skillName}`);
if (!this.json) error(`Could not read SKILL.md for: ${skillName}`);
exitCode = 1;
continue;
}
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (this.json) {
jsonResults.push({ name: skillName, content, path: skill.path });
} else {
console.log(`Reading: ${skillName}`);
console.log(`Base directory: ${skill.path}`);
console.log();
console.log(content);
console.log();
console.log(`Skill read: ${skillName}`);
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
if (skillNames.length > 1 && skillName !== skillNames[skillNames.length - 1]) {
console.log('\n---\n');
}
}
}
if (this.json) {
if (jsonResults.length === 1) {
console.log(JSON.stringify(jsonResults[0]));
} else {
console.log(JSON.stringify(jsonResults));
}
}
+43 -9
View File
@@ -1,6 +1,6 @@
import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
import { join, dirname, basename } from 'node:path';
import { colors, warn, success, error } from '../onboarding/index.js';
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
import { Command, Option } from 'clipanion';
import { findSkill, findAllSkills, loadMetadata, AgentsMdParser, AgentsMdGenerator, removeSkillFromLock } from '@skillkit/core';
import { getSearchDirs } from '../helpers.js';
@@ -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;
+39 -16
View File
@@ -43,14 +43,26 @@ export class SaveCommand extends Command {
description: 'Local file path to save as a skill',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const sources = [this.url, this.text, this.file].filter(Boolean);
if (sources.length === 0) {
console.log(colors.error('Provide a URL, --text, or --file'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Provide a URL, --text, or --file' }));
} else {
console.log(colors.error('Provide a URL, --text, or --file'));
}
return 1;
}
if (sources.length > 1) {
console.log(colors.error('Provide only one of: URL, --text, or --file'));
if (this.json) {
console.log(JSON.stringify({ success: false, error: 'Provide only one of: URL, --text, or --file' }));
} else {
console.log(colors.error('Provide only one of: URL, --text, or --file'));
}
return 1;
}
@@ -58,7 +70,7 @@ export class SaveCommand extends Command {
const generator = new SkillGenerator();
const tagger = new AutoTagger();
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
try {
s.start('Extracting content');
@@ -82,15 +94,9 @@ export class SaveCommand extends Command {
global: this.global,
});
s.stop(colors.success('Skill saved'));
console.log('');
console.log(colors.bold(' Name: ') + colors.cyan(result.name));
console.log(colors.bold(' Path: ') + colors.muted(result.skillPath));
if (tags.length > 0) {
console.log(colors.bold(' Tags: ') + tags.map(t => colors.warning(t)).join(', '));
}
s.stop('Skill saved');
const installedAgents: string[] = [];
if (this.agent) {
const agents = this.agent.split(',').map(a => a.trim()).filter(Boolean);
const skillDir = dirname(result.skillPath);
@@ -101,18 +107,35 @@ export class SaveCommand extends Command {
const targetDir = join(adapter.skillsDir, result.name);
mkdirSync(targetDir, { recursive: true });
cpSync(skillDir, targetDir, { recursive: true });
console.log(colors.success(` Installed to ${agentName}: `) + colors.muted(targetDir));
installedAgents.push(agentName);
if (!this.json) {
console.log(colors.success(` Installed to ${agentName}: `) + colors.muted(targetDir));
}
} catch (err) {
warn(` Skipped ${agentName}: ${err instanceof Error ? err.message : String(err)}`);
if (!this.json) warn(` Skipped ${agentName}: ${err instanceof Error ? err.message : String(err)}`);
}
}
}
console.log('');
if (this.json) {
console.log(JSON.stringify({ success: true, name: result.name, path: result.skillPath, agents: installedAgents }));
} else {
console.log('');
console.log(colors.bold(' Name: ') + colors.cyan(result.name));
console.log(colors.bold(' Path: ') + colors.muted(result.skillPath));
if (tags.length > 0) {
console.log(colors.bold(' Tags: ') + tags.map(t => colors.warning(t)).join(', '));
}
console.log('');
}
return 0;
} catch (err) {
s.stop(colors.error('Failed'));
console.log(colors.error(err instanceof Error ? err.message : String(err)));
s.stop('Failed');
if (this.json) {
console.log(JSON.stringify({ success: false, error: err instanceof Error ? err.message : String(err) }));
} else {
console.log(colors.error(err instanceof Error ? err.message : String(err)));
}
return 1;
}
}
+20 -2
View File
@@ -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');
+35 -21
View File
@@ -53,16 +53,20 @@ export class SyncCommand extends Command {
description: 'Minimal output',
});
async execute(): Promise<number> {
const isInteractive = process.stdin.isTTY && !this.yes;
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
if (!this.quiet) {
async execute(): Promise<number> {
const isInteractive = process.stdin.isTTY && !this.yes && !this.json;
if (!this.quiet && !this.json) {
header('Sync Skills');
}
try {
let agentType: AgentType;
const s = spinner();
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (this.agent) {
agentType = this.agent as AgentType;
@@ -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;
}
}
+47 -6
View File
@@ -1,5 +1,5 @@
import { Command, Option } from 'clipanion';
import { colors, symbols, step, success, warn } from '../onboarding/index.js';
import { colors, symbols, step, success, warn, spinner } from '../onboarding/index.js';
import { loadTaps, saveTaps } from '../helpers.js';
export class TapAddCommand extends Command {
@@ -19,15 +19,26 @@ export class TapAddCommand extends Command {
description: 'Display name for the tap',
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const taps = loadTaps();
const exists = taps.taps.some((t) => t.source === this.source);
if (exists) {
warn(`Tap already exists: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
warn(`Tap already exists: ${this.source}`);
}
return 0;
}
s.start('Adding tap');
taps.taps.push({
source: this.source,
name: this.name,
@@ -35,8 +46,14 @@ export class TapAddCommand extends Command {
});
saveTaps(taps);
success(`Added tap: ${this.source}${this.name ? ` (${this.name})` : ''}`);
console.log(colors.muted('Skills from this source will appear in search results'));
s.stop('Tap added');
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
success(`Added tap: ${this.source}${this.name ? ` (${this.name})` : ''}`);
console.log(colors.muted('Skills from this source will appear in search results'));
}
return 0;
}
}
@@ -53,19 +70,34 @@ export class TapRemoveCommand extends Command {
source = Option.String({ required: true });
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
const taps = loadTaps();
const idx = taps.taps.findIndex((t) => t.source === this.source);
if (idx === -1) {
warn(`Tap not found: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
warn(`Tap not found: ${this.source}`);
}
return 0;
}
s.start('Removing tap');
taps.taps.splice(idx, 1);
saveTaps(taps);
s.stop('Tap removed');
success(`Removed tap: ${this.source}`);
if (this.json) {
console.log(JSON.stringify({ success: true, source: this.source }));
} else {
success(`Removed tap: ${this.source}`);
}
return 0;
}
}
@@ -80,9 +112,18 @@ export class TapListCommand extends Command {
],
});
json = Option.Boolean('--json', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const taps = loadTaps();
if (this.json) {
console.log(JSON.stringify({ taps: taps.taps }));
return 0;
}
if (taps.taps.length === 0) {
step('No custom taps configured');
console.log(colors.muted('Add one with: skillkit tap add owner/repo'));
+16 -2
View File
@@ -5,7 +5,7 @@
*/
import { Command, Option } from 'clipanion';
import { colors } from '../onboarding/index.js';
import { colors, spinner } from '../onboarding/index.js';
import { createTeamManager, createSkillBundle, exportBundle, importBundle } from '@skillkit/core';
import { join } from 'node:path';
@@ -82,10 +82,13 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Initializing team');
const config = await teamManager.init({
teamName: this.name,
registryUrl: this.registry,
});
s.stop('Team initialized');
this.context.stdout.write(colors.success('✓ Team initialized!\n'));
this.context.stdout.write(` Team ID: ${config.teamId}\n`);
@@ -105,11 +108,14 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Sharing skill');
const shared = await teamManager.shareSkill({
skillName: this.name,
description: this.description,
tags: this.tags?.split(',').map((t) => t.trim()),
});
s.stop('Skill shared');
this.context.stdout.write(colors.success('✓ Skill shared!\n'));
this.context.stdout.write(` Name: ${shared.name}\n`);
@@ -130,10 +136,13 @@ export class TeamCommand extends Command {
return 1;
}
const s = spinner();
s.start('Importing skill');
const result = await teamManager.importSkill(this.name, {
overwrite: this.overwrite,
dryRun: this.dryRun,
});
s.stop('Import complete');
if (!result.success) {
this.context.stderr.write(colors.error(`✗ ${result.error}\n`));
@@ -184,9 +193,11 @@ export class TeamCommand extends Command {
return 1;
}
this.context.stdout.write(`Syncing with ${config.registryUrl}...\n`);
const s = spinner();
s.start(`Syncing with ${config.registryUrl}`);
const result = await teamManager.sync();
s.stop('Sync complete');
this.context.stdout.write(colors.success('✓ Sync complete!\n'));
if (result.added.length > 0) {
@@ -335,7 +346,10 @@ export class TeamCommand extends Command {
return 0;
}
const s = spinner();
s.start('Importing bundle');
const result = importBundle(this.source, skillsDir, { overwrite: this.overwrite });
s.stop('Import complete');
if (!result.success && result.imported.length === 0) {
this.context.stderr.write(colors.error('✗ Failed to import bundle:\n'));
+5 -3
View File
@@ -1,7 +1,7 @@
import { Command, Option } from 'clipanion';
import { resolve, join } from 'node:path';
import { existsSync, readFileSync, readdirSync } from 'node:fs';
import { colors, warn, success, error, step } from '../onboarding/index.js';
import { colors, warn, success, error, step, spinner } from '../onboarding/index.js';
import {
runTestSuite,
createTestSuiteFromFrontmatter,
@@ -105,16 +105,16 @@ export class TestCommand extends Command {
return 1;
}
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
if (!this.json) {
console.log(colors.bold('Running skill tests...\n'));
}
// Parse tags
const tags = this.tags?.split(',').map((t) => t.trim());
const skipTags = this.skipTags?.split(',').map((t) => t.trim());
const timeout = this.timeout ? parseInt(this.timeout, 10) : undefined;
// Run tests for each skill
const results: TestSuiteResult[] = [];
let allPassed = true;
@@ -128,6 +128,7 @@ export class TestCommand extends Command {
if (!this.json) {
step(`Testing: ${suite.skillName}`);
}
s.start(`Running ${suite.skillName}`);
const result = await runTestSuite(suite, {
cwd: targetPath,
@@ -162,6 +163,7 @@ export class TestCommand extends Command {
},
});
s.stop(`Completed ${suite.skillName}`);
results.push(result);
if (!result.passed) {
+70 -35
View File
@@ -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;
}
+19 -6
View File
@@ -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 -1
View File
@@ -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",
+12
View File
@@ -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 -1
View File
@@ -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 -1
View File
@@ -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",
+155 -1
View File
@@ -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');
});
});
+43 -1
View File
@@ -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
View File
@@ -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,
};
}
}
+16
View File
@@ -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 -1
View File
@@ -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 -1
View File
@@ -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 -1
View File
@@ -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 -1
View File
@@ -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 -1
View File
@@ -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",