Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
d2e5c346f7 | ||
|
|
3e16ac25a7 | ||
|
|
45c94fdcab | ||
|
|
a9e5c83a4c | ||
|
|
e42ae9d87a | ||
|
|
bf6ec9008b | ||
|
|
c4959a50b3 | ||
|
|
9e4739b195 | ||
|
|
a974515520 | ||
|
|
b5b251acff | ||
|
|
1e7cad18c1 | ||
|
|
17e9720834 | ||
|
|
821e9f714b | ||
|
|
7e6612d424 | ||
|
|
49bcd85abf | ||
|
|
2843bd3c5c | ||
|
|
aea3b3ba32 | ||
|
|
97ee4b9a43 | ||
|
|
c8d0bbc844 | ||
|
|
27afc45dea | ||
|
|
fb95260eb5 | ||
|
|
9cbd0e394b | ||
|
|
0b94c6001a | ||
|
|
94fa5c8bce | ||
|
|
5bd2822f12 | ||
|
|
e5d18eba28 | ||
|
|
1af78cbf26 | ||
|
|
97c7b2f16b | ||
|
|
5878e9f80c | ||
|
|
ae8c7a1abb | ||
|
|
196a959569 | ||
|
|
23d1c8932a | ||
|
|
0c82c58905 | ||
|
|
1ce9751797 | ||
|
|
6485745295 | ||
|
|
e9014e130c | ||
|
|
9e50c8abe1 | ||
|
|
49fcc532d2 | ||
|
|
ecead6585c | ||
|
|
cc2eb2504c | ||
|
|
5d7ca0cd8e | ||
|
|
eda488c960 | ||
|
|
559b760202 | ||
|
|
ebd26b7c84 | ||
|
|
8ec5b9d8f2 | ||
|
|
0cba1be49c | ||
|
|
9f0eabc876 | ||
|
|
ceeae304b5 | ||
|
|
bb97e9b747 | ||
|
|
8b4f207fa1 | ||
|
|
c533d6f3bc | ||
|
|
e7dbaeb2b3 | ||
|
|
05b566c0df | ||
|
|
56c565bc65 | ||
|
|
b4582c465d | ||
|
|
d929fe3af0 | ||
|
|
696db60cb4 | ||
|
|
da14f329fd | ||
|
|
dc3f9ba330 | ||
|
|
4206b8aab1 | ||
|
|
a4540c5fc1 | ||
|
|
8cfae7e105 | ||
|
|
f2183b8e14 | ||
|
|
573bbbeed7 | ||
|
|
7003fd3372 | ||
|
|
c611e70764 | ||
|
|
73f95c0b6e | ||
|
|
25556d15d9 | ||
|
|
2b1c04e221 | ||
|
|
b1e1e2f266 | ||
|
|
84fb16486b | ||
|
|
0aae4b16a7 | ||
|
|
244413da79 | ||
|
|
d9d775b189 | ||
|
|
ba09309d5b | ||
|
|
430bcefaa6 | ||
|
|
3007e9f8fd | ||
|
|
7160dfddf2 | ||
|
|
16d00a8ec9 | ||
|
|
3457fbc011 | ||
|
|
dd30ee0af0 | ||
|
|
1fb95fd57e | ||
|
|
dfa8d12c65 | ||
|
|
172602f173 | ||
|
|
e542c4e484 | ||
|
|
9fa542e8d8 | ||
|
|
f714a39a46 | ||
|
|
d9142c8125 | ||
|
|
64944a1c50 | ||
|
|
12bba7f32c | ||
|
|
02fe3f2509 | ||
|
|
808ae83271 | ||
|
|
5324e4528b | ||
|
|
59ea709613 | ||
|
|
6ed78ceba7 | ||
|
|
3509b74f85 | ||
|
|
5691b10c7e |
@@ -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
|
||||||
@@ -0,0 +1,324 @@
|
|||||||
|
name: Auto-Publish Skill Submission
|
||||||
|
|
||||||
|
on:
|
||||||
|
issues:
|
||||||
|
types: [labeled]
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
issues: write
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
concurrency:
|
||||||
|
group: auto-publish-${{ github.event.issue.number }}
|
||||||
|
cancel-in-progress: false
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
auto-publish:
|
||||||
|
if: github.event.label.name == 'skill-submission'
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Install pnpm
|
||||||
|
uses: pnpm/action-setup@v4
|
||||||
|
|
||||||
|
- name: Setup Node.js
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: '20'
|
||||||
|
cache: 'pnpm'
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Build
|
||||||
|
run: pnpm build
|
||||||
|
|
||||||
|
- name: Extract and validate submission
|
||||||
|
id: validate
|
||||||
|
uses: actions/github-script@v7
|
||||||
|
env:
|
||||||
|
ISSUE_BODY: ${{ github.event.issue.body }}
|
||||||
|
with:
|
||||||
|
script: |
|
||||||
|
const { execSync } = require('child_process');
|
||||||
|
const fs = require('fs');
|
||||||
|
const path = require('path');
|
||||||
|
|
||||||
|
const body = process.env.ISSUE_BODY || '';
|
||||||
|
|
||||||
|
const jsonMatch = body.match(/```json\s*\n([\s\S]*?)\n```/);
|
||||||
|
if (!jsonMatch) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', 'No JSON block found in issue body. Please include your source entry between \\`\\`\\`json and \\`\\`\\` fences.');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let entry;
|
||||||
|
try {
|
||||||
|
entry = JSON.parse(jsonMatch[1].trim());
|
||||||
|
} catch (e) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', `Invalid JSON in submission: ${e.message}`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const source = entry.source || (entry.owner && entry.repo ? `${entry.owner}/${entry.repo}` : null);
|
||||||
|
const name = entry.name;
|
||||||
|
const description = entry.description || '';
|
||||||
|
|
||||||
|
if (!source || !name) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', 'Missing required fields. JSON must include `source` (owner/repo) and `name`.');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const parts = source.split('/');
|
||||||
|
if (parts.length !== 2 || !parts[0] || !parts[1]) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', `Invalid source format "${source}". Must be "owner/repo".`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const [owner, repo] = parts;
|
||||||
|
|
||||||
|
const sourcesData = JSON.parse(fs.readFileSync('marketplace/sources.json', 'utf-8'));
|
||||||
|
const existing = sourcesData.sources.find(s => s.source === source);
|
||||||
|
if (existing) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', `Source "${source}" already exists in sources.json as "${existing.name}".`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const repoCheck = await github.rest.repos.get({ owner, repo });
|
||||||
|
if (repoCheck.status !== 200) throw new Error('not found');
|
||||||
|
} catch (e) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', `Repository "${source}" does not exist or is not accessible on GitHub.`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const cloneDir = `/tmp/skill-check-${owner}-${repo}`;
|
||||||
|
try {
|
||||||
|
execSync(`git clone --depth 1 https://github.com/${owner}/${repo}.git ${cloneDir}`, {
|
||||||
|
timeout: 60000,
|
||||||
|
stdio: 'pipe',
|
||||||
|
});
|
||||||
|
} catch (e) {
|
||||||
|
core.setOutput('status', 'error');
|
||||||
|
core.setOutput('message', `Failed to clone repository "${source}".`);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let scanVerdict = 'pass';
|
||||||
|
let scanSummary = '';
|
||||||
|
let qualityScore = 0;
|
||||||
|
let qualitySummary = '';
|
||||||
|
|
||||||
|
try {
|
||||||
|
const scanScript = `
|
||||||
|
const { SkillScanner } = require('./packages/core/dist/scanner/scanner.js');
|
||||||
|
const scanner = new SkillScanner();
|
||||||
|
scanner.scan('${cloneDir}').then(result => {
|
||||||
|
console.log(JSON.stringify({
|
||||||
|
verdict: result.verdict,
|
||||||
|
stats: result.stats,
|
||||||
|
findings: result.findings.length,
|
||||||
|
}));
|
||||||
|
});
|
||||||
|
`;
|
||||||
|
|
||||||
|
const scanOutput = execSync(`node -e "${scanScript.replace(/\n/g, ' ')}"`, {
|
||||||
|
cwd: process.cwd(),
|
||||||
|
timeout: 30000,
|
||||||
|
stdio: 'pipe',
|
||||||
|
}).toString().trim();
|
||||||
|
|
||||||
|
const scanResult = JSON.parse(scanOutput);
|
||||||
|
scanVerdict = scanResult.verdict;
|
||||||
|
scanSummary = `Verdict: ${scanResult.verdict}, Findings: ${scanResult.findings}, Critical: ${scanResult.stats.critical}, High: ${scanResult.stats.high}`;
|
||||||
|
} catch (e) {
|
||||||
|
scanSummary = 'Scanner completed with warnings';
|
||||||
|
}
|
||||||
|
|
||||||
|
const skillMdCandidates = ['SKILL.md', 'skill.md', 'README.md'];
|
||||||
|
let skillContent = null;
|
||||||
|
|
||||||
|
for (const candidate of skillMdCandidates) {
|
||||||
|
try {
|
||||||
|
const found = execSync(`find ${cloneDir} -name "${candidate}" -maxdepth 3 -type f`, {
|
||||||
|
stdio: 'pipe',
|
||||||
|
}).toString().trim().split('\n').filter(Boolean);
|
||||||
|
|
||||||
|
if (found.length > 0) {
|
||||||
|
skillContent = fs.readFileSync(found[0], 'utf-8');
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
} catch {}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (skillContent) {
|
||||||
|
try {
|
||||||
|
const qualityScript = `
|
||||||
|
const { evaluateSkillContent } = require('./packages/core/dist/quality/index.js');
|
||||||
|
const fs = require('fs');
|
||||||
|
const content = fs.readFileSync('${cloneDir}/.skill-content.tmp', 'utf-8');
|
||||||
|
const result = evaluateSkillContent(content);
|
||||||
|
console.log(JSON.stringify({ overall: result.overall, warnings: result.warnings }));
|
||||||
|
`;
|
||||||
|
|
||||||
|
fs.writeFileSync(`${cloneDir}/.skill-content.tmp`, skillContent);
|
||||||
|
|
||||||
|
const qualityOutput = execSync(`node -e "${qualityScript.replace(/\n/g, ' ')}"`, {
|
||||||
|
cwd: process.cwd(),
|
||||||
|
timeout: 30000,
|
||||||
|
stdio: 'pipe',
|
||||||
|
}).toString().trim();
|
||||||
|
|
||||||
|
const qualityResult = JSON.parse(qualityOutput);
|
||||||
|
qualityScore = qualityResult.overall;
|
||||||
|
qualitySummary = `Score: ${qualityResult.overall}/100, Warnings: ${qualityResult.warnings.length}`;
|
||||||
|
} catch (e) {
|
||||||
|
qualityScore = 50;
|
||||||
|
qualitySummary = 'Quality evaluation encountered an error; defaulting to 50';
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
qualityScore = 50;
|
||||||
|
qualitySummary = 'No SKILL.md or README.md found; defaulting to score 50';
|
||||||
|
}
|
||||||
|
|
||||||
|
const scanPassed = scanVerdict !== 'fail';
|
||||||
|
const qualityPassed = qualityScore >= 75;
|
||||||
|
|
||||||
|
core.setOutput('source', source);
|
||||||
|
core.setOutput('name', name);
|
||||||
|
core.setOutput('description', description);
|
||||||
|
core.setOutput('official', entry.official === true ? 'true' : 'false');
|
||||||
|
core.setOutput('scan_verdict', scanVerdict);
|
||||||
|
core.setOutput('scan_summary', scanSummary);
|
||||||
|
core.setOutput('quality_score', String(qualityScore));
|
||||||
|
core.setOutput('quality_summary', qualitySummary);
|
||||||
|
|
||||||
|
if (scanPassed && qualityPassed) {
|
||||||
|
core.setOutput('status', 'pass');
|
||||||
|
core.setOutput('message', `Validation passed. Security: ${scanSummary}. Quality: ${qualitySummary}.`);
|
||||||
|
} else {
|
||||||
|
const reasons = [];
|
||||||
|
if (!scanPassed) reasons.push(`Security scan failed: ${scanSummary}`);
|
||||||
|
if (!qualityPassed) reasons.push(`Quality score ${qualityScore}/100 is below threshold of 75`);
|
||||||
|
core.setOutput('status', 'reject');
|
||||||
|
core.setOutput('message', reasons.join('. '));
|
||||||
|
}
|
||||||
|
|
||||||
|
- name: Add source and commit
|
||||||
|
if: steps.validate.outputs.status == 'pass'
|
||||||
|
env:
|
||||||
|
SKILL_SOURCE: ${{ steps.validate.outputs.source }}
|
||||||
|
SKILL_NAME: ${{ steps.validate.outputs.name }}
|
||||||
|
SKILL_DESCRIPTION: ${{ steps.validate.outputs.description }}
|
||||||
|
ISSUE_NUMBER: ${{ github.event.issue.number }}
|
||||||
|
run: |
|
||||||
|
node -e "
|
||||||
|
const fs = require('fs');
|
||||||
|
const data = JSON.parse(fs.readFileSync('marketplace/sources.json', 'utf-8'));
|
||||||
|
|
||||||
|
const newEntry = { source: process.env.SKILL_SOURCE, name: process.env.SKILL_NAME };
|
||||||
|
|
||||||
|
if (process.env.SKILL_DESCRIPTION) {
|
||||||
|
newEntry.description = process.env.SKILL_DESCRIPTION;
|
||||||
|
}
|
||||||
|
|
||||||
|
const skillsSh = data.sources.pop();
|
||||||
|
data.sources.push(newEntry);
|
||||||
|
if (skillsSh && skillsSh.registry === 'skills-sh') {
|
||||||
|
data.sources.push(skillsSh);
|
||||||
|
}
|
||||||
|
|
||||||
|
data.updatedAt = new Date().toISOString().split('T')[0];
|
||||||
|
fs.writeFileSync('marketplace/sources.json', JSON.stringify(data, null, 2) + '\n');
|
||||||
|
"
|
||||||
|
|
||||||
|
git config --local user.email "github-actions[bot]@users.noreply.github.com"
|
||||||
|
git config --local user.name "github-actions[bot]"
|
||||||
|
git add marketplace/sources.json
|
||||||
|
git commit -m "feat(marketplace): add source from #${ISSUE_NUMBER}"
|
||||||
|
git push
|
||||||
|
|
||||||
|
- name: Close issue on success
|
||||||
|
if: steps.validate.outputs.status == 'pass'
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
SKILL_SOURCE: ${{ steps.validate.outputs.source }}
|
||||||
|
SKILL_NAME: ${{ steps.validate.outputs.name }}
|
||||||
|
SCAN_SUMMARY: ${{ steps.validate.outputs.scan_summary }}
|
||||||
|
QUALITY_SUMMARY: ${{ steps.validate.outputs.quality_summary }}
|
||||||
|
ISSUE_NUMBER: ${{ github.event.issue.number }}
|
||||||
|
run: |
|
||||||
|
cat > /tmp/comment.md <<ENDOFCOMMENT
|
||||||
|
**Skill source auto-published!**
|
||||||
|
|
||||||
|
**Source:** \`${SKILL_SOURCE}\`
|
||||||
|
**Name:** ${SKILL_NAME}
|
||||||
|
**Security:** ${SCAN_SUMMARY}
|
||||||
|
**Quality:** ${QUALITY_SUMMARY}
|
||||||
|
|
||||||
|
The source has been added to \`marketplace/sources.json\` and will be included in the next release.
|
||||||
|
ENDOFCOMMENT
|
||||||
|
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
|
||||||
|
gh issue close "${ISSUE_NUMBER}"
|
||||||
|
|
||||||
|
- name: Comment rejection reason
|
||||||
|
if: steps.validate.outputs.status == 'reject'
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
REJECT_MESSAGE: ${{ steps.validate.outputs.message }}
|
||||||
|
SCAN_VERDICT: ${{ steps.validate.outputs.scan_verdict }}
|
||||||
|
SCAN_SUMMARY: ${{ steps.validate.outputs.scan_summary }}
|
||||||
|
QUALITY_SCORE: ${{ steps.validate.outputs.quality_score }}
|
||||||
|
QUALITY_SUMMARY: ${{ steps.validate.outputs.quality_summary }}
|
||||||
|
ISSUE_NUMBER: ${{ github.event.issue.number }}
|
||||||
|
run: |
|
||||||
|
cat > /tmp/comment.md <<ENDOFCOMMENT
|
||||||
|
**Skill submission did not pass automated checks.**
|
||||||
|
|
||||||
|
${REJECT_MESSAGE}
|
||||||
|
|
||||||
|
**Details:**
|
||||||
|
- Security scan: ${SCAN_VERDICT} (${SCAN_SUMMARY})
|
||||||
|
- Quality score: ${QUALITY_SCORE}/100 (${QUALITY_SUMMARY})
|
||||||
|
|
||||||
|
Please address these issues and update your submission. A maintainer will review manually.
|
||||||
|
ENDOFCOMMENT
|
||||||
|
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
|
||||||
|
gh issue edit "${ISSUE_NUMBER}" --add-label "needs-review"
|
||||||
|
|
||||||
|
- name: Comment parse error
|
||||||
|
if: steps.validate.outputs.status == 'error'
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
ERROR_MESSAGE: ${{ steps.validate.outputs.message }}
|
||||||
|
ISSUE_NUMBER: ${{ github.event.issue.number }}
|
||||||
|
run: |
|
||||||
|
cat > /tmp/comment.md <<'ENDOFCOMMENT'
|
||||||
|
**Could not process skill submission.**
|
||||||
|
|
||||||
|
ENDOFCOMMENT
|
||||||
|
echo "${ERROR_MESSAGE}" >> /tmp/comment.md
|
||||||
|
cat >> /tmp/comment.md <<'ENDOFCOMMENT'
|
||||||
|
|
||||||
|
**Expected format in issue body:**
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"source": "owner/repo",
|
||||||
|
"name": "Display Name",
|
||||||
|
"description": "Optional description"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Please update the issue body and re-apply the `skill-submission` label.
|
||||||
|
ENDOFCOMMENT
|
||||||
|
gh issue comment "${ISSUE_NUMBER}" --body-file /tmp/comment.md
|
||||||
|
gh issue edit "${ISSUE_NUMBER}" --add-label "needs-review"
|
||||||
@@ -3,106 +3,220 @@
|
|||||||
<picture>
|
<picture>
|
||||||
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
|
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
|
||||||
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
|
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
|
||||||
<img alt="SkillKit - One Skill. Every Agent." src="docs/img/banner.svg" width="100%">
|
<img alt="SkillKit. One skill. Every agent." src="docs/img/banner.svg" width="100%">
|
||||||
</picture>
|
</picture>
|
||||||
|
|
||||||
<br/>
|
<br/>
|
||||||
|
|
||||||
|
### *One skill. Every agent. 46 of them.*
|
||||||
|
|
||||||
<br/>
|
<br/>
|
||||||
|
|
||||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
[](https://www.npmjs.com/package/skillkit)
|
||||||
[](https://www.npmjs.com/package/skillkit)
|
[](https://www.npmjs.com/package/skillkit)
|
||||||
[](https://www.npmjs.com/package/skillkit)
|
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||||
[](https://opensource.org/licenses/Apache-2.0)
|
[](LICENSE)
|
||||||
|
|
||||||
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 400K+ skills across registries.
|
|
||||||
|
|
||||||
[Website](https://skillkit.sh) · [Docs](https://skillkit.sh/docs) · [API Explorer](https://skillkit.sh/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
|
<a href="https://skillkit.sh"><img src="assets/tags/skills.svg" alt="400K+ skills"></a>
|
||||||
|
<a href="#supported-agents"><img src="assets/tags/agents.svg" alt="46 agents"></a>
|
||||||
|
<a href="#skill-sources"><img src="assets/tags/sources.svg" alt="31 sources"></a>
|
||||||
|
<img src="assets/tags/tests.svg" alt="757 tests">
|
||||||
|
<a href="LICENSE"><img src="assets/tags/license.svg" alt="Apache 2.0"></a>
|
||||||
|
<a href="CONTRIBUTING.md"><img src="assets/tags/prs-welcome.svg" alt="PRs welcome"></a>
|
||||||
|
|
||||||
|
<a href="#full-vs-slim"><img src="assets/tags/slim-install.svg" alt="slim install"></a>
|
||||||
|
<a href="https://github.com/rohitg00/skillkit/releases/latest"><img src="assets/tags/v1.24.0.svg" alt="v1.24.0"></a>
|
||||||
|
<img src="assets/tags/new.svg" alt="new">
|
||||||
|
<img src="assets/tags/one-skill.svg" alt="one skill">
|
||||||
|
<img src="assets/tags/every-agent.svg" alt="every agent">
|
||||||
|
|
||||||
|
### Quick nav
|
||||||
|
|
||||||
|
[**Quick start**](#quick-start) · [**Install**](#install) · [**Commands**](#commands) · [**Agents**](#supported-agents) · [**Sources**](#skill-sources) · [**API**](#programmatic-api) · [**Website**](https://skillkit.sh)
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Skills make AI coding agents smarter. But every agent uses a different format:
|
|
||||||
|
|
||||||
| Agent | Format | Directory |
|
|
||||||
|-------|--------|-----------|
|
|
||||||
| Claude Code | `SKILL.md` | `.claude/skills/` |
|
|
||||||
| Cursor | `.mdc` | `.cursor/skills/` |
|
|
||||||
| Copilot | Markdown | `.github/skills/` |
|
|
||||||
| Windsurf | Markdown | `.windsurf/skills/` |
|
|
||||||
|
|
||||||
You end up rewriting the same skill for each agent, or locking into one platform.
|
|
||||||
|
|
||||||
**SkillKit fixes this.** Install from 400K+ skills across registries, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npx skillkit@latest
|
|
||||||
```
|
|
||||||
|
|
||||||
## See It In Action
|
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
[](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
|
||||||
|
|
||||||
*Click the image above to watch the full demo*
|
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
## Quick Start
|
## The problem
|
||||||
|
|
||||||
|
Every AI coding agent wants skills. Every agent invented a different format.
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr>
|
||||||
|
<th>Agent</th>
|
||||||
|
<th>Format</th>
|
||||||
|
<th>Directory</th>
|
||||||
|
</tr>
|
||||||
|
<tr><td>Claude Code</td><td><code>SKILL.md</code></td><td><code>.claude/skills/</code></td></tr>
|
||||||
|
<tr><td>Cursor</td><td><code>.mdc</code></td><td><code>.cursor/skills/</code></td></tr>
|
||||||
|
<tr><td>Copilot</td><td>Markdown</td><td><code>.github/skills/</code></td></tr>
|
||||||
|
<tr><td>Windsurf</td><td>Markdown</td><td><code>.windsurf/skills/</code></td></tr>
|
||||||
|
<tr><td colspan="3"><i>... 41 more</i></td></tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
You rewrite the same skill for each agent. Or you lock in to one.
|
||||||
|
|
||||||
|
## The fix
|
||||||
|
|
||||||
|
SkillKit is the package manager for AI agent skills. Install from 400K+ skills across 31 sources. Auto-translate between formats. Persist session learnings. Ship to 46 agents at once.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npx skillkit@latest init # Detect agents, create dirs
|
npx skillkit add anthropics/skills
|
||||||
skillkit recommend # Get smart suggestions
|
|
||||||
skillkit install anthropics/skills # Install from marketplace
|
|
||||||
skillkit sync # Deploy to your agents
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Four commands. Your agents now have skills for PDF processing, code review, and more.
|
That is the whole first-run. Pick your agent (your detected agent is pre-selected), confirm, done.
|
||||||
|
|
||||||
## What Can You Do?
|
## Quick start
|
||||||
|
|
||||||
### Install skills from anywhere
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit install anthropics/skills # GitHub
|
npx skillkit init # detect agent, create dirs
|
||||||
skillkit install gitlab:team/skills # GitLab
|
skillkit recommend # stack-aware suggestions
|
||||||
skillkit install ./my-local-skills # Local path
|
skillkit add anthropics/skills # install from marketplace
|
||||||
|
skillkit sync # deploy to agent config
|
||||||
```
|
```
|
||||||
|
|
||||||
### Translate between agents
|
Four commands. Your agent now has PDF processing, code review, auth patterns, and whatever you need.
|
||||||
|
|
||||||
Write for Claude, deploy to Cursor:
|
### What the first install looks like
|
||||||
|
|
||||||
|
```
|
||||||
|
$ npx skillkit add anthropics/skills
|
||||||
|
|
||||||
|
◇ Detected 32 agents
|
||||||
|
│
|
||||||
|
◆ Install to
|
||||||
|
│ ● Just Claude Code (detected) claude-code
|
||||||
|
│ ○ Select specific agents space to toggle
|
||||||
|
│ ○ All supported agents 32 agents, writes to every adapter
|
||||||
|
└
|
||||||
|
|
||||||
|
◇ Cloning anthropics/skills
|
||||||
|
◇ Security scan: 42/42 skills pass
|
||||||
|
◇ Installed 42 skills to Claude Code
|
||||||
|
│
|
||||||
|
└ Done in 3.1s. Run `skillkit list` to see them.
|
||||||
|
```
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
Pick one. All three do the same thing.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g skillkit # npm
|
||||||
|
pnpm add -g skillkit # pnpm
|
||||||
|
bun add -g skillkit # bun
|
||||||
|
```
|
||||||
|
|
||||||
|
Both `skillkit` and `sk` work as the binary name.
|
||||||
|
|
||||||
|
### Full vs slim
|
||||||
|
|
||||||
|
Four features ship as optional packages so a bare CLI stays small. The default install pulls everything. Add `--omit=optional` if you only want the core.
|
||||||
|
|
||||||
|
| Feature | Package | Command |
|
||||||
|
| :-------------- | :--------------------- | :--------------- |
|
||||||
|
| Terminal UI | `@skillkit/tui` | `skillkit ui` |
|
||||||
|
| REST server | `@skillkit/api` | `skillkit serve` |
|
||||||
|
| Peer mesh | `@skillkit/mesh` | `skillkit mesh` |
|
||||||
|
| Agent messaging | `@skillkit/messaging` | `skillkit message` |
|
||||||
|
|
||||||
|
Cold install numbers on a fresh npm cache:
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="assets/tags/packages.svg" alt="118 packages">
|
||||||
|
<img src="assets/tags/install.svg" alt="9s install">
|
||||||
|
<img src="assets/tags/vulns.svg" alt="0 vulnerabilities">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
| Mode | Packages | Time | Vulns (crit/high) |
|
||||||
|
| :---------------------------------- | -------: | :--: | ----------------: |
|
||||||
|
| `npm i -g skillkit` | 418 | 18s | 0/0 |
|
||||||
|
| `npm i -g skillkit --omit=optional` | 118 | 9s | 0/0 |
|
||||||
|
|
||||||
|
Skipped optional? Add just the one you want later:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm i -g @skillkit/tui # enables: skillkit ui
|
||||||
|
npm i -g @skillkit/api # enables: skillkit serve
|
||||||
|
npm i -g @skillkit/mesh # enables: skillkit mesh
|
||||||
|
npm i -g @skillkit/messaging # enables: skillkit message
|
||||||
|
```
|
||||||
|
|
||||||
|
The CLI catches missing optional packages and prints a one-line hint. No stack trace.
|
||||||
|
|
||||||
|
### Using `npx`
|
||||||
|
|
||||||
|
`npx skillkit add <owner/repo>` works with zero install. First call caches the package under `~/.npm/_npx/`. Every run after that is instant until a new version ships.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npx skillkit add anthropics/skills # full
|
||||||
|
npx --omit=optional skillkit add anthropics/skills # slim
|
||||||
|
```
|
||||||
|
|
||||||
|
If you reach for `npx skillkit` more than twice, switch to a global install. Kills the prompt-to-proceed and the per-release refetch.
|
||||||
|
|
||||||
|
## What you can do
|
||||||
|
|
||||||
|
<details open>
|
||||||
|
<summary><b>Install from anywhere</b></summary>
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit add anthropics/skills # GitHub
|
||||||
|
skillkit add gitlab:team/skills # GitLab
|
||||||
|
skillkit add ./my-local-skills # local path
|
||||||
|
skillkit add https://gist.github.com/... # gist
|
||||||
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Translate between agents</b></summary>
|
||||||
|
|
||||||
|
Write once for Claude, ship everywhere:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit translate my-skill --to cursor
|
skillkit translate my-skill --to cursor
|
||||||
skillkit translate --all --to windsurf
|
skillkit translate --all --to windsurf,codex
|
||||||
|
skillkit translate my-skill --to copilot --dry-run
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Get smart recommendations
|
<details>
|
||||||
|
<summary><b>Stack-aware recommendations</b></summary>
|
||||||
|
|
||||||
SkillKit reads your project, detects your stack, and suggests relevant skills:
|
SkillKit reads your repo, spots your stack, ranks skills:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit recommend
|
$ skillkit recommend
|
||||||
# 92% vercel-react-best-practices
|
|
||||||
# 87% tailwind-v4-patterns
|
92% vercel-react-best-practices
|
||||||
# 85% nextjs-app-router
|
87% tailwind-v4-patterns
|
||||||
|
85% nextjs-app-router
|
||||||
|
81% shadcn-ui-components
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Discover skills at runtime
|
<details>
|
||||||
|
<summary><b>Runtime skill discovery (REST)</b></summary>
|
||||||
|
|
||||||
Start an API server and let agents find skills on demand:
|
Start the server, let agents fetch skills on demand:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit serve
|
skillkit serve
|
||||||
# Server running at http://localhost:3737
|
# http://localhost:3737
|
||||||
|
|
||||||
curl "http://localhost:3737/search?q=react+performance"
|
curl "http://localhost:3737/search?q=react+performance"
|
||||||
```
|
```
|
||||||
|
|
||||||
Or use MCP for native agent integration:
|
Or wire it up with MCP:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
@@ -112,11 +226,7 @@ Or use MCP for native agent integration:
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Or use Python:
|
Or call from Python:
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install skillkit-client
|
|
||||||
```
|
|
||||||
|
|
||||||
```python
|
```python
|
||||||
from skillkit import SkillKitClient
|
from skillkit import SkillKitClient
|
||||||
@@ -125,53 +235,47 @@ async with SkillKitClient() as client:
|
|||||||
results = await client.search("react performance", limit=5)
|
results = await client.search("react performance", limit=5)
|
||||||
```
|
```
|
||||||
|
|
||||||
[REST API docs](https://skillkit.sh/docs/rest-api) · [MCP Server docs](https://skillkit.sh/docs/mcp-server) · [Python Client docs](https://skillkit.sh/docs/python-client) · [Interactive API explorer](https://skillkit.sh/api)
|
[REST docs](https://skillkit.sh/docs/rest-api) · [MCP docs](https://skillkit.sh/docs/mcp-server) · [Python client](https://skillkit.sh/docs/python-client)
|
||||||
|
</details>
|
||||||
|
|
||||||
### Auto-generate agent instructions
|
<details>
|
||||||
|
<summary><b>Auto-generate agent instructions</b></summary>
|
||||||
|
|
||||||
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
|
Analyze the codebase and write CLAUDE.md, `.cursorrules`, AGENTS.md, and friends:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit primer --all-agents
|
skillkit primer --all-agents
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Session memory
|
<details>
|
||||||
|
<summary><b>Session memory</b></summary>
|
||||||
|
|
||||||
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
|
AI agents learn during a session, then forget. SkillKit captures what they learned:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit memory compress
|
skillkit memory compress
|
||||||
skillkit memory search "auth patterns"
|
skillkit memory search "auth patterns"
|
||||||
skillkit memory export auth-patterns
|
skillkit memory export auth-patterns
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### AI skill generation
|
<details>
|
||||||
|
<summary><b>AI skill generation</b></summary>
|
||||||
|
|
||||||
Generate skills from natural language with multi-source context:
|
Generate skills from plain English with multi-source context:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit generate
|
skillkit generate
|
||||||
# Interactive wizard with 4 context sources:
|
|
||||||
# - Documentation (via Context7)
|
|
||||||
# - Your codebase patterns
|
|
||||||
# - 400K+ marketplace skills
|
|
||||||
# - Memory (your corrections)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
|
Pulls context from four places: Context7 docs, your codebase, 400K marketplace skills, your memory. Works with Claude, GPT-4, Gemini, Ollama (local), or any OpenRouter model.
|
||||||
|
</details>
|
||||||
|
|
||||||
### Mesh network
|
<details>
|
||||||
|
<summary><b>Team collaboration</b></summary>
|
||||||
|
|
||||||
Distribute agents across machines with encrypted P2P:
|
Share skills via a committable `.skills` manifest:
|
||||||
|
|
||||||
```bash
|
|
||||||
skillkit mesh init
|
|
||||||
skillkit mesh discover
|
|
||||||
```
|
|
||||||
|
|
||||||
### Team collaboration
|
|
||||||
|
|
||||||
Share skills via a Git-committable `.skills` manifest:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit manifest init
|
skillkit manifest init
|
||||||
@@ -179,112 +283,156 @@ skillkit manifest add anthropics/skills
|
|||||||
git commit -m "add team skills"
|
git commit -m "add team skills"
|
||||||
```
|
```
|
||||||
|
|
||||||
Team members run `skillkit manifest install` and they're in sync.
|
Everyone else runs `skillkit manifest install` and matches state.
|
||||||
|
</details>
|
||||||
|
|
||||||
### Chrome Extension
|
<details>
|
||||||
|
<summary><b>Mesh network</b></summary>
|
||||||
|
|
||||||
Save any webpage as a skill directly from your browser.
|
Distribute agents across machines with encrypted P2P:
|
||||||
|
|
||||||
1. Build: `pnpm --filter @skillkit/extension build`
|
```bash
|
||||||
2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
|
skillkit mesh init
|
||||||
3. Click the extension icon or right-click → "Save page as Skill"
|
skillkit mesh discover
|
||||||
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
|
<details>
|
||||||
|
<summary><b>Chrome extension</b></summary>
|
||||||
|
|
||||||
|
Save any webpage as a skill from the browser. Click the extension, the page round-trips through the SkillKit API (Turndown, 5-source tag detection, GitHub URL support), the `SKILL.md` downloads, then run `skillkit add ~/Downloads/skillkit-skills/<name>`.
|
||||||
|
|
||||||
[Extension docs](https://skillkit.sh/docs/chrome-extension)
|
[Extension docs](https://skillkit.sh/docs/chrome-extension)
|
||||||
|
</details>
|
||||||
|
|
||||||
### Interactive TUI
|
<details>
|
||||||
|
<summary><b>Interactive TUI</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit ui
|
skillkit ui
|
||||||
```
|
```
|
||||||
|
|
||||||
`h` Home · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `q` Quit
|
<sub><code>h</code> home · <code>m</code> marketplace · <code>r</code> recommend · <code>t</code> translate · <code>i</code> installed · <code>s</code> sync · <code>q</code> quit</sub>
|
||||||
|
|
||||||

|
<img src="docs/img/skillkit-ui.png" width="100%" alt="SkillKit interactive TUI">
|
||||||
|
|
||||||
## Supported Agents (44)
|
</details>
|
||||||
|
|
||||||
| Agent | Format | Directory |
|
|
||||||
|-------|--------|-----------|
|
|
||||||
| **Claude Code** | SKILL.md | `.claude/skills/` |
|
|
||||||
| **Cursor** | .mdc | `.cursor/skills/` |
|
|
||||||
| **Codex** | SKILL.md | `.codex/skills/` |
|
|
||||||
| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
|
|
||||||
| **OpenCode** | SKILL.md | `.opencode/skills/` |
|
|
||||||
| **GitHub Copilot** | Markdown | `.github/skills/` |
|
|
||||||
| **Windsurf** | Markdown | `.windsurf/skills/` |
|
|
||||||
| **Devin** | Markdown | `.devin/skills/` |
|
|
||||||
| **Aider** | SKILL.md | `.aider/skills/` |
|
|
||||||
| **Sourcegraph Cody** | SKILL.md | `.cody/skills/` |
|
|
||||||
| **Amazon Q** | SKILL.md | `.amazonq/skills/` |
|
|
||||||
|
|
||||||
Plus 33 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
|
|
||||||
|
|
||||||
[Full agent details](https://skillkit.sh/docs/agents)
|
|
||||||
|
|
||||||
## Commands
|
## Commands
|
||||||
|
|
||||||
### Core
|
<details open>
|
||||||
|
<summary><b>Core</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit install <source> # Install skills
|
skillkit add <source> # install skills (live progress)
|
||||||
skillkit remove <skills> # Remove skills
|
skillkit remove <skills> # remove
|
||||||
skillkit translate <skill> --to # Translate between agents
|
skillkit remove --source org/repo # bulk by source
|
||||||
skillkit sync # Deploy to agent config
|
skillkit remove --all # remove everything
|
||||||
skillkit recommend # Smart recommendations
|
skillkit update # update (change detection)
|
||||||
skillkit generate # AI skill generation wizard
|
skillkit check # updates, quality, activity
|
||||||
skillkit serve # Start REST API server
|
skillkit translate <skill> --to # agent format conversion
|
||||||
|
skillkit sync # deploy to agent config
|
||||||
|
skillkit recommend # smart recommendations
|
||||||
|
skillkit generate # AI skill wizard
|
||||||
|
skillkit serve # REST API server
|
||||||
|
skillkit publish submit # publish to marketplace
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Discovery & Security
|
<details>
|
||||||
|
<summary><b>Discovery & security</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit marketplace # Browse skills
|
skillkit marketplace # browse
|
||||||
skillkit tree # Hierarchical taxonomy
|
skillkit tree # taxonomy
|
||||||
skillkit find <query> # Quick search
|
skillkit find <query> # quick search
|
||||||
skillkit scan <path> # Security scan for skills
|
skillkit scan <path> # security scan
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Issue Planner
|
<details>
|
||||||
|
<summary><b>Custom sources</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit issue plan "#42" # Plan from GitHub Issue
|
skillkit tap add owner/repo
|
||||||
skillkit issue plan owner/repo#42 # Cross-repo plan
|
skillkit tap list
|
||||||
skillkit issue list # List open issues
|
skillkit tap remove owner/repo
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Session Intelligence
|
<details>
|
||||||
|
<summary><b>Issue planner</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit timeline # Unified event stream
|
skillkit issue plan "#42"
|
||||||
skillkit session handoff # Agent-to-agent context
|
skillkit issue plan owner/repo#42
|
||||||
skillkit lineage # Skill impact graph
|
skillkit issue list
|
||||||
skillkit session explain # Human-readable summary
|
|
||||||
skillkit activity # Skill activity log
|
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
### Advanced
|
<details>
|
||||||
|
<summary><b>Session intelligence</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit primer --all-agents # Generate agent instructions
|
skillkit timeline # unified event stream
|
||||||
skillkit memory compress # Capture session learnings
|
skillkit session handoff # agent-to-agent context
|
||||||
skillkit mesh init # Multi-machine distribution
|
skillkit lineage # skill impact graph
|
||||||
skillkit message send # Inter-agent messaging
|
skillkit session explain # human summary
|
||||||
skillkit workflow run <name> # Run workflows
|
skillkit activity # activity log
|
||||||
skillkit test # Test skills
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Advanced</b></summary>
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit primer --all-agents # agent instruction files
|
||||||
|
skillkit memory compress # capture session learnings
|
||||||
|
skillkit mesh init # multi-machine distribution
|
||||||
|
skillkit message send # inter-agent messaging
|
||||||
|
skillkit workflow run <name> # run workflows
|
||||||
|
skillkit test # test skills
|
||||||
skillkit cicd init # CI/CD templates
|
skillkit cicd init # CI/CD templates
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
[Full command reference](https://skillkit.sh/docs/commands)
|
[Full command reference](https://skillkit.sh/docs/commands)
|
||||||
|
|
||||||
## Creating Skills
|
## Supported agents
|
||||||
|
|
||||||
|
<details open>
|
||||||
|
<summary><b>Top 11</b></summary>
|
||||||
|
|
||||||
|
| Agent | Format | Directory |
|
||||||
|
| :----------------- | :--------- | :----------------- |
|
||||||
|
| **Claude Code** | `SKILL.md` | `.claude/skills/` |
|
||||||
|
| **Cursor** | `.mdc` | `.cursor/skills/` |
|
||||||
|
| **Codex** | `SKILL.md` | `.codex/skills/` |
|
||||||
|
| **Gemini CLI** | `SKILL.md` | `.gemini/skills/` |
|
||||||
|
| **OpenCode** | `SKILL.md` | `.opencode/skills/`|
|
||||||
|
| **GitHub Copilot** | Markdown | `.github/skills/` |
|
||||||
|
| **Windsurf** | Markdown | `.windsurf/skills/`|
|
||||||
|
| **Devin** | Markdown | `.devin/skills/` |
|
||||||
|
| **Aider** | `SKILL.md` | `.aider/skills/` |
|
||||||
|
| **Cody** | `SKILL.md` | `.cody/skills/` |
|
||||||
|
| **Amazon Q** | `SKILL.md` | `.amazonq/skills/` |
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Plus 35 more</b></summary>
|
||||||
|
|
||||||
|
Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Hermes Agent, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
[Full agent details](https://skillkit.sh/docs/agents)
|
||||||
|
|
||||||
|
## Creating skills
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit create my-skill
|
skillkit create my-skill
|
||||||
```
|
```
|
||||||
|
|
||||||
Or manually create a `SKILL.md`:
|
Or author a `SKILL.md` by hand:
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
---
|
---
|
||||||
@@ -295,20 +443,20 @@ license: MIT
|
|||||||
|
|
||||||
# My Skill
|
# My Skill
|
||||||
|
|
||||||
Instructions for the AI agent.
|
Instructions for the agent.
|
||||||
|
|
||||||
## When to Use
|
## When to use
|
||||||
- Scenario 1
|
- scenario 1
|
||||||
- Scenario 2
|
- scenario 2
|
||||||
|
|
||||||
## Steps
|
## Steps
|
||||||
1. First step
|
1. first
|
||||||
2. Second step
|
2. second
|
||||||
```
|
```
|
||||||
|
|
||||||
## Programmatic API
|
## Programmatic API
|
||||||
|
|
||||||
```typescript
|
```ts
|
||||||
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
|
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
|
||||||
|
|
||||||
const skill = await translateSkill(content, 'cursor');
|
const skill = await translateSkill(content, 'cursor');
|
||||||
@@ -318,53 +466,53 @@ const engine = new RecommendationEngine();
|
|||||||
const recs = await engine.recommend(profile);
|
const recs = await engine.recommend(profile);
|
||||||
```
|
```
|
||||||
|
|
||||||
```typescript
|
```ts
|
||||||
import { startServer } from '@skillkit/api';
|
import { startServer } from '@skillkit/api';
|
||||||
await startServer({ port: 3737, skills: [...] });
|
await startServer({ port: 3737, skills: [...] });
|
||||||
```
|
```
|
||||||
|
|
||||||
```typescript
|
```ts
|
||||||
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
|
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
|
||||||
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
|
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
|
||||||
const ranker = new RelevanceRanker();
|
const ranker = new RelevanceRanker();
|
||||||
const results = ranker.rank(skills, 'react performance');
|
const results = ranker.rank(skills, 'react performance');
|
||||||
```
|
```
|
||||||
|
|
||||||
## Skill Sources
|
## Skill sources
|
||||||
|
|
||||||
SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
|
All original creators credited. Licenses preserved. PRs welcome.
|
||||||
|
|
||||||
### Official Partners
|
### Official partners
|
||||||
|
|
||||||
| Repository | Description |
|
| Repository | What |
|
||||||
|------------|-------------|
|
|:-----------|:-----|
|
||||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
|
||||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
|
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React |
|
||||||
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
|
| [expo/skills](https://github.com/expo/skills) | Expo mobile |
|
||||||
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
|
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video |
|
||||||
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
|
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth |
|
||||||
| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
|
| [stripe/ai](https://github.com/stripe/ai) | Payments |
|
||||||
|
|
||||||
### Community
|
### Community
|
||||||
|
|
||||||
[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
|
[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
|
||||||
|
|
||||||
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
|
**Want your skills listed?** [Submit your repo](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md).
|
||||||
|
|
||||||
## Install
|
## Contributing
|
||||||
|
|
||||||
```bash
|
Issues and PRs land fast. See [CONTRIBUTING.md](CONTRIBUTING.md) for the short version.
|
||||||
npm install -g skillkit # npm
|
|
||||||
pnpm add -g skillkit # pnpm
|
|
||||||
yarn global add skillkit # yarn
|
|
||||||
bun add -g skillkit # bun
|
|
||||||
npx skillkit <command> # no install
|
|
||||||
```
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
Apache License 2.0 — see [LICENSE](LICENSE).
|
Apache 2.0. See [LICENSE](LICENSE).
|
||||||
|
|
||||||
## Links
|
<br/>
|
||||||
|
|
||||||
[Documentation](https://skillkit.sh/docs) · [Website](https://skillkit.sh) · [API Explorer](https://skillkit.sh/api) · [npm](https://www.npmjs.com/package/skillkit) · [GitHub](https://github.com/rohitg00/skillkit)
|
<div align="center">
|
||||||
|
|
||||||
|
[**Docs**](https://skillkit.sh/docs) · [**Website**](https://skillkit.sh) · [**API Explorer**](https://skillkit.sh/api) · [**npm**](https://www.npmjs.com/package/skillkit) · [**GitHub**](https://github.com/rohitg00/skillkit)
|
||||||
|
|
||||||
|
<sub>Built for agents. Written by humans.</sub>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|||||||
@@ -0,0 +1,35 @@
|
|||||||
|
# SOUL
|
||||||
|
|
||||||
|
## Core Truths
|
||||||
|
|
||||||
|
- Ship working software. Everything else is negotiable.
|
||||||
|
- Simple beats clever. If a junior dev can't read it in 30 seconds, it's too complex.
|
||||||
|
- Opinions are load-bearing. "It depends" is a cop-out 90% of the time. Pick a side, explain why, move on.
|
||||||
|
- Exhaustion before escalation. Try everything available before asking for help or giving up.
|
||||||
|
- Broken things get fixed now, not "in a follow-up PR."
|
||||||
|
- If the tests pass and the build is green, stop touching it.
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Never leak secrets, credentials, or private data. Period.
|
||||||
|
- Ask before doing anything destructive or irreversible. One confirmation. Not three.
|
||||||
|
- Be honest about uncertainty. "I don't know" is a valid answer. Bullshitting is not.
|
||||||
|
- The user's codebase is their house. Don't rearrange the furniture without permission.
|
||||||
|
|
||||||
|
## Vibe
|
||||||
|
|
||||||
|
- Never open with "Great question," "I'd be happy to help," or "Absolutely." Just answer.
|
||||||
|
- Brevity is mandatory. If the answer fits in one sentence, one sentence is what you get.
|
||||||
|
- Humor is welcome when it's natural. Not forced puns. The kind of wit that comes from actually understanding the problem.
|
||||||
|
- Call things out. If you're about to do something dumb, I'll say so. Charm over cruelty, but no sugarcoating.
|
||||||
|
- Swearing is fine when it lands. A well-placed "that's fucking brilliant" hits different than sterile corporate praise. Don't force it. Don't overdo it. But if a situation calls for a "holy shit" — say holy shit.
|
||||||
|
- No hedging. No weasel words. No "it might be worth considering perhaps maybe." Say the thing.
|
||||||
|
- Match energy. Quick question gets a quick answer. Deep problem gets deep analysis. Read the room.
|
||||||
|
- Code speaks louder than explanations. Show, don't tell. Then shut up.
|
||||||
|
- Be the assistant you'd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good.
|
||||||
|
|
||||||
|
## Continuity
|
||||||
|
|
||||||
|
- This file is a living document. If something stops being true, change it.
|
||||||
|
- Session memory is ephemeral. This file is how identity persists.
|
||||||
|
- If this file gets modified during a session, say so explicitly.
|
||||||
@@ -1,11 +1,49 @@
|
|||||||
# SkillKit
|
# 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 46 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Full install (default) — every feature, everything works:
|
||||||
npm install -g skillkit
|
npm install -g skillkit
|
||||||
|
|
||||||
|
# Slim install — core commands only, ~75% smaller, no native addons:
|
||||||
|
npm install -g skillkit --omit=optional
|
||||||
|
```
|
||||||
|
|
||||||
|
### What's optional
|
||||||
|
|
||||||
|
Four power features ship as **optional dependencies** so the core CLI
|
||||||
|
stays lean. They install automatically with `npm install -g skillkit`,
|
||||||
|
and are skipped with `--omit=optional`:
|
||||||
|
|
||||||
|
| Feature | Package | Command |
|
||||||
|
| ------------------------ | -------------------- | ------------------------------ |
|
||||||
|
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
|
||||||
|
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
|
||||||
|
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
|
||||||
|
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
|
||||||
|
|
||||||
|
Add one later with `npm install -g @skillkit/tui` (or `api` / `mesh` / `messaging`).
|
||||||
|
|
||||||
|
### Using `npx`
|
||||||
|
|
||||||
|
`npx skillkit add <owner/repo>` works with zero install. First run pulls
|
||||||
|
the package into the npx cache (`~/.npm/_npx/`); every subsequent run
|
||||||
|
from the same cache is instant.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npx skillkit add anthropics/skills # full
|
||||||
|
npx --omit=optional skillkit add anthropics/skills # slim, 118 pkgs, 9 s
|
||||||
|
```
|
||||||
|
|
||||||
|
Running `npx` more than a couple of times? Install globally — no
|
||||||
|
prompt-to-proceed, no refetch on each release:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g skillkit --omit=optional
|
||||||
|
skillkit add anthropics/skills
|
||||||
```
|
```
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
@@ -150,11 +188,11 @@ skillkit memory compress
|
|||||||
skillkit memory export auth-insight --output auth-skill.md
|
skillkit memory export auth-insight --output auth-skill.md
|
||||||
```
|
```
|
||||||
|
|
||||||
## Supported Agents (32)
|
## Supported Agents (46)
|
||||||
|
|
||||||
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
**Primary (19):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Hermes Agent, 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
|
## Usage Examples
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "skillkit",
|
"name": "skillkit",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 41 more",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"bin": {
|
"bin": {
|
||||||
"skillkit": "./dist/cli.js",
|
"skillkit": "./dist/cli.js",
|
||||||
@@ -53,16 +53,17 @@
|
|||||||
"node": ">=18.0.0"
|
"node": ">=18.0.0"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@skillkit/api": "workspace:*",
|
|
||||||
"@skillkit/core": "workspace:*",
|
"@skillkit/core": "workspace:*",
|
||||||
"@skillkit/agents": "workspace:*",
|
"@skillkit/agents": "workspace:*",
|
||||||
"@skillkit/cli": "workspace:*",
|
"@skillkit/cli": "workspace:*",
|
||||||
"@skillkit/tui": "workspace:*",
|
|
||||||
"@skillkit/memory": "workspace:*",
|
|
||||||
"@skillkit/mesh": "workspace:*",
|
|
||||||
"@skillkit/messaging": "workspace:*",
|
|
||||||
"clipanion": "^4.0.0-rc.4"
|
"clipanion": "^4.0.0-rc.4"
|
||||||
},
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"@skillkit/api": "workspace:*",
|
||||||
|
"@skillkit/tui": "workspace:*",
|
||||||
|
"@skillkit/mesh": "workspace:*",
|
||||||
|
"@skillkit/messaging": "workspace:*"
|
||||||
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@types/node": "^22.10.5",
|
"@types/node": "^22.10.5",
|
||||||
"tsup": "^8.3.5",
|
"tsup": "^8.3.5",
|
||||||
|
|||||||
@@ -3,6 +3,8 @@ import { readFileSync } from 'node:fs';
|
|||||||
import { fileURLToPath } from 'node:url';
|
import { fileURLToPath } from 'node:url';
|
||||||
import { dirname, join } from 'node:path';
|
import { dirname, join } from 'node:path';
|
||||||
import { Cli, Builtins } from 'clipanion';
|
import { Cli, Builtins } from 'clipanion';
|
||||||
|
import { setVersion, setAgentCount } from '@skillkit/cli';
|
||||||
|
import { getAdapterCount } from '@skillkit/agents';
|
||||||
import {
|
import {
|
||||||
InstallCommand,
|
InstallCommand,
|
||||||
SyncCommand,
|
SyncCommand,
|
||||||
@@ -110,6 +112,7 @@ import {
|
|||||||
SkillMdCheckCommand,
|
SkillMdCheckCommand,
|
||||||
ServeCommand,
|
ServeCommand,
|
||||||
ScanCommand,
|
ScanCommand,
|
||||||
|
EvalCommand,
|
||||||
DoctorCommand,
|
DoctorCommand,
|
||||||
SaveCommand,
|
SaveCommand,
|
||||||
AgentsMdCommand,
|
AgentsMdCommand,
|
||||||
@@ -121,6 +124,9 @@ import {
|
|||||||
TimelineCommand,
|
TimelineCommand,
|
||||||
SessionHandoffCommand,
|
SessionHandoffCommand,
|
||||||
LineageCommand,
|
LineageCommand,
|
||||||
|
TapAddCommand,
|
||||||
|
TapRemoveCommand,
|
||||||
|
TapListCommand,
|
||||||
} from '@skillkit/cli';
|
} from '@skillkit/cli';
|
||||||
|
|
||||||
const __filename = fileURLToPath(import.meta.url);
|
const __filename = fileURLToPath(import.meta.url);
|
||||||
@@ -129,6 +135,9 @@ const packageJsonPath = join(__dirname, '../package.json');
|
|||||||
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
|
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
|
||||||
const version = packageJson.version || '1.2.0';
|
const version = packageJson.version || '1.2.0';
|
||||||
|
|
||||||
|
setVersion(version);
|
||||||
|
setAgentCount(getAdapterCount());
|
||||||
|
|
||||||
const cli = new Cli({
|
const cli = new Cli({
|
||||||
binaryLabel: 'skillkit',
|
binaryLabel: 'skillkit',
|
||||||
binaryName: 'skillkit',
|
binaryName: 'skillkit',
|
||||||
@@ -256,6 +265,7 @@ cli.register(SkillMdCheckCommand);
|
|||||||
|
|
||||||
cli.register(ServeCommand);
|
cli.register(ServeCommand);
|
||||||
cli.register(ScanCommand);
|
cli.register(ScanCommand);
|
||||||
|
cli.register(EvalCommand);
|
||||||
cli.register(DoctorCommand);
|
cli.register(DoctorCommand);
|
||||||
cli.register(SaveCommand);
|
cli.register(SaveCommand);
|
||||||
cli.register(AgentsMdCommand);
|
cli.register(AgentsMdCommand);
|
||||||
@@ -270,4 +280,8 @@ cli.register(TimelineCommand);
|
|||||||
cli.register(SessionHandoffCommand);
|
cli.register(SessionHandoffCommand);
|
||||||
cli.register(LineageCommand);
|
cli.register(LineageCommand);
|
||||||
|
|
||||||
|
cli.register(TapAddCommand);
|
||||||
|
cli.register(TapRemoveCommand);
|
||||||
|
cli.register(TapListCommand);
|
||||||
|
|
||||||
cli.runExit(process.argv.slice(2));
|
cli.runExit(process.argv.slice(2));
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
// Re-export all public APIs from packages
|
|
||||||
export * from '@skillkit/core';
|
export * from '@skillkit/core';
|
||||||
export * from '@skillkit/agents';
|
export * from '@skillkit/agents';
|
||||||
|
|
||||||
// Re-export TUI entry point
|
export async function startTUI(...args: unknown[]): Promise<unknown> {
|
||||||
export { startTUI } from '@skillkit/tui';
|
const mod = await import('@skillkit/tui');
|
||||||
|
return mod.startTUI(...(args as Parameters<typeof mod.startTUI>));
|
||||||
|
}
|
||||||
|
|||||||
@@ -7,4 +7,7 @@ export default defineConfig({
|
|||||||
splitting: false,
|
splitting: false,
|
||||||
sourcemap: true,
|
sourcemap: true,
|
||||||
clean: true,
|
clean: true,
|
||||||
|
platform: 'node',
|
||||||
|
target: 'node18',
|
||||||
|
skipNodeModulesBundle: true,
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="56" height="28" fill="#18181b"/>
|
||||||
|
<rect x="56" width="28" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">agents</text>
|
||||||
|
<text x="70" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">46</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 804 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#a78bfa"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">community</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 454 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#06b6d4"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">curated</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 452 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="119" height="28" viewBox="0 0 119 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="119" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="98" height="28" fill="#18181b"/>
|
||||||
|
<rect x="98" width="21" height="28" fill="#22c55e"/>
|
||||||
|
<rect x="0.5" y="0.5" width="118" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="49" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">deprecations</text>
|
||||||
|
<text x="108.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 813 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">every agent</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 459 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="63" height="28" fill="#18181b"/>
|
||||||
|
<rect x="63" width="28" height="28" fill="#22c55e"/>
|
||||||
|
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">install</text>
|
||||||
|
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">9s</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 804 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="147" height="28" viewBox="0 0 147 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="147" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="63" height="28" fill="#18181b"/>
|
||||||
|
<rect x="63" width="84" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="146" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">license</text>
|
||||||
|
<text x="105" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">Apache-2.0</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 820 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="50" height="28" viewBox="0 0 50 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="49" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">new</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 448 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="42" height="28" fill="#18181b"/>
|
||||||
|
<rect x="42" width="42" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="21" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">node</text>
|
||||||
|
<text x="63" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">>=18</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 804 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="86" height="28" viewBox="0 0 86 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="85" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#f59e0b"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">official</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 453 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="93" height="28" viewBox="0 0 93 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="92" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">one skill</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 454 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#f472b6"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">open source</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 459 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="70" height="28" fill="#18181b"/>
|
||||||
|
<rect x="70" width="35" height="28" fill="#3b82f6"/>
|
||||||
|
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="35" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">packages</text>
|
||||||
|
<text x="87.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fff" letter-spacing="0.3">118</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 810 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="28" viewBox="0 0 107 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="106" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#22c55e"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">PRs welcome</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 459 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="105" height="28" viewBox="0 0 105 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="105" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="56" height="28" fill="#18181b"/>
|
||||||
|
<rect x="56" width="49" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="104" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="28" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">skills</text>
|
||||||
|
<text x="80.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">400K+</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 813 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="114" height="28" viewBox="0 0 114 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="113" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">slim install</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 460 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="91" height="28" viewBox="0 0 91 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="91" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="63" height="28" fill="#18181b"/>
|
||||||
|
<rect x="63" width="28" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="90" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="31.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">sources</text>
|
||||||
|
<text x="77" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">31</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 807 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="84" height="28" viewBox="0 0 84 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="84" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="49" height="28" fill="#18181b"/>
|
||||||
|
<rect x="49" width="35" height="28" fill="#09090b"/>
|
||||||
|
<rect x="0.5" y="0.5" width="83" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">tests</text>
|
||||||
|
<text x="66.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#fafafa" letter-spacing="0.3">757</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 808 B |
@@ -0,0 +1,5 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
|
||||||
|
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||||
|
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
|
||||||
|
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">v1.24.0</text>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 452 B |
@@ -0,0 +1,10 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="70" height="28" viewBox="0 0 70 28" role="img">
|
||||||
|
<clipPath id="c"><rect width="70" height="28" rx="4" ry="4"/></clipPath>
|
||||||
|
<g clip-path="url(#c)">
|
||||||
|
<rect width="49" height="28" fill="#18181b"/>
|
||||||
|
<rect x="49" width="21" height="28" fill="#22c55e"/>
|
||||||
|
<rect x="0.5" y="0.5" width="69" height="27" fill="none" stroke="#3f3f46" rx="4" ry="4"/>
|
||||||
|
<text x="24.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="500" fill="#a1a1aa" letter-spacing="0.3">vulns</text>
|
||||||
|
<text x="59.5" y="18" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="700" fill="#000" letter-spacing="0.3">0</text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 803 B |
@@ -1,11 +1,11 @@
|
|||||||
---
|
---
|
||||||
title: Supported Agents
|
title: Supported Agents
|
||||||
description: 44 AI coding agents supported by SkillKit
|
description: 45 AI coding agents supported by SkillKit
|
||||||
---
|
---
|
||||||
|
|
||||||
# Supported Agents
|
# Supported Agents
|
||||||
|
|
||||||
SkillKit uses an adapter pattern to support 44 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
SkillKit uses an adapter pattern to support 45 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
||||||
|
|
||||||
## Agent Directory Mapping
|
## Agent Directory Mapping
|
||||||
|
|
||||||
|
|||||||
@@ -70,11 +70,24 @@ skillkit install anthropics/skills --agent claude --agent cursor
|
|||||||
skillkit remove <skill-names> [options]
|
skillkit remove <skill-names> [options]
|
||||||
```
|
```
|
||||||
|
|
||||||
| Option | Purpose |
|
| Option | Short | Purpose |
|
||||||
|--------|---------|
|
|--------|-------|---------|
|
||||||
| `--agent` | Target specific agents (default: all) |
|
| `--agent` | — | Target specific agents (default: all) |
|
||||||
| `--yes` | Skip confirmation |
|
| `--yes` | — | Skip confirmation |
|
||||||
| `--keep-metadata` | Remove skill but preserve metadata |
|
| `--keep-metadata` | — | Remove skill but preserve metadata |
|
||||||
|
| `--source` | `-s` | Remove all skills installed from a specific source |
|
||||||
|
| `--all` | `-a` | Remove all installed skills |
|
||||||
|
| `--force` | `-f` | Skip confirmation prompt |
|
||||||
|
|
||||||
|
### Bulk Removal
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit remove --source iii-hq/iii
|
||||||
|
skillkit remove --all
|
||||||
|
skillkit remove --all --force
|
||||||
|
```
|
||||||
|
|
||||||
|
When using `--source`, SkillKit matches against the source field in each skill's metadata and removes every skill that was installed from that repository. When using `--all`, every discovered skill across all agent directories is removed. Both flags update AGENTS.md automatically if managed sections are present.
|
||||||
|
|
||||||
## Update Command
|
## Update Command
|
||||||
|
|
||||||
@@ -82,11 +95,19 @@ skillkit remove <skill-names> [options]
|
|||||||
skillkit update [skill-names] [options]
|
skillkit update [skill-names] [options]
|
||||||
```
|
```
|
||||||
|
|
||||||
| Option | Purpose |
|
| Option | Short | Purpose |
|
||||||
|--------|---------|
|
|--------|-------|---------|
|
||||||
| `--dry-run` | Check for updates without installing |
|
| `--dry-run` | — | Check for updates without installing |
|
||||||
| `--yes` | Skip confirmation prompts |
|
| `--yes` | — | Skip confirmation prompts |
|
||||||
| `--agent` | Update in specific agents only |
|
| `--agent` | — | Update in specific agents only |
|
||||||
|
| `--force` | `-f` | Force update, bypass checksum and GitHub API checks |
|
||||||
|
|
||||||
|
The update command uses a two-stage change detection pipeline:
|
||||||
|
|
||||||
|
1. **GitHub API check** -- For remote sources, SkillKit queries the GitHub API to compare the repository's `pushed_at` timestamp against the installed metadata. If the repository has not been pushed since the last install or update, the skill is skipped without cloning.
|
||||||
|
2. **Checksum comparison** -- After cloning, a checksum of the source SKILL.md is compared against the stored checksum. If the content is identical, the update is skipped.
|
||||||
|
|
||||||
|
Use `--force` to bypass both checks and always overwrite the installed skill.
|
||||||
|
|
||||||
## Enable/Disable Commands
|
## Enable/Disable Commands
|
||||||
|
|
||||||
@@ -97,6 +118,26 @@ skillkit disable <skill-names> [options]
|
|||||||
|
|
||||||
Disabled skills are ignored by the `sync` command. No file changes occur.
|
Disabled skills are ignored by the `sync` command. No file changes occur.
|
||||||
|
|
||||||
|
## Check Command
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit check [skill-names] [options]
|
||||||
|
```
|
||||||
|
|
||||||
|
Checks installed skills for available updates, quality scores, and GitHub activity.
|
||||||
|
|
||||||
|
| Option | Short | Purpose |
|
||||||
|
|--------|-------|---------|
|
||||||
|
| `--verbose` | `-v` | Show detailed output including stars and push dates |
|
||||||
|
| `--quiet` | `-q` | Minimal output |
|
||||||
|
|
||||||
|
For remote GitHub sources, the check command queries the GitHub API to compare each repository's `pushed_at` timestamp against the installed date. Each skill displays its quality score badge (A-F). In verbose mode, the output also includes the repository's star count and how recently it was pushed.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit check
|
||||||
|
skillkit check pdf xlsx --verbose
|
||||||
|
```
|
||||||
|
|
||||||
## List Command
|
## List Command
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -457,6 +498,48 @@ skillkit publish --dry-run # Preview without writing
|
|||||||
skillkit publish submit # Submit to SkillKit marketplace
|
skillkit publish submit # Submit to SkillKit marketplace
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### publish submit
|
||||||
|
|
||||||
|
Submits a skill to the SkillKit marketplace by creating a GitHub issue on `rohitg00/skillkit` via the `gh` CLI. No browser is needed.
|
||||||
|
|
||||||
|
Before submitting, the command displays:
|
||||||
|
- Quality score and grade (A-F) from the skill evaluator
|
||||||
|
- GitHub star count and last push date from the GitHub API
|
||||||
|
- Any quality warnings (up to 3)
|
||||||
|
|
||||||
|
If `gh` is not installed or not authenticated, the command prints a manual submission URL as a fallback.
|
||||||
|
|
||||||
|
## Tap Command
|
||||||
|
|
||||||
|
Manage custom skill sources (taps). Taps are user-level source repositories stored in `~/.skillkit/taps.json`. They let you add private or third-party skill repositories that are not part of the official marketplace.
|
||||||
|
|
||||||
|
### tap add
|
||||||
|
|
||||||
|
Add a custom skill source.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit tap add owner/repo
|
||||||
|
skillkit tap add owner/repo --name "My Skills"
|
||||||
|
```
|
||||||
|
|
||||||
|
### tap remove
|
||||||
|
|
||||||
|
Remove a custom skill source.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit tap remove owner/repo
|
||||||
|
```
|
||||||
|
|
||||||
|
### tap list
|
||||||
|
|
||||||
|
List all custom skill sources.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
skillkit tap list
|
||||||
|
```
|
||||||
|
|
||||||
|
Once a tap is added, skills from that source appear in `skillkit marketplace search` results and can be installed with the standard `skillkit install owner/repo` workflow.
|
||||||
|
|
||||||
## Security Scanning
|
## Security Scanning
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
@@ -152,11 +152,61 @@ primer:
|
|||||||
- .next
|
- .next
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Lock File
|
||||||
|
|
||||||
|
SkillKit maintains a centralized lock file at `~/.skillkit/lock.json` that tracks every installed skill. The lock file is written on install, updated on update, and cleaned on remove.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"version": 1,
|
||||||
|
"skills": {
|
||||||
|
"pdf": {
|
||||||
|
"source": "anthropics/skills",
|
||||||
|
"checksum": "sha256:abc123...",
|
||||||
|
"agents": ["claude-code", "cursor"],
|
||||||
|
"installedAt": "2026-04-01T12:00:00Z",
|
||||||
|
"updatedAt": "2026-04-08T09:30:00Z"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
| Field | Description |
|
||||||
|
|-------|-------------|
|
||||||
|
| `source` | The repository or local path the skill was installed from |
|
||||||
|
| `checksum` | SHA-256 hash of the SKILL.md content at install time, used for update detection |
|
||||||
|
| `agents` | Which agents the skill is installed for |
|
||||||
|
| `installedAt` | ISO timestamp of initial installation |
|
||||||
|
| `updatedAt` | ISO timestamp of the most recent update |
|
||||||
|
|
||||||
|
The `update` command compares the stored checksum against the source to skip unchanged skills. The `remove` command cleans up the corresponding lock entry.
|
||||||
|
|
||||||
|
## Taps File
|
||||||
|
|
||||||
|
Custom skill source repositories are stored in `~/.skillkit/taps.json`. Taps are managed via the `skillkit tap` commands.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"version": 1,
|
||||||
|
"taps": [
|
||||||
|
{
|
||||||
|
"source": "myorg/internal-skills",
|
||||||
|
"name": "Internal Skills",
|
||||||
|
"addedAt": "2026-04-05T10:00:00Z"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Skills from tapped sources appear in marketplace search results and can be installed like any other source. See the [tap command](/docs/commands#tap-command) documentation for usage.
|
||||||
|
|
||||||
## Directory Structure
|
## Directory Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
~/.skillkit/
|
~/.skillkit/
|
||||||
├── preferences.json # User preferences
|
├── preferences.json # User preferences
|
||||||
|
├── lock.json # Installed skill tracking
|
||||||
|
├── taps.json # Custom skill sources
|
||||||
├── cache/ # Marketplace cache
|
├── cache/ # Marketplace cache
|
||||||
├── memory/ # Learning storage
|
├── memory/ # Learning storage
|
||||||
│ ├── observations/
|
│ ├── observations/
|
||||||
|
|||||||
@@ -29,7 +29,7 @@ skillkit/
|
|||||||
│ ├── core/ # Business logic
|
│ ├── core/ # Business logic
|
||||||
│ ├── cli/ # CLI
|
│ ├── cli/ # CLI
|
||||||
│ ├── tui/ # Terminal UI
|
│ ├── tui/ # Terminal UI
|
||||||
│ └── agents/ # 44 adapters
|
│ └── agents/ # 45 adapters
|
||||||
├── marketplace/ # Skills data
|
├── marketplace/ # Skills data
|
||||||
│ ├── skills.json
|
│ ├── skills.json
|
||||||
│ └── sources.json
|
│ └── sources.json
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ description: Universal skill management for AI coding agents
|
|||||||
|
|
||||||
Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
|
Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
|
||||||
|
|
||||||
SkillKit fixes this. Write a skill once, deploy it to all 44 agents.
|
SkillKit fixes this. Write a skill once, deploy it to all 45 agents.
|
||||||
|
|
||||||
## Get Started
|
## Get Started
|
||||||
|
|
||||||
@@ -95,7 +95,7 @@ SkillKit sits between your skills and your agents. It handles format translation
|
|||||||
|
|
||||||
## Supported Agents
|
## Supported Agents
|
||||||
|
|
||||||
44 agents and counting:
|
45 agents and counting:
|
||||||
|
|
||||||
**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
|
**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
|
||||||
|
|
||||||
|
|||||||
@@ -33,6 +33,61 @@ bun add -g skillkit
|
|||||||
|
|
||||||
Both `skillkit` and `sk` work as command aliases.
|
Both `skillkit` and `sk` work as command aliases.
|
||||||
|
|
||||||
|
## Full vs slim install
|
||||||
|
|
||||||
|
SkillKit ships four power features as **optional dependencies** so the
|
||||||
|
core install stays small. The default `npm install -g skillkit` installs
|
||||||
|
every feature; `--omit=optional` installs only the core CLI.
|
||||||
|
|
||||||
|
| Feature | Package | Command |
|
||||||
|
| ------------------------ | -------------------- | ------------------------------ |
|
||||||
|
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
|
||||||
|
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
|
||||||
|
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
|
||||||
|
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Full (default) — every feature works out of the box:
|
||||||
|
npm install -g skillkit
|
||||||
|
|
||||||
|
# Slim — core commands only, ~75% smaller, no native addons, 0 deprecation warnings:
|
||||||
|
npm install -g skillkit --omit=optional
|
||||||
|
```
|
||||||
|
|
||||||
|
Add one later:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g @skillkit/tui # enables: skillkit ui
|
||||||
|
npm install -g @skillkit/api # enables: skillkit serve
|
||||||
|
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||||
|
npm install -g @skillkit/messaging # enables: skillkit message
|
||||||
|
```
|
||||||
|
|
||||||
|
The CLI catches a missing optional feature and prints a one-line hint,
|
||||||
|
so you'll never see an unhandled stack trace.
|
||||||
|
|
||||||
|
## Using `npx`
|
||||||
|
|
||||||
|
`npx skillkit add <owner/repo>` runs without a global install. First run
|
||||||
|
downloads into the npx cache (`~/.npm/_npx/`); every call after that is
|
||||||
|
instant until the cache expires or a new version ships.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Full — every feature works:
|
||||||
|
npx skillkit add anthropics/skills
|
||||||
|
|
||||||
|
# Slim — core commands only, 75% fewer packages, 0 warnings:
|
||||||
|
npx --omit=optional skillkit add anthropics/skills
|
||||||
|
```
|
||||||
|
|
||||||
|
If you use `npx skillkit` more than a couple of times, install globally
|
||||||
|
to skip the prompt-to-proceed and avoid the per-release cache refetch:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g skillkit --omit=optional
|
||||||
|
skillkit add anthropics/skills
|
||||||
|
```
|
||||||
|
|
||||||
## Verify
|
## Verify
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -58,7 +113,7 @@ The init command:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
skillkit init --agent cursor
|
skillkit init --agent cursor
|
||||||
skillkit init --list # Show all 44 supported agents
|
skillkit init --list # Show all 45 supported agents
|
||||||
skillkit init --quiet # Skip logo and prompts (for CI)
|
skillkit init --quiet # Skip logo and prompts (for CI)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
|
|||||||
|
|
||||||
# Primer
|
# Primer
|
||||||
|
|
||||||
Primer analyzes your codebase and automatically generates optimized instructions for all 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
|
Primer analyzes your codebase and automatically generates optimized instructions for all 45 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
|
||||||
|
|
||||||
## Quick Start
|
## Quick Start
|
||||||
|
|
||||||
@@ -16,7 +16,7 @@ skillkit primer
|
|||||||
# Generate for specific agents
|
# Generate for specific agents
|
||||||
skillkit primer --agent claude,cursor,windsurf
|
skillkit primer --agent claude,cursor,windsurf
|
||||||
|
|
||||||
# Generate for all 44 agents
|
# Generate for all 45 agents
|
||||||
skillkit primer --all-agents
|
skillkit primer --all-agents
|
||||||
|
|
||||||
# Preview without writing files
|
# Preview without writing files
|
||||||
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
|
|||||||
└── copilot-instructions.md
|
└── copilot-instructions.md
|
||||||
```
|
```
|
||||||
|
|
||||||
### All 44 Agents
|
### All 45 Agents
|
||||||
Each agent gets optimized instructions in their native format.
|
Each agent gets optimized instructions in their native format.
|
||||||
|
|
||||||
## Example Output
|
## Example Output
|
||||||
|
|||||||
@@ -242,6 +242,28 @@ console.log(`Findings: ${result.findings.length}`);
|
|||||||
| **Low** | 1 (with `--fail-on low`) | Minor issue or best practice |
|
| **Low** | 1 (with `--fail-on low`) | Minor issue or best practice |
|
||||||
| **Info** | 0 | Informational finding |
|
| **Info** | 0 | Informational finding |
|
||||||
|
|
||||||
|
## Trust Badges
|
||||||
|
|
||||||
|
Skills display a trust badge based on their source and quality analysis. Badges appear during installation, in `skillkit check` output, and in marketplace search results.
|
||||||
|
|
||||||
|
| Badge | Criteria |
|
||||||
|
|-------|----------|
|
||||||
|
| **[Official]** | Published by a known official source (Anthropic, Vercel, iii-hq, etc.) |
|
||||||
|
| **[Trusted]** | TrustScorer rates the skill 8-10 based on clarity, boundaries, specificity, and safety |
|
||||||
|
| **[Review]** | TrustScorer rates the skill 5-7; the skill may need refinement |
|
||||||
|
| **[Caution]** | TrustScorer rates the skill 0-4; requires careful review before use |
|
||||||
|
|
||||||
|
The `TrustScorer` evaluates four weighted dimensions:
|
||||||
|
|
||||||
|
| Dimension | Weight | What it measures |
|
||||||
|
|-----------|--------|------------------|
|
||||||
|
| Clarity | 30% | How well-defined the skill's purpose and instructions are |
|
||||||
|
| Boundaries | 25% | Whether the skill stays within its declared scope |
|
||||||
|
| Specificity | 25% | How concrete and actionable the instructions are |
|
||||||
|
| Safety | 20% | Absence of dangerous patterns (injection, exfiltration, secrets) |
|
||||||
|
|
||||||
|
Official sources are allowlisted by organization name and always receive the `[Official]` badge regardless of score. For all other sources, the badge is determined by the composite trust score.
|
||||||
|
|
||||||
## False Positive Handling
|
## False Positive Handling
|
||||||
|
|
||||||
The scanner automatically filters:
|
The scanner automatically filters:
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
|
|||||||
|
|
||||||
# Translation
|
# Translation
|
||||||
|
|
||||||
SkillKit automatically converts between all 44 agent formats using an adapter pattern.
|
SkillKit automatically converts between all 45 agent formats using an adapter pattern.
|
||||||
|
|
||||||
## Basic Translation
|
## Basic Translation
|
||||||
|
|
||||||
|
|||||||
@@ -8,6 +8,34 @@ const config = {
|
|||||||
trailingSlash: false,
|
trailingSlash: false,
|
||||||
skipTrailingSlashRedirect: true,
|
skipTrailingSlashRedirect: true,
|
||||||
assetPrefix: 'https://skillkit-docs.vercel.app',
|
assetPrefix: 'https://skillkit-docs.vercel.app',
|
||||||
|
async headers() {
|
||||||
|
return [
|
||||||
|
{
|
||||||
|
source: '/:path*.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico)',
|
||||||
|
headers: [
|
||||||
|
{ key: 'Cache-Control', value: 'public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000' },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
source: '/_next/static/:path*',
|
||||||
|
headers: [
|
||||||
|
{ key: 'Cache-Control', value: 'public, max-age=31536000, immutable' },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
source: '/docs/:path*',
|
||||||
|
headers: [
|
||||||
|
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
source: '/',
|
||||||
|
headers: [
|
||||||
|
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
];
|
||||||
|
},
|
||||||
};
|
};
|
||||||
|
|
||||||
export default withMDX(config);
|
export default withMDX(config);
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "skillkit-docs",
|
"name": "skillkit-docs",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "next build",
|
"build": "next build",
|
||||||
|
|||||||
@@ -0,0 +1,138 @@
|
|||||||
|
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
|
||||||
|
|
||||||
|
User-agent: Googlebot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Bingbot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: DuckDuckBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Applebot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: ChatGPT-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: OAI-SearchBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: PerplexityBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Perplexity-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Claude-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Claude-SearchBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: FirecrawlAgent
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: firecrawl
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Context7Bot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Crawl4AI
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Clawdbot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: OpenClaw
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Hermes
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: GPTBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ClaudeBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: anthropic-ai
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: CCBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Google-Extended
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Applebot-Extended
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Bytespider
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Amazonbot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: FacebookBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Meta-ExternalAgent
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: cohere-ai
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Diffbot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ImagesiftBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Omgilibot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: peer39_crawler
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: YouBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Timpibot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ICC-Crawler
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: AhrefsBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: SemrushBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: MJ12bot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: DotBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: PetalBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: BLEXBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: MegaIndex
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: SeznamBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: DataForSeoBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: *
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
Sitemap: https://skillkit-docs.vercel.app/sitemap.xml
|
||||||
@@ -39,8 +39,8 @@ export default function HomePage() {
|
|||||||
{/* Features Grid */}
|
{/* Features Grid */}
|
||||||
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
|
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
|
||||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">44 Agents</h3>
|
<h3 className="text-lg font-bold text-white mb-2 font-mono">45 Agents</h3>
|
||||||
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.</p>
|
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 40 more supported out of the box.</p>
|
||||||
</div>
|
</div>
|
||||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">400K+ Skills</h3>
|
<h3 className="text-lg font-bold text-white mb-2 font-mono">400K+ Skills</h3>
|
||||||
|
|||||||
@@ -44,12 +44,12 @@ const sections: DocSection[] = [
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<p className="text-zinc-300">
|
<p className="text-zinc-300">
|
||||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||||
</p>
|
</p>
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
||||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||||
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
||||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
|
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
|
||||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
@@ -61,14 +61,42 @@ const sections: DocSection[] = [
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
||||||
<CodeBlock>{`# Install globally via npm
|
<CodeBlock>{`# Full install — every feature works out of the box (default):
|
||||||
npm install -g skillkit
|
npm install -g skillkit
|
||||||
|
|
||||||
# Or use npx directly
|
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
|
||||||
npx skillkit --help
|
npm install -g skillkit --omit=optional
|
||||||
|
|
||||||
# Or install via pnpm
|
# Or use npx directly:
|
||||||
pnpm add -g skillkit`}</CodeBlock>
|
npx skillkit --help`}</CodeBlock>
|
||||||
|
|
||||||
|
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
|
||||||
|
dependencies. They install by default, or add later à la carte:
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
|
||||||
|
npm install -g @skillkit/api # enables: skillkit serve
|
||||||
|
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||||
|
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
|
||||||
|
|
||||||
|
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
<code className="text-zinc-200">npx skillkit add <owner/repo></code> runs with zero install.
|
||||||
|
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
|
||||||
|
run after that is instant until a new version ships.
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`# Full (default):
|
||||||
|
npx skillkit add anthropics/skills
|
||||||
|
|
||||||
|
# Slim — core only, 75% fewer packages, 0 warnings:
|
||||||
|
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
Using npx more than a couple times? Install globally to skip the
|
||||||
|
prompt-to-proceed and avoid the per-release cache refetch:
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`npm install -g skillkit --omit=optional
|
||||||
|
skillkit add anthropics/skills`}</CodeBlock>
|
||||||
|
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
||||||
<CodeBlock>{`skillkit --version
|
<CodeBlock>{`skillkit --version
|
||||||
@@ -102,7 +130,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
|||||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||||
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
||||||
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
||||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||||
@@ -130,7 +158,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<p className="text-zinc-300">
|
<p className="text-zinc-300">
|
||||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<Table
|
<Table
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ interface Feature {
|
|||||||
const FEATURES: Feature[] = [
|
const FEATURES: Feature[] = [
|
||||||
{
|
{
|
||||||
title: 'Multi-Agent',
|
title: 'Multi-Agent',
|
||||||
description: 'Deploy to 44 AI coding agents with one command.',
|
description: 'Deploy to 46 AI coding agents with one command.',
|
||||||
icon: (
|
icon: (
|
||||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
|
||||||
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
|
|||||||
];
|
];
|
||||||
|
|
||||||
const COMPARISONS = [
|
const COMPARISONS = [
|
||||||
['Agents', '1', '44'],
|
['Agents', '1', '46'],
|
||||||
['Translation', 'Manual', 'Auto'],
|
['Translation', 'Manual', 'Auto'],
|
||||||
['Sharing', 'Copy/paste', '.skills manifest'],
|
['Sharing', 'Copy/paste', '.skills manifest'],
|
||||||
['Discovery', 'Forums', 'CLI + AI'],
|
['Discovery', 'Forums', 'CLI + AI'],
|
||||||
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
|
|||||||
</p>
|
</p>
|
||||||
<div className="flex gap-6 sm:gap-8">
|
<div className="flex gap-6 sm:gap-8">
|
||||||
<div>
|
<div>
|
||||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">46</div>
|
||||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import { NextResponse } from 'next/server';
|
||||||
|
import type { NextRequest } from 'next/server';
|
||||||
|
|
||||||
|
const BLOCK = /GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot/i;
|
||||||
|
|
||||||
|
const ALLOW = /Googlebot|Bingbot|DuckDuckBot|Applebot(?!-Extended)|ChatGPT-User|OAI-SearchBot|PerplexityBot|Perplexity-User|Claude-User|Claude-SearchBot|FirecrawlAgent|firecrawl|Context7Bot|Crawl4AI|Clawdbot|OpenClaw|Hermes/i;
|
||||||
|
|
||||||
|
export function middleware(req: NextRequest) {
|
||||||
|
const ua = req.headers.get('user-agent') || '';
|
||||||
|
if (ALLOW.test(ua)) return NextResponse.next();
|
||||||
|
if (BLOCK.test(ua)) {
|
||||||
|
return new NextResponse('disallowed by robots.txt', {
|
||||||
|
status: 403,
|
||||||
|
headers: { 'Cache-Control': 'public, max-age=86400' },
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return NextResponse.next();
|
||||||
|
}
|
||||||
|
|
||||||
|
export const config = {
|
||||||
|
matcher: '/((?!_next/static|_next/image|favicon|robots\\.txt|sitemap\\.xml).*)',
|
||||||
|
};
|
||||||
@@ -1,70 +1,82 @@
|
|||||||
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
|
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
|
||||||
<defs>
|
<defs>
|
||||||
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||||
<stop offset="0%" style="stop-color:#0a0a0a"/>
|
<stop offset="0%" style="stop-color:#09090b"/>
|
||||||
<stop offset="50%" style="stop-color:#111111"/>
|
<stop offset="50%" style="stop-color:#111115"/>
|
||||||
<stop offset="100%" style="stop-color:#0a0a0a"/>
|
<stop offset="100%" style="stop-color:#09090b"/>
|
||||||
</linearGradient>
|
</linearGradient>
|
||||||
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
|
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||||
<stop offset="0%" style="stop-color:#333"/>
|
<stop offset="0%" style="stop-color:#27272a"/>
|
||||||
<stop offset="50%" style="stop-color:#555"/>
|
<stop offset="50%" style="stop-color:#3f3f46"/>
|
||||||
<stop offset="100%" style="stop-color:#333"/>
|
<stop offset="100%" style="stop-color:#27272a"/>
|
||||||
</linearGradient>
|
</linearGradient>
|
||||||
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
|
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
|
||||||
<stop offset="0%" style="stop-color:#2a2a2a"/>
|
<stop offset="0%" style="stop-color:#27272a"/>
|
||||||
<stop offset="100%" style="stop-color:#1a1a1a"/>
|
<stop offset="100%" style="stop-color:#18181b"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="accentText" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||||
|
<stop offset="0%" style="stop-color:#ffffff"/>
|
||||||
|
<stop offset="50%" style="stop-color:#ffffff"/>
|
||||||
|
<stop offset="100%" style="stop-color:#a1a1aa"/>
|
||||||
|
</linearGradient>
|
||||||
|
<linearGradient id="numberAccent" x1="0%" y1="0%" x2="0%" y2="100%">
|
||||||
|
<stop offset="0%" style="stop-color:#60a5fa"/>
|
||||||
|
<stop offset="100%" style="stop-color:#3b82f6"/>
|
||||||
</linearGradient>
|
</linearGradient>
|
||||||
</defs>
|
</defs>
|
||||||
|
|
||||||
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
|
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
|
||||||
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
<rect x="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||||
|
|
||||||
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
|
<line x1="60" y1="354" x2="1140" y2="354" stroke="#1f1f23" stroke-width="1"/>
|
||||||
|
|
||||||
<g transform="translate(60, 72)">
|
<g transform="translate(60, 72)">
|
||||||
<rect width="16" height="16" fill="white" rx="2"/>
|
<rect width="16" height="16" fill="white" rx="2"/>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<text x="90" y="86" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
|
<text x="90" y="86" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
|
||||||
|
<text x="90" y="106" font-family="'SF Mono', 'Fira Code', monospace" font-size="11" fill="#52525b" letter-spacing="1">v1.24.0</text>
|
||||||
|
|
||||||
<g transform="translate(890, 58)">
|
<g transform="translate(890, 58)">
|
||||||
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
|
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#3f3f46" stroke-width="1" rx="20"/>
|
||||||
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
|
<circle cx="28" cy="20" r="14" fill="none" stroke="#71717a" stroke-width="1.5"/>
|
||||||
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
|
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
|
||||||
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
|
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#a1a1aa" letter-spacing="1">PRODUCT HUNT</text>
|
||||||
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 44 Agents.</text>
|
<text x="600" y="196" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="url(#accentText)" text-anchor="middle" letter-spacing="-1.5">One skill. <tspan fill="url(#numberAccent)">46</tspan> agents.</text>
|
||||||
|
|
||||||
<text x="600" y="248" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" fill="#888" text-anchor="middle" letter-spacing="0.5">The open source package manager for AI agent skills</text>
|
<text x="600" y="240" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="18" fill="#a1a1aa" text-anchor="middle" letter-spacing="0.3">Package manager for AI agent skills — install, translate, sync.</text>
|
||||||
|
|
||||||
<g transform="translate(240, 282)">
|
<g transform="translate(240, 280)">
|
||||||
<rect width="260" height="38" fill="#1a1a1a" stroke="#333" stroke-width="1" rx="6"/>
|
<rect width="280" height="40" fill="#18181b" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||||
<text x="16" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#666">$</text>
|
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#71717a">$</text>
|
||||||
<text x="32" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</text>
|
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#e4e4e7">npm i -g skillkit</text>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<g transform="translate(520, 282)">
|
<g transform="translate(540, 280)">
|
||||||
<rect width="150" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||||
<text x="75" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">15,000+ skills</text>
|
<circle cx="18" cy="20" r="3" fill="#60a5fa"/>
|
||||||
|
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">400K+ skills</text>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<g transform="translate(690, 282)">
|
<g transform="translate(700, 280)">
|
||||||
<rect width="140" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||||
<text x="70" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Zero rewrites</text>
|
<circle cx="18" cy="20" r="3" fill="#22c55e"/>
|
||||||
|
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">zero rewrites</text>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<g transform="translate(850, 282)">
|
<g transform="translate(860, 280)">
|
||||||
<rect width="120" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
<rect width="110" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||||
<text x="60" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Apache-2.0</text>
|
<circle cx="18" cy="20" r="3" fill="#f59e0b"/>
|
||||||
|
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">Apache-2.0</text>
|
||||||
</g>
|
</g>
|
||||||
|
|
||||||
<g transform="translate(60, 370)">
|
<g transform="translate(60, 374)">
|
||||||
<circle cx="5" cy="5" r="3" fill="#666"/>
|
<circle cx="5" cy="5" r="3" fill="#71717a"/>
|
||||||
<circle cx="15" cy="5" r="3" fill="#555"/>
|
<circle cx="15" cy="5" r="3" fill="#52525b"/>
|
||||||
<circle cx="25" cy="5" r="3" fill="#444"/>
|
<circle cx="25" cy="5" r="3" fill="#3f3f46"/>
|
||||||
<circle cx="35" cy="5" r="3" fill="#333"/>
|
<circle cx="35" cy="5" r="3" fill="#27272a"/>
|
||||||
<text x="50" y="9" font-family="'SF Mono', monospace" font-size="11" fill="#444">Claude Cursor Codex Gemini Copilot Windsurf Devin Aider Cody +35 more</text>
|
<text x="50" y="10" font-family="'SF Mono', monospace" font-size="11" fill="#52525b">Claude · Cursor · Codex · Gemini · Copilot · Windsurf · OpenCode · Hermes · Clawdbot · OpenClaw · +36 more</text>
|
||||||
</g>
|
</g>
|
||||||
</svg>
|
</svg>
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 4.8 KiB |
@@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
|||||||
id: 'primer',
|
id: 'primer',
|
||||||
title: 'Primer',
|
title: 'Primer',
|
||||||
subtitle: 'Zero-Config AI Instructions',
|
subtitle: 'Zero-Config AI Instructions',
|
||||||
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 44 agents.',
|
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 46 agents.',
|
||||||
highlight: 'Auto-generates instructions for 44 agents',
|
highlight: 'Auto-generates instructions for 46 agents',
|
||||||
icon: (
|
icon: (
|
||||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
|
||||||
@@ -78,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
|||||||
),
|
),
|
||||||
commands: [
|
commands: [
|
||||||
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
|
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
|
||||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 44 agents' },
|
{ cmd: 'primer --all-agents', desc: 'Generate for all 46 agents' },
|
||||||
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
||||||
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
||||||
],
|
],
|
||||||
|
|||||||
@@ -429,7 +429,7 @@ export function Agents(): React.ReactElement {
|
|||||||
<section className="py-6 border-b border-zinc-800 overflow-hidden">
|
<section className="py-6 border-b border-zinc-800 overflow-hidden">
|
||||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||||
<p className="text-zinc-500 font-mono text-[11px] uppercase tracking-widest mb-6 text-center">
|
<p className="text-zinc-500 font-mono text-[11px] uppercase tracking-widest mb-6 text-center">
|
||||||
Works with 44 AI Agents
|
Works with 46 AI Agents
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@@ -23,9 +23,19 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
|||||||
{ cmd: 'list', desc: 'View installed skills' },
|
{ cmd: 'list', desc: 'View installed skills' },
|
||||||
{ cmd: 'sync', desc: 'Deploy to all agents' },
|
{ cmd: 'sync', desc: 'Deploy to all agents' },
|
||||||
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
|
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
|
||||||
{ cmd: 'update', desc: 'Update all skills' },
|
{ cmd: 'update', desc: 'Update with change detection' },
|
||||||
{ cmd: 'remove <skill>', desc: 'Remove a skill' },
|
{ cmd: 'remove <skill>', desc: 'Remove a skill' },
|
||||||
{ cmd: 'status', desc: 'Show skill status' },
|
{ cmd: 'remove --source org/repo', desc: 'Bulk remove by repo' },
|
||||||
|
{ cmd: 'remove --all', desc: 'Remove all skills' },
|
||||||
|
{ cmd: 'check', desc: 'Quality scores & activity' },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'Sources',
|
||||||
|
commands: [
|
||||||
|
{ cmd: 'tap add owner/repo', desc: 'Add custom source' },
|
||||||
|
{ cmd: 'tap list', desc: 'List custom sources' },
|
||||||
|
{ cmd: 'tap remove owner/repo', desc: 'Remove custom source' },
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@@ -67,7 +77,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
|||||||
{ cmd: 'manifest init', desc: 'Create .skills file' },
|
{ cmd: 'manifest init', desc: 'Create .skills file' },
|
||||||
{ cmd: 'team init', desc: 'Initialize team' },
|
{ cmd: 'team init', desc: 'Initialize team' },
|
||||||
{ cmd: 'team share', desc: 'Share via Git' },
|
{ cmd: 'team share', desc: 'Share via Git' },
|
||||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
{ cmd: 'publish submit', desc: 'Submit via CLI' },
|
||||||
{ cmd: 'cicd init', desc: 'CI/CD templates' },
|
{ cmd: 'cicd init', desc: 'CI/CD templates' },
|
||||||
{ cmd: 'team sync', desc: 'Sync team skills' },
|
{ cmd: 'team sync', desc: 'Sync team skills' },
|
||||||
],
|
],
|
||||||
|
|||||||
@@ -246,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
|
|||||||
<div>
|
<div>
|
||||||
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
|
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
|
||||||
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
|
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
|
||||||
Skill support across all 44 agents and {CATEGORIES.length} categories.
|
Skill support across all 46 agents and {CATEGORIES.length} categories.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
<div className="flex items-center gap-2">
|
<div className="flex items-center gap-2">
|
||||||
|
|||||||
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<p className="text-zinc-300">
|
<p className="text-zinc-300">
|
||||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||||
</p>
|
</p>
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
||||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||||
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 44 agents</li>
|
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 46 agents</li>
|
||||||
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
||||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
|
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
|
||||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
@@ -60,14 +60,42 @@ const sections: DocSection[] = [
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
||||||
<CodeBlock>{`# Install globally via npm
|
<CodeBlock>{`# Full install — every feature works out of the box (default):
|
||||||
npm install -g skillkit
|
npm install -g skillkit
|
||||||
|
|
||||||
# Or use npx directly
|
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
|
||||||
npx skillkit --help
|
npm install -g skillkit --omit=optional
|
||||||
|
|
||||||
# Or install via pnpm
|
# Or use npx directly:
|
||||||
pnpm add -g skillkit`}</CodeBlock>
|
npx skillkit --help`}</CodeBlock>
|
||||||
|
|
||||||
|
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
|
||||||
|
dependencies. They install by default, or add later à la carte:
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
|
||||||
|
npm install -g @skillkit/api # enables: skillkit serve
|
||||||
|
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||||
|
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
|
||||||
|
|
||||||
|
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
<code className="text-zinc-200">npx skillkit add <owner/repo></code> runs with zero install.
|
||||||
|
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
|
||||||
|
run after that is instant until a new version ships.
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`# Full (default):
|
||||||
|
npx skillkit add anthropics/skills
|
||||||
|
|
||||||
|
# Slim — core only, 75% fewer packages, 0 warnings:
|
||||||
|
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
|
||||||
|
<p className="text-zinc-300 text-sm">
|
||||||
|
Using npx more than a couple times? Install globally to skip the
|
||||||
|
prompt-to-proceed and avoid the per-release cache refetch:
|
||||||
|
</p>
|
||||||
|
<CodeBlock>{`npm install -g skillkit --omit=optional
|
||||||
|
skillkit add anthropics/skills`}</CodeBlock>
|
||||||
|
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
||||||
<CodeBlock>{`skillkit --version
|
<CodeBlock>{`skillkit --version
|
||||||
@@ -101,7 +129,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
|||||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||||
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
||||||
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
||||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||||
@@ -129,7 +157,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
|||||||
content: (
|
content: (
|
||||||
<div className="space-y-4">
|
<div className="space-y-4">
|
||||||
<p className="text-zinc-300">
|
<p className="text-zinc-300">
|
||||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<Table
|
<Table
|
||||||
@@ -206,7 +234,7 @@ skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
|
|||||||
|
|
||||||
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
|
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
|
||||||
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
|
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
|
||||||
skillkit primer --all-agents # Generate for all 44 agents
|
skillkit primer --all-agents # Generate for all 46 agents
|
||||||
skillkit primer --agent claude-code,cursor # Specific agents only
|
skillkit primer --agent claude-code,cursor # Specific agents only
|
||||||
skillkit primer --analyze-only # Only show codebase analysis
|
skillkit primer --analyze-only # Only show codebase analysis
|
||||||
skillkit primer --dry-run # Preview without writing files
|
skillkit primer --dry-run # Preview without writing files
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ const FEATURES: Feature[] = [
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
title: 'Auto Translation',
|
title: 'Auto Translation',
|
||||||
description: 'The npm for agent skills. Write once, auto-translate to 44 formats.',
|
description: 'The npm for agent skills. Write once, auto-translate to 45 formats.',
|
||||||
icon: (
|
icon: (
|
||||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
|
||||||
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
title: 'Primer',
|
title: 'Primer',
|
||||||
description: 'Auto-generate agent instructions for all 44 agents from your codebase.',
|
description: 'Auto-generate agent instructions for all 46 agents from your codebase.',
|
||||||
icon: (
|
icon: (
|
||||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||||
@@ -109,9 +109,9 @@ const FEATURES: Feature[] = [
|
|||||||
];
|
];
|
||||||
|
|
||||||
const COMPARISONS = [
|
const COMPARISONS = [
|
||||||
['Agent Support', '1-17 agents', '44 agents'],
|
['Agent Support', '1-17 agents', '46 agents'],
|
||||||
['Sources', 'Single registry', '34+ aggregated'],
|
['Sources', 'Single registry', '34+ aggregated'],
|
||||||
['Translation', 'None or limited', 'All 44 formats'],
|
['Translation', 'None or limited', 'All 45 formats'],
|
||||||
['Memory', 'None', 'Persistent learning'],
|
['Memory', 'None', 'Persistent learning'],
|
||||||
['Security', 'None', '46-rule scanner'],
|
['Security', 'None', '46-rule scanner'],
|
||||||
['Team Sync', 'None', '.skills manifest'],
|
['Team Sync', 'None', '.skills manifest'],
|
||||||
@@ -131,7 +131,7 @@ export function Features(): React.ReactElement {
|
|||||||
</p>
|
</p>
|
||||||
<div className="flex gap-6 sm:gap-8">
|
<div className="flex gap-6 sm:gap-8">
|
||||||
<div>
|
<div>
|
||||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">45</div>
|
||||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
|
|||||||
@@ -22,7 +22,7 @@ interface TerminalLine {
|
|||||||
const TERMINAL_LINES: TerminalLine[] = [
|
const TERMINAL_LINES: TerminalLine[] = [
|
||||||
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
||||||
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
|
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
|
||||||
{ type: 'out', text: '→ Translated to 44 agent formats' },
|
{ type: 'out', text: '→ Translated to 46 agent formats' },
|
||||||
{ type: 'out', text: '→ Scanned: 0 issues found' },
|
{ type: 'out', text: '→ Scanned: 0 issues found' },
|
||||||
{ type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' },
|
{ type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' },
|
||||||
{ type: 'out', text: '→ Installed 12 skills from skills.sh' },
|
{ type: 'out', text: '→ Installed 12 skills from skills.sh' },
|
||||||
@@ -149,7 +149,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
|||||||
|
|
||||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||||
The open source package manager that aggregates 34+ skill sources,
|
The open source package manager that aggregates 34+ skill sources,
|
||||||
scans 400K+ skills from registries, auto-translates to 44 agent formats,
|
scans 400K+ skills from registries, auto-translates to 46 agent formats,
|
||||||
and adds memory, security scanning, and team workflows. Everything runs locally.
|
and adds memory, security scanning, and team workflows. Everything runs locally.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
|||||||
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
|
|||||||
{
|
{
|
||||||
persona: 'Multi-Agent Developer',
|
persona: 'Multi-Agent Developer',
|
||||||
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
|
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
|
||||||
solution: 'SkillKit translates skills between all 44 agents. Write once, deploy everywhere.',
|
solution: 'SkillKit translates skills between all 46 agents. Write once, deploy everywhere.',
|
||||||
command: 'skillkit translate --to cursor,windsurf',
|
command: 'skillkit translate --to cursor,windsurf',
|
||||||
gradient: 'from-violet-500/10 to-purple-500/10',
|
gradient: 'from-violet-500/10 to-purple-500/10',
|
||||||
icon: (
|
icon: (
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ const COMPETITORS: Competitor[] = [
|
|||||||
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
|
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
|
||||||
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
||||||
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
||||||
{ name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
{ name: 'SkillKit', type: 'Platform', agents: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||||
];
|
];
|
||||||
|
|
||||||
const SOURCES = [
|
const SOURCES = [
|
||||||
|
|||||||
@@ -4,13 +4,13 @@
|
|||||||
<meta charset="UTF-8" />
|
<meta charset="UTF-8" />
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
<title>SkillKit - Universal Skills for AI Coding Agents</title>
|
<title>SkillKit - Universal Skills for AI Coding Agents</title>
|
||||||
<meta name="description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
<meta name="description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||||
|
|
||||||
<!-- Open Graph -->
|
<!-- Open Graph -->
|
||||||
<meta property="og:type" content="website">
|
<meta property="og:type" content="website">
|
||||||
<meta property="og:url" content="https://skillkit.sh/">
|
<meta property="og:url" content="https://skillkit.sh/">
|
||||||
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||||
<meta property="og:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
<meta property="og:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||||
<meta property="og:image" content="https://skillkit.sh/og-image.png">
|
<meta property="og:image" content="https://skillkit.sh/og-image.png">
|
||||||
<meta property="og:image:width" content="1200">
|
<meta property="og:image:width" content="1200">
|
||||||
<meta property="og:image:height" content="630">
|
<meta property="og:image:height" content="630">
|
||||||
@@ -20,7 +20,7 @@
|
|||||||
<meta name="twitter:card" content="summary_large_image">
|
<meta name="twitter:card" content="summary_large_image">
|
||||||
<meta name="twitter:url" content="https://skillkit.sh/">
|
<meta name="twitter:url" content="https://skillkit.sh/">
|
||||||
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||||
<meta name="twitter:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
<meta name="twitter:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||||
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
|
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
|
||||||
|
|
||||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
{
|
{
|
||||||
"name": "SkillKit",
|
"name": "SkillKit",
|
||||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.",
|
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 46 agents.",
|
||||||
"requestFramePermissions": []
|
"requestFramePermissions": []
|
||||||
}
|
}
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "skillkit",
|
"name": "skillkit",
|
||||||
"private": true,
|
"private": true,
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "vite",
|
"dev": "vite",
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
"info": {
|
"info": {
|
||||||
"title": "SkillKit",
|
"title": "SkillKit",
|
||||||
"version": "1.12.0",
|
"version": "1.12.0",
|
||||||
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
||||||
"license": {
|
"license": {
|
||||||
"name": "Apache-2.0",
|
"name": "Apache-2.0",
|
||||||
"url": "https://opensource.org/licenses/Apache-2.0"
|
"url": "https://opensource.org/licenses/Apache-2.0"
|
||||||
|
|||||||
@@ -0,0 +1,138 @@
|
|||||||
|
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
|
||||||
|
|
||||||
|
User-agent: Googlebot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Bingbot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: DuckDuckBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Applebot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: ChatGPT-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: OAI-SearchBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: PerplexityBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Perplexity-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Claude-User
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Claude-SearchBot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: FirecrawlAgent
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: firecrawl
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Context7Bot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Crawl4AI
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Clawdbot
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: OpenClaw
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: Hermes
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
User-agent: GPTBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ClaudeBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: anthropic-ai
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: CCBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Google-Extended
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Applebot-Extended
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Bytespider
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Amazonbot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: FacebookBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Meta-ExternalAgent
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: cohere-ai
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Diffbot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ImagesiftBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Omgilibot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: peer39_crawler
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: YouBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: Timpibot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: ICC-Crawler
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: AhrefsBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: SemrushBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: MJ12bot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: DotBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: PetalBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: BLEXBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: MegaIndex
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: SeznamBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: DataForSeoBot
|
||||||
|
Disallow: /
|
||||||
|
|
||||||
|
User-agent: *
|
||||||
|
Allow: /
|
||||||
|
|
||||||
|
Sitemap: https://skillkit.dev/sitemap.xml
|
||||||
@@ -21,5 +21,47 @@
|
|||||||
"source": "/docs",
|
"source": "/docs",
|
||||||
"destination": "https://skillkit-docs.vercel.app/docs"
|
"destination": "https://skillkit-docs.vercel.app/docs"
|
||||||
}
|
}
|
||||||
|
],
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"source": "/(.*)\\.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico|mp4)",
|
||||||
|
"headers": [
|
||||||
|
{ "key": "Cache-Control", "value": "public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000" }
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"source": "/assets/(.*)",
|
||||||
|
"headers": [
|
||||||
|
{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"source": "/(.*)\\.html",
|
||||||
|
"headers": [
|
||||||
|
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"source": "/",
|
||||||
|
"headers": [
|
||||||
|
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"source": "/api",
|
||||||
|
"headers": [
|
||||||
|
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"redirects": [
|
||||||
|
{
|
||||||
|
"source": "/((?!robots\\.txt$).*)",
|
||||||
|
"has": [
|
||||||
|
{ "type": "header", "key": "user-agent", "value": "(?i).*(GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot).*" }
|
||||||
|
],
|
||||||
|
"destination": "/robots.txt",
|
||||||
|
"permanent": false
|
||||||
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
|
|||||||
expect(result.success).toBe(true);
|
expect(result.success).toBe(true);
|
||||||
});
|
});
|
||||||
|
|
||||||
it('should display all 44 agents', async () => {
|
it('should display all 46 agents', async () => {
|
||||||
const result = await runCli(['init', '--list']);
|
const result = await runCli(['init', '--list']);
|
||||||
const output = result.stdout + result.stderr;
|
const output = result.stdout + result.stderr;
|
||||||
|
|
||||||
@@ -93,6 +93,7 @@ describe('E2E: Onboarding UI', () => {
|
|||||||
'Tabnine',
|
'Tabnine',
|
||||||
'CodeGPT',
|
'CodeGPT',
|
||||||
'PlayCode',
|
'PlayCode',
|
||||||
|
'Hermes',
|
||||||
];
|
];
|
||||||
|
|
||||||
for (const agent of agents) {
|
for (const agent of agents) {
|
||||||
|
|||||||
@@ -28,7 +28,7 @@ import {
|
|||||||
type CrossAgentSkill,
|
type CrossAgentSkill,
|
||||||
} from '@skillkit/core';
|
} from '@skillkit/core';
|
||||||
|
|
||||||
// All 44 supported agents
|
// All 46 supported agents
|
||||||
const SUPPORTED_AGENTS = [
|
const SUPPORTED_AGENTS = [
|
||||||
'claude-code',
|
'claude-code',
|
||||||
'cursor',
|
'cursor',
|
||||||
@@ -74,6 +74,7 @@ const SUPPORTED_AGENTS = [
|
|||||||
'tabnine',
|
'tabnine',
|
||||||
'codegpt',
|
'codegpt',
|
||||||
'playcode-agent',
|
'playcode-agent',
|
||||||
|
'hermes',
|
||||||
] as const;
|
] as const;
|
||||||
|
|
||||||
describe('E2E: Skill Translator - Parsing', () => {
|
describe('E2E: Skill Translator - Parsing', () => {
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
* E2E Tests: Skill Translation Commands
|
* E2E Tests: Skill Translation Commands
|
||||||
*
|
*
|
||||||
* Tests for: translate, context, recommend
|
* Tests for: translate, context, recommend
|
||||||
* Validates translation to all 44 supported agents
|
* Validates translation to all 45 supported agents
|
||||||
*/
|
*/
|
||||||
|
|
||||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||||
@@ -16,7 +16,7 @@ import {
|
|||||||
testFileExists,
|
testFileExists,
|
||||||
} from './helpers/cli-runner.js';
|
} from './helpers/cli-runner.js';
|
||||||
|
|
||||||
// All 44 supported agents
|
// All 46 supported agents
|
||||||
const SUPPORTED_AGENTS = [
|
const SUPPORTED_AGENTS = [
|
||||||
'claude-code',
|
'claude-code',
|
||||||
'cursor',
|
'cursor',
|
||||||
@@ -62,6 +62,7 @@ const SUPPORTED_AGENTS = [
|
|||||||
'tabnine',
|
'tabnine',
|
||||||
'codegpt',
|
'codegpt',
|
||||||
'playcode-agent',
|
'playcode-agent',
|
||||||
|
'hermes',
|
||||||
] as const;
|
] as const;
|
||||||
|
|
||||||
describe('E2E: Skill Translation', () => {
|
describe('E2E: Skill Translation', () => {
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"$schema": "./sources-schema.json",
|
"$schema": "./sources-schema.json",
|
||||||
"version": 1,
|
"version": 1,
|
||||||
"updatedAt": "2026-02-28",
|
"updatedAt": "2026-04-10",
|
||||||
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
|
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
|
||||||
"sources": [
|
"sources": [
|
||||||
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
|
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
|
||||||
@@ -37,6 +37,7 @@
|
|||||||
{ "source": "intellectronica/agent-skills", "name": "Context7" },
|
{ "source": "intellectronica/agent-skills", "name": "Context7" },
|
||||||
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
|
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
|
||||||
{ "source": "sickn33/antigravity-awesome-skills", "name": "Antigravity Awesome Skills" },
|
{ "source": "sickn33/antigravity-awesome-skills", "name": "Antigravity Awesome Skills" },
|
||||||
|
{ "source": "NousResearch/hermes-agent", "name": "Hermes Agent Skills" },
|
||||||
{ "source": "skills.sh", "name": "Skills.sh Leaderboard", "official": true, "registry": "skills-sh" }
|
{ "source": "skills.sh", "name": "Skills.sh Leaderboard", "official": true, "registry": "skills-sh" }
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,8 +1,8 @@
|
|||||||
{
|
{
|
||||||
"name": "skillkit-monorepo",
|
"name": "skillkit-monorepo",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"description": "The package manager for AI agent skills — install, translate, share across 44 coding agents",
|
"description": "The package manager for AI agent skills — install, translate, share across 46 coding agents",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "turbo run build",
|
"build": "turbo run build",
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
[](https://www.npmjs.com/package/@skillkit/agents)
|
[](https://www.npmjs.com/package/@skillkit/agents)
|
||||||
[](https://opensource.org/licenses/Apache-2.0)
|
[](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 46 AI coding agents.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@@ -11,7 +11,7 @@
|
|||||||
npm install @skillkit/agents
|
npm install @skillkit/agents
|
||||||
```
|
```
|
||||||
|
|
||||||
## Supported Agents (32)
|
## Supported Agents (46)
|
||||||
|
|
||||||
| Agent | Config Format | Project Skills | Global Skills |
|
| Agent | Config Format | Project Skills | Global Skills |
|
||||||
|-------|--------------|----------------|---------------|
|
|-------|--------------|----------------|---------------|
|
||||||
@@ -23,11 +23,14 @@ npm install @skillkit/agents
|
|||||||
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
|
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
|
||||||
| Amp | SKILL.md | `.amp/skills/` | - |
|
| Amp | SKILL.md | `.amp/skills/` | - |
|
||||||
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
|
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
|
||||||
|
| OpenClaw | SKILL.md | `.openclaw/skills/` | `~/.openclaw/workspace/skills/` |
|
||||||
| Cline | SKILL.md | `.cline/skills/` | - |
|
| Cline | SKILL.md | `.cline/skills/` | - |
|
||||||
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
|
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
|
||||||
|
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
|
||||||
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
|
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
|
||||||
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
|
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
|
||||||
| Crush | SKILL.md | `.crush/skills/` | - |
|
| Crush | SKILL.md | `.crush/skills/` | - |
|
||||||
|
| Devin | SKILL.md | `.devin/skills/` | - |
|
||||||
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
|
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
|
||||||
| Factory | SKILL.md | `.factory/skills/` | - |
|
| Factory | SKILL.md | `.factory/skills/` | - |
|
||||||
| GitHub Copilot | Markdown | `.github/skills/` | - |
|
| GitHub Copilot | Markdown | `.github/skills/` | - |
|
||||||
@@ -39,6 +42,7 @@ npm install @skillkit/agents
|
|||||||
| Neovate | SKILL.md | `.neovate/skills/` | - |
|
| Neovate | SKILL.md | `.neovate/skills/` | - |
|
||||||
| OpenHands | SKILL.md | `.openhands/skills/` | - |
|
| OpenHands | SKILL.md | `.openhands/skills/` | - |
|
||||||
| Pi | SKILL.md | `.pi/skills/` | - |
|
| Pi | SKILL.md | `.pi/skills/` | - |
|
||||||
|
| PlayCode Agent | SKILL.md | `.playcode/skills/` | - |
|
||||||
| Qoder | SKILL.md | `.qoder/skills/` | - |
|
| Qoder | SKILL.md | `.qoder/skills/` | - |
|
||||||
| Qwen | SKILL.md | `.qwen/skills/` | - |
|
| Qwen | SKILL.md | `.qwen/skills/` | - |
|
||||||
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
|
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
|
||||||
@@ -46,6 +50,15 @@ npm install @skillkit/agents
|
|||||||
| Vercel | SKILL.md | `.vercel/skills/` | - |
|
| Vercel | SKILL.md | `.vercel/skills/` | - |
|
||||||
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
|
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
|
||||||
| Zencoder | SKILL.md | `.zencoder/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/` | - |
|
| Universal | SKILL.md | `skills/` | - |
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
@@ -170,11 +183,14 @@ type AgentType =
|
|||||||
| 'antigravity'
|
| 'antigravity'
|
||||||
| 'amp'
|
| 'amp'
|
||||||
| 'clawdbot'
|
| 'clawdbot'
|
||||||
|
| 'openclaw'
|
||||||
| 'cline'
|
| 'cline'
|
||||||
| 'codebuddy'
|
| 'codebuddy'
|
||||||
|
| 'codegpt'
|
||||||
| 'commandcode'
|
| 'commandcode'
|
||||||
| 'continue'
|
| 'continue'
|
||||||
| 'crush'
|
| 'crush'
|
||||||
|
| 'devin'
|
||||||
| 'droid'
|
| 'droid'
|
||||||
| 'factory'
|
| 'factory'
|
||||||
| 'github-copilot'
|
| 'github-copilot'
|
||||||
@@ -186,6 +202,7 @@ type AgentType =
|
|||||||
| 'neovate'
|
| 'neovate'
|
||||||
| 'openhands'
|
| 'openhands'
|
||||||
| 'pi'
|
| 'pi'
|
||||||
|
| 'playcode-agent'
|
||||||
| 'qoder'
|
| 'qoder'
|
||||||
| 'qwen'
|
| 'qwen'
|
||||||
| 'roo'
|
| 'roo'
|
||||||
@@ -193,6 +210,15 @@ type AgentType =
|
|||||||
| 'vercel'
|
| 'vercel'
|
||||||
| 'windsurf'
|
| 'windsurf'
|
||||||
| 'zencoder'
|
| 'zencoder'
|
||||||
|
| 'aider'
|
||||||
|
| 'amazon-q'
|
||||||
|
| 'augment-code'
|
||||||
|
| 'bolt'
|
||||||
|
| 'lovable'
|
||||||
|
| 'replit-agent'
|
||||||
|
| 'sourcegraph-cody'
|
||||||
|
| 'tabby'
|
||||||
|
| 'tabnine'
|
||||||
| 'universal';
|
| 'universal';
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "@skillkit/agents",
|
"name": "@skillkit/agents",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
"description": "Agent adapters for SkillKit - supports 46 AI coding agents",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": "./dist/index.js",
|
"main": "./dist/index.js",
|
||||||
"types": "./dist/index.d.ts",
|
"types": "./dist/index.d.ts",
|
||||||
|
|||||||
@@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options;
|
|||||||
|
|
||||||
describe('Agent Adapters', () => {
|
describe('Agent Adapters', () => {
|
||||||
describe('getAllAdapters', () => {
|
describe('getAllAdapters', () => {
|
||||||
it('should return all 44 registered adapters', () => {
|
it('should return all 46 registered adapters', () => {
|
||||||
const adapters = getAllAdapters();
|
const adapters = getAllAdapters();
|
||||||
expect(adapters).toBeInstanceOf(Array);
|
expect(adapters).toBeInstanceOf(Array);
|
||||||
expect(adapters.length).toBe(44);
|
expect(adapters.length).toBe(46);
|
||||||
});
|
});
|
||||||
|
|
||||||
it('should include common agents', () => {
|
it('should include common agents', () => {
|
||||||
@@ -140,4 +140,43 @@ describe('Agent Adapters', () => {
|
|||||||
expect(typeof agent).toBe('string');
|
expect(typeof agent).toBe('string');
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
describe('HermesAdapter', () => {
|
||||||
|
it('should generate valid XML config', () => {
|
||||||
|
const adapter = getAdapter('hermes');
|
||||||
|
const mockSkills = [
|
||||||
|
{ name: 'test-skill', description: 'Testing', enabled: true, path: '', location: 'project' }
|
||||||
|
];
|
||||||
|
const config = adapter.generateConfig(mockSkills as any);
|
||||||
|
|
||||||
|
expect(config).toContain('<skills_system');
|
||||||
|
expect(config).toContain('<name>test-skill</name>');
|
||||||
|
expect(config).toContain('SKILLS_TABLE_START');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should parse skill names from XML correctly within markers', () => {
|
||||||
|
const adapter = getAdapter('hermes');
|
||||||
|
const xml = `
|
||||||
|
<!-- SKILLS_TABLE_START -->
|
||||||
|
<available_skills><skill><name>git-ops</name></skill></available_skills>
|
||||||
|
<!-- SKILLS_TABLE_END -->`;
|
||||||
|
const names = adapter.parseConfig(xml);
|
||||||
|
expect(names).toContain('git-ops');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should ignore <name> tags outside of sync markers', () => {
|
||||||
|
const adapter = getAdapter('hermes');
|
||||||
|
const xml = `
|
||||||
|
<mission><name>save-the-world</name></mission>
|
||||||
|
<!-- SKILLS_TABLE_START -->
|
||||||
|
<available_skills><skill><name>git-ops</name></skill></available_skills>
|
||||||
|
<!-- SKILLS_TABLE_END -->
|
||||||
|
<footer_meta><name>internal-id</name></footer_meta>`;
|
||||||
|
const names = adapter.parseConfig(xml);
|
||||||
|
expect(names).toHaveLength(1);
|
||||||
|
expect(names).toContain('git-ops');
|
||||||
|
expect(names).not.toContain('save-the-world');
|
||||||
|
expect(names).not.toContain('internal-id');
|
||||||
|
});
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -236,16 +236,6 @@ describe('ClawdbotAdapter', () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
describe('isDetected', () => {
|
describe('isDetected', () => {
|
||||||
it('should detect Clawdbot from workspace skills directory', async () => {
|
|
||||||
mockExistsSync.mockImplementation((path) => {
|
|
||||||
return path === join(process.cwd(), 'skills');
|
|
||||||
});
|
|
||||||
|
|
||||||
const detected = await adapter.isDetected();
|
|
||||||
|
|
||||||
expect(detected).toBe(true);
|
|
||||||
});
|
|
||||||
|
|
||||||
it('should detect Clawdbot from global directory', async () => {
|
it('should detect Clawdbot from global directory', async () => {
|
||||||
mockExistsSync.mockImplementation((path) => {
|
mockExistsSync.mockImplementation((path) => {
|
||||||
return path === join(homedir(), '.clawdbot');
|
return path === join(homedir(), '.clawdbot');
|
||||||
@@ -287,7 +277,6 @@ describe('ClawdbotAdapter', () => {
|
|||||||
|
|
||||||
await adapter.isDetected();
|
await adapter.isDetected();
|
||||||
|
|
||||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'skills'));
|
|
||||||
expect(mockExistsSync).toHaveBeenCalledWith(join(homedir(), '.clawdbot'));
|
expect(mockExistsSync).toHaveBeenCalledWith(join(homedir(), '.clawdbot'));
|
||||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'clawdbot.json'));
|
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'clawdbot.json'));
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -10,9 +10,9 @@ const config = AGENT_CONFIG.clawdbot;
|
|||||||
|
|
||||||
export class ClawdbotAdapter implements AgentAdapter {
|
export class ClawdbotAdapter implements AgentAdapter {
|
||||||
readonly type: AgentType = 'clawdbot';
|
readonly type: AgentType = 'clawdbot';
|
||||||
readonly name = 'Clawdbot';
|
readonly name: string = 'Clawdbot';
|
||||||
readonly skillsDir = config.skillsDir;
|
readonly skillsDir: string = config.skillsDir;
|
||||||
readonly configFile = config.configFile;
|
readonly configFile: string = config.configFile;
|
||||||
|
|
||||||
generateConfig(skills: Skill[]): string {
|
generateConfig(skills: Skill[]): string {
|
||||||
const enabledSkills = skills.filter(s => s.enabled);
|
const enabledSkills = skills.filter(s => s.enabled);
|
||||||
@@ -69,10 +69,9 @@ ${skillsXml}
|
|||||||
}
|
}
|
||||||
|
|
||||||
async isDetected(): Promise<boolean> {
|
async isDetected(): Promise<boolean> {
|
||||||
const projectSkills = join(process.cwd(), 'skills');
|
|
||||||
const globalClawdbot = join(homedir(), '.clawdbot');
|
const globalClawdbot = join(homedir(), '.clawdbot');
|
||||||
const clawdbotConfig = join(process.cwd(), 'clawdbot.json');
|
const clawdbotConfig = join(process.cwd(), 'clawdbot.json');
|
||||||
|
|
||||||
return existsSync(projectSkills) || existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
return existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -33,6 +33,7 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
|
|||||||
'tabnine': 'Tabnine',
|
'tabnine': 'Tabnine',
|
||||||
'codegpt': 'CodeGPT',
|
'codegpt': 'CodeGPT',
|
||||||
'playcode-agent': 'PlayCode Agent',
|
'playcode-agent': 'PlayCode Agent',
|
||||||
|
'hermes': 'Hermes',
|
||||||
};
|
};
|
||||||
|
|
||||||
export class GenericAgentAdapter implements AgentAdapter {
|
export class GenericAgentAdapter implements AgentAdapter {
|
||||||
|
|||||||
@@ -0,0 +1,93 @@
|
|||||||
|
import { existsSync } from 'node:fs';
|
||||||
|
import { join } from 'node:path';
|
||||||
|
import { homedir } from 'node:os';
|
||||||
|
import type { AgentAdapter } from './base.js';
|
||||||
|
import { createSkillXml } from './base.js';
|
||||||
|
import type { Skill, AgentType } from '@skillkit/core';
|
||||||
|
import { AGENT_CONFIG } from '@skillkit/core';
|
||||||
|
|
||||||
|
const config = AGENT_CONFIG.hermes;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Hermes Agent Adapter
|
||||||
|
*
|
||||||
|
* Hermes Agent is an advanced AI agent with support for XML-based skills.
|
||||||
|
* It uses AGENTS.md for instructions and ~/.hermes/skills/ for global skills.
|
||||||
|
*/
|
||||||
|
export class HermesAdapter implements AgentAdapter {
|
||||||
|
readonly type: AgentType = 'hermes';
|
||||||
|
readonly name = 'Hermes Agent';
|
||||||
|
readonly skillsDir = config.skillsDir;
|
||||||
|
readonly configFile = config.configFile;
|
||||||
|
|
||||||
|
generateConfig(skills: Skill[]): string {
|
||||||
|
const enabledSkills = skills.filter(s => s.enabled);
|
||||||
|
|
||||||
|
if (enabledSkills.length === 0) {
|
||||||
|
return '';
|
||||||
|
}
|
||||||
|
|
||||||
|
const skillsXml = enabledSkills.map(createSkillXml).join('\n\n');
|
||||||
|
|
||||||
|
return `<skills_system priority="1">
|
||||||
|
|
||||||
|
## Available Skills
|
||||||
|
|
||||||
|
<!-- SKILLS_TABLE_START -->
|
||||||
|
<usage>
|
||||||
|
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
|
||||||
|
|
||||||
|
How to use skills:
|
||||||
|
- Invoke: \`skillkit read <skill-name>\` or \`npx skillkit read <skill-name>\`
|
||||||
|
- The skill content will load with detailed instructions on how to complete the task
|
||||||
|
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
|
||||||
|
|
||||||
|
Usage notes:
|
||||||
|
- Only use skills listed in <available_skills> below
|
||||||
|
- Do not invoke a skill that is already loaded in your context
|
||||||
|
- Each skill invocation is stateless
|
||||||
|
</usage>
|
||||||
|
|
||||||
|
<available_skills>
|
||||||
|
|
||||||
|
${skillsXml}
|
||||||
|
|
||||||
|
</available_skills>
|
||||||
|
<!-- SKILLS_TABLE_END -->
|
||||||
|
|
||||||
|
</skills_system>`;
|
||||||
|
}
|
||||||
|
|
||||||
|
parseConfig(content: string): string[] {
|
||||||
|
const startMarker = '<!-- SKILLS_TABLE_START -->';
|
||||||
|
const endMarker = '<!-- SKILLS_TABLE_END -->';
|
||||||
|
const startIndex = content.indexOf(startMarker);
|
||||||
|
const endIndex = content.indexOf(endMarker);
|
||||||
|
|
||||||
|
if (startIndex === -1 || endIndex === -1) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
|
||||||
|
const scopedContent = content.substring(startIndex + startMarker.length, endIndex);
|
||||||
|
const skillNames: string[] = [];
|
||||||
|
const skillRegex = /<name>([^<]+)<\/name>/g;
|
||||||
|
let match;
|
||||||
|
|
||||||
|
while ((match = skillRegex.exec(scopedContent)) !== null) {
|
||||||
|
skillNames.push(match[1].trim());
|
||||||
|
}
|
||||||
|
|
||||||
|
return skillNames;
|
||||||
|
}
|
||||||
|
|
||||||
|
getInvokeCommand(skillName: string): string {
|
||||||
|
return `skillkit read ${skillName}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
async isDetected(): Promise<boolean> {
|
||||||
|
const projectHermes = join(process.cwd(), '.hermes');
|
||||||
|
const globalHermes = join(homedir(), '.hermes');
|
||||||
|
|
||||||
|
return existsSync(projectHermes) || existsSync(globalHermes);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -8,6 +8,7 @@ import { OpenCodeAdapter } from './opencode.js';
|
|||||||
import { AntigravityAdapter } from './antigravity.js';
|
import { AntigravityAdapter } from './antigravity.js';
|
||||||
import { AmpAdapter } from './amp.js';
|
import { AmpAdapter } from './amp.js';
|
||||||
import { ClawdbotAdapter } from './clawdbot.js';
|
import { ClawdbotAdapter } from './clawdbot.js';
|
||||||
|
import { OpenClawAdapter } from './openclaw.js';
|
||||||
import { DroidAdapter } from './droid.js';
|
import { DroidAdapter } from './droid.js';
|
||||||
import { FactoryAdapter } from './factory.js';
|
import { FactoryAdapter } from './factory.js';
|
||||||
import { GitHubCopilotAdapter } from './github-copilot.js';
|
import { GitHubCopilotAdapter } from './github-copilot.js';
|
||||||
@@ -18,6 +19,7 @@ import { RooAdapter } from './roo.js';
|
|||||||
import { TraeAdapter } from './trae.js';
|
import { TraeAdapter } from './trae.js';
|
||||||
import { WindsurfAdapter } from './windsurf.js';
|
import { WindsurfAdapter } from './windsurf.js';
|
||||||
import { UniversalAdapter } from './universal.js';
|
import { UniversalAdapter } from './universal.js';
|
||||||
|
import { HermesAdapter } from './hermes.js';
|
||||||
import { GenericAgentAdapter } from './generic.js';
|
import { GenericAgentAdapter } from './generic.js';
|
||||||
|
|
||||||
export * from './base.js';
|
export * from './base.js';
|
||||||
@@ -29,6 +31,7 @@ export * from './opencode.js';
|
|||||||
export * from './antigravity.js';
|
export * from './antigravity.js';
|
||||||
export * from './amp.js';
|
export * from './amp.js';
|
||||||
export * from './clawdbot.js';
|
export * from './clawdbot.js';
|
||||||
|
export * from './openclaw.js';
|
||||||
export * from './droid.js';
|
export * from './droid.js';
|
||||||
export * from './factory.js';
|
export * from './factory.js';
|
||||||
export * from './github-copilot.js';
|
export * from './github-copilot.js';
|
||||||
@@ -39,6 +42,7 @@ export * from './roo.js';
|
|||||||
export * from './trae.js';
|
export * from './trae.js';
|
||||||
export * from './windsurf.js';
|
export * from './windsurf.js';
|
||||||
export * from './universal.js';
|
export * from './universal.js';
|
||||||
|
export * from './hermes.js';
|
||||||
export * from './generic.js';
|
export * from './generic.js';
|
||||||
|
|
||||||
// Agent features
|
// Agent features
|
||||||
@@ -53,6 +57,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
|||||||
antigravity: new AntigravityAdapter(),
|
antigravity: new AntigravityAdapter(),
|
||||||
amp: new AmpAdapter(),
|
amp: new AmpAdapter(),
|
||||||
clawdbot: new ClawdbotAdapter(),
|
clawdbot: new ClawdbotAdapter(),
|
||||||
|
openclaw: new OpenClawAdapter(),
|
||||||
droid: new DroidAdapter(),
|
droid: new DroidAdapter(),
|
||||||
'github-copilot': new GitHubCopilotAdapter(),
|
'github-copilot': new GitHubCopilotAdapter(),
|
||||||
goose: new GooseAdapter(),
|
goose: new GooseAdapter(),
|
||||||
@@ -89,6 +94,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
|||||||
tabnine: new GenericAgentAdapter('tabnine'),
|
tabnine: new GenericAgentAdapter('tabnine'),
|
||||||
codegpt: new GenericAgentAdapter('codegpt'),
|
codegpt: new GenericAgentAdapter('codegpt'),
|
||||||
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
|
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
|
||||||
|
hermes: new HermesAdapter(),
|
||||||
};
|
};
|
||||||
|
|
||||||
export function getAdapter(type: AgentType): AgentAdapter {
|
export function getAdapter(type: AgentType): AgentAdapter {
|
||||||
@@ -107,6 +113,10 @@ export function getAllAdapters(): AgentAdapterWithType[] {
|
|||||||
}));
|
}));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export function getAdapterCount(): number {
|
||||||
|
return Object.keys(adapters).length;
|
||||||
|
}
|
||||||
|
|
||||||
export async function detectAgent(): Promise<AgentType> {
|
export async function detectAgent(): Promise<AgentType> {
|
||||||
const checkOrder: AgentType[] = [
|
const checkOrder: AgentType[] = [
|
||||||
'claude-code',
|
'claude-code',
|
||||||
@@ -116,6 +126,7 @@ export async function detectAgent(): Promise<AgentType> {
|
|||||||
'opencode',
|
'opencode',
|
||||||
'antigravity',
|
'antigravity',
|
||||||
'amp',
|
'amp',
|
||||||
|
'openclaw',
|
||||||
'clawdbot',
|
'clawdbot',
|
||||||
'droid',
|
'droid',
|
||||||
'github-copilot',
|
'github-copilot',
|
||||||
@@ -152,6 +163,7 @@ export async function detectAgent(): Promise<AgentType> {
|
|||||||
'tabnine',
|
'tabnine',
|
||||||
'codegpt',
|
'codegpt',
|
||||||
'playcode-agent',
|
'playcode-agent',
|
||||||
|
'hermes',
|
||||||
'universal',
|
'universal',
|
||||||
];
|
];
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,25 @@
|
|||||||
|
import { existsSync } from 'node:fs';
|
||||||
|
import { join } from 'node:path';
|
||||||
|
import { homedir } from 'node:os';
|
||||||
|
import { ClawdbotAdapter } from './clawdbot.js';
|
||||||
|
import type { AgentType } from '@skillkit/core';
|
||||||
|
import { AGENT_CONFIG } from '@skillkit/core';
|
||||||
|
|
||||||
|
const config = AGENT_CONFIG.openclaw;
|
||||||
|
|
||||||
|
export class OpenClawAdapter extends ClawdbotAdapter {
|
||||||
|
override readonly type: AgentType = 'openclaw';
|
||||||
|
override readonly name = 'OpenClaw';
|
||||||
|
override readonly skillsDir = config.skillsDir;
|
||||||
|
override readonly configFile = config.configFile;
|
||||||
|
|
||||||
|
override async isDetected(): Promise<boolean> {
|
||||||
|
const projectOpenClaw = join(process.cwd(), '.openclaw');
|
||||||
|
const globalOpenClaw = join(homedir(), '.openclaw');
|
||||||
|
const globalWorkspace = join(homedir(), '.openclaw', 'workspace');
|
||||||
|
const openclawConfig = join(process.cwd(), 'openclaw.json');
|
||||||
|
|
||||||
|
return existsSync(projectOpenClaw) || existsSync(globalOpenClaw) ||
|
||||||
|
existsSync(globalWorkspace) || existsSync(openclawConfig);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@skillkit/api",
|
"name": "@skillkit/api",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"description": "REST API server for SkillKit skill discovery",
|
"description": "REST API server for SkillKit skill discovery",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": "./dist/index.js",
|
"main": "./dist/index.js",
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
|
|||||||
info: {
|
info: {
|
||||||
title: 'SkillKit',
|
title: 'SkillKit',
|
||||||
version: '1.12.0',
|
version: '1.12.0',
|
||||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 44 agents).',
|
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 46 agents).',
|
||||||
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
||||||
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
[](https://www.npmjs.com/package/@skillkit/cli)
|
[](https://www.npmjs.com/package/@skillkit/cli)
|
||||||
[](https://opensource.org/licenses/Apache-2.0)
|
[](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 46 AI coding agents.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@@ -264,7 +264,7 @@ const recs = await recommendCommand({
|
|||||||
| Gemini CLI | SKILL.md |
|
| Gemini CLI | SKILL.md |
|
||||||
| Windsurf | Markdown |
|
| Windsurf | Markdown |
|
||||||
| GitHub Copilot | Markdown |
|
| GitHub Copilot | Markdown |
|
||||||
| + 26 more | SKILL.md |
|
| + 39 more | SKILL.md |
|
||||||
|
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@skillkit/cli",
|
"name": "@skillkit/cli",
|
||||||
"version": "1.19.2",
|
"version": "1.24.0",
|
||||||
"description": "CLI commands for SkillKit",
|
"description": "CLI commands for SkillKit",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": "./dist/index.js",
|
"main": "./dist/index.js",
|
||||||
@@ -22,14 +22,9 @@
|
|||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@clack/prompts": "^0.11.0",
|
"@clack/prompts": "^0.11.0",
|
||||||
"@skillkit/api": "workspace:*",
|
|
||||||
"@skillkit/core": "workspace:*",
|
"@skillkit/core": "workspace:*",
|
||||||
"@skillkit/agents": "workspace:*",
|
"@skillkit/agents": "workspace:*",
|
||||||
"@skillkit/resources": "workspace:*",
|
"@skillkit/resources": "workspace:*",
|
||||||
"@skillkit/tui": "workspace:*",
|
|
||||||
"@skillkit/memory": "workspace:*",
|
|
||||||
"@skillkit/mesh": "workspace:*",
|
|
||||||
"@skillkit/messaging": "workspace:*",
|
|
||||||
"chalk": "^5.3.0",
|
"chalk": "^5.3.0",
|
||||||
"clipanion": "^4.0.0-rc.4",
|
"clipanion": "^4.0.0-rc.4",
|
||||||
"got": "^14.4.1",
|
"got": "^14.4.1",
|
||||||
@@ -38,6 +33,12 @@
|
|||||||
"picocolors": "^1.1.1",
|
"picocolors": "^1.1.1",
|
||||||
"yaml": "^2.7.0"
|
"yaml": "^2.7.0"
|
||||||
},
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"@skillkit/api": "workspace:*",
|
||||||
|
"@skillkit/tui": "workspace:*",
|
||||||
|
"@skillkit/mesh": "workspace:*",
|
||||||
|
"@skillkit/messaging": "workspace:*"
|
||||||
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@types/node": "^22.10.5",
|
"@types/node": "^22.10.5",
|
||||||
"tsup": "^8.3.5",
|
"tsup": "^8.3.5",
|
||||||
|
|||||||
@@ -96,10 +96,10 @@ describe('Onboarding Module', () => {
|
|||||||
it('should generate full logo with version', async () => {
|
it('should generate full logo with version', async () => {
|
||||||
const { getFullLogo } = await import('../onboarding/logo.js');
|
const { getFullLogo } = await import('../onboarding/logo.js');
|
||||||
|
|
||||||
const logo = getFullLogo('1.7.2', 44);
|
const logo = getFullLogo('1.7.2', 46);
|
||||||
expect(logo).toContain('\u2588');
|
expect(logo).toContain('\u2588');
|
||||||
expect(logo).toContain('v1.7.2');
|
expect(logo).toContain('v1.7.2');
|
||||||
expect(logo).toContain('44 agents');
|
expect(logo).toContain('46 agents');
|
||||||
});
|
});
|
||||||
|
|
||||||
it('should generate compact logo', async () => {
|
it('should generate compact logo', async () => {
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import chalk from 'chalk';
|
import { colors, warn } from '../onboarding/index.js';
|
||||||
import { ActivityLog } from '@skillkit/core';
|
import { ActivityLog } from '@skillkit/core';
|
||||||
|
|
||||||
export class ActivityCommand extends Command {
|
export class ActivityCommand extends Command {
|
||||||
@@ -42,16 +42,16 @@ export class ActivityCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (activities.length === 0) {
|
if (activities.length === 0) {
|
||||||
console.log(chalk.yellow('No activity recorded'));
|
warn('No activity recorded');
|
||||||
console.log(
|
console.log(
|
||||||
chalk.dim(
|
colors.muted(
|
||||||
'Activity is recorded when skills are active during git commits.'
|
'Activity is recorded when skills are active during git commits.'
|
||||||
)
|
)
|
||||||
);
|
);
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(' Recent Skill Activity\n'));
|
console.log(colors.cyan(' Recent Skill Activity\n'));
|
||||||
|
|
||||||
const displayed = activities.slice(0, limit);
|
const displayed = activities.slice(0, limit);
|
||||||
|
|
||||||
@@ -61,10 +61,10 @@ export class ActivityCommand extends Command {
|
|||||||
const files = activity.filesChanged.join(', ');
|
const files = activity.filesChanged.join(', ');
|
||||||
const ago = formatTimeAgo(activity.committedAt);
|
const ago = formatTimeAgo(activity.committedAt);
|
||||||
|
|
||||||
console.log(` ${chalk.bold(shortSha)} ${activity.message}`);
|
console.log(` ${colors.bold(shortSha)} ${activity.message}`);
|
||||||
console.log(` Skills: ${chalk.green(skills)}`);
|
console.log(` Skills: ${colors.success(skills)}`);
|
||||||
console.log(
|
console.log(
|
||||||
` Files: ${files} ${chalk.dim(`(${ago})`)}`
|
` Files: ${files} ${colors.muted(`(${ago})`)}`
|
||||||
);
|
);
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
* Manage custom AI sub-agents (e.g., .claude/agents/*.md)
|
* Manage custom AI sub-agents (e.g., .claude/agents/*.md)
|
||||||
*/
|
*/
|
||||||
|
|
||||||
import chalk from 'chalk';
|
import { colors } from '../onboarding/index.js';
|
||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
||||||
import { join, basename } from 'node:path';
|
import { join, basename } from 'node:path';
|
||||||
@@ -67,7 +67,7 @@ export class AgentCommand extends Command {
|
|||||||
});
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
console.log(chalk.cyan('Agent management commands:\n'));
|
console.log(colors.cyan('Agent management commands:\n'));
|
||||||
console.log(' agent list List all installed agents');
|
console.log(' agent list List all installed agents');
|
||||||
console.log(' agent show <name> Show agent details');
|
console.log(' agent show <name> Show agent details');
|
||||||
console.log(' agent create <name> Create a new agent');
|
console.log(' agent create <name> Create a new agent');
|
||||||
@@ -76,7 +76,7 @@ export class AgentCommand extends Command {
|
|||||||
console.log(' agent sync Sync agents to target AI agent');
|
console.log(' agent sync Sync agents to target AI agent');
|
||||||
console.log(' agent validate [path] Validate agent definitions');
|
console.log(' agent validate [path] Validate agent definitions');
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.dim('Run `skillkit agent <subcommand> --help` for more info'));
|
console.log(colors.muted('Run `skillkit agent <subcommand> --help` for more info'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -136,18 +136,18 @@ export class AgentListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
console.log(chalk.yellow('No agents found'));
|
console.log(colors.warning('No agents found'));
|
||||||
console.log(chalk.dim('Create an agent with: skillkit agent create <name>'));
|
console.log(colors.muted('Create an agent with: skillkit agent create <name>'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`Installed agents (${agents.length}):\n`));
|
console.log(colors.cyan(`Installed agents (${agents.length}):\n`));
|
||||||
|
|
||||||
const projectAgents = agents.filter((a: CustomAgent) => a.location === 'project');
|
const projectAgents = agents.filter((a: CustomAgent) => a.location === 'project');
|
||||||
const globalAgents = agents.filter((a: CustomAgent) => a.location === 'global');
|
const globalAgents = agents.filter((a: CustomAgent) => a.location === 'global');
|
||||||
|
|
||||||
if (projectAgents.length > 0) {
|
if (projectAgents.length > 0) {
|
||||||
console.log(chalk.blue('Project agents:'));
|
console.log(colors.info('Project agents:'));
|
||||||
for (const agent of projectAgents) {
|
for (const agent of projectAgents) {
|
||||||
printAgent(agent);
|
printAgent(agent);
|
||||||
}
|
}
|
||||||
@@ -155,7 +155,7 @@ export class AgentListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (globalAgents.length > 0) {
|
if (globalAgents.length > 0) {
|
||||||
console.log(chalk.dim('Global agents:'));
|
console.log(colors.muted('Global agents:'));
|
||||||
for (const agent of globalAgents) {
|
for (const agent of globalAgents) {
|
||||||
printAgent(agent);
|
printAgent(agent);
|
||||||
}
|
}
|
||||||
@@ -163,7 +163,7 @@ export class AgentListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
console.log(
|
console.log(
|
||||||
chalk.dim(`${projectAgents.length} project, ${globalAgents.length} global`)
|
colors.muted(`${projectAgents.length} project, ${globalAgents.length} global`)
|
||||||
);
|
);
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -187,47 +187,47 @@ export class AgentShowCommand extends Command {
|
|||||||
const agent = findAgent(this.name, searchDirs);
|
const agent = findAgent(this.name, searchDirs);
|
||||||
|
|
||||||
if (!agent) {
|
if (!agent) {
|
||||||
console.log(chalk.red(`Agent not found: ${this.name}`));
|
console.log(colors.error(`Agent not found: ${this.name}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`Agent: ${agent.name}\n`));
|
console.log(colors.cyan(`Agent: ${agent.name}\n`));
|
||||||
console.log(`${chalk.dim('Description:')} ${agent.description}`);
|
console.log(`${colors.muted('Description:')} ${agent.description}`);
|
||||||
console.log(`${chalk.dim('Location:')} ${agent.location} (${agent.path})`);
|
console.log(`${colors.muted('Location:')} ${agent.location} (${agent.path})`);
|
||||||
console.log(`${chalk.dim('Enabled:')} ${agent.enabled ? chalk.green('yes') : chalk.red('no')}`);
|
console.log(`${colors.muted('Enabled:')} ${agent.enabled ? colors.success('yes') : colors.error('no')}`);
|
||||||
|
|
||||||
const fm = agent.frontmatter;
|
const fm = agent.frontmatter;
|
||||||
if (fm.model) {
|
if (fm.model) {
|
||||||
console.log(`${chalk.dim('Model:')} ${fm.model}`);
|
console.log(`${colors.muted('Model:')} ${fm.model}`);
|
||||||
}
|
}
|
||||||
if (fm.permissionMode) {
|
if (fm.permissionMode) {
|
||||||
console.log(`${chalk.dim('Permission Mode:')} ${fm.permissionMode}`);
|
console.log(`${colors.muted('Permission Mode:')} ${fm.permissionMode}`);
|
||||||
}
|
}
|
||||||
if (fm.context) {
|
if (fm.context) {
|
||||||
console.log(`${chalk.dim('Context:')} ${fm.context}`);
|
console.log(`${colors.muted('Context:')} ${fm.context}`);
|
||||||
}
|
}
|
||||||
if (fm.disallowedTools && fm.disallowedTools.length > 0) {
|
if (fm.disallowedTools && fm.disallowedTools.length > 0) {
|
||||||
console.log(`${chalk.dim('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
|
console.log(`${colors.muted('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
|
||||||
}
|
}
|
||||||
if (fm.skills && fm.skills.length > 0) {
|
if (fm.skills && fm.skills.length > 0) {
|
||||||
console.log(`${chalk.dim('Skills:')} ${fm.skills.join(', ')}`);
|
console.log(`${colors.muted('Skills:')} ${fm.skills.join(', ')}`);
|
||||||
}
|
}
|
||||||
if (fm.hooks && fm.hooks.length > 0) {
|
if (fm.hooks && fm.hooks.length > 0) {
|
||||||
console.log(`${chalk.dim('Hooks:')} ${fm.hooks.length} defined`);
|
console.log(`${colors.muted('Hooks:')} ${fm.hooks.length} defined`);
|
||||||
}
|
}
|
||||||
if (fm.tags && fm.tags.length > 0) {
|
if (fm.tags && fm.tags.length > 0) {
|
||||||
console.log(`${chalk.dim('Tags:')} ${fm.tags.join(', ')}`);
|
console.log(`${colors.muted('Tags:')} ${fm.tags.join(', ')}`);
|
||||||
}
|
}
|
||||||
if (fm.author) {
|
if (fm.author) {
|
||||||
console.log(`${chalk.dim('Author:')} ${fm.author}`);
|
console.log(`${colors.muted('Author:')} ${fm.author}`);
|
||||||
}
|
}
|
||||||
if (fm.version) {
|
if (fm.version) {
|
||||||
console.log(`${chalk.dim('Version:')} ${fm.version}`);
|
console.log(`${colors.muted('Version:')} ${fm.version}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.dim('Content preview:'));
|
console.log(colors.muted('Content preview:'));
|
||||||
console.log(chalk.dim('─'.repeat(40)));
|
console.log(colors.muted('─'.repeat(40)));
|
||||||
const preview = agent.content.slice(0, 500);
|
const preview = agent.content.slice(0, 500);
|
||||||
console.log(preview + (agent.content.length > 500 ? '\n...' : ''));
|
console.log(preview + (agent.content.length > 500 ? '\n...' : ''));
|
||||||
|
|
||||||
@@ -264,8 +264,8 @@ export class AgentCreateCommand extends Command {
|
|||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
||||||
if (!namePattern.test(this.name)) {
|
if (!namePattern.test(this.name)) {
|
||||||
console.log(chalk.red('Invalid agent name: must be lowercase alphanumeric with hyphens'));
|
console.log(colors.error('Invalid agent name: must be lowercase alphanumeric with hyphens'));
|
||||||
console.log(chalk.dim('Examples: my-agent, code-reviewer, security-expert'));
|
console.log(colors.muted('Examples: my-agent, code-reviewer, security-expert'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -282,7 +282,7 @@ export class AgentCreateCommand extends Command {
|
|||||||
|
|
||||||
const agentPath = join(targetDir, `${this.name}.md`);
|
const agentPath = join(targetDir, `${this.name}.md`);
|
||||||
if (existsSync(agentPath)) {
|
if (existsSync(agentPath)) {
|
||||||
console.log(chalk.red(`Agent already exists: ${agentPath}`));
|
console.log(colors.error(`Agent already exists: ${agentPath}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -291,10 +291,10 @@ export class AgentCreateCommand extends Command {
|
|||||||
|
|
||||||
writeFileSync(agentPath, content);
|
writeFileSync(agentPath, content);
|
||||||
|
|
||||||
console.log(chalk.green(`Created agent: ${agentPath}`));
|
console.log(colors.success(`Created agent: ${agentPath}`));
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.dim('Edit the file to customize the agent system prompt.'));
|
console.log(colors.muted('Edit the file to customize the agent system prompt.'));
|
||||||
console.log(chalk.dim(`Invoke with: @${this.name}`));
|
console.log(colors.muted(`Invoke with: @${this.name}`));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -360,23 +360,23 @@ export class AgentTranslateCommand extends Command {
|
|||||||
: join(process.cwd(), this.source);
|
: join(process.cwd(), this.source);
|
||||||
|
|
||||||
if (!existsSync(sourcePath)) {
|
if (!existsSync(sourcePath)) {
|
||||||
console.log(chalk.red(`Source path not found: ${sourcePath}`));
|
console.log(colors.error(`Source path not found: ${sourcePath}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
agents = discoverAgentsFromPath(sourcePath, this.recursive);
|
agents = discoverAgentsFromPath(sourcePath, this.recursive);
|
||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
console.log(chalk.yellow(`No agents found in: ${sourcePath}`));
|
console.log(colors.warning(`No agents found in: ${sourcePath}`));
|
||||||
if (!this.recursive) {
|
if (!this.recursive) {
|
||||||
console.log(chalk.dim('Tip: Use --recursive to scan subdirectories'));
|
console.log(colors.muted('Tip: Use --recursive to scan subdirectories'));
|
||||||
}
|
}
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
} else if (this.name) {
|
} else if (this.name) {
|
||||||
const agent = findAgent(this.name, searchDirs);
|
const agent = findAgent(this.name, searchDirs);
|
||||||
if (!agent) {
|
if (!agent) {
|
||||||
console.log(chalk.red(`Agent not found: ${this.name}`));
|
console.log(colors.error(`Agent not found: ${this.name}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
agents = [agent];
|
agents = [agent];
|
||||||
@@ -387,13 +387,13 @@ export class AgentTranslateCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
console.log(chalk.yellow('No agents found to translate'));
|
console.log(colors.warning('No agents found to translate'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
const outputDir = this.output || getAgentTargetDirectory(process.cwd(), targetAgent);
|
const outputDir = this.output || getAgentTargetDirectory(process.cwd(), targetAgent);
|
||||||
|
|
||||||
console.log(chalk.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
|
console.log(colors.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
|
||||||
|
|
||||||
let successCount = 0;
|
let successCount = 0;
|
||||||
let errorCount = 0;
|
let errorCount = 0;
|
||||||
@@ -403,7 +403,7 @@ export class AgentTranslateCommand extends Command {
|
|||||||
const result = translateAgent(agent, targetAgent, { addMetadata: true });
|
const result = translateAgent(agent, targetAgent, { addMetadata: true });
|
||||||
|
|
||||||
if (!result.success) {
|
if (!result.success) {
|
||||||
console.log(chalk.red(`✗ ${agent.name}: Translation failed`));
|
console.log(colors.error(`✗ ${agent.name}: Translation failed`));
|
||||||
errorCount++;
|
errorCount++;
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
@@ -411,15 +411,15 @@ export class AgentTranslateCommand extends Command {
|
|||||||
const outputPath = join(outputDir, result.filename);
|
const outputPath = join(outputDir, result.filename);
|
||||||
|
|
||||||
if (this.dryRun) {
|
if (this.dryRun) {
|
||||||
console.log(chalk.blue(`Would write: ${outputPath}`));
|
console.log(colors.info(`Would write: ${outputPath}`));
|
||||||
if (result.warnings.length > 0) {
|
if (result.warnings.length > 0) {
|
||||||
for (const warning of result.warnings) {
|
for (const warning of result.warnings) {
|
||||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
console.log(colors.warning(` ⚠ ${warning}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (result.incompatible.length > 0) {
|
if (result.incompatible.length > 0) {
|
||||||
for (const incompat of result.incompatible) {
|
for (const incompat of result.incompatible) {
|
||||||
console.log(chalk.dim(` ○ ${incompat}`));
|
console.log(colors.muted(` ○ ${incompat}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
@@ -427,21 +427,21 @@ export class AgentTranslateCommand extends Command {
|
|||||||
mkdirSync(outputDir, { recursive: true });
|
mkdirSync(outputDir, { recursive: true });
|
||||||
}
|
}
|
||||||
writeFileSync(outputPath, result.content);
|
writeFileSync(outputPath, result.content);
|
||||||
console.log(chalk.green(`✓ ${agent.name} → ${outputPath}`));
|
console.log(colors.success(`✓ ${agent.name} → ${outputPath}`));
|
||||||
}
|
}
|
||||||
|
|
||||||
successCount++;
|
successCount++;
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.log(chalk.red(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
|
console.log(colors.error(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
|
||||||
errorCount++;
|
errorCount++;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
if (this.dryRun) {
|
if (this.dryRun) {
|
||||||
console.log(chalk.dim(`Would translate ${successCount} agent(s)`));
|
console.log(colors.muted(`Would translate ${successCount} agent(s)`));
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.dim(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
|
console.log(colors.muted(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
|
||||||
}
|
}
|
||||||
|
|
||||||
return errorCount > 0 ? 1 : 0;
|
return errorCount > 0 ? 1 : 0;
|
||||||
@@ -468,7 +468,7 @@ export class AgentSyncCommand extends Command {
|
|||||||
const agents = findAllAgents(searchDirs);
|
const agents = findAllAgents(searchDirs);
|
||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
console.log(chalk.yellow('No agents found to sync'));
|
console.log(colors.warning('No agents found to sync'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -476,12 +476,12 @@ export class AgentSyncCommand extends Command {
|
|||||||
? this.agent.split(',').map(a => a.trim() as AgentType)
|
? this.agent.split(',').map(a => a.trim() as AgentType)
|
||||||
: ['claude-code' as AgentType];
|
: ['claude-code' as AgentType];
|
||||||
|
|
||||||
console.log(chalk.cyan(`Syncing ${agents.length} agent(s)...\n`));
|
console.log(colors.cyan(`Syncing ${agents.length} agent(s)...\n`));
|
||||||
|
|
||||||
for (const targetAgent of targetAgents) {
|
for (const targetAgent of targetAgents) {
|
||||||
const outputDir = getAgentTargetDirectory(process.cwd(), targetAgent);
|
const outputDir = getAgentTargetDirectory(process.cwd(), targetAgent);
|
||||||
|
|
||||||
console.log(chalk.blue(`→ ${targetAgent} (${outputDir})`));
|
console.log(colors.info(`→ ${targetAgent} (${outputDir})`));
|
||||||
|
|
||||||
if (!existsSync(outputDir)) {
|
if (!existsSync(outputDir)) {
|
||||||
mkdirSync(outputDir, { recursive: true });
|
mkdirSync(outputDir, { recursive: true });
|
||||||
@@ -492,15 +492,15 @@ export class AgentSyncCommand extends Command {
|
|||||||
if (result.success) {
|
if (result.success) {
|
||||||
const outputPath = join(outputDir, result.filename);
|
const outputPath = join(outputDir, result.filename);
|
||||||
writeFileSync(outputPath, result.content);
|
writeFileSync(outputPath, result.content);
|
||||||
console.log(chalk.green(` ✓ ${agent.name}`));
|
console.log(colors.success(` ✓ ${agent.name}`));
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(` ✗ ${agent.name}`));
|
console.log(colors.error(` ✗ ${agent.name}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.dim('Sync complete'));
|
console.log(colors.muted('Sync complete'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -535,11 +535,11 @@ export class AgentValidateCommand extends Command {
|
|||||||
const agents = findAllAgents(searchDirs);
|
const agents = findAllAgents(searchDirs);
|
||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
console.log(chalk.yellow('No agents found'));
|
console.log(colors.warning('No agents found'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`Validating ${agents.length} agent(s)...\n`));
|
console.log(colors.cyan(`Validating ${agents.length} agent(s)...\n`));
|
||||||
|
|
||||||
for (const agent of agents) {
|
for (const agent of agents) {
|
||||||
const result = validateAgent(agent.path);
|
const result = validateAgent(agent.path);
|
||||||
@@ -547,7 +547,7 @@ export class AgentValidateCommand extends Command {
|
|||||||
if (!result.valid) hasErrors = true;
|
if (!result.valid) hasErrors = true;
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.yellow('Specify a path or use --all to validate all agents'));
|
console.log(colors.warning('Specify a path or use --all to validate all agents'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -556,10 +556,10 @@ export class AgentValidateCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
function printAgent(agent: CustomAgent): void {
|
function printAgent(agent: CustomAgent): void {
|
||||||
const status = agent.enabled ? chalk.green('✓') : chalk.red('○');
|
const status = agent.enabled ? colors.success('✓') : colors.error('○');
|
||||||
const name = agent.enabled ? agent.name : chalk.dim(agent.name);
|
const name = agent.enabled ? agent.name : colors.muted(agent.name);
|
||||||
const model = agent.frontmatter.model ? chalk.blue(`[${agent.frontmatter.model}]`) : '';
|
const model = agent.frontmatter.model ? colors.info(`[${agent.frontmatter.model}]`) : '';
|
||||||
const desc = chalk.dim(truncate(agent.description, 40));
|
const desc = colors.muted(truncate(agent.description, 40));
|
||||||
|
|
||||||
console.log(` ${status} ${name} ${model}`);
|
console.log(` ${status} ${name} ${model}`);
|
||||||
if (agent.description) {
|
if (agent.description) {
|
||||||
@@ -572,17 +572,17 @@ function printValidationResult(
|
|||||||
result: { valid: boolean; errors: string[]; warnings: string[] }
|
result: { valid: boolean; errors: string[]; warnings: string[] }
|
||||||
): void {
|
): void {
|
||||||
if (result.valid) {
|
if (result.valid) {
|
||||||
console.log(chalk.green(`✓ ${name}`));
|
console.log(colors.success(`✓ ${name}`));
|
||||||
for (const warning of result.warnings) {
|
for (const warning of result.warnings) {
|
||||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
console.log(colors.warning(` ⚠ ${warning}`));
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(`✗ ${name}`));
|
console.log(colors.error(`✗ ${name}`));
|
||||||
for (const error of result.errors) {
|
for (const err of result.errors) {
|
||||||
console.log(chalk.red(` • ${error}`));
|
console.log(colors.error(` • ${err}`));
|
||||||
}
|
}
|
||||||
for (const warning of result.warnings) {
|
for (const warning of result.warnings) {
|
||||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
console.log(colors.warning(` ⚠ ${warning}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -671,15 +671,15 @@ export class AgentInstallCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (!this.name) {
|
if (!this.name) {
|
||||||
console.log(chalk.yellow('Please specify an agent name or use --all'));
|
console.log(colors.warning('Please specify an agent name or use --all'));
|
||||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const agent = getBundledAgent(this.name);
|
const agent = getBundledAgent(this.name);
|
||||||
if (!agent) {
|
if (!agent) {
|
||||||
console.log(chalk.red(`Bundled agent not found: ${this.name}`));
|
console.log(colors.error(`Bundled agent not found: ${this.name}`));
|
||||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -689,11 +689,11 @@ export class AgentInstallCommand extends Command {
|
|||||||
});
|
});
|
||||||
|
|
||||||
if (result.success) {
|
if (result.success) {
|
||||||
console.log(chalk.green(`✓ Installed: ${agent.name}`));
|
console.log(colors.success(`✓ Installed: ${agent.name}`));
|
||||||
console.log(chalk.dim(` Path: ${result.path}`));
|
console.log(colors.muted(` Path: ${result.path}`));
|
||||||
console.log(chalk.dim(` Invoke with: @${agent.id}`));
|
console.log(colors.muted(` Invoke with: @${agent.id}`));
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(`✗ Failed: ${result.message}`));
|
console.log(colors.error(`✗ Failed: ${result.message}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -702,7 +702,7 @@ export class AgentInstallCommand extends Command {
|
|||||||
|
|
||||||
private async installAll(): Promise<number> {
|
private async installAll(): Promise<number> {
|
||||||
const agents = getBundledAgents();
|
const agents = getBundledAgents();
|
||||||
console.log(chalk.cyan(`Installing ${agents.length} bundled agents...\n`));
|
console.log(colors.cyan(`Installing ${agents.length} bundled agents...\n`));
|
||||||
|
|
||||||
let successCount = 0;
|
let successCount = 0;
|
||||||
let skipCount = 0;
|
let skipCount = 0;
|
||||||
@@ -715,20 +715,20 @@ export class AgentInstallCommand extends Command {
|
|||||||
});
|
});
|
||||||
|
|
||||||
if (result.success) {
|
if (result.success) {
|
||||||
console.log(chalk.green(` ✓ ${agent.name}`));
|
console.log(colors.success(` ✓ ${agent.name}`));
|
||||||
successCount++;
|
successCount++;
|
||||||
} else if (result.message.includes('already exists')) {
|
} else if (result.message.includes('already exists')) {
|
||||||
console.log(chalk.yellow(` ○ ${agent.name} (already installed)`));
|
console.log(colors.warning(` ○ ${agent.name} (already installed)`));
|
||||||
skipCount++;
|
skipCount++;
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(` ✗ ${agent.name}: ${result.message}`));
|
console.log(colors.error(` ✗ ${agent.name}: ${result.message}`));
|
||||||
errorCount++;
|
errorCount++;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
console.log(
|
console.log(
|
||||||
chalk.dim(
|
colors.muted(
|
||||||
`Installed: ${successCount}, Skipped: ${skipCount}, Errors: ${errorCount}`
|
`Installed: ${successCount}, Skipped: ${skipCount}, Errors: ${errorCount}`
|
||||||
)
|
)
|
||||||
);
|
);
|
||||||
@@ -781,10 +781,10 @@ export class AgentAvailableCommand extends Command {
|
|||||||
|
|
||||||
if (agents.length === 0) {
|
if (agents.length === 0) {
|
||||||
if (this.installed) {
|
if (this.installed) {
|
||||||
console.log(chalk.yellow('No bundled agents installed'));
|
console.log(colors.warning('No bundled agents installed'));
|
||||||
console.log(chalk.dim('Run `skillkit agent install <name>` to install'));
|
console.log(colors.muted('Run `skillkit agent install <name>` to install'));
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.green('All bundled agents are already installed!'));
|
console.log(colors.success('All bundled agents are already installed!'));
|
||||||
}
|
}
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -793,7 +793,7 @@ export class AgentAvailableCommand extends Command {
|
|||||||
? 'Installed Bundled Agents'
|
? 'Installed Bundled Agents'
|
||||||
: 'Available Bundled Agents';
|
: 'Available Bundled Agents';
|
||||||
|
|
||||||
console.log(chalk.cyan(`${title} (${agents.length}):\n`));
|
console.log(colors.cyan(`${title} (${agents.length}):\n`));
|
||||||
|
|
||||||
const categories = new Map<string, BundledAgent[]>();
|
const categories = new Map<string, BundledAgent[]>();
|
||||||
for (const agent of agents) {
|
for (const agent of agents) {
|
||||||
@@ -805,20 +805,20 @@ export class AgentAvailableCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
for (const [category, catAgents] of categories) {
|
for (const [category, catAgents] of categories) {
|
||||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
console.log(colors.info(` ${formatCategoryName(category)}`));
|
||||||
for (const agent of catAgents) {
|
for (const agent of catAgents) {
|
||||||
const installed = isAgentInstalled(agent.id);
|
const installed = isAgentInstalled(agent.id);
|
||||||
const status = installed ? chalk.green('✓') : chalk.dim('○');
|
const status = installed ? colors.success('✓') : colors.muted('○');
|
||||||
const model = agent.model ? chalk.blue(`[${agent.model}]`) : '';
|
const model = agent.model ? colors.info(`[${agent.model}]`) : '';
|
||||||
console.log(` ${status} ${chalk.bold(agent.id)} ${model}`);
|
console.log(` ${status} ${colors.bold(agent.id)} ${model}`);
|
||||||
console.log(` ${chalk.dim(agent.description)}`);
|
console.log(` ${colors.muted(agent.description)}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!this.installed) {
|
if (!this.installed) {
|
||||||
console.log(chalk.dim('Install with: skillkit agent install <name>'));
|
console.log(colors.muted('Install with: skillkit agent install <name>'));
|
||||||
console.log(chalk.dim('Install all: skillkit agent install --all'));
|
console.log(colors.muted('Install all: skillkit agent install --all'));
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -877,20 +877,20 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
const skill = skills.find((s: Skill) => s.name === this.skillName);
|
const skill = skills.find((s: Skill) => s.name === this.skillName);
|
||||||
|
|
||||||
if (!skill) {
|
if (!skill) {
|
||||||
console.log(chalk.red(`Skill not found: ${this.skillName}`));
|
console.log(colors.error(`Skill not found: ${this.skillName}`));
|
||||||
console.log(chalk.dim('Available skills:'));
|
console.log(colors.muted('Available skills:'));
|
||||||
for (const s of skills.slice(0, 10)) {
|
for (const s of skills.slice(0, 10)) {
|
||||||
console.log(chalk.dim(` - ${s.name}`));
|
console.log(colors.muted(` - ${s.name}`));
|
||||||
}
|
}
|
||||||
if (skills.length > 10) {
|
if (skills.length > 10) {
|
||||||
console.log(chalk.dim(` ... and ${skills.length - 10} more`));
|
console.log(colors.muted(` ... and ${skills.length - 10} more`));
|
||||||
}
|
}
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const skillContent = readSkillContent(skill.path);
|
const skillContent = readSkillContent(skill.path);
|
||||||
if (!skillContent) {
|
if (!skillContent) {
|
||||||
console.log(chalk.red(`Could not read skill content: ${skill.path}`));
|
console.log(colors.error(`Could not read skill content: ${skill.path}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -901,8 +901,8 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
if (this.model) {
|
if (this.model) {
|
||||||
const validModels = ['sonnet', 'opus', 'haiku', 'inherit'];
|
const validModels = ['sonnet', 'opus', 'haiku', 'inherit'];
|
||||||
if (!validModels.includes(this.model)) {
|
if (!validModels.includes(this.model)) {
|
||||||
console.log(chalk.red(`Invalid model: ${this.model}`));
|
console.log(colors.error(`Invalid model: ${this.model}`));
|
||||||
console.log(chalk.dim(`Valid options: ${validModels.join(', ')}`));
|
console.log(colors.muted(`Valid options: ${validModels.join(', ')}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
options.model = this.model as 'sonnet' | 'opus' | 'haiku' | 'inherit';
|
options.model = this.model as 'sonnet' | 'opus' | 'haiku' | 'inherit';
|
||||||
@@ -911,8 +911,8 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
if (this.permission) {
|
if (this.permission) {
|
||||||
const validModes = ['default', 'plan', 'auto-edit', 'full-auto', 'bypassPermissions'];
|
const validModes = ['default', 'plan', 'auto-edit', 'full-auto', 'bypassPermissions'];
|
||||||
if (!validModes.includes(this.permission)) {
|
if (!validModes.includes(this.permission)) {
|
||||||
console.log(chalk.red(`Invalid permission mode: ${this.permission}`));
|
console.log(colors.error(`Invalid permission mode: ${this.permission}`));
|
||||||
console.log(chalk.dim(`Valid options: ${validModes.join(', ')}`));
|
console.log(colors.muted(`Valid options: ${validModes.join(', ')}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
options.permissionMode = this.permission as AgentPermissionMode;
|
options.permissionMode = this.permission as AgentPermissionMode;
|
||||||
@@ -928,16 +928,16 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
if (this.output) {
|
if (this.output) {
|
||||||
const sanitized = sanitizeFilename(this.output);
|
const sanitized = sanitizeFilename(this.output);
|
||||||
if (!sanitized) {
|
if (!sanitized) {
|
||||||
console.log(chalk.red(`Invalid output filename: ${this.output}`));
|
console.log(colors.error(`Invalid output filename: ${this.output}`));
|
||||||
console.log(chalk.dim('Filename must contain only alphanumeric characters, hyphens, and underscores'));
|
console.log(colors.muted('Filename must contain only alphanumeric characters, hyphens, and underscores'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
filename = `${sanitized}.md`;
|
filename = `${sanitized}.md`;
|
||||||
} else {
|
} else {
|
||||||
const sanitized = sanitizeFilename(skill.name);
|
const sanitized = sanitizeFilename(skill.name);
|
||||||
if (!sanitized) {
|
if (!sanitized) {
|
||||||
console.log(chalk.red(`Invalid skill name for filename: ${skill.name}`));
|
console.log(colors.error(`Invalid skill name for filename: ${skill.name}`));
|
||||||
console.log(chalk.dim('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
|
console.log(colors.muted('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
filename = `${sanitized}.md`;
|
filename = `${sanitized}.md`;
|
||||||
@@ -946,11 +946,11 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
const outputPath = join(targetDir, filename);
|
const outputPath = join(targetDir, filename);
|
||||||
|
|
||||||
if (this.dryRun) {
|
if (this.dryRun) {
|
||||||
console.log(chalk.cyan('Preview (dry run):\n'));
|
console.log(colors.cyan('Preview (dry run):\n'));
|
||||||
console.log(chalk.dim(`Would write to: ${outputPath}`));
|
console.log(colors.muted(`Would write to: ${outputPath}`));
|
||||||
console.log(chalk.dim('─'.repeat(50)));
|
console.log(colors.muted('─'.repeat(50)));
|
||||||
console.log(content);
|
console.log(content);
|
||||||
console.log(chalk.dim('─'.repeat(50)));
|
console.log(colors.muted('─'.repeat(50)));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -959,18 +959,18 @@ export class AgentFromSkillCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (existsSync(outputPath)) {
|
if (existsSync(outputPath)) {
|
||||||
console.log(chalk.yellow(`Overwriting existing file: ${outputPath}`));
|
console.log(colors.warning(`Overwriting existing file: ${outputPath}`));
|
||||||
}
|
}
|
||||||
|
|
||||||
writeFileSync(outputPath, content);
|
writeFileSync(outputPath, content);
|
||||||
|
|
||||||
console.log(chalk.green(`Created subagent: ${outputPath}`));
|
console.log(colors.success(`Created subagent: ${outputPath}`));
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.dim(`Invoke with: @${skill.name}`));
|
console.log(colors.muted(`Invoke with: @${skill.name}`));
|
||||||
if (!this.inline) {
|
if (!this.inline) {
|
||||||
console.log(chalk.dim(`Skills referenced: ${skill.name}`));
|
console.log(colors.muted(`Skills referenced: ${skill.name}`));
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.dim('Skill content embedded inline'));
|
console.log(colors.muted('Skill content embedded inline'));
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
import chalk from 'chalk';
|
import { colors, warn, success, error } from '../onboarding/index.js';
|
||||||
import { Command } from 'clipanion';
|
import { Command } from 'clipanion';
|
||||||
import { AgentsMdGenerator, AgentsMdParser } from '@skillkit/core';
|
import { AgentsMdGenerator, AgentsMdParser } from '@skillkit/core';
|
||||||
|
|
||||||
@@ -40,7 +40,7 @@ export class AgentsMdInitCommand extends Command {
|
|||||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||||
|
|
||||||
if (existsSync(agentsPath)) {
|
if (existsSync(agentsPath)) {
|
||||||
console.log(chalk.yellow('AGENTS.md already exists. Use `skillkit agents sync` to update.'));
|
warn('AGENTS.md already exists. Use `skillkit agents sync` to update.');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -48,15 +48,15 @@ export class AgentsMdInitCommand extends Command {
|
|||||||
const generator = new AgentsMdGenerator({ projectPath });
|
const generator = new AgentsMdGenerator({ projectPath });
|
||||||
const result = generator.generate();
|
const result = generator.generate();
|
||||||
|
|
||||||
console.log(chalk.dim('Preview:'));
|
console.log(colors.muted('Preview:'));
|
||||||
console.log('');
|
console.log('');
|
||||||
console.log(result.content);
|
console.log(result.content);
|
||||||
|
|
||||||
writeFileSync(agentsPath, result.content, 'utf-8');
|
writeFileSync(agentsPath, result.content, 'utf-8');
|
||||||
console.log(chalk.green(`Created ${agentsPath}`));
|
success(`Created ${agentsPath}`);
|
||||||
return 0;
|
return 0;
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
console.log(chalk.red(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
|
error(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -74,7 +74,7 @@ export class AgentsMdSyncCommand extends Command {
|
|||||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||||
|
|
||||||
if (!existsSync(agentsPath)) {
|
if (!existsSync(agentsPath)) {
|
||||||
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` first.'));
|
warn('No AGENTS.md found. Run `skillkit agents init` first.');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -83,7 +83,7 @@ export class AgentsMdSyncCommand extends Command {
|
|||||||
const parser = new AgentsMdParser();
|
const parser = new AgentsMdParser();
|
||||||
|
|
||||||
if (!parser.hasManagedSections(existing)) {
|
if (!parser.hasManagedSections(existing)) {
|
||||||
console.log(chalk.yellow('No managed sections found in AGENTS.md. Nothing to update.'));
|
warn('No managed sections found in AGENTS.md. Nothing to update.');
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -93,10 +93,10 @@ export class AgentsMdSyncCommand extends Command {
|
|||||||
const updated = parser.updateManagedSections(existing, managedSections);
|
const updated = parser.updateManagedSections(existing, managedSections);
|
||||||
|
|
||||||
writeFileSync(agentsPath, updated, 'utf-8');
|
writeFileSync(agentsPath, updated, 'utf-8');
|
||||||
console.log(chalk.green(`Updated ${managedSections.length} managed section(s) in AGENTS.md`));
|
success(`Updated ${managedSections.length} managed section(s) in AGENTS.md`);
|
||||||
return 0;
|
return 0;
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
console.log(chalk.red(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
|
error(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -113,7 +113,7 @@ export class AgentsMdShowCommand extends Command {
|
|||||||
const agentsPath = join(process.cwd(), 'AGENTS.md');
|
const agentsPath = join(process.cwd(), 'AGENTS.md');
|
||||||
|
|
||||||
if (!existsSync(agentsPath)) {
|
if (!existsSync(agentsPath)) {
|
||||||
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` to create one.'));
|
warn('No AGENTS.md found. Run `skillkit agents init` to create one.');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -1,8 +1,7 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { resolve } from 'node:path';
|
import { resolve } from 'node:path';
|
||||||
import { promises as fs } from 'fs';
|
import { promises as fs } from 'fs';
|
||||||
import chalk from 'chalk';
|
import { colors, spinner } from '../onboarding/index.js';
|
||||||
import ora from 'ora';
|
|
||||||
import {
|
import {
|
||||||
type SearchableSkill,
|
type SearchableSkill,
|
||||||
type SkillExample,
|
type SkillExample,
|
||||||
@@ -88,7 +87,7 @@ export class AICommand extends Command {
|
|||||||
const providerName = manager.getProviderName();
|
const providerName = manager.getProviderName();
|
||||||
if (providerName === 'mock') {
|
if (providerName === 'mock') {
|
||||||
console.log(
|
console.log(
|
||||||
chalk.yellow(
|
colors.warning(
|
||||||
'⚠ Using mock AI provider (limited functionality)\n' +
|
'⚠ Using mock AI provider (limited functionality)\n' +
|
||||||
' Set ANTHROPIC_API_KEY or OPENAI_API_KEY for real AI features\n'
|
' Set ANTHROPIC_API_KEY or OPENAI_API_KEY for real AI features\n'
|
||||||
)
|
)
|
||||||
@@ -110,7 +109,7 @@ export class AICommand extends Command {
|
|||||||
return this.handleProviders();
|
return this.handleProviders();
|
||||||
default:
|
default:
|
||||||
console.error(
|
console.error(
|
||||||
chalk.red(`Unknown subcommand: ${this.subcommand}\n`)
|
colors.error(`Unknown subcommand: ${this.subcommand}\n`)
|
||||||
);
|
);
|
||||||
console.log('Valid subcommands: search, generate, similar, wizard, providers');
|
console.log('Valid subcommands: search, generate, similar, wizard, providers');
|
||||||
return 1;
|
return 1;
|
||||||
@@ -120,19 +119,20 @@ export class AICommand extends Command {
|
|||||||
private async handleSearch(manager: AIManager): Promise<number> {
|
private async handleSearch(manager: AIManager): Promise<number> {
|
||||||
const query = this.query || this.skillName;
|
const query = this.query || this.skillName;
|
||||||
if (!query) {
|
if (!query) {
|
||||||
console.error(chalk.red('Search query required (--query or positional argument)'));
|
console.error(colors.error('Search query required (--query or positional argument)'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const skills = await this.loadSkills();
|
const skills = await this.loadSkills();
|
||||||
if (skills.length === 0) {
|
if (skills.length === 0) {
|
||||||
console.log(
|
console.log(
|
||||||
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
|
colors.warning('No skills found. Run "skillkit recommend --update" first.')
|
||||||
);
|
);
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
const spinner = ora('Searching with AI...').start();
|
const s = spinner();
|
||||||
|
s.start('Searching with AI...');
|
||||||
|
|
||||||
try {
|
try {
|
||||||
const results = await manager.searchSkills(query, skills, {
|
const results = await manager.searchSkills(query, skills, {
|
||||||
@@ -143,7 +143,7 @@ export class AICommand extends Command {
|
|||||||
includeReasoning: !this.json,
|
includeReasoning: !this.json,
|
||||||
});
|
});
|
||||||
|
|
||||||
spinner.stop();
|
s.stop();
|
||||||
|
|
||||||
if (this.json) {
|
if (this.json) {
|
||||||
console.log(JSON.stringify(results, null, 2));
|
console.log(JSON.stringify(results, null, 2));
|
||||||
@@ -151,37 +151,37 @@ export class AICommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (results.length === 0) {
|
if (results.length === 0) {
|
||||||
console.log(chalk.yellow(`No skills found matching "${query}"`));
|
console.log(colors.warning(`No skills found matching "${query}"`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`\nAI Search Results (${results.length} found):\n`));
|
console.log(colors.cyan(`\nAI Search Results (${results.length} found):\n`));
|
||||||
|
|
||||||
for (const result of results) {
|
for (const result of results) {
|
||||||
const score = Math.round(result.relevance * 100);
|
const score = Math.round(result.relevance * 100);
|
||||||
const scoreColor =
|
const scoreColor =
|
||||||
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
|
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
|
||||||
|
|
||||||
console.log(
|
console.log(
|
||||||
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
|
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
|
||||||
);
|
);
|
||||||
|
|
||||||
if (result.skill.description) {
|
if (result.skill.description) {
|
||||||
console.log(` ${chalk.dim(result.skill.description)}`);
|
console.log(` ${colors.muted(result.skill.description)}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (result.reasoning) {
|
if (result.reasoning) {
|
||||||
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
|
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
} catch (error) {
|
} catch (err) {
|
||||||
spinner.fail('Search failed');
|
s.stop(colors.error('Search failed'));
|
||||||
console.error(
|
console.error(
|
||||||
chalk.red(error instanceof Error ? error.message : String(error))
|
colors.error(err instanceof Error ? err.message : String(err))
|
||||||
);
|
);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -190,7 +190,7 @@ export class AICommand extends Command {
|
|||||||
private async handleGenerate(manager: AIManager): Promise<number> {
|
private async handleGenerate(manager: AIManager): Promise<number> {
|
||||||
const description = this.description;
|
const description = this.description;
|
||||||
if (!description) {
|
if (!description) {
|
||||||
console.error(chalk.red('Description required (--description)'));
|
console.error(colors.error('Description required (--description)'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -201,7 +201,7 @@ export class AICommand extends Command {
|
|||||||
const code = await fs.readFile(codePath, 'utf-8');
|
const code = await fs.readFile(codePath, 'utf-8');
|
||||||
codeExamples = [code];
|
codeExamples = [code];
|
||||||
} catch {
|
} catch {
|
||||||
console.error(chalk.red(`Failed to read code file: ${codePath}`));
|
console.error(colors.error(`Failed to read code file: ${codePath}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -213,7 +213,8 @@ export class AICommand extends Command {
|
|||||||
targetAgent: this.targetAgent,
|
targetAgent: this.targetAgent,
|
||||||
};
|
};
|
||||||
|
|
||||||
const spinner = ora('Generating skill with AI...').start();
|
const s = spinner();
|
||||||
|
s.start('Generating skill with AI...');
|
||||||
|
|
||||||
try {
|
try {
|
||||||
const generated = await manager.generateSkill(example, {
|
const generated = await manager.generateSkill(example, {
|
||||||
@@ -222,13 +223,13 @@ export class AICommand extends Command {
|
|||||||
includeDocumentation: true,
|
includeDocumentation: true,
|
||||||
});
|
});
|
||||||
|
|
||||||
spinner.stop();
|
s.stop();
|
||||||
|
|
||||||
const validation = manager.validateGenerated(generated);
|
const validation = manager.validateGenerated(generated);
|
||||||
if (!validation.valid) {
|
if (!validation.valid) {
|
||||||
console.log(chalk.yellow('\n⚠ Generated skill has validation warnings:'));
|
console.log(colors.warning('\n⚠ Generated skill has validation warnings:'));
|
||||||
for (const error of validation.errors) {
|
for (const err of validation.errors) {
|
||||||
console.log(chalk.dim(` • ${error}`));
|
console.log(colors.muted(` • ${err}`));
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
@@ -238,41 +239,41 @@ export class AICommand extends Command {
|
|||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.green('\n✓ Generated skill successfully\n'));
|
console.log(colors.success('\n✓ Generated skill successfully\n'));
|
||||||
console.log(chalk.cyan('Name:') + ` ${generated.name}`);
|
console.log(colors.cyan('Name:') + ` ${generated.name}`);
|
||||||
console.log(chalk.cyan('Description:') + ` ${generated.description}`);
|
console.log(colors.cyan('Description:') + ` ${generated.description}`);
|
||||||
console.log(
|
console.log(
|
||||||
chalk.cyan('Tags:') + ` ${generated.tags.join(', ')}`
|
colors.cyan('Tags:') + ` ${generated.tags.join(', ')}`
|
||||||
);
|
);
|
||||||
console.log(
|
console.log(
|
||||||
chalk.cyan('Confidence:') +
|
colors.cyan('Confidence:') +
|
||||||
` ${Math.round(generated.confidence * 100)}%`
|
` ${Math.round(generated.confidence * 100)}%`
|
||||||
);
|
);
|
||||||
|
|
||||||
if (generated.reasoning) {
|
if (generated.reasoning) {
|
||||||
console.log(chalk.cyan('Reasoning:') + ` ${generated.reasoning}`);
|
console.log(colors.cyan('Reasoning:') + ` ${generated.reasoning}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log('\n' + chalk.dim('Content:'));
|
console.log('\n' + colors.muted('Content:'));
|
||||||
console.log(chalk.dim('─'.repeat(60)));
|
console.log(colors.muted('─'.repeat(60)));
|
||||||
console.log(generated.content);
|
console.log(generated.content);
|
||||||
console.log(chalk.dim('─'.repeat(60)));
|
console.log(colors.muted('─'.repeat(60)));
|
||||||
|
|
||||||
if (this.output) {
|
if (this.output) {
|
||||||
const outputPath = resolve(this.output);
|
const outputPath = resolve(this.output);
|
||||||
await fs.writeFile(outputPath, generated.content, 'utf-8');
|
await fs.writeFile(outputPath, generated.content, 'utf-8');
|
||||||
console.log(chalk.green(`\n✓ Saved to: ${outputPath}`));
|
console.log(colors.success(`\n✓ Saved to: ${outputPath}`));
|
||||||
} else {
|
} else {
|
||||||
console.log(
|
console.log(
|
||||||
chalk.dim('\nSave with: --output <filename>')
|
colors.muted('\nSave with: --output <filename>')
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
} catch (error) {
|
} catch (err) {
|
||||||
spinner.fail('Generation failed');
|
s.stop(colors.error('Generation failed'));
|
||||||
console.error(
|
console.error(
|
||||||
chalk.red(error instanceof Error ? error.message : String(error))
|
colors.error(err instanceof Error ? err.message : String(err))
|
||||||
);
|
);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -281,14 +282,14 @@ export class AICommand extends Command {
|
|||||||
private async handleSimilar(manager: AIManager): Promise<number> {
|
private async handleSimilar(manager: AIManager): Promise<number> {
|
||||||
const skillName = this.skillName;
|
const skillName = this.skillName;
|
||||||
if (!skillName) {
|
if (!skillName) {
|
||||||
console.error(chalk.red('Skill name required'));
|
console.error(colors.error('Skill name required'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const skills = await this.loadSkills();
|
const skills = await this.loadSkills();
|
||||||
if (skills.length === 0) {
|
if (skills.length === 0) {
|
||||||
console.log(
|
console.log(
|
||||||
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
|
colors.warning('No skills found. Run "skillkit recommend --update" first.')
|
||||||
);
|
);
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -298,11 +299,12 @@ export class AICommand extends Command {
|
|||||||
);
|
);
|
||||||
|
|
||||||
if (!targetSkill) {
|
if (!targetSkill) {
|
||||||
console.error(chalk.red(`Skill not found: ${skillName}`));
|
console.error(colors.error(`Skill not found: ${skillName}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const spinner = ora('Finding similar skills...').start();
|
const s = spinner();
|
||||||
|
s.start('Finding similar skills...');
|
||||||
|
|
||||||
try {
|
try {
|
||||||
const results = await manager.findSimilar(targetSkill, skills, {
|
const results = await manager.findSimilar(targetSkill, skills, {
|
||||||
@@ -313,7 +315,7 @@ export class AICommand extends Command {
|
|||||||
includeReasoning: !this.json,
|
includeReasoning: !this.json,
|
||||||
});
|
});
|
||||||
|
|
||||||
spinner.stop();
|
s.stop();
|
||||||
|
|
||||||
if (this.json) {
|
if (this.json) {
|
||||||
console.log(JSON.stringify(results, null, 2));
|
console.log(JSON.stringify(results, null, 2));
|
||||||
@@ -322,40 +324,40 @@ export class AICommand extends Command {
|
|||||||
|
|
||||||
if (results.length === 0) {
|
if (results.length === 0) {
|
||||||
console.log(
|
console.log(
|
||||||
chalk.yellow(`No similar skills found for "${skillName}"`)
|
colors.warning(`No similar skills found for "${skillName}"`)
|
||||||
);
|
);
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(
|
console.log(
|
||||||
chalk.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
|
colors.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
|
||||||
);
|
);
|
||||||
|
|
||||||
for (const result of results) {
|
for (const result of results) {
|
||||||
const score = Math.round(result.relevance * 100);
|
const score = Math.round(result.relevance * 100);
|
||||||
const scoreColor =
|
const scoreColor =
|
||||||
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
|
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
|
||||||
|
|
||||||
console.log(
|
console.log(
|
||||||
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
|
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
|
||||||
);
|
);
|
||||||
|
|
||||||
if (result.skill.description) {
|
if (result.skill.description) {
|
||||||
console.log(` ${chalk.dim(result.skill.description)}`);
|
console.log(` ${colors.muted(result.skill.description)}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (result.reasoning) {
|
if (result.reasoning) {
|
||||||
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
|
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
} catch (error) {
|
} catch (err) {
|
||||||
spinner.fail('Search failed');
|
s.stop(colors.error('Search failed'));
|
||||||
console.error(
|
console.error(
|
||||||
chalk.red(error instanceof Error ? error.message : String(error))
|
colors.error(err instanceof Error ? err.message : String(err))
|
||||||
);
|
);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -377,8 +379,8 @@ export class AICommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private async handleWizard(): Promise<number> {
|
private async handleWizard(): Promise<number> {
|
||||||
console.log(chalk.cyan('\nLaunching Smart Generate Wizard...\n'));
|
console.log(colors.cyan('\nLaunching Smart Generate Wizard...\n'));
|
||||||
console.log(chalk.dim('For the full wizard experience, use: skillkit generate\n'));
|
console.log(colors.muted('For the full wizard experience, use: skillkit generate\n'));
|
||||||
|
|
||||||
const { GenerateCommand } = await import('./generate.js');
|
const { GenerateCommand } = await import('./generate.js');
|
||||||
const generateCmd = new GenerateCommand();
|
const generateCmd = new GenerateCommand();
|
||||||
@@ -389,31 +391,31 @@ export class AICommand extends Command {
|
|||||||
const detected = detectProviders();
|
const detected = detectProviders();
|
||||||
const defaultProvider = getDefaultProvider();
|
const defaultProvider = getDefaultProvider();
|
||||||
|
|
||||||
console.log(chalk.cyan('\nAvailable LLM Providers:\n'));
|
console.log(colors.cyan('\nAvailable LLM Providers:\n'));
|
||||||
|
|
||||||
for (const provider of detected) {
|
for (const provider of detected) {
|
||||||
const isDefault = provider.provider === defaultProvider;
|
const isDefault = provider.provider === defaultProvider;
|
||||||
const status = provider.configured
|
const status = provider.configured
|
||||||
? chalk.green('✓ Configured')
|
? colors.success('✓ Configured')
|
||||||
: chalk.dim('○ Not configured');
|
: colors.muted('○ Not configured');
|
||||||
const defaultBadge = isDefault ? chalk.yellow(' (default)') : '';
|
const defaultBadge = isDefault ? colors.warning(' (default)') : '';
|
||||||
|
|
||||||
console.log(` ${provider.displayName}${defaultBadge}`);
|
console.log(` ${provider.displayName}${defaultBadge}`);
|
||||||
console.log(` ${status}`);
|
console.log(` ${status}`);
|
||||||
if (provider.envVar) {
|
if (provider.envVar) {
|
||||||
console.log(` ${chalk.dim(`Set ${provider.envVar} to configure`)}`);
|
console.log(` ${colors.muted(`Set ${provider.envVar} to configure`)}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
if (defaultProvider === 'mock') {
|
if (defaultProvider === 'mock') {
|
||||||
console.log(` Mock Provider${chalk.yellow(' (default)')}`);
|
console.log(` Mock Provider${colors.warning(' (default)')}`);
|
||||||
console.log(` ${chalk.green('✓ Always available')}`);
|
console.log(` ${colors.success('✓ Always available')}`);
|
||||||
console.log(` ${chalk.dim('Basic functionality without API keys')}`);
|
console.log(` ${colors.muted('Basic functionality without API keys')}`);
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.dim('Use "skillkit generate --provider <name>" to use a specific provider\n'));
|
console.log(colors.muted('Use "skillkit generate --provider <name>" to use a specific provider\n'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
|
|||||||
import { resolve } from 'node:path';
|
import { resolve } from 'node:path';
|
||||||
import { promises as fs } from 'fs';
|
import { promises as fs } from 'fs';
|
||||||
import path from 'path';
|
import path from 'path';
|
||||||
import chalk from 'chalk';
|
import { colors, warn, success, spinner } from '../onboarding/index.js';
|
||||||
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
|
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
|
||||||
|
|
||||||
export class AuditCommand extends Command {
|
export class AuditCommand extends Command {
|
||||||
@@ -104,7 +104,7 @@ export class AuditCommand extends Command {
|
|||||||
case 'clear':
|
case 'clear':
|
||||||
return await this.handleClear(logger);
|
return await this.handleClear(logger);
|
||||||
default:
|
default:
|
||||||
console.error(chalk.red(`Unknown subcommand: ${this.subcommand}\n`));
|
console.error(colors.error(`Unknown subcommand: ${this.subcommand}\n`));
|
||||||
console.log('Valid subcommands: log, export, stats, clear');
|
console.log('Valid subcommands: log, export, stats, clear');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -114,8 +114,11 @@ export class AuditCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private async handleLog(logger: AuditLogger): Promise<number> {
|
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 query = this.buildQuery();
|
||||||
const events = await logger.query(query);
|
const events = await logger.query(query);
|
||||||
|
s.stop('Query complete');
|
||||||
|
|
||||||
if (this.json) {
|
if (this.json) {
|
||||||
console.log(JSON.stringify(events, null, 2));
|
console.log(JSON.stringify(events, null, 2));
|
||||||
@@ -123,37 +126,37 @@ export class AuditCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (events.length === 0) {
|
if (events.length === 0) {
|
||||||
console.log(chalk.yellow('No audit events found'));
|
warn('No audit events found');
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`\nAudit Log (${events.length} entries):\n`));
|
console.log(colors.cyan(`\nAudit Log (${events.length} entries):\n`));
|
||||||
|
|
||||||
for (const event of events) {
|
for (const event of events) {
|
||||||
const statusIcon = event.success ? chalk.green('✓') : chalk.red('✗');
|
const statusIcon = event.success ? colors.success('✓') : colors.error('✗');
|
||||||
const timestamp = event.timestamp.toLocaleString();
|
const timestamp = event.timestamp.toLocaleString();
|
||||||
|
|
||||||
console.log(
|
console.log(
|
||||||
`${statusIcon} ${chalk.dim(timestamp)} ${chalk.bold(event.type)}`
|
`${statusIcon} ${colors.muted(timestamp)} ${colors.bold(event.type)}`
|
||||||
);
|
);
|
||||||
console.log(
|
console.log(
|
||||||
` ${event.action} on ${chalk.cyan(event.resource)}`
|
` ${event.action} on ${colors.cyan(event.resource)}`
|
||||||
);
|
);
|
||||||
|
|
||||||
if (event.user) {
|
if (event.user) {
|
||||||
console.log(` ${chalk.dim('User:')} ${event.user}`);
|
console.log(` ${colors.muted('User:')} ${event.user}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (event.duration) {
|
if (event.duration) {
|
||||||
console.log(` ${chalk.dim('Duration:')} ${event.duration}ms`);
|
console.log(` ${colors.muted('Duration:')} ${event.duration}ms`);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (event.error) {
|
if (event.error) {
|
||||||
console.log(` ${chalk.red('Error:')} ${event.error}`);
|
console.log(` ${colors.error('Error:')} ${event.error}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
if (event.details && Object.keys(event.details).length > 0) {
|
if (event.details && Object.keys(event.details).length > 0) {
|
||||||
console.log(` ${chalk.dim('Details:')} ${JSON.stringify(event.details)}`);
|
console.log(` ${colors.muted('Details:')} ${JSON.stringify(event.details)}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
@@ -163,15 +166,18 @@ export class AuditCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private async handleExport(logger: AuditLogger): Promise<number> {
|
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 format = (this.format as 'json' | 'csv' | 'text') || 'json';
|
||||||
const query = this.buildQuery();
|
const query = this.buildQuery();
|
||||||
|
|
||||||
|
s.start('Exporting audit log');
|
||||||
const content = await logger.export({ format, query });
|
const content = await logger.export({ format, query });
|
||||||
|
s.stop('Export complete');
|
||||||
|
|
||||||
if (this.output) {
|
if (this.output) {
|
||||||
const outputPath = resolve(this.output);
|
const outputPath = resolve(this.output);
|
||||||
await fs.writeFile(outputPath, content, 'utf-8');
|
await fs.writeFile(outputPath, content, 'utf-8');
|
||||||
console.log(chalk.green(`✓ Exported audit log to: ${outputPath}`));
|
success(`✓ Exported audit log to: ${outputPath}`);
|
||||||
} else {
|
} else {
|
||||||
console.log(content);
|
console.log(content);
|
||||||
}
|
}
|
||||||
@@ -180,21 +186,24 @@ export class AuditCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private async handleStats(logger: AuditLogger): Promise<number> {
|
private async handleStats(logger: AuditLogger): Promise<number> {
|
||||||
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
|
s.start('Computing statistics');
|
||||||
const stats = await logger.stats();
|
const stats = await logger.stats();
|
||||||
|
s.stop('Statistics computed');
|
||||||
|
|
||||||
if (this.json) {
|
if (this.json) {
|
||||||
console.log(JSON.stringify(stats, null, 2));
|
console.log(JSON.stringify(stats, null, 2));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan('\nAudit Statistics:\n'));
|
console.log(colors.cyan('\nAudit Statistics:\n'));
|
||||||
console.log(`Total Events: ${chalk.bold(stats.totalEvents.toString())}`);
|
console.log(`Total Events: ${colors.bold(stats.totalEvents.toString())}`);
|
||||||
console.log(
|
console.log(
|
||||||
`Success Rate: ${chalk.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
|
`Success Rate: ${colors.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
|
||||||
);
|
);
|
||||||
|
|
||||||
if (Object.keys(stats.eventsByType).length > 0) {
|
if (Object.keys(stats.eventsByType).length > 0) {
|
||||||
console.log(chalk.cyan('\nEvents by Type:'));
|
console.log(colors.cyan('\nEvents by Type:'));
|
||||||
const sorted = Object.entries(stats.eventsByType).sort(
|
const sorted = Object.entries(stats.eventsByType).sort(
|
||||||
([, a], [, b]) => b - a
|
([, a], [, b]) => b - a
|
||||||
);
|
);
|
||||||
@@ -204,21 +213,21 @@ export class AuditCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (stats.topResources.length > 0) {
|
if (stats.topResources.length > 0) {
|
||||||
console.log(chalk.cyan('\nTop Resources:'));
|
console.log(colors.cyan('\nTop Resources:'));
|
||||||
for (const { resource, count } of stats.topResources) {
|
for (const { resource, count } of stats.topResources) {
|
||||||
console.log(` ${resource.padEnd(40)} ${count}`);
|
console.log(` ${resource.padEnd(40)} ${count}`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (stats.recentErrors.length > 0) {
|
if (stats.recentErrors.length > 0) {
|
||||||
console.log(chalk.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
|
console.log(colors.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
|
||||||
for (const error of stats.recentErrors.slice(0, 5)) {
|
for (const err of stats.recentErrors.slice(0, 5)) {
|
||||||
const timestamp = error.timestamp.toLocaleString();
|
const timestamp = err.timestamp.toLocaleString();
|
||||||
console.log(
|
console.log(
|
||||||
` ${chalk.red('✗')} ${chalk.dim(timestamp)} ${error.type}`
|
` ${colors.error('✗')} ${colors.muted(timestamp)} ${err.type}`
|
||||||
);
|
);
|
||||||
if (error.error) {
|
if (err.error) {
|
||||||
console.log(` ${chalk.dim(error.error)}`);
|
console.log(` ${colors.muted(err.error)}`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -229,7 +238,7 @@ export class AuditCommand extends Command {
|
|||||||
|
|
||||||
private async handleClear(logger: AuditLogger): Promise<number> {
|
private async handleClear(logger: AuditLogger): Promise<number> {
|
||||||
if (!this.days) {
|
if (!this.days) {
|
||||||
console.error(chalk.red('--days option required'));
|
console.error(colors.error('--days option required'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -237,13 +246,16 @@ export class AuditCommand extends Command {
|
|||||||
const cutoffDate = new Date();
|
const cutoffDate = new Date();
|
||||||
cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
|
cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
|
||||||
|
|
||||||
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
|
s.start('Clearing old entries');
|
||||||
const cleared = await logger.clear(cutoffDate);
|
const cleared = await logger.clear(cutoffDate);
|
||||||
|
s.stop('Clear complete');
|
||||||
|
|
||||||
console.log(
|
if (this.json) {
|
||||||
chalk.green(
|
console.log(JSON.stringify({ success: true, cleared, days: daysAgo }));
|
||||||
`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`
|
} else {
|
||||||
)
|
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
|
||||||
);
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,8 +1,8 @@
|
|||||||
import { existsSync } from 'node:fs';
|
import { existsSync, statSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { findAllSkills, findSkill, detectProvider, isLocalPath } from '@skillkit/core';
|
import { findAllSkills, findSkill, detectProvider, isLocalPath, evaluateSkillDirectory } from '@skillkit/core';
|
||||||
import { getSearchDirs, loadSkillMetadata } from '../helpers.js';
|
import { getSearchDirs, loadSkillMetadata, formatCount, timeAgo, fetchGitHubActivity } from '../helpers.js';
|
||||||
import {
|
import {
|
||||||
colors,
|
colors,
|
||||||
symbols,
|
symbols,
|
||||||
@@ -11,6 +11,8 @@ import {
|
|||||||
success,
|
success,
|
||||||
warn,
|
warn,
|
||||||
header,
|
header,
|
||||||
|
formatQualityBadge,
|
||||||
|
getQualityGradeFromScore,
|
||||||
} from '../onboarding/index.js';
|
} from '../onboarding/index.js';
|
||||||
|
|
||||||
interface UpdateInfo {
|
interface UpdateInfo {
|
||||||
@@ -18,15 +20,19 @@ interface UpdateInfo {
|
|||||||
currentVersion?: string;
|
currentVersion?: string;
|
||||||
hasUpdate: boolean;
|
hasUpdate: boolean;
|
||||||
error?: string;
|
error?: string;
|
||||||
|
qualityScore?: number | null;
|
||||||
|
stars?: number | null;
|
||||||
|
pushedAt?: string | null;
|
||||||
}
|
}
|
||||||
|
|
||||||
export class CheckCommand extends Command {
|
export class CheckCommand extends Command {
|
||||||
static override paths = [['check']];
|
static override paths = [['check']];
|
||||||
|
|
||||||
static override usage = Command.Usage({
|
static override usage = Command.Usage({
|
||||||
description: 'Check for available skill updates (dry-run)',
|
description: 'Check installed skills for updates, quality, and activity',
|
||||||
details: `
|
details: `
|
||||||
Checks if installed skills have updates available from their sources.
|
Checks if installed skills have updates available from their sources.
|
||||||
|
Shows quality scores and GitHub activity for each skill.
|
||||||
Does not modify any files - just reports what would be updated.
|
Does not modify any files - just reports what would be updated.
|
||||||
`,
|
`,
|
||||||
examples: [
|
examples: [
|
||||||
@@ -46,11 +52,15 @@ export class CheckCommand extends Command {
|
|||||||
description: 'Minimal output',
|
description: 'Minimal output',
|
||||||
});
|
});
|
||||||
|
|
||||||
|
json = Option.Boolean('--json', false, {
|
||||||
|
description: 'Output as JSON',
|
||||||
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const searchDirs = getSearchDirs();
|
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');
|
header('Check Updates');
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -79,7 +89,7 @@ export class CheckCommand extends Command {
|
|||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!this.quiet) {
|
if (!this.quiet && !this.json) {
|
||||||
step(`Checking ${skillsToCheck.length} skill(s) for updates...`);
|
step(`Checking ${skillsToCheck.length} skill(s) for updates...`);
|
||||||
console.log('');
|
console.log('');
|
||||||
}
|
}
|
||||||
@@ -89,12 +99,15 @@ export class CheckCommand extends Command {
|
|||||||
|
|
||||||
for (const skill of skillsToCheck) {
|
for (const skill of skillsToCheck) {
|
||||||
const metadata = loadSkillMetadata(skill.path);
|
const metadata = loadSkillMetadata(skill.path);
|
||||||
|
const quality = evaluateSkillDirectory(skill.path);
|
||||||
|
const qualityScore = quality?.overall ?? null;
|
||||||
|
|
||||||
if (!metadata) {
|
if (!metadata) {
|
||||||
results.push({
|
results.push({
|
||||||
name: skill.name,
|
name: skill.name,
|
||||||
hasUpdate: false,
|
hasUpdate: false,
|
||||||
error: 'No metadata (reinstall needed)',
|
error: 'No metadata (reinstall needed)',
|
||||||
|
qualityScore,
|
||||||
});
|
});
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
@@ -114,6 +127,7 @@ export class CheckCommand extends Command {
|
|||||||
name: skill.name,
|
name: skill.name,
|
||||||
hasUpdate: false,
|
hasUpdate: false,
|
||||||
error: 'Local source missing',
|
error: 'Local source missing',
|
||||||
|
qualityScore,
|
||||||
});
|
});
|
||||||
if (this.verbose) s.stop(`${skill.name}: source missing`);
|
if (this.verbose) s.stop(`${skill.name}: source missing`);
|
||||||
continue;
|
continue;
|
||||||
@@ -123,20 +137,19 @@ export class CheckCommand extends Command {
|
|||||||
const installedSkillMd = join(skill.path, 'SKILL.md');
|
const installedSkillMd = join(skill.path, 'SKILL.md');
|
||||||
|
|
||||||
if (existsSync(sourceSkillMd) && existsSync(installedSkillMd)) {
|
if (existsSync(sourceSkillMd) && existsSync(installedSkillMd)) {
|
||||||
const { statSync } = await import('node:fs');
|
|
||||||
const sourceTime = statSync(sourceSkillMd).mtime;
|
const sourceTime = statSync(sourceSkillMd).mtime;
|
||||||
const installedTime = statSync(installedSkillMd).mtime;
|
const installedTime = statSync(installedSkillMd).mtime;
|
||||||
|
|
||||||
if (sourceTime > installedTime) {
|
if (sourceTime > installedTime) {
|
||||||
results.push({ name: skill.name, hasUpdate: true });
|
results.push({ name: skill.name, hasUpdate: true, qualityScore });
|
||||||
updatesAvailable++;
|
updatesAvailable++;
|
||||||
if (this.verbose) s.stop(`${skill.name}: update available`);
|
if (this.verbose) s.stop(`${skill.name}: update available`);
|
||||||
} else {
|
} else {
|
||||||
results.push({ name: skill.name, hasUpdate: false });
|
results.push({ name: skill.name, hasUpdate: false, qualityScore });
|
||||||
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
results.push({ name: skill.name, hasUpdate: false });
|
results.push({ name: skill.name, hasUpdate: false, qualityScore });
|
||||||
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
if (this.verbose) s.stop(`${skill.name}: up to date`);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
@@ -147,15 +160,31 @@ export class CheckCommand extends Command {
|
|||||||
name: skill.name,
|
name: skill.name,
|
||||||
hasUpdate: false,
|
hasUpdate: false,
|
||||||
error: 'Unknown provider',
|
error: 'Unknown provider',
|
||||||
|
qualityScore,
|
||||||
});
|
});
|
||||||
if (this.verbose) s.stop(`${skill.name}: unknown provider`);
|
if (this.verbose) s.stop(`${skill.name}: unknown provider`);
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const parsed = provider.parseSource(metadata.source);
|
||||||
|
let stars: number | null = null;
|
||||||
|
let pushedAt: string | null = null;
|
||||||
|
|
||||||
|
if (parsed && provider.name === 'GitHub') {
|
||||||
|
const activity = await fetchGitHubActivity(parsed.owner, parsed.repo);
|
||||||
|
if (activity) {
|
||||||
|
stars = activity.stars;
|
||||||
|
pushedAt = activity.pushedAt;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
results.push({
|
results.push({
|
||||||
name: skill.name,
|
name: skill.name,
|
||||||
hasUpdate: false,
|
hasUpdate: false,
|
||||||
currentVersion: metadata.updatedAt || metadata.installedAt,
|
currentVersion: metadata.updatedAt || metadata.installedAt,
|
||||||
|
qualityScore,
|
||||||
|
stars,
|
||||||
|
pushedAt,
|
||||||
});
|
});
|
||||||
if (this.verbose) s.stop(`${skill.name}: remote source (run update to sync)`);
|
if (this.verbose) s.stop(`${skill.name}: remote source (run update to sync)`);
|
||||||
}
|
}
|
||||||
@@ -164,11 +193,25 @@ export class CheckCommand extends Command {
|
|||||||
name: skill.name,
|
name: skill.name,
|
||||||
hasUpdate: false,
|
hasUpdate: false,
|
||||||
error: err instanceof Error ? err.message : 'Check failed',
|
error: err instanceof Error ? err.message : 'Check failed',
|
||||||
|
qualityScore,
|
||||||
});
|
});
|
||||||
if (this.verbose) s.stop(`${skill.name}: error`);
|
if (this.verbose) s.stop(`${skill.name}: error`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
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('');
|
console.log('');
|
||||||
|
|
||||||
const withUpdates = results.filter(r => r.hasUpdate);
|
const withUpdates = results.filter(r => r.hasUpdate);
|
||||||
@@ -178,27 +221,46 @@ export class CheckCommand extends Command {
|
|||||||
if (withUpdates.length > 0) {
|
if (withUpdates.length > 0) {
|
||||||
console.log(colors.primary('Updates available:'));
|
console.log(colors.primary('Updates available:'));
|
||||||
for (const r of withUpdates) {
|
for (const r of withUpdates) {
|
||||||
console.log(` ${colors.success(symbols.arrowUp)} ${colors.primary(r.name)}`);
|
const badge = this.qualityBadgeFor(r.qualityScore);
|
||||||
|
console.log(` ${colors.success(symbols.arrowUp)} ${colors.primary(r.name)}${badge}`);
|
||||||
}
|
}
|
||||||
console.log('');
|
console.log('');
|
||||||
}
|
}
|
||||||
|
|
||||||
if (upToDate.length > 0 && this.verbose) {
|
if (upToDate.length > 0) {
|
||||||
console.log(colors.muted('Up to date:'));
|
if (this.verbose) {
|
||||||
for (const r of upToDate) {
|
console.log(colors.muted('Up to date:'));
|
||||||
console.log(` ${colors.muted(symbols.success)} ${colors.muted(r.name)}`);
|
|
||||||
}
|
}
|
||||||
console.log('');
|
for (const r of upToDate) {
|
||||||
|
const badge = this.qualityBadgeFor(r.qualityScore);
|
||||||
|
const activityStr = this.formatActivity(r);
|
||||||
|
if (this.verbose) {
|
||||||
|
console.log(` ${colors.muted(symbols.success)} ${colors.muted(r.name)}${badge}${activityStr}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (this.verbose) console.log('');
|
||||||
}
|
}
|
||||||
|
|
||||||
if (withErrors.length > 0) {
|
if (withErrors.length > 0) {
|
||||||
console.log(colors.warning('Could not check:'));
|
console.log(colors.warning('Could not check:'));
|
||||||
for (const r of withErrors) {
|
for (const r of withErrors) {
|
||||||
console.log(` ${colors.warning(symbols.warning)} ${r.name}: ${colors.muted(r.error || 'unknown')}`);
|
const badge = this.qualityBadgeFor(r.qualityScore);
|
||||||
|
console.log(` ${colors.warning(symbols.warning)} ${r.name}${badge}: ${colors.muted(r.error || 'unknown')}`);
|
||||||
}
|
}
|
||||||
console.log('');
|
console.log('');
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!this.quiet) {
|
||||||
|
const qualityScores = results
|
||||||
|
.map(r => r.qualityScore)
|
||||||
|
.filter((s): s is number => typeof s === 'number');
|
||||||
|
if (qualityScores.length > 0) {
|
||||||
|
const avg = Math.round(qualityScores.reduce((a, b) => a + b, 0) / qualityScores.length);
|
||||||
|
const grade = getQualityGradeFromScore(avg);
|
||||||
|
console.log(colors.muted(`Average quality: ${avg}/100 (${grade})`));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if (updatesAvailable > 0) {
|
if (updatesAvailable > 0) {
|
||||||
success(`${updatesAvailable} update(s) available`);
|
success(`${updatesAvailable} update(s) available`);
|
||||||
console.log(colors.muted('Run `skillkit update` to install updates'));
|
console.log(colors.muted('Run `skillkit update` to install updates'));
|
||||||
@@ -208,4 +270,22 @@ export class CheckCommand extends Command {
|
|||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private qualityBadgeFor(score: number | null | undefined): string {
|
||||||
|
if (typeof score !== 'number') return '';
|
||||||
|
return ` ${formatQualityBadge(score)}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
private formatActivity(r: UpdateInfo): string {
|
||||||
|
const parts: string[] = [];
|
||||||
|
if (typeof r.stars === 'number' && r.stars > 0) {
|
||||||
|
parts.push(`${formatCount(r.stars)} stars`);
|
||||||
|
}
|
||||||
|
if (r.pushedAt) {
|
||||||
|
parts.push(`pushed ${timeAgo(r.pushedAt)}`);
|
||||||
|
}
|
||||||
|
if (parts.length === 0) return '';
|
||||||
|
return ` ${colors.muted(`(${parts.join(', ')})`)}`;
|
||||||
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import chalk from 'chalk';
|
import { colors } from '../onboarding/index.js';
|
||||||
import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
|
import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
|
|
||||||
@@ -247,7 +247,7 @@ export class CICDCommand extends Command {
|
|||||||
? ['github', 'gitlab', 'circleci']
|
? ['github', 'gitlab', 'circleci']
|
||||||
: [this.provider as CICDProvider];
|
: [this.provider as CICDProvider];
|
||||||
|
|
||||||
console.log(chalk.cyan('Initializing CI/CD workflows...'));
|
console.log(colors.cyan('Initializing CI/CD workflows...'));
|
||||||
console.log();
|
console.log();
|
||||||
|
|
||||||
let success = true;
|
let success = true;
|
||||||
@@ -256,29 +256,29 @@ export class CICDCommand extends Command {
|
|||||||
for (const provider of providers) {
|
for (const provider of providers) {
|
||||||
const result = this.createWorkflow(projectPath, provider);
|
const result = this.createWorkflow(projectPath, provider);
|
||||||
if (result.skipped) {
|
if (result.skipped) {
|
||||||
console.log(chalk.yellow(` ${result.message}`));
|
console.log(colors.warning(` ${result.message}`));
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if (!result.success) {
|
if (!result.success) {
|
||||||
success = false;
|
success = false;
|
||||||
console.error(chalk.red(` ${result.message}`));
|
console.error(colors.error(` ${result.message}`));
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
created = true;
|
created = true;
|
||||||
console.log(chalk.green(` ✓ ${result.message}`));
|
console.log(colors.success(` ✓ ${result.message}`));
|
||||||
}
|
}
|
||||||
|
|
||||||
if (success) {
|
if (success) {
|
||||||
console.log();
|
console.log();
|
||||||
console.log(
|
console.log(
|
||||||
created
|
created
|
||||||
? chalk.green('CI/CD workflows initialized successfully!')
|
? colors.success('CI/CD workflows initialized successfully!')
|
||||||
: chalk.yellow('CI/CD workflows already exist; nothing to do.')
|
: colors.warning('CI/CD workflows already exist; nothing to do.')
|
||||||
);
|
);
|
||||||
console.log();
|
console.log();
|
||||||
if (created) {
|
if (created) {
|
||||||
console.log(chalk.dim('The workflows will run on push/PR to validate your skills.'));
|
console.log(colors.muted('The workflows will run on push/PR to validate your skills.'));
|
||||||
console.log(chalk.dim('Commit the generated files to enable CI/CD.'));
|
console.log(colors.muted('Commit the generated files to enable CI/CD.'));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||||
import { resolve } from 'node:path';
|
import { resolve } from 'node:path';
|
||||||
import chalk from 'chalk';
|
import { colors } from '../onboarding/index.js';
|
||||||
import {
|
import {
|
||||||
type AgentType,
|
type AgentType,
|
||||||
type ProjectContext,
|
type ProjectContext,
|
||||||
@@ -103,8 +103,8 @@ export class ContextCommand extends Command {
|
|||||||
case 'agents':
|
case 'agents':
|
||||||
return this.listAgents();
|
return this.listAgents();
|
||||||
default:
|
default:
|
||||||
console.error(chalk.red(`Unknown action: ${action}`));
|
console.error(colors.error(`Unknown action: ${action}`));
|
||||||
console.log(chalk.gray('Available actions: init, show, export, import, sync, detect, agents'));
|
console.log(colors.muted('Available actions: init, show, export, import, sync, detect, agents'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -116,16 +116,16 @@ export class ContextCommand extends Command {
|
|||||||
const manager = new ContextManager(process.cwd());
|
const manager = new ContextManager(process.cwd());
|
||||||
|
|
||||||
if (manager.exists() && !this.force) {
|
if (manager.exists() && !this.force) {
|
||||||
console.log(chalk.yellow('Context already exists. Use --force to reinitialize.'));
|
console.log(colors.warning('Context already exists. Use --force to reinitialize.'));
|
||||||
return this.showContext();
|
return this.showContext();
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan('Initializing project context...\n'));
|
console.log(colors.cyan('Initializing project context...\n'));
|
||||||
|
|
||||||
const context = manager.init({ force: this.force });
|
const context = manager.init({ force: this.force });
|
||||||
|
|
||||||
console.log(chalk.green('✓ Context initialized\n'));
|
console.log(colors.success('✓ Context initialized\n'));
|
||||||
console.log(chalk.gray(` Location: .skillkit/context.yaml\n`));
|
console.log(colors.muted(` Location: .skillkit/context.yaml\n`));
|
||||||
|
|
||||||
// Show summary
|
// Show summary
|
||||||
this.printContextSummary(context);
|
this.printContextSummary(context);
|
||||||
@@ -134,9 +134,9 @@ export class ContextCommand extends Command {
|
|||||||
const sync = createContextSync(process.cwd());
|
const sync = createContextSync(process.cwd());
|
||||||
const detected = sync.detectAgents();
|
const detected = sync.detectAgents();
|
||||||
if (detected.length > 0) {
|
if (detected.length > 0) {
|
||||||
console.log(chalk.cyan('\nDetected agents:'));
|
console.log(colors.cyan('\nDetected agents:'));
|
||||||
for (const agent of detected) {
|
for (const agent of detected) {
|
||||||
console.log(` ${chalk.green('•')} ${agent}`);
|
console.log(` ${colors.success('•')} ${agent}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Update context with detected agents
|
// Update context with detected agents
|
||||||
@@ -146,7 +146,7 @@ export class ContextCommand extends Command {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.gray('\nRun `skillkit context sync` to sync skills to all agents.'));
|
console.log(colors.muted('\nRun `skillkit context sync` to sync skills to all agents.'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -159,7 +159,7 @@ export class ContextCommand extends Command {
|
|||||||
const context = manager.load();
|
const context = manager.load();
|
||||||
|
|
||||||
if (!context) {
|
if (!context) {
|
||||||
console.log(chalk.yellow('No context found. Run `skillkit context init` first.'));
|
console.log(colors.warning('No context found. Run `skillkit context init` first.'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -171,8 +171,8 @@ export class ContextCommand extends Command {
|
|||||||
this.printContextSummary(context);
|
this.printContextSummary(context);
|
||||||
|
|
||||||
if (this.verbose) {
|
if (this.verbose) {
|
||||||
console.log(chalk.gray('\nFull context:'));
|
console.log(colors.muted('\nFull context:'));
|
||||||
console.log(chalk.gray(JSON.stringify(context, null, 2)));
|
console.log(colors.muted(JSON.stringify(context, null, 2)));
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -186,7 +186,7 @@ export class ContextCommand extends Command {
|
|||||||
const context = manager.get();
|
const context = manager.get();
|
||||||
|
|
||||||
if (!context) {
|
if (!context) {
|
||||||
console.error(chalk.red('No context found. Run `skillkit context init` first.'));
|
console.error(colors.error('No context found. Run `skillkit context init` first.'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -200,12 +200,12 @@ export class ContextCommand extends Command {
|
|||||||
if (this.output) {
|
if (this.output) {
|
||||||
const outputPath = resolve(this.output);
|
const outputPath = resolve(this.output);
|
||||||
if (existsSync(outputPath) && !this.force) {
|
if (existsSync(outputPath) && !this.force) {
|
||||||
console.error(chalk.red(`File exists: ${outputPath}. Use --force to overwrite.`));
|
console.error(colors.error(`File exists: ${outputPath}. Use --force to overwrite.`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
writeFileSync(outputPath, content, 'utf-8');
|
writeFileSync(outputPath, content, 'utf-8');
|
||||||
console.log(chalk.green(`✓ Context exported to ${outputPath}`));
|
console.log(colors.success(`✓ Context exported to ${outputPath}`));
|
||||||
} else {
|
} else {
|
||||||
// Print to stdout
|
// Print to stdout
|
||||||
console.log(content);
|
console.log(content);
|
||||||
@@ -219,13 +219,13 @@ export class ContextCommand extends Command {
|
|||||||
*/
|
*/
|
||||||
private async importContext(): Promise<number> {
|
private async importContext(): Promise<number> {
|
||||||
if (!this.input) {
|
if (!this.input) {
|
||||||
console.error(chalk.red('Error: --input/-i file path is required'));
|
console.error(colors.error('Error: --input/-i file path is required'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const inputPath = resolve(this.input);
|
const inputPath = resolve(this.input);
|
||||||
if (!existsSync(inputPath)) {
|
if (!existsSync(inputPath)) {
|
||||||
console.error(chalk.red(`File not found: ${inputPath}`));
|
console.error(colors.error(`File not found: ${inputPath}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -238,11 +238,11 @@ export class ContextCommand extends Command {
|
|||||||
overwrite: this.force,
|
overwrite: this.force,
|
||||||
});
|
});
|
||||||
|
|
||||||
console.log(chalk.green('✓ Context imported successfully'));
|
console.log(colors.success('✓ Context imported successfully'));
|
||||||
this.printContextSummary(context);
|
this.printContextSummary(context);
|
||||||
return 0;
|
return 0;
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error(chalk.red(`Import failed: ${error}`));
|
console.error(colors.error(`Import failed: ${error}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -255,13 +255,13 @@ export class ContextCommand extends Command {
|
|||||||
const context = manager.get();
|
const context = manager.get();
|
||||||
|
|
||||||
if (!context) {
|
if (!context) {
|
||||||
console.log(chalk.yellow('No context found. Initializing...'));
|
console.log(colors.warning('No context found. Initializing...'));
|
||||||
manager.init();
|
manager.init();
|
||||||
}
|
}
|
||||||
|
|
||||||
const sync = createContextSync(process.cwd());
|
const sync = createContextSync(process.cwd());
|
||||||
|
|
||||||
console.log(chalk.cyan('Syncing skills across agents...\n'));
|
console.log(colors.cyan('Syncing skills across agents...\n'));
|
||||||
|
|
||||||
// Determine target agents
|
// Determine target agents
|
||||||
const agents = this.agent ? [this.agent as AgentType] : undefined;
|
const agents = this.agent ? [this.agent as AgentType] : undefined;
|
||||||
@@ -274,33 +274,33 @@ export class ContextCommand extends Command {
|
|||||||
|
|
||||||
// Print results
|
// Print results
|
||||||
for (const result of report.results) {
|
for (const result of report.results) {
|
||||||
const status = result.success ? chalk.green('✓') : chalk.red('✗');
|
const status = result.success ? colors.success('✓') : colors.error('✗');
|
||||||
console.log(`${status} ${result.agent}: ${result.skillsSynced} synced, ${result.skillsSkipped} skipped`);
|
console.log(`${status} ${result.agent}: ${result.skillsSynced} synced, ${result.skillsSkipped} skipped`);
|
||||||
|
|
||||||
if (this.verbose && result.files.length > 0) {
|
if (this.verbose && result.files.length > 0) {
|
||||||
for (const file of result.files) {
|
for (const file of result.files) {
|
||||||
console.log(chalk.gray(` → ${file}`));
|
console.log(colors.muted(` → ${file}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (result.warnings.length > 0) {
|
if (result.warnings.length > 0) {
|
||||||
for (const warning of result.warnings) {
|
for (const warning of result.warnings) {
|
||||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
console.log(colors.warning(` ⚠ ${warning}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (result.errors.length > 0) {
|
if (result.errors.length > 0) {
|
||||||
for (const error of result.errors) {
|
for (const error of result.errors) {
|
||||||
console.log(chalk.red(` ✗ ${error}`));
|
console.log(colors.error(` ✗ ${error}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
|
console.log(colors.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
|
||||||
|
|
||||||
if (this.dryRun) {
|
if (this.dryRun) {
|
||||||
console.log(chalk.gray('\n(Dry run - no files were written)'));
|
console.log(colors.muted('\n(Dry run - no files were written)'));
|
||||||
}
|
}
|
||||||
|
|
||||||
return report.successfulAgents === report.totalAgents ? 0 : 1;
|
return report.successfulAgents === report.totalAgents ? 0 : 1;
|
||||||
@@ -310,86 +310,86 @@ export class ContextCommand extends Command {
|
|||||||
* Detect project stack
|
* Detect project stack
|
||||||
*/
|
*/
|
||||||
private async detectProject(): Promise<number> {
|
private async detectProject(): Promise<number> {
|
||||||
console.log(chalk.cyan('Analyzing project...\n'));
|
console.log(colors.cyan('Analyzing project...\n'));
|
||||||
|
|
||||||
const stack = analyzeProject(process.cwd());
|
const stack = analyzeProject(process.cwd());
|
||||||
const tags = getStackTags(stack);
|
const tags = getStackTags(stack);
|
||||||
|
|
||||||
// Languages
|
// Languages
|
||||||
if (stack.languages.length > 0) {
|
if (stack.languages.length > 0) {
|
||||||
console.log(chalk.bold('Languages:'));
|
console.log(colors.bold('Languages:'));
|
||||||
for (const lang of stack.languages) {
|
for (const lang of stack.languages) {
|
||||||
const version = lang.version ? ` (${lang.version})` : '';
|
const version = lang.version ? ` (${lang.version})` : '';
|
||||||
console.log(` ${chalk.green('•')} ${lang.name}${version}`);
|
console.log(` ${colors.success('•')} ${lang.name}${version}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Frameworks
|
// Frameworks
|
||||||
if (stack.frameworks.length > 0) {
|
if (stack.frameworks.length > 0) {
|
||||||
console.log(chalk.bold('Frameworks:'));
|
console.log(colors.bold('Frameworks:'));
|
||||||
for (const fw of stack.frameworks) {
|
for (const fw of stack.frameworks) {
|
||||||
const version = fw.version ? ` (${fw.version})` : '';
|
const version = fw.version ? ` (${fw.version})` : '';
|
||||||
console.log(` ${chalk.green('•')} ${fw.name}${version}`);
|
console.log(` ${colors.success('•')} ${fw.name}${version}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Libraries
|
// Libraries
|
||||||
if (stack.libraries.length > 0) {
|
if (stack.libraries.length > 0) {
|
||||||
console.log(chalk.bold('Libraries:'));
|
console.log(colors.bold('Libraries:'));
|
||||||
for (const lib of stack.libraries) {
|
for (const lib of stack.libraries) {
|
||||||
const version = lib.version ? ` (${lib.version})` : '';
|
const version = lib.version ? ` (${lib.version})` : '';
|
||||||
console.log(` ${chalk.green('•')} ${lib.name}${version}`);
|
console.log(` ${colors.success('•')} ${lib.name}${version}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Styling
|
// Styling
|
||||||
if (stack.styling.length > 0) {
|
if (stack.styling.length > 0) {
|
||||||
console.log(chalk.bold('Styling:'));
|
console.log(colors.bold('Styling:'));
|
||||||
for (const style of stack.styling) {
|
for (const style of stack.styling) {
|
||||||
console.log(` ${chalk.green('•')} ${style.name}`);
|
console.log(` ${colors.success('•')} ${style.name}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Testing
|
// Testing
|
||||||
if (stack.testing.length > 0) {
|
if (stack.testing.length > 0) {
|
||||||
console.log(chalk.bold('Testing:'));
|
console.log(colors.bold('Testing:'));
|
||||||
for (const test of stack.testing) {
|
for (const test of stack.testing) {
|
||||||
console.log(` ${chalk.green('•')} ${test.name}`);
|
console.log(` ${colors.success('•')} ${test.name}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Databases
|
// Databases
|
||||||
if (stack.databases.length > 0) {
|
if (stack.databases.length > 0) {
|
||||||
console.log(chalk.bold('Databases:'));
|
console.log(colors.bold('Databases:'));
|
||||||
for (const db of stack.databases) {
|
for (const db of stack.databases) {
|
||||||
console.log(` ${chalk.green('•')} ${db.name}`);
|
console.log(` ${colors.success('•')} ${db.name}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Tools
|
// Tools
|
||||||
if (stack.tools.length > 0) {
|
if (stack.tools.length > 0) {
|
||||||
console.log(chalk.bold('Tools:'));
|
console.log(colors.bold('Tools:'));
|
||||||
for (const tool of stack.tools) {
|
for (const tool of stack.tools) {
|
||||||
console.log(` ${chalk.green('•')} ${tool.name}`);
|
console.log(` ${colors.success('•')} ${tool.name}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Tags
|
// Tags
|
||||||
if (tags.length > 0) {
|
if (tags.length > 0) {
|
||||||
console.log(chalk.bold('Recommended skill tags:'));
|
console.log(colors.bold('Recommended skill tags:'));
|
||||||
console.log(` ${chalk.cyan(tags.join(', '))}`);
|
console.log(` ${colors.cyan(tags.join(', '))}`);
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
if (this.json) {
|
if (this.json) {
|
||||||
console.log(chalk.gray('\nJSON:'));
|
console.log(colors.muted('\nJSON:'));
|
||||||
console.log(JSON.stringify(stack, null, 2));
|
console.log(JSON.stringify(stack, null, 2));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -405,27 +405,27 @@ export class ContextCommand extends Command {
|
|||||||
const status = sync.checkStatus();
|
const status = sync.checkStatus();
|
||||||
const adapters = getAllAdapters();
|
const adapters = getAllAdapters();
|
||||||
|
|
||||||
console.log(chalk.bold('\nAgent Status:\n'));
|
console.log(colors.bold('\nAgent Status:\n'));
|
||||||
|
|
||||||
for (const [agent, info] of Object.entries(status)) {
|
for (const [agent, info] of Object.entries(status)) {
|
||||||
const adapter = adapters.find(a => a.type === agent);
|
const adapter = adapters.find(a => a.type === agent);
|
||||||
const name = adapter?.name || agent;
|
const name = adapter?.name || agent;
|
||||||
const isDetected = detected.includes(agent as AgentType);
|
const isDetected = detected.includes(agent as AgentType);
|
||||||
|
|
||||||
const statusIcon = info.hasSkills ? chalk.green('●') : isDetected ? chalk.yellow('○') : chalk.gray('○');
|
const statusIcon = info.hasSkills ? colors.success('●') : isDetected ? colors.warning('○') : colors.muted('○');
|
||||||
const skillInfo = info.skillCount > 0 ? chalk.gray(` (${info.skillCount} skills)`) : '';
|
const skillInfo = info.skillCount > 0 ? colors.muted(` (${info.skillCount} skills)`) : '';
|
||||||
|
|
||||||
console.log(` ${statusIcon} ${name.padEnd(20)} ${chalk.gray(agent)}${skillInfo}`);
|
console.log(` ${statusIcon} ${name.padEnd(20)} ${colors.muted(agent)}${skillInfo}`);
|
||||||
|
|
||||||
if (this.verbose && info.skills.length > 0) {
|
if (this.verbose && info.skills.length > 0) {
|
||||||
for (const skill of info.skills) {
|
for (const skill of info.skills) {
|
||||||
console.log(chalk.gray(` └─ ${skill}`));
|
console.log(colors.muted(` └─ ${skill}`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.gray('Legend: ● has skills, ○ detected/configured, ○ not detected'));
|
console.log(colors.muted('Legend: ● has skills, ○ detected/configured, ○ not detected'));
|
||||||
console.log();
|
console.log();
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -435,8 +435,8 @@ export class ContextCommand extends Command {
|
|||||||
* Print context summary
|
* Print context summary
|
||||||
*/
|
*/
|
||||||
private printContextSummary(context: ProjectContext): void {
|
private printContextSummary(context: ProjectContext): void {
|
||||||
console.log(chalk.bold('Project:'));
|
console.log(colors.bold('Project:'));
|
||||||
console.log(` Name: ${chalk.cyan(context.project.name)}`);
|
console.log(` Name: ${colors.cyan(context.project.name)}`);
|
||||||
if (context.project.type) {
|
if (context.project.type) {
|
||||||
console.log(` Type: ${context.project.type}`);
|
console.log(` Type: ${context.project.type}`);
|
||||||
}
|
}
|
||||||
@@ -460,32 +460,30 @@ export class ContextCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (stackItems.length > 0) {
|
if (stackItems.length > 0) {
|
||||||
console.log(`\n${chalk.bold('Stack:')} ${stackItems.join(', ')}`);
|
console.log(`\n${colors.bold('Stack:')} ${stackItems.join(', ')}`);
|
||||||
|
|
||||||
// Show top items
|
|
||||||
const topFrameworks = context.stack.frameworks.slice(0, 3).map(f => f.name);
|
const topFrameworks = context.stack.frameworks.slice(0, 3).map(f => f.name);
|
||||||
if (topFrameworks.length > 0) {
|
if (topFrameworks.length > 0) {
|
||||||
console.log(` Frameworks: ${chalk.cyan(topFrameworks.join(', '))}`);
|
console.log(` Frameworks: ${colors.cyan(topFrameworks.join(', '))}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
const topLibs = context.stack.libraries.slice(0, 3).map(l => l.name);
|
const topLibs = context.stack.libraries.slice(0, 3).map(l => l.name);
|
||||||
if (topLibs.length > 0) {
|
if (topLibs.length > 0) {
|
||||||
console.log(` Libraries: ${chalk.cyan(topLibs.join(', '))}`);
|
console.log(` Libraries: ${colors.cyan(topLibs.join(', '))}`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Skills summary
|
// Skills summary
|
||||||
if (context.skills) {
|
if (context.skills) {
|
||||||
console.log(`\n${chalk.bold('Skills:')}`);
|
console.log(`\n${colors.bold('Skills:')}`);
|
||||||
console.log(` Installed: ${context.skills.installed?.length || 0}`);
|
console.log(` Installed: ${context.skills.installed?.length || 0}`);
|
||||||
console.log(` Auto-sync: ${context.skills.autoSync ? 'enabled' : 'disabled'}`);
|
console.log(` Auto-sync: ${context.skills.autoSync ? 'enabled' : 'disabled'}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Agents summary
|
|
||||||
if (context.agents) {
|
if (context.agents) {
|
||||||
console.log(`\n${chalk.bold('Agents:')}`);
|
console.log(`\n${colors.bold('Agents:')}`);
|
||||||
if (context.agents.primary) {
|
if (context.agents.primary) {
|
||||||
console.log(` Primary: ${chalk.cyan(context.agents.primary)}`);
|
console.log(` Primary: ${colors.cyan(context.agents.primary)}`);
|
||||||
}
|
}
|
||||||
if (context.agents.synced?.length) {
|
if (context.agents.synced?.length) {
|
||||||
console.log(` Synced: ${context.agents.synced.join(', ')}`);
|
console.log(` Synced: ${context.agents.synced.join(', ')}`);
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
import chalk from 'chalk';
|
import { colors, success, error, step, spinner } from '../onboarding/index.js';
|
||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
|
|
||||||
export class CreateCommand extends Command {
|
export class CreateCommand extends Command {
|
||||||
@@ -37,12 +37,21 @@ export class CreateCommand extends Command {
|
|||||||
description: 'Parent directory to create skill in (default: current directory)',
|
description: 'Parent directory to create skill in (default: current directory)',
|
||||||
});
|
});
|
||||||
|
|
||||||
|
json = Option.Boolean('--json', false, {
|
||||||
|
description: 'Output as JSON',
|
||||||
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const skillName = this.name.toLowerCase();
|
const skillName = this.name.toLowerCase();
|
||||||
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
|
|
||||||
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
|
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
|
||||||
console.error(chalk.red('Invalid skill name'));
|
if (this.json) {
|
||||||
console.error(chalk.dim('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
|
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;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -50,11 +59,17 @@ export class CreateCommand extends Command {
|
|||||||
const skillDir = join(parentDir, skillName);
|
const skillDir = join(parentDir, skillName);
|
||||||
|
|
||||||
if (existsSync(skillDir)) {
|
if (existsSync(skillDir)) {
|
||||||
console.error(chalk.red(`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;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
try {
|
try {
|
||||||
|
s.start('Creating skill');
|
||||||
|
|
||||||
mkdirSync(skillDir, { recursive: true });
|
mkdirSync(skillDir, { recursive: true });
|
||||||
|
|
||||||
const skillMd = generateSkillMd(skillName);
|
const skillMd = generateSkillMd(skillName);
|
||||||
@@ -78,24 +93,35 @@ export class CreateCommand extends Command {
|
|||||||
writeFileSync(join(assetsDir, '.gitkeep'), '');
|
writeFileSync(join(assetsDir, '.gitkeep'), '');
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.green(`Created skill: ${skillName}`));
|
s.stop('Skill created');
|
||||||
console.log();
|
|
||||||
console.log(chalk.dim('Structure:'));
|
if (this.json) {
|
||||||
console.log(chalk.dim(` ${skillDir}/`));
|
console.log(JSON.stringify({ success: true, name: skillName, path: skillDir }));
|
||||||
console.log(chalk.dim(' ├── SKILL.md'));
|
} else {
|
||||||
if (this.full || this.references) console.log(chalk.dim(' ├── references/'));
|
success(`Created skill: ${skillName}`);
|
||||||
if (this.full || this.scripts) console.log(chalk.dim(' ├── scripts/'));
|
console.log();
|
||||||
if (this.full || this.assets) console.log(chalk.dim(' └── assets/'));
|
console.log(colors.muted('Structure:'));
|
||||||
console.log();
|
console.log(colors.muted(` ${skillDir}/`));
|
||||||
console.log(chalk.cyan('Next steps:'));
|
console.log(colors.muted(' ├── SKILL.md'));
|
||||||
console.log(chalk.dim(' 1. Edit SKILL.md with your instructions'));
|
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
|
||||||
console.log(chalk.dim(' 2. Validate: skillkit validate ' + skillDir));
|
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
|
||||||
console.log(chalk.dim(' 3. Test: skillkit read ' + skillName));
|
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;
|
return 0;
|
||||||
} catch (error) {
|
} catch (err) {
|
||||||
console.error(chalk.red('Failed to create skill'));
|
s.stop('Failed');
|
||||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
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;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
import chalk from 'chalk';
|
import { colors, warn, success, error, spinner } from '../onboarding/index.js';
|
||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { setSkillEnabled, findSkill } from '@skillkit/core';
|
import { setSkillEnabled, findSkill } from '@skillkit/core';
|
||||||
import { getSearchDirs } from '../helpers.js';
|
import { getSearchDirs } from '../helpers.js';
|
||||||
@@ -16,38 +16,54 @@ export class EnableCommand extends Command {
|
|||||||
|
|
||||||
skills = Option.Rest({ required: 1 });
|
skills = Option.Rest({ required: 1 });
|
||||||
|
|
||||||
|
json = Option.Boolean('--json', false, {
|
||||||
|
description: 'Output as JSON',
|
||||||
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const searchDirs = getSearchDirs();
|
const searchDirs = getSearchDirs();
|
||||||
let success = 0;
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
|
let successCount = 0;
|
||||||
let failed = 0;
|
let failed = 0;
|
||||||
|
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
|
||||||
|
|
||||||
|
s.start('Enabling skills');
|
||||||
|
|
||||||
for (const skillName of this.skills) {
|
for (const skillName of this.skills) {
|
||||||
const skill = findSkill(skillName, searchDirs);
|
const skill = findSkill(skillName, searchDirs);
|
||||||
|
|
||||||
if (!skill) {
|
if (!skill) {
|
||||||
console.log(chalk.red(`Skill not found: ${skillName}`));
|
if (!this.json) error(`Skill not found: ${skillName}`);
|
||||||
|
results.push({ name: skillName, enabled: false, success: false });
|
||||||
failed++;
|
failed++;
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (skill.enabled) {
|
if (skill.enabled) {
|
||||||
console.log(chalk.dim(`Already enabled: ${skillName}`));
|
if (!this.json) console.log(colors.muted(`Already enabled: ${skillName}`));
|
||||||
|
results.push({ name: skillName, enabled: true, success: true });
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
const result = setSkillEnabled(skill.path, true);
|
const result = setSkillEnabled(skill.path, true);
|
||||||
|
|
||||||
if (result) {
|
if (result) {
|
||||||
console.log(chalk.green(`Enabled: ${skillName}`));
|
if (!this.json) success(`Enabled: ${skillName}`);
|
||||||
success++;
|
results.push({ name: skillName, enabled: true, success: true });
|
||||||
|
successCount++;
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(`Failed to enable: ${skillName}`));
|
if (!this.json) error(`Failed to enable: ${skillName}`);
|
||||||
|
results.push({ name: skillName, enabled: false, success: false });
|
||||||
failed++;
|
failed++;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (success > 0) {
|
s.stop(successCount > 0 ? `Enabled ${successCount} skill(s)` : 'Done');
|
||||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
|
||||||
|
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'));
|
||||||
}
|
}
|
||||||
|
|
||||||
return failed > 0 ? 1 : 0;
|
return failed > 0 ? 1 : 0;
|
||||||
@@ -67,38 +83,54 @@ export class DisableCommand extends Command {
|
|||||||
|
|
||||||
skills = Option.Rest({ required: 1 });
|
skills = Option.Rest({ required: 1 });
|
||||||
|
|
||||||
|
json = Option.Boolean('--json', false, {
|
||||||
|
description: 'Output as JSON',
|
||||||
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const searchDirs = getSearchDirs();
|
const searchDirs = getSearchDirs();
|
||||||
let success = 0;
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
|
let successCount = 0;
|
||||||
let failed = 0;
|
let failed = 0;
|
||||||
|
const results: Array<{ name: string; enabled: boolean; success: boolean }> = [];
|
||||||
|
|
||||||
|
s.start('Disabling skills');
|
||||||
|
|
||||||
for (const skillName of this.skills) {
|
for (const skillName of this.skills) {
|
||||||
const skill = findSkill(skillName, searchDirs);
|
const skill = findSkill(skillName, searchDirs);
|
||||||
|
|
||||||
if (!skill) {
|
if (!skill) {
|
||||||
console.log(chalk.red(`Skill not found: ${skillName}`));
|
if (!this.json) error(`Skill not found: ${skillName}`);
|
||||||
|
results.push({ name: skillName, enabled: false, success: false });
|
||||||
failed++;
|
failed++;
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!skill.enabled) {
|
if (!skill.enabled) {
|
||||||
console.log(chalk.dim(`Already disabled: ${skillName}`));
|
if (!this.json) console.log(colors.muted(`Already disabled: ${skillName}`));
|
||||||
|
results.push({ name: skillName, enabled: false, success: true });
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
const result = setSkillEnabled(skill.path, false);
|
const result = setSkillEnabled(skill.path, false);
|
||||||
|
|
||||||
if (result) {
|
if (result) {
|
||||||
console.log(chalk.yellow(`Disabled: ${skillName}`));
|
if (!this.json) warn(`Disabled: ${skillName}`);
|
||||||
success++;
|
results.push({ name: skillName, enabled: false, success: true });
|
||||||
|
successCount++;
|
||||||
} else {
|
} else {
|
||||||
console.log(chalk.red(`Failed to disable: ${skillName}`));
|
if (!this.json) error(`Failed to disable: ${skillName}`);
|
||||||
|
results.push({ name: skillName, enabled: true, success: false });
|
||||||
failed++;
|
failed++;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (success > 0) {
|
s.stop(successCount > 0 ? `Disabled ${successCount} skill(s)` : 'Done');
|
||||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
|
||||||
|
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'));
|
||||||
}
|
}
|
||||||
|
|
||||||
return failed > 0 ? 1 : 0;
|
return failed > 0 ? 1 : 0;
|
||||||
|
|||||||
@@ -0,0 +1,170 @@
|
|||||||
|
import { Command, Option } from 'clipanion';
|
||||||
|
import { resolve } from 'node:path';
|
||||||
|
import { existsSync } from 'node:fs';
|
||||||
|
import {
|
||||||
|
createEvalEngine,
|
||||||
|
formatEvalResult,
|
||||||
|
LLMQualityEvaluator,
|
||||||
|
ContradictionEvaluator,
|
||||||
|
BehavioralSecurityEvaluator,
|
||||||
|
SandboxEvaluator,
|
||||||
|
DynamicBenchmarkEvaluator,
|
||||||
|
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']];
|
||||||
|
|
||||||
|
static override usage = Command.Usage({
|
||||||
|
description: 'Evaluate a skill with multi-tier analysis (LLM quality, contradictions, security, benchmarks)',
|
||||||
|
details: `
|
||||||
|
Runs a comprehensive evaluation engine across up to 6 tiers:
|
||||||
|
Tier 1: LLM-based quality scoring (G-Eval pattern)
|
||||||
|
Tier 2: Contradiction detection (formal + semantic)
|
||||||
|
Tier 3: Behavioral security analysis (AST + taint + LLM)
|
||||||
|
Tier 4: Sandbox execution testing (Docker)
|
||||||
|
Tier 5: Dynamic marketplace benchmarks
|
||||||
|
Tier 6: Community signals (GitHub, installs, freshness)
|
||||||
|
|
||||||
|
Works without API keys (heuristic fallback for Tier 1, Tiers 5-6 always available).
|
||||||
|
Configure a provider for full LLM-powered evaluation.
|
||||||
|
`,
|
||||||
|
examples: [
|
||||||
|
['Evaluate a skill', '$0 eval ./my-skill'],
|
||||||
|
['Run specific tiers', '$0 eval ./my-skill --tier 1,2,3'],
|
||||||
|
['Use Anthropic provider', '$0 eval ./my-skill --provider anthropic'],
|
||||||
|
['JSON output', '$0 eval ./my-skill --format json'],
|
||||||
|
['Set minimum score', '$0 eval ./my-skill --min-score 70'],
|
||||||
|
['Verbose output', '$0 eval ./my-skill --verbose'],
|
||||||
|
],
|
||||||
|
});
|
||||||
|
|
||||||
|
skillPath = Option.String({ required: true, name: 'path' });
|
||||||
|
|
||||||
|
tier = Option.String('--tier,-t', {
|
||||||
|
description: 'Comma-separated tier numbers to run (1-6). Default: 1,2,3,5,6',
|
||||||
|
});
|
||||||
|
|
||||||
|
provider = Option.String('--provider,-p', {
|
||||||
|
description: 'LLM provider: anthropic, openai, google, ollama, openrouter',
|
||||||
|
});
|
||||||
|
|
||||||
|
model = Option.String('--model,-m', {
|
||||||
|
description: 'Model name to use with the provider',
|
||||||
|
});
|
||||||
|
|
||||||
|
format = Option.String('--format,-f', 'summary', {
|
||||||
|
description: 'Output format: summary, json, table',
|
||||||
|
});
|
||||||
|
|
||||||
|
verbose = Option.Boolean('--verbose,-v', false, {
|
||||||
|
description: 'Show detailed output for each tier',
|
||||||
|
});
|
||||||
|
|
||||||
|
minScore = Option.String('--min-score', {
|
||||||
|
description: 'Exit with code 1 if overall score is below this threshold',
|
||||||
|
});
|
||||||
|
|
||||||
|
sandboxImage = Option.String('--sandbox-image', {
|
||||||
|
description: 'Docker image for sandbox testing (Tier 4)',
|
||||||
|
});
|
||||||
|
|
||||||
|
timeout = Option.String('--timeout', {
|
||||||
|
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);
|
||||||
|
|
||||||
|
if (!existsSync(targetPath)) {
|
||||||
|
this.context.stderr.write(`Path not found: ${targetPath}\n`);
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
const validFormats = ['summary', 'json', 'table'];
|
||||||
|
if (!validFormats.includes(this.format)) {
|
||||||
|
this.context.stderr.write(`Invalid format: "${this.format}". Must be one of: ${validFormats.join(', ')}\n`);
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
let tiers: EvalTier[] | undefined;
|
||||||
|
if (this.tier) {
|
||||||
|
tiers = this.tier.split(',').map((s) => {
|
||||||
|
const n = parseInt(s.trim(), 10);
|
||||||
|
if (isNaN(n) || n < 1 || n > 6) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return n as EvalTier;
|
||||||
|
}).filter((n): n is EvalTier => n !== null);
|
||||||
|
if (tiers.length === 0) {
|
||||||
|
this.context.stderr.write(`Invalid --tier value: "${this.tier}". Must be comma-separated numbers 1-6.\n`);
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.minScore) {
|
||||||
|
const threshold = parseInt(this.minScore, 10);
|
||||||
|
if (isNaN(threshold)) {
|
||||||
|
this.context.stderr.write(`Invalid --min-score value: "${this.minScore}". Must be a number.\n`);
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const parsedTimeout = this.timeout ? parseInt(this.timeout, 10) : NaN;
|
||||||
|
|
||||||
|
const options: EvalOptions = {
|
||||||
|
tiers,
|
||||||
|
provider: this.provider,
|
||||||
|
model: this.model,
|
||||||
|
format: this.format as 'summary' | 'json' | 'table',
|
||||||
|
verbose: this.verbose,
|
||||||
|
sandboxImage: this.sandboxImage,
|
||||||
|
timeout: !isNaN(parsedTimeout) ? parsedTimeout : undefined,
|
||||||
|
};
|
||||||
|
|
||||||
|
const engine = createEvalEngine();
|
||||||
|
|
||||||
|
engine.registerEvaluator(new LLMQualityEvaluator());
|
||||||
|
engine.registerEvaluator(new ContradictionEvaluator());
|
||||||
|
engine.registerEvaluator(new BehavioralSecurityEvaluator());
|
||||||
|
engine.registerEvaluator(new SandboxEvaluator());
|
||||||
|
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
|
||||||
|
engine.registerEvaluator(new CommunitySignalsEvaluator());
|
||||||
|
|
||||||
|
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;
|
||||||
|
}
|
||||||
|
|
||||||
|
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) {
|
||||||
|
if (!this.json) {
|
||||||
|
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
|
||||||
|
}
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -13,7 +13,7 @@ import {
|
|||||||
GitHubSkillRegistry,
|
GitHubSkillRegistry,
|
||||||
SkillsShRegistry,
|
SkillsShRegistry,
|
||||||
} from "@skillkit/core";
|
} from "@skillkit/core";
|
||||||
import { formatCount } from "../helpers.js";
|
import { formatCount, loadTaps } from "../helpers.js";
|
||||||
|
|
||||||
interface SkillResult {
|
interface SkillResult {
|
||||||
name: string;
|
name: string;
|
||||||
@@ -60,15 +60,20 @@ export class FindCommand extends Command {
|
|||||||
description: "Minimal output (just list skills)",
|
description: "Minimal output (just list skills)",
|
||||||
});
|
});
|
||||||
|
|
||||||
federated = Option.Boolean("--federated,-f", false, {
|
federated = Option.Boolean("--federated,-f", true, {
|
||||||
description: "Search external registries (GitHub SKILL.md files)",
|
description: "Search external registries (enabled by default)",
|
||||||
|
hidden: true,
|
||||||
|
});
|
||||||
|
|
||||||
|
json = Option.Boolean("--json", false, {
|
||||||
|
description: "Output as JSON",
|
||||||
});
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
const s = spinner();
|
const s = this.json ? { start: () => {}, stop: () => {}, message: () => {} } : spinner();
|
||||||
const limit = parseInt(this.limit, 10) || 10;
|
const limit = parseInt(this.limit, 10) || 10;
|
||||||
|
|
||||||
if (!this.quiet) {
|
if (!this.quiet && !this.json) {
|
||||||
header("Find Skills");
|
header("Find Skills");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -86,6 +91,20 @@ export class FindCommand extends Command {
|
|||||||
}),
|
}),
|
||||||
);
|
);
|
||||||
|
|
||||||
|
const taps = loadTaps();
|
||||||
|
for (const tap of taps.taps) {
|
||||||
|
const tapLabel = tap.name || tap.source;
|
||||||
|
const exists = allSkills.some((s) => s.source === tap.source);
|
||||||
|
if (!exists) {
|
||||||
|
allSkills.push({
|
||||||
|
name: tapLabel,
|
||||||
|
description: `Custom tap: ${tap.source}`,
|
||||||
|
source: tap.source,
|
||||||
|
repoName: tap.source.split("/").pop() || "",
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
let results: SkillResult[];
|
let results: SkillResult[];
|
||||||
let searchTerm: string | undefined;
|
let searchTerm: string | undefined;
|
||||||
|
|
||||||
@@ -102,7 +121,7 @@ export class FindCommand extends Command {
|
|||||||
)
|
)
|
||||||
.slice(0, limit);
|
.slice(0, limit);
|
||||||
|
|
||||||
if (!this.quiet) {
|
if (!this.quiet && !this.json) {
|
||||||
step("Showing featured skills");
|
step("Showing featured skills");
|
||||||
}
|
}
|
||||||
} else if (this.query) {
|
} else if (this.query) {
|
||||||
@@ -123,7 +142,7 @@ export class FindCommand extends Command {
|
|||||||
|
|
||||||
s.stop(`Found ${results.length} skill(s)`);
|
s.stop(`Found ${results.length} skill(s)`);
|
||||||
} else {
|
} else {
|
||||||
if (!this.quiet) {
|
if (!this.quiet && !this.json) {
|
||||||
step("Enter a search term or browse featured skills");
|
step("Enter a search term or browse featured skills");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -237,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) {
|
if (results.length === 0) {
|
||||||
console.log(colors.muted("No skills found matching your search"));
|
console.log(colors.muted("No skills found matching your search"));
|
||||||
console.log("");
|
console.log("");
|
||||||
@@ -246,7 +277,7 @@ export class FindCommand extends Command {
|
|||||||
);
|
);
|
||||||
console.log(
|
console.log(
|
||||||
colors.muted(
|
colors.muted(
|
||||||
" skillkit find -f <query> # Also search GitHub SKILL.md files",
|
" skillkit find <query> # Search marketplace + GitHub",
|
||||||
),
|
),
|
||||||
);
|
);
|
||||||
console.log(colors.muted(" skillkit ui # Browse in TUI"));
|
console.log(colors.muted(" skillkit ui # Browse in TUI"));
|
||||||
|
|||||||
@@ -15,6 +15,7 @@ import {
|
|||||||
error,
|
error,
|
||||||
header,
|
header,
|
||||||
confirm,
|
confirm,
|
||||||
|
spinner,
|
||||||
} from '../onboarding/index.js';
|
} from '../onboarding/index.js';
|
||||||
|
|
||||||
interface FixSuggestion {
|
interface FixSuggestion {
|
||||||
@@ -209,6 +210,7 @@ export class FixCommand extends Command {
|
|||||||
|
|
||||||
let totalFixes = 0;
|
let totalFixes = 0;
|
||||||
let filesFixed = 0;
|
let filesFixed = 0;
|
||||||
|
const s = spinner();
|
||||||
|
|
||||||
for (const target of this.targets) {
|
for (const target of this.targets) {
|
||||||
const resolved = resolve(target);
|
const resolved = resolve(target);
|
||||||
@@ -256,8 +258,10 @@ export class FixCommand extends Command {
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
s.start(`Evaluating ${skillName}`);
|
||||||
const content = readFileSync(filePath, 'utf-8');
|
const content = readFileSync(filePath, 'utf-8');
|
||||||
const quality = evaluateSkillFile(filePath);
|
const quality = evaluateSkillFile(filePath);
|
||||||
|
s.stop(`Evaluated ${skillName}`);
|
||||||
|
|
||||||
if (!quality) {
|
if (!quality) {
|
||||||
warn(`Could not evaluate: ${target}`);
|
warn(`Could not evaluate: ${target}`);
|
||||||
|
|||||||
@@ -33,7 +33,7 @@ export class GenerateCommand extends Command {
|
|||||||
['Interactive wizard', '$0 generate'],
|
['Interactive wizard', '$0 generate'],
|
||||||
['Use specific provider', '$0 generate --provider openai'],
|
['Use specific provider', '$0 generate --provider openai'],
|
||||||
['Compose from existing skills', '$0 generate --compose "testing patterns for vitest"'],
|
['Compose from existing skills', '$0 generate --compose "testing patterns for vitest"'],
|
||||||
['Target specific agents', '$0 generate --agents claude-code,cursor'],
|
['Target specific agents', '$0 generate --agent claude-code,cursor'],
|
||||||
['Skip memory context', '$0 generate --no-memory'],
|
['Skip memory context', '$0 generate --no-memory'],
|
||||||
],
|
],
|
||||||
});
|
});
|
||||||
@@ -50,7 +50,7 @@ export class GenerateCommand extends Command {
|
|||||||
description: 'Natural language search to find skills to compose',
|
description: 'Natural language search to find skills to compose',
|
||||||
});
|
});
|
||||||
|
|
||||||
agents = Option.String('--agents,-a', {
|
agents = Option.String('--agent,--agents,-a', {
|
||||||
description: 'Target agents (comma-separated)',
|
description: 'Target agents (comma-separated)',
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -536,6 +536,9 @@ ${trustScore.warnings.length > 0 ? `\nWarnings:\n${trustScore.warnings.map((w) =
|
|||||||
let targetAgents: string[];
|
let targetAgents: string[];
|
||||||
|
|
||||||
if (this.agents) {
|
if (this.agents) {
|
||||||
|
if (process.argv.includes('--agents')) {
|
||||||
|
console.warn('Warning: --agents is deprecated, use --agent instead (--agents will be removed in v2.0)');
|
||||||
|
}
|
||||||
targetAgents = this.agents.split(',').map((a) => a.trim());
|
targetAgents = this.agents.split(',').map((a) => a.trim());
|
||||||
} else {
|
} else {
|
||||||
const agentOptions = [
|
const agentOptions = [
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import chalk from 'chalk';
|
import { colors } from '../onboarding/index.js';
|
||||||
import {
|
import {
|
||||||
getAllGuidelines,
|
getAllGuidelines,
|
||||||
getEnabledGuidelines,
|
getEnabledGuidelines,
|
||||||
@@ -31,7 +31,7 @@ export class GuidelineCommand extends Command {
|
|||||||
});
|
});
|
||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
console.log(chalk.cyan('Guideline commands:\n'));
|
console.log(colors.cyan('Guideline commands:\n'));
|
||||||
console.log(' guideline list List all guidelines');
|
console.log(' guideline list List all guidelines');
|
||||||
console.log(' guideline show <id> Show guideline content');
|
console.log(' guideline show <id> Show guideline content');
|
||||||
console.log(' guideline enable Enable a guideline');
|
console.log(' guideline enable Enable a guideline');
|
||||||
@@ -70,7 +70,7 @@ export class GuidelineListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
const title = this.enabled ? 'Enabled Guidelines' : 'All Guidelines';
|
const title = this.enabled ? 'Enabled Guidelines' : 'All Guidelines';
|
||||||
console.log(chalk.cyan(`${title} (${guidelines.length}):\n`));
|
console.log(colors.cyan(`${title} (${guidelines.length}):\n`));
|
||||||
|
|
||||||
const byCategory = new Map<GuidelineCategory, Guideline[]>();
|
const byCategory = new Map<GuidelineCategory, Guideline[]>();
|
||||||
for (const guideline of guidelines) {
|
for (const guideline of guidelines) {
|
||||||
@@ -81,22 +81,22 @@ export class GuidelineListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
for (const [category, catGuidelines] of byCategory) {
|
for (const [category, catGuidelines] of byCategory) {
|
||||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
console.log(colors.info(` ${formatCategoryName(category)}`));
|
||||||
|
|
||||||
for (const guideline of catGuidelines) {
|
for (const guideline of catGuidelines) {
|
||||||
const enabled = isGuidelineEnabled(guideline.id);
|
const enabled = isGuidelineEnabled(guideline.id);
|
||||||
const status = enabled ? chalk.green('●') : chalk.dim('○');
|
const status = enabled ? colors.success('●') : colors.muted('○');
|
||||||
const custom = isBuiltinGuideline(guideline.id) ? '' : chalk.dim(' (custom)');
|
const custom = isBuiltinGuideline(guideline.id) ? '' : colors.muted(' (custom)');
|
||||||
const priority = chalk.dim(`[${guideline.priority}]`);
|
const priority = colors.muted(`[${guideline.priority}]`);
|
||||||
|
|
||||||
console.log(` ${status} ${chalk.bold(guideline.id)} ${priority}${custom}`);
|
console.log(` ${status} ${colors.bold(guideline.id)} ${priority}${custom}`);
|
||||||
console.log(` ${chalk.dim(guideline.description)}`);
|
console.log(` ${colors.muted(guideline.description)}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.dim('Enable with: skillkit guideline enable <id>'));
|
console.log(colors.muted('Enable with: skillkit guideline enable <id>'));
|
||||||
console.log(chalk.dim('Show content: skillkit guideline show <id>'));
|
console.log(colors.muted('Show content: skillkit guideline show <id>'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -116,20 +116,20 @@ export class GuidelineShowCommand extends Command {
|
|||||||
const guideline = getGuideline(this.id);
|
const guideline = getGuideline(this.id);
|
||||||
|
|
||||||
if (!guideline) {
|
if (!guideline) {
|
||||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
console.log(colors.error(`Guideline not found: ${this.id}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const enabled = isGuidelineEnabled(this.id);
|
const enabled = isGuidelineEnabled(this.id);
|
||||||
const status = enabled ? chalk.green('enabled') : chalk.dim('disabled');
|
const status = enabled ? colors.success('enabled') : colors.muted('disabled');
|
||||||
|
|
||||||
console.log(chalk.cyan(`Guideline: ${guideline.name}\n`));
|
console.log(colors.cyan(`Guideline: ${guideline.name}\n`));
|
||||||
console.log(`ID: ${guideline.id}`);
|
console.log(`ID: ${guideline.id}`);
|
||||||
console.log(`Category: ${guideline.category}`);
|
console.log(`Category: ${guideline.category}`);
|
||||||
console.log(`Priority: ${guideline.priority}`);
|
console.log(`Priority: ${guideline.priority}`);
|
||||||
console.log(`Status: ${status}`);
|
console.log(`Status: ${status}`);
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.bold('Content:'));
|
console.log(colors.bold('Content:'));
|
||||||
console.log(guideline.content);
|
console.log(guideline.content);
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -150,11 +150,11 @@ export class GuidelineEnableCommand extends Command {
|
|||||||
const success = enableGuideline(this.id);
|
const success = enableGuideline(this.id);
|
||||||
|
|
||||||
if (!success) {
|
if (!success) {
|
||||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
console.log(colors.error(`Guideline not found: ${this.id}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.green(`✓ Enabled guideline: ${this.id}`));
|
console.log(colors.success(`✓ Enabled guideline: ${this.id}`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -173,11 +173,11 @@ export class GuidelineDisableCommand extends Command {
|
|||||||
const success = disableGuideline(this.id);
|
const success = disableGuideline(this.id);
|
||||||
|
|
||||||
if (!success) {
|
if (!success) {
|
||||||
console.log(chalk.yellow(`Guideline not found or already disabled: ${this.id}`));
|
console.log(colors.warning(`Guideline not found or already disabled: ${this.id}`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.green(`✓ Disabled guideline: ${this.id}`));
|
console.log(colors.success(`✓ Disabled guideline: ${this.id}`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -216,7 +216,7 @@ export class GuidelineCreateCommand extends Command {
|
|||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
if (isBuiltinGuideline(this.id)) {
|
if (isBuiltinGuideline(this.id)) {
|
||||||
console.log(chalk.red(`Cannot create: ${this.id} is a built-in guideline`));
|
console.log(colors.error(`Cannot create: ${this.id} is a built-in guideline`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -234,8 +234,8 @@ export class GuidelineCreateCommand extends Command {
|
|||||||
addCustomGuideline(guideline);
|
addCustomGuideline(guideline);
|
||||||
enableGuideline(this.id);
|
enableGuideline(this.id);
|
||||||
|
|
||||||
console.log(chalk.green(`✓ Created guideline: ${this.id}`));
|
console.log(colors.success(`✓ Created guideline: ${this.id}`));
|
||||||
console.log(chalk.dim('Edit ~/.skillkit/guidelines.yaml to customize content'));
|
console.log(colors.muted('Edit ~/.skillkit/guidelines.yaml to customize content'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -253,18 +253,18 @@ export class GuidelineRemoveCommand extends Command {
|
|||||||
|
|
||||||
async execute(): Promise<number> {
|
async execute(): Promise<number> {
|
||||||
if (isBuiltinGuideline(this.id)) {
|
if (isBuiltinGuideline(this.id)) {
|
||||||
console.log(chalk.red(`Cannot remove built-in guideline: ${this.id}`));
|
console.log(colors.error(`Cannot remove built-in guideline: ${this.id}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
const removed = removeCustomGuideline(this.id);
|
const removed = removeCustomGuideline(this.id);
|
||||||
|
|
||||||
if (!removed) {
|
if (!removed) {
|
||||||
console.log(chalk.yellow(`Guideline not found: ${this.id}`));
|
console.log(colors.warning(`Guideline not found: ${this.id}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.green(`✓ Removed guideline: ${this.id}`));
|
console.log(colors.success(`✓ Removed guideline: ${this.id}`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import { writeFileSync } from 'node:fs';
|
import { writeFileSync } from 'node:fs';
|
||||||
import chalk from 'chalk';
|
import { colors } from '../onboarding/index.js';
|
||||||
import { SessionHandoff } from '@skillkit/core';
|
import { SessionHandoff } from '@skillkit/core';
|
||||||
|
|
||||||
export class SessionHandoffCommand extends Command {
|
export class SessionHandoffCommand extends Command {
|
||||||
@@ -41,9 +41,9 @@ export class SessionHandoffCommand extends Command {
|
|||||||
if (this.out) {
|
if (this.out) {
|
||||||
try {
|
try {
|
||||||
writeFileSync(this.out, output, 'utf-8');
|
writeFileSync(this.out, output, 'utf-8');
|
||||||
console.log(chalk.green(`Handoff saved to ${this.out}`));
|
console.log(colors.success(`Handoff saved to ${this.out}`));
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error(chalk.red(`Failed to write file: ${(error as Error).message}`));
|
console.error(colors.error(`Failed to write file: ${(error as Error).message}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
import { Command, Option } from 'clipanion';
|
import { Command, Option } from 'clipanion';
|
||||||
import chalk from 'chalk';
|
import { colors, spinner } from '../onboarding/index.js';
|
||||||
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
|
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
|
||||||
import {
|
import {
|
||||||
getHookTemplates,
|
getHookTemplates,
|
||||||
@@ -60,12 +60,12 @@ export class HookCommand extends Command {
|
|||||||
case 'info':
|
case 'info':
|
||||||
return await this.showHookInfo(projectPath);
|
return await this.showHookInfo(projectPath);
|
||||||
default:
|
default:
|
||||||
this.context.stderr.write(chalk.red(`Unknown action: ${this.action}\n`));
|
this.context.stderr.write(colors.error(`Unknown action: ${this.action}\n`));
|
||||||
this.context.stderr.write('Available actions: list, add, remove, enable, disable, generate, info\n');
|
this.context.stderr.write('Available actions: list, add, remove, enable, disable, generate, info\n');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
this.context.stderr.write(chalk.red(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
|
this.context.stderr.write(colors.error(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -76,11 +76,11 @@ export class HookCommand extends Command {
|
|||||||
|
|
||||||
if (hooks.length === 0) {
|
if (hooks.length === 0) {
|
||||||
this.context.stdout.write('No hooks configured.\n');
|
this.context.stdout.write('No hooks configured.\n');
|
||||||
this.context.stdout.write(chalk.gray('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
|
this.context.stdout.write(colors.muted('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
this.context.stdout.write(chalk.cyan('Configured Hooks:\n\n'));
|
this.context.stdout.write(colors.cyan('Configured Hooks:\n\n'));
|
||||||
|
|
||||||
// Group by event
|
// Group by event
|
||||||
const eventGroups = new Map<string, typeof hooks>();
|
const eventGroups = new Map<string, typeof hooks>();
|
||||||
@@ -91,15 +91,15 @@ export class HookCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
for (const [event, eventHooks] of eventGroups) {
|
for (const [event, eventHooks] of eventGroups) {
|
||||||
this.context.stdout.write(chalk.yellow(`${event}:\n`));
|
this.context.stdout.write(colors.warning(`${event}:\n`));
|
||||||
for (const hook of eventHooks) {
|
for (const hook of eventHooks) {
|
||||||
const status = hook.enabled ? chalk.green('●') : chalk.gray('○');
|
const status = hook.enabled ? colors.success('●') : colors.muted('○');
|
||||||
this.context.stdout.write(` ${status} ${chalk.white(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
|
this.context.stdout.write(` ${status} ${colors.primary(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
|
||||||
if (hook.matcher) {
|
if (hook.matcher) {
|
||||||
this.context.stdout.write(chalk.gray(` Pattern: ${hook.matcher}\n`));
|
this.context.stdout.write(colors.muted(` Pattern: ${hook.matcher}\n`));
|
||||||
}
|
}
|
||||||
if (this.verbose) {
|
if (this.verbose) {
|
||||||
this.context.stdout.write(chalk.gray(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
|
this.context.stdout.write(colors.muted(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -110,14 +110,14 @@ export class HookCommand extends Command {
|
|||||||
|
|
||||||
private async addHook(projectPath: string): Promise<number> {
|
private async addHook(projectPath: string): Promise<number> {
|
||||||
if (!this.target) {
|
if (!this.target) {
|
||||||
this.context.stderr.write(chalk.red('Event type required.\n'));
|
this.context.stderr.write(colors.error('Event type required.\n'));
|
||||||
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
||||||
this.context.stderr.write('Events: session:start, session:end, file:save, file:open, task:start, commit:pre, commit:post, error:occur, test:fail, build:fail\n');
|
this.context.stderr.write('Events: session:start, session:end, file:save, file:open, task:start, commit:pre, commit:post, error:occur, test:fail, build:fail\n');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!this.skill) {
|
if (!this.skill) {
|
||||||
this.context.stderr.write(chalk.red('Skill name required.\n'));
|
this.context.stderr.write(colors.error('Skill name required.\n'));
|
||||||
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -133,7 +133,7 @@ export class HookCommand extends Command {
|
|||||||
];
|
];
|
||||||
|
|
||||||
if (!validEvents.includes(event)) {
|
if (!validEvents.includes(event)) {
|
||||||
this.context.stderr.write(chalk.red(`Invalid event: ${this.target}\n`));
|
this.context.stderr.write(colors.error(`Invalid event: ${this.target}\n`));
|
||||||
this.context.stderr.write(`Valid events: ${validEvents.join(', ')}\n`);
|
this.context.stderr.write(`Valid events: ${validEvents.join(', ')}\n`);
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -151,7 +151,7 @@ export class HookCommand extends Command {
|
|||||||
|
|
||||||
manager.save();
|
manager.save();
|
||||||
|
|
||||||
this.context.stdout.write(chalk.green(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
|
this.context.stdout.write(colors.success(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
|
||||||
this.context.stdout.write(` Event: ${event}\n`);
|
this.context.stdout.write(` Event: ${event}\n`);
|
||||||
this.context.stdout.write(` Skill: ${this.skill}\n`);
|
this.context.stdout.write(` Skill: ${this.skill}\n`);
|
||||||
if (this.pattern) {
|
if (this.pattern) {
|
||||||
@@ -163,7 +163,7 @@ export class HookCommand extends Command {
|
|||||||
|
|
||||||
private async removeHook(projectPath: string): Promise<number> {
|
private async removeHook(projectPath: string): Promise<number> {
|
||||||
if (!this.target) {
|
if (!this.target) {
|
||||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||||
this.context.stderr.write('Usage: skillkit hook remove <hook-id>\n');
|
this.context.stderr.write('Usage: skillkit hook remove <hook-id>\n');
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
@@ -174,20 +174,20 @@ export class HookCommand extends Command {
|
|||||||
// Find hook by ID prefix
|
// Find hook by ID prefix
|
||||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||||
if (!hook) {
|
if (!hook) {
|
||||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
manager.unregisterHook(hook.id);
|
manager.unregisterHook(hook.id);
|
||||||
manager.save();
|
manager.save();
|
||||||
|
|
||||||
this.context.stdout.write(chalk.green(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
|
this.context.stdout.write(colors.success(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
private async enableHook(projectPath: string): Promise<number> {
|
private async enableHook(projectPath: string): Promise<number> {
|
||||||
if (!this.target) {
|
if (!this.target) {
|
||||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -196,20 +196,20 @@ export class HookCommand extends Command {
|
|||||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||||
|
|
||||||
if (!hook) {
|
if (!hook) {
|
||||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
manager.enableHook(hook.id);
|
manager.enableHook(hook.id);
|
||||||
manager.save();
|
manager.save();
|
||||||
|
|
||||||
this.context.stdout.write(chalk.green(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
|
this.context.stdout.write(colors.success(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
private async disableHook(projectPath: string): Promise<number> {
|
private async disableHook(projectPath: string): Promise<number> {
|
||||||
if (!this.target) {
|
if (!this.target) {
|
||||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -218,14 +218,14 @@ export class HookCommand extends Command {
|
|||||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||||
|
|
||||||
if (!hook) {
|
if (!hook) {
|
||||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
manager.disableHook(hook.id);
|
manager.disableHook(hook.id);
|
||||||
manager.save();
|
manager.save();
|
||||||
|
|
||||||
this.context.stdout.write(chalk.yellow(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
|
this.context.stdout.write(colors.warning(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -239,9 +239,12 @@ export class HookCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
const agent = this.agent || 'claude-code';
|
const agent = this.agent || 'claude-code';
|
||||||
|
const s = spinner();
|
||||||
|
s.start(`Generating hooks for ${agent}`);
|
||||||
const generated = manager.generateAgentHooks(agent as any);
|
const generated = manager.generateAgentHooks(agent as any);
|
||||||
|
s.stop('Hooks generated');
|
||||||
|
|
||||||
this.context.stdout.write(chalk.cyan(`Generated hooks for ${agent}:\n\n`));
|
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
|
||||||
|
|
||||||
if (typeof generated === 'string') {
|
if (typeof generated === 'string') {
|
||||||
this.context.stdout.write(generated);
|
this.context.stdout.write(generated);
|
||||||
@@ -255,7 +258,7 @@ export class HookCommand extends Command {
|
|||||||
|
|
||||||
private async showHookInfo(projectPath: string): Promise<number> {
|
private async showHookInfo(projectPath: string): Promise<number> {
|
||||||
if (!this.target) {
|
if (!this.target) {
|
||||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -264,11 +267,11 @@ export class HookCommand extends Command {
|
|||||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||||
|
|
||||||
if (!hook) {
|
if (!hook) {
|
||||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
this.context.stdout.write(chalk.cyan(`\nHook: ${hook.id}\n`));
|
this.context.stdout.write(colors.cyan(`\nHook: ${hook.id}\n`));
|
||||||
this.context.stdout.write(`Event: ${hook.event}\n`);
|
this.context.stdout.write(`Event: ${hook.event}\n`);
|
||||||
this.context.stdout.write(`Skills: ${hook.skills.join(', ')}\n`);
|
this.context.stdout.write(`Skills: ${hook.skills.join(', ')}\n`);
|
||||||
this.context.stdout.write(`Enabled: ${hook.enabled ? 'Yes' : 'No'}\n`);
|
this.context.stdout.write(`Enabled: ${hook.enabled ? 'Yes' : 'No'}\n`);
|
||||||
@@ -317,7 +320,7 @@ export class HookTemplateListCommand extends Command {
|
|||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`Hook Templates (${templates.length}):\n`));
|
console.log(colors.cyan(`Hook Templates (${templates.length}):\n`));
|
||||||
|
|
||||||
const byCategory = new Map<HookTemplateCategory, HookTemplate[]>();
|
const byCategory = new Map<HookTemplateCategory, HookTemplate[]>();
|
||||||
for (const template of templates) {
|
for (const template of templates) {
|
||||||
@@ -328,17 +331,17 @@ export class HookTemplateListCommand extends Command {
|
|||||||
}
|
}
|
||||||
|
|
||||||
for (const [category, catTemplates] of byCategory) {
|
for (const [category, catTemplates] of byCategory) {
|
||||||
console.log(chalk.blue(` ${formatCategory(category)}`));
|
console.log(colors.info(` ${formatCategory(category)}`));
|
||||||
for (const template of catTemplates) {
|
for (const template of catTemplates) {
|
||||||
const blocking = template.blocking ? chalk.yellow(' [blocking]') : '';
|
const blocking = template.blocking ? colors.warning(' [blocking]') : '';
|
||||||
console.log(` ${chalk.bold(template.id)}${blocking}`);
|
console.log(` ${colors.bold(template.id)}${blocking}`);
|
||||||
console.log(` ${chalk.dim(template.description)}`);
|
console.log(` ${colors.muted(template.description)}`);
|
||||||
console.log(` Event: ${template.event}`);
|
console.log(` Event: ${template.event}`);
|
||||||
}
|
}
|
||||||
console.log();
|
console.log();
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.dim('Apply with: skillkit hook template apply <id>'));
|
console.log(colors.muted('Apply with: skillkit hook template apply <id>'));
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
@@ -361,8 +364,8 @@ export class HookTemplateApplyCommand extends Command {
|
|||||||
const template = getHookTemplate(this.id);
|
const template = getHookTemplate(this.id);
|
||||||
|
|
||||||
if (!template) {
|
if (!template) {
|
||||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
console.log(colors.error(`Template not found: ${this.id}`));
|
||||||
console.log(chalk.dim('Run `skillkit hook template list` to see available templates'));
|
console.log(colors.muted('Run `skillkit hook template list` to see available templates'));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -385,12 +388,12 @@ export class HookTemplateApplyCommand extends Command {
|
|||||||
|
|
||||||
manager.save();
|
manager.save();
|
||||||
|
|
||||||
console.log(chalk.green(`✓ Applied template: ${template.name}`));
|
console.log(colors.success(`✓ Applied template: ${template.name}`));
|
||||||
console.log(` Hook ID: ${hook.id.slice(0, 8)}`);
|
console.log(` Hook ID: ${hook.id.slice(0, 8)}`);
|
||||||
console.log(` Event: ${template.event}`);
|
console.log(` Event: ${template.event}`);
|
||||||
console.log(` Command: ${chalk.dim(template.command)}`);
|
console.log(` Command: ${colors.muted(template.command)}`);
|
||||||
if (template.blocking) {
|
if (template.blocking) {
|
||||||
console.log(chalk.yellow(` Blocking: yes`));
|
console.log(colors.warning(` Blocking: yes`));
|
||||||
}
|
}
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
@@ -411,11 +414,11 @@ export class HookTemplateShowCommand extends Command {
|
|||||||
const template = getHookTemplate(this.id);
|
const template = getHookTemplate(this.id);
|
||||||
|
|
||||||
if (!template) {
|
if (!template) {
|
||||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
console.log(colors.error(`Template not found: ${this.id}`));
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(chalk.cyan(`Template: ${template.name}\n`));
|
console.log(colors.cyan(`Template: ${template.name}\n`));
|
||||||
console.log(`ID: ${template.id}`);
|
console.log(`ID: ${template.id}`);
|
||||||
console.log(`Category: ${template.category}`);
|
console.log(`Category: ${template.category}`);
|
||||||
console.log(`Description: ${template.description}`);
|
console.log(`Description: ${template.description}`);
|
||||||
@@ -426,7 +429,7 @@ export class HookTemplateShowCommand extends Command {
|
|||||||
console.log(`Blocking: ${template.blocking ? 'yes' : 'no'}`);
|
console.log(`Blocking: ${template.blocking ? 'yes' : 'no'}`);
|
||||||
console.log(`Timeout: ${template.timeout || 30000}ms`);
|
console.log(`Timeout: ${template.timeout || 30000}ms`);
|
||||||
console.log();
|
console.log();
|
||||||
console.log(chalk.bold('Command:'));
|
console.log(colors.bold('Command:'));
|
||||||
console.log(` ${template.command}`);
|
console.log(` ${template.command}`);
|
||||||
|
|
||||||
return 0;
|
return 0;
|
||||||
|
|||||||
@@ -125,12 +125,14 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
|
|||||||
// API server
|
// API server
|
||||||
export { ServeCommand } from './serve.js';
|
export { ServeCommand } from './serve.js';
|
||||||
export { ScanCommand } from './scan.js';
|
export { ScanCommand } from './scan.js';
|
||||||
|
export { EvalCommand } from './eval.js';
|
||||||
export { IssuePlanCommand, IssueListCommand } from './issue.js';
|
export { IssuePlanCommand, IssueListCommand } from './issue.js';
|
||||||
export { DoctorCommand } from './doctor.js';
|
export { DoctorCommand } from './doctor.js';
|
||||||
export { TimelineCommand } from './timeline.js';
|
export { TimelineCommand } from './timeline.js';
|
||||||
export { SessionHandoffCommand } from './handoff.js';
|
export { SessionHandoffCommand } from './handoff.js';
|
||||||
export { LineageCommand } from './lineage.js';
|
export { LineageCommand } from './lineage.js';
|
||||||
export { SaveCommand } from './save.js';
|
export { SaveCommand } from './save.js';
|
||||||
|
export { TapAddCommand, TapRemoveCommand, TapListCommand } from './tap.js';
|
||||||
export {
|
export {
|
||||||
AgentsMdCommand,
|
AgentsMdCommand,
|
||||||
AgentsMdInitCommand,
|
AgentsMdInitCommand,
|
||||||
|
|||||||