Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2b63b37ee6 | ||
|
|
57b29014ec |
@@ -1,87 +0,0 @@
|
||||
# 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'
|
||||
```
|
||||
@@ -1,65 +0,0 @@
|
||||
name: 'SkillKit'
|
||||
description: 'Install, scan, and manage AI agent skills in CI/CD'
|
||||
inputs:
|
||||
command:
|
||||
description: 'SkillKit command to run (install, scan, check, sync)'
|
||||
required: true
|
||||
source:
|
||||
description: 'Skill source for install (e.g. owner/repo)'
|
||||
required: false
|
||||
args:
|
||||
description: 'Additional arguments'
|
||||
required: false
|
||||
default: ''
|
||||
node-version:
|
||||
description: 'Node.js version'
|
||||
required: false
|
||||
default: '20'
|
||||
agent:
|
||||
description: 'Target agent (e.g. claude-code, cursor)'
|
||||
required: false
|
||||
default: 'claude-code'
|
||||
|
||||
runs:
|
||||
using: 'composite'
|
||||
steps:
|
||||
- name: Setup Node.js
|
||||
uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: ${{ inputs.node-version }}
|
||||
|
||||
- name: Install SkillKit
|
||||
shell: bash
|
||||
run: npm install -g skillkit@latest
|
||||
|
||||
- name: Run SkillKit
|
||||
shell: bash
|
||||
env:
|
||||
SK_COMMAND: ${{ inputs.command }}
|
||||
SK_SOURCE: ${{ inputs.source }}
|
||||
SK_AGENT: ${{ inputs.agent }}
|
||||
SK_ARGS: ${{ inputs.args }}
|
||||
run: |
|
||||
case "${SK_COMMAND}" in
|
||||
install)
|
||||
if [ -n "${SK_SOURCE}" ]; then
|
||||
skillkit install "${SK_SOURCE}" --agent "${SK_AGENT}" --yes --json ${SK_ARGS}
|
||||
else
|
||||
echo "Error: source is required for install" >&2; exit 1
|
||||
fi
|
||||
;;
|
||||
scan)
|
||||
if [ -n "${SK_SOURCE}" ]; then
|
||||
skillkit scan "${SK_SOURCE}" --json ${SK_ARGS}
|
||||
else
|
||||
echo "Error: source is required for scan" >&2; exit 1
|
||||
fi
|
||||
;;
|
||||
check|sync|list|update)
|
||||
skillkit "${SK_COMMAND}" ${SK_ARGS}
|
||||
;;
|
||||
*)
|
||||
echo "Error: unsupported command '${SK_COMMAND}'. Use: install, scan, check, sync, list, update" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
@@ -1,324 +0,0 @@
|
||||
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"
|
||||
@@ -24,9 +24,8 @@ npm-debug.log*
|
||||
|
||||
# Environment
|
||||
.env
|
||||
**/.env
|
||||
**/.env.local
|
||||
**/.env.*.local
|
||||
.env.local
|
||||
.env.*.local
|
||||
|
||||
# Package manager
|
||||
yarn.lock
|
||||
|
||||
@@ -1,24 +0,0 @@
|
||||
# Changelog
|
||||
|
||||
All notable changes to SkillKit are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions use [Semantic Versioning](https://semver.org/).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
### Added
|
||||
- **Skill integrity verification (`skillkit verify`).** New command computes a deterministic SHA-256 over every file in a skill (excluding metadata, VCS, and editor artifacts) and emits the result as a Subresource Integrity string (`sha256-<base64>`). Supports:
|
||||
- `--expected <sri|hex>` to verify against a known publisher digest
|
||||
- `--against-lock` to verify against the local `~/.skillkit/lock.json` entry
|
||||
- `--files` to dump per-file digests
|
||||
- `--json` for CI pipelines
|
||||
- **`computeSkillIntegrity` / `verifySkillIntegrity`** exported from `@skillkit/core` for programmatic use.
|
||||
- **`integrity` field** in `WellKnownSkill` index. `skillkit publish` now records a full SRI digest for each published skill alongside the file list.
|
||||
- **Lockfile records full integrity.** `skillkit install` and `skillkit update` now persist the full SRI digest to `~/.skillkit/lock.json` (with graceful fallback to the legacy short checksum when integrity computation fails).
|
||||
- Phase 1 of supply-chain integrity (issue #90). Phase 2 (ed25519 signing + publisher key registry) tracked separately.
|
||||
|
||||
### Tests
|
||||
- 11 unit tests for the integrity module (`packages/core/src/integrity/__tests__/integrity.test.ts`).
|
||||
- 5 CLI end-to-end tests for `skillkit verify` (`packages/cli/src/__tests__/verify.test.ts`).
|
||||
|
||||
## [1.24.0] - 2026-04-XX
|
||||
|
||||
See [GitHub releases](https://github.com/rohitg00/skillkit/releases) for prior history.
|
||||
@@ -3,220 +3,106 @@
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
|
||||
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
|
||||
<img alt="SkillKit. One skill. Every agent." src="docs/img/banner.svg" width="100%">
|
||||
<img alt="SkillKit - One Skill. Every Agent." src="docs/img/banner.svg" width="100%">
|
||||
</picture>
|
||||
|
||||
<br/>
|
||||
|
||||
### *One skill. Every agent. 46 of them.*
|
||||
|
||||
<br/>
|
||||
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](LICENSE)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**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. 15,000+ skills in the marketplace.
|
||||
|
||||
<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)
|
||||
[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)
|
||||
|
||||
</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 15,000+ skills, 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">
|
||||
|
||||
https://github.com/user-attachments/assets/b1843a07-2c54-422d-8903-f30a790cfb37
|
||||
[](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
||||
|
||||
*Click the image above to watch the full demo*
|
||||
|
||||
</div>
|
||||
|
||||
## 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.
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
npx skillkit add anthropics/skills
|
||||
npx skillkit@latest init # Detect agents, create dirs
|
||||
skillkit recommend # Get smart suggestions
|
||||
skillkit install anthropics/skills # Install from marketplace
|
||||
skillkit sync # Deploy to your agents
|
||||
```
|
||||
|
||||
That is the whole first-run. Pick your agent (your detected agent is pre-selected), confirm, done.
|
||||
Four commands. Your agents now have skills for PDF processing, code review, and more.
|
||||
|
||||
## Quick start
|
||||
## What Can You Do?
|
||||
|
||||
### Install skills from anywhere
|
||||
|
||||
```bash
|
||||
npx skillkit init # detect agent, create dirs
|
||||
skillkit recommend # stack-aware suggestions
|
||||
skillkit add anthropics/skills # install from marketplace
|
||||
skillkit sync # deploy to agent config
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local path
|
||||
```
|
||||
|
||||
Four commands. Your agent now has PDF processing, code review, auth patterns, and whatever you need.
|
||||
### Translate between agents
|
||||
|
||||
### 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:
|
||||
Write for Claude, deploy to Cursor:
|
||||
|
||||
```bash
|
||||
skillkit translate my-skill --to cursor
|
||||
skillkit translate --all --to windsurf,codex
|
||||
skillkit translate my-skill --to copilot --dry-run
|
||||
skillkit translate --all --to windsurf
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Stack-aware recommendations</b></summary>
|
||||
### Get smart recommendations
|
||||
|
||||
SkillKit reads your repo, spots your stack, ranks skills:
|
||||
SkillKit reads your project, detects your stack, and suggests relevant skills:
|
||||
|
||||
```bash
|
||||
$ skillkit recommend
|
||||
|
||||
92% vercel-react-best-practices
|
||||
87% tailwind-v4-patterns
|
||||
85% nextjs-app-router
|
||||
81% shadcn-ui-components
|
||||
skillkit recommend
|
||||
# 92% vercel-react-best-practices
|
||||
# 87% tailwind-v4-patterns
|
||||
# 85% nextjs-app-router
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Runtime skill discovery (REST)</b></summary>
|
||||
### Discover skills at runtime
|
||||
|
||||
Start the server, let agents fetch skills on demand:
|
||||
Start an API server and let agents find skills on demand:
|
||||
|
||||
```bash
|
||||
skillkit serve
|
||||
# http://localhost:3737
|
||||
# Server running at http://localhost:3737
|
||||
|
||||
curl "http://localhost:3737/search?q=react+performance"
|
||||
```
|
||||
|
||||
Or wire it up with MCP:
|
||||
Or use MCP for native agent integration:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -226,7 +112,11 @@ Or wire it up with MCP:
|
||||
}
|
||||
```
|
||||
|
||||
Or call from Python:
|
||||
Or use Python:
|
||||
|
||||
```bash
|
||||
pip install skillkit-client
|
||||
```
|
||||
|
||||
```python
|
||||
from skillkit import SkillKitClient
|
||||
@@ -235,59 +125,42 @@ async with SkillKitClient() as client:
|
||||
results = await client.search("react performance", limit=5)
|
||||
```
|
||||
|
||||
[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>
|
||||
[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)
|
||||
|
||||
<details>
|
||||
<summary><b>Auto-generate agent instructions</b></summary>
|
||||
### Auto-generate agent instructions
|
||||
|
||||
Analyze the codebase and write CLAUDE.md, `.cursorrules`, AGENTS.md, and friends:
|
||||
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Session memory</b></summary>
|
||||
### Session memory
|
||||
|
||||
AI agents learn during a session, then forget. SkillKit captures what they learned:
|
||||
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
|
||||
|
||||
```bash
|
||||
skillkit memory compress
|
||||
skillkit memory search "auth patterns"
|
||||
skillkit memory export auth-patterns
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>AI skill generation</b></summary>
|
||||
### AI skill generation
|
||||
|
||||
Generate skills from plain English with multi-source context:
|
||||
Generate skills from natural language with multi-source context:
|
||||
|
||||
```bash
|
||||
skillkit generate
|
||||
# Interactive wizard with 4 context sources:
|
||||
# - Documentation (via Context7)
|
||||
# - Your codebase patterns
|
||||
# - 15,000+ marketplace skills
|
||||
# - Memory (your corrections)
|
||||
```
|
||||
|
||||
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>
|
||||
Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
|
||||
|
||||
<details>
|
||||
<summary><b>Team collaboration</b></summary>
|
||||
|
||||
Share skills via a committable `.skills` manifest:
|
||||
|
||||
```bash
|
||||
skillkit manifest init
|
||||
skillkit manifest add anthropics/skills
|
||||
git commit -m "add team skills"
|
||||
```
|
||||
|
||||
Everyone else runs `skillkit manifest install` and matches state.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Mesh network</b></summary>
|
||||
### Mesh network
|
||||
|
||||
Distribute agents across machines with encrypted P2P:
|
||||
|
||||
@@ -295,147 +168,123 @@ Distribute agents across machines with encrypted P2P:
|
||||
skillkit mesh init
|
||||
skillkit mesh discover
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Chrome extension</b></summary>
|
||||
### Team collaboration
|
||||
|
||||
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>`.
|
||||
Share skills via a Git-committable `.skills` manifest:
|
||||
|
||||
```bash
|
||||
skillkit manifest init
|
||||
skillkit manifest add anthropics/skills
|
||||
git commit -m "add team skills"
|
||||
```
|
||||
|
||||
Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
### Chrome Extension
|
||||
|
||||
Save any webpage as a skill directly from your browser.
|
||||
|
||||
1. Build: `pnpm --filter @skillkit/extension build`
|
||||
2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
|
||||
3. Click the extension icon or right-click → "Save page as Skill"
|
||||
|
||||
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.
|
||||
|
||||
[Extension docs](https://skillkit.sh/docs/chrome-extension)
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Interactive TUI</b></summary>
|
||||
### Interactive TUI
|
||||
|
||||
```bash
|
||||
skillkit ui
|
||||
```
|
||||
|
||||
<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>
|
||||
`h` Home · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `q` Quit
|
||||
|
||||
<img src="docs/img/skillkit-ui.png" width="100%" alt="SkillKit interactive TUI">
|
||||

|
||||
|
||||
</details>
|
||||
## Supported Agents (44)
|
||||
|
||||
## Commands
|
||||
| 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/` |
|
||||
|
||||
<details open>
|
||||
<summary><b>Core</b></summary>
|
||||
|
||||
```bash
|
||||
skillkit add <source> # install skills (live progress)
|
||||
skillkit remove <skills> # remove
|
||||
skillkit remove --source org/repo # bulk by source
|
||||
skillkit remove --all # remove everything
|
||||
skillkit update # update (change detection)
|
||||
skillkit check # updates, quality, activity
|
||||
skillkit translate <skill> --to # agent format conversion
|
||||
skillkit sync # deploy to agent config
|
||||
skillkit recommend # smart recommendations
|
||||
skillkit generate # AI skill wizard
|
||||
skillkit serve # REST API server
|
||||
skillkit publish submit # publish to marketplace
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Discovery & security</b></summary>
|
||||
|
||||
```bash
|
||||
skillkit marketplace # browse
|
||||
skillkit tree # taxonomy
|
||||
skillkit find <query> # quick search
|
||||
skillkit scan <path> # security scan
|
||||
skillkit verify <path> # SHA-256 integrity (SRI)
|
||||
skillkit verify <path> --expected sha256-... # verify against published digest
|
||||
skillkit verify <path> --against-lock # verify against ~/.skillkit/lock.json
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Custom sources</b></summary>
|
||||
|
||||
```bash
|
||||
skillkit tap add owner/repo
|
||||
skillkit tap list
|
||||
skillkit tap remove owner/repo
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Issue planner</b></summary>
|
||||
|
||||
```bash
|
||||
skillkit issue plan "#42"
|
||||
skillkit issue plan owner/repo#42
|
||||
skillkit issue list
|
||||
```
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Session intelligence</b></summary>
|
||||
|
||||
```bash
|
||||
skillkit timeline # unified event stream
|
||||
skillkit session handoff # agent-to-agent context
|
||||
skillkit lineage # skill impact graph
|
||||
skillkit session explain # human summary
|
||||
skillkit activity # activity log
|
||||
```
|
||||
</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
|
||||
```
|
||||
</details>
|
||||
|
||||
[Full command reference](https://skillkit.sh/docs/commands)
|
||||
|
||||
## 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>
|
||||
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)
|
||||
|
||||
## Creating skills
|
||||
## Commands
|
||||
|
||||
### Core
|
||||
|
||||
```bash
|
||||
skillkit install <source> # Install skills
|
||||
skillkit remove <skills> # Remove skills
|
||||
skillkit translate <skill> --to # Translate between agents
|
||||
skillkit sync # Deploy to agent config
|
||||
skillkit recommend # Smart recommendations
|
||||
skillkit generate # AI skill generation wizard
|
||||
skillkit serve # Start REST API server
|
||||
```
|
||||
|
||||
### Discovery & Security
|
||||
|
||||
```bash
|
||||
skillkit marketplace # Browse skills
|
||||
skillkit tree # Hierarchical taxonomy
|
||||
skillkit find <query> # Quick search
|
||||
skillkit scan <path> # Security scan for skills
|
||||
```
|
||||
|
||||
### Issue Planner
|
||||
|
||||
```bash
|
||||
skillkit issue plan "#42" # Plan from GitHub Issue
|
||||
skillkit issue plan owner/repo#42 # Cross-repo plan
|
||||
skillkit issue list # List open issues
|
||||
```
|
||||
|
||||
### Session Intelligence
|
||||
|
||||
```bash
|
||||
skillkit timeline # Unified event stream
|
||||
skillkit session handoff # Agent-to-agent context
|
||||
skillkit lineage # Skill impact graph
|
||||
skillkit session explain # Human-readable summary
|
||||
skillkit activity # Skill activity log
|
||||
```
|
||||
|
||||
### Advanced
|
||||
|
||||
```bash
|
||||
skillkit primer --all-agents # Generate agent instructions
|
||||
skillkit memory compress # Capture session learnings
|
||||
skillkit mesh init # Multi-machine distribution
|
||||
skillkit message send # Inter-agent messaging
|
||||
skillkit workflow run <name> # Run workflows
|
||||
skillkit test # Test skills
|
||||
skillkit cicd init # CI/CD templates
|
||||
```
|
||||
|
||||
[Full command reference](https://skillkit.sh/docs/commands)
|
||||
|
||||
## Creating Skills
|
||||
|
||||
```bash
|
||||
skillkit create my-skill
|
||||
```
|
||||
|
||||
Or author a `SKILL.md` by hand:
|
||||
Or manually create a `SKILL.md`:
|
||||
|
||||
```markdown
|
||||
---
|
||||
@@ -446,20 +295,20 @@ license: MIT
|
||||
|
||||
# My Skill
|
||||
|
||||
Instructions for the agent.
|
||||
Instructions for the AI agent.
|
||||
|
||||
## When to use
|
||||
- scenario 1
|
||||
- scenario 2
|
||||
## When to Use
|
||||
- Scenario 1
|
||||
- Scenario 2
|
||||
|
||||
## Steps
|
||||
1. first
|
||||
2. second
|
||||
1. First step
|
||||
2. Second step
|
||||
```
|
||||
|
||||
## Programmatic API
|
||||
|
||||
```ts
|
||||
```typescript
|
||||
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
|
||||
|
||||
const skill = await translateSkill(content, 'cursor');
|
||||
@@ -469,53 +318,53 @@ const engine = new RecommendationEngine();
|
||||
const recs = await engine.recommend(profile);
|
||||
```
|
||||
|
||||
```ts
|
||||
```typescript
|
||||
import { startServer } from '@skillkit/api';
|
||||
await startServer({ port: 3737, skills: [...] });
|
||||
```
|
||||
|
||||
```ts
|
||||
```typescript
|
||||
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
|
||||
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
|
||||
const ranker = new RelevanceRanker();
|
||||
const results = ranker.rank(skills, 'react performance');
|
||||
```
|
||||
|
||||
## Skill sources
|
||||
## Skill Sources
|
||||
|
||||
All original creators credited. Licenses preserved. PRs welcome.
|
||||
SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
|
||||
|
||||
### Official partners
|
||||
### Official Partners
|
||||
|
||||
| Repository | What |
|
||||
|:-----------|:-----|
|
||||
| Repository | Description |
|
||||
|------------|-------------|
|
||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
|
||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js, React |
|
||||
| [expo/skills](https://github.com/expo/skills) | Expo mobile |
|
||||
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video |
|
||||
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database, auth |
|
||||
| [stripe/ai](https://github.com/stripe/ai) | Payments |
|
||||
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
|
||||
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
|
||||
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
|
||||
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
|
||||
| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
|
||||
|
||||
### 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 your skills listed?** [Submit your repo](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md).
|
||||
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
|
||||
|
||||
## Contributing
|
||||
## Install
|
||||
|
||||
Issues and PRs land fast. See [CONTRIBUTING.md](CONTRIBUTING.md) for the short version.
|
||||
```bash
|
||||
npm install -g skillkit # npm
|
||||
pnpm add -g skillkit # pnpm
|
||||
yarn global add skillkit # yarn
|
||||
bun add -g skillkit # bun
|
||||
npx skillkit <command> # no install
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
Apache 2.0. See [LICENSE](LICENSE).
|
||||
Apache License 2.0 — see [LICENSE](LICENSE).
|
||||
|
||||
<br/>
|
||||
## Links
|
||||
|
||||
<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>
|
||||
[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)
|
||||
|
||||
@@ -1,35 +0,0 @@
|
||||
# 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,49 +1,11 @@
|
||||
# SkillKit
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Full install (default) — every feature, everything works:
|
||||
npm install -g skillkit
|
||||
|
||||
# Slim install — core commands only, ~75% smaller, no native addons:
|
||||
npm install -g skillkit --omit=optional
|
||||
```
|
||||
|
||||
### What's optional
|
||||
|
||||
Four power features ship as **optional dependencies** so the core CLI
|
||||
stays lean. They install automatically with `npm install -g skillkit`,
|
||||
and are skipped with `--omit=optional`:
|
||||
|
||||
| Feature | Package | Command |
|
||||
| ------------------------ | -------------------- | ------------------------------ |
|
||||
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
|
||||
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
|
||||
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
|
||||
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
|
||||
|
||||
Add one later with `npm install -g @skillkit/tui` (or `api` / `mesh` / `messaging`).
|
||||
|
||||
### Using `npx`
|
||||
|
||||
`npx skillkit add <owner/repo>` works with zero install. First run pulls
|
||||
the package into the npx cache (`~/.npm/_npx/`); every subsequent run
|
||||
from the same cache is instant.
|
||||
|
||||
```bash
|
||||
npx skillkit add anthropics/skills # full
|
||||
npx --omit=optional skillkit add anthropics/skills # slim, 118 pkgs, 9 s
|
||||
```
|
||||
|
||||
Running `npx` more than a couple of times? Install globally — no
|
||||
prompt-to-proceed, no refetch on each release:
|
||||
|
||||
```bash
|
||||
npm install -g skillkit --omit=optional
|
||||
skillkit add anthropics/skills
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
@@ -188,11 +150,11 @@ skillkit memory compress
|
||||
skillkit memory export auth-insight --output auth-skill.md
|
||||
```
|
||||
|
||||
## Supported Agents (46)
|
||||
## Supported Agents (32)
|
||||
|
||||
**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
|
||||
**Primary (17):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
|
||||
**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
|
||||
**Extended (15):** Cline, CodeBuddy, CommandCode, Continue, Crush, Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Vercel, Zencoder
|
||||
|
||||
## Usage Examples
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.24.0",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 41 more",
|
||||
"version": "1.19.2",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
"skillkit": "./dist/cli.js",
|
||||
@@ -53,16 +53,15 @@
|
||||
"node": ">=18.0.0"
|
||||
},
|
||||
"dependencies": {
|
||||
"@skillkit/api": "workspace:*",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"@skillkit/agents": "workspace:*",
|
||||
"@skillkit/cli": "workspace:*",
|
||||
"clipanion": "^4.0.0-rc.4"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@skillkit/api": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
"@skillkit/memory": "workspace:*",
|
||||
"@skillkit/mesh": "workspace:*",
|
||||
"@skillkit/messaging": "workspace:*"
|
||||
"@skillkit/messaging": "workspace:*",
|
||||
"clipanion": "^4.0.0-rc.4"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
|
||||
@@ -3,8 +3,6 @@ import { readFileSync } from 'node:fs';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { Cli, Builtins } from 'clipanion';
|
||||
import { setVersion, setAgentCount } from '@skillkit/cli';
|
||||
import { getAdapterCount } from '@skillkit/agents';
|
||||
import {
|
||||
InstallCommand,
|
||||
SyncCommand,
|
||||
@@ -112,8 +110,6 @@ import {
|
||||
SkillMdCheckCommand,
|
||||
ServeCommand,
|
||||
ScanCommand,
|
||||
VerifyCommand,
|
||||
EvalCommand,
|
||||
DoctorCommand,
|
||||
SaveCommand,
|
||||
AgentsMdCommand,
|
||||
@@ -125,9 +121,6 @@ import {
|
||||
TimelineCommand,
|
||||
SessionHandoffCommand,
|
||||
LineageCommand,
|
||||
TapAddCommand,
|
||||
TapRemoveCommand,
|
||||
TapListCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -136,9 +129,6 @@ const packageJsonPath = join(__dirname, '../package.json');
|
||||
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
|
||||
const version = packageJson.version || '1.2.0';
|
||||
|
||||
setVersion(version);
|
||||
setAgentCount(getAdapterCount());
|
||||
|
||||
const cli = new Cli({
|
||||
binaryLabel: 'skillkit',
|
||||
binaryName: 'skillkit',
|
||||
@@ -266,8 +256,6 @@ cli.register(SkillMdCheckCommand);
|
||||
|
||||
cli.register(ServeCommand);
|
||||
cli.register(ScanCommand);
|
||||
cli.register(VerifyCommand);
|
||||
cli.register(EvalCommand);
|
||||
cli.register(DoctorCommand);
|
||||
cli.register(SaveCommand);
|
||||
cli.register(AgentsMdCommand);
|
||||
@@ -282,8 +270,4 @@ cli.register(TimelineCommand);
|
||||
cli.register(SessionHandoffCommand);
|
||||
cli.register(LineageCommand);
|
||||
|
||||
cli.register(TapAddCommand);
|
||||
cli.register(TapRemoveCommand);
|
||||
cli.register(TapListCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
@@ -1,7 +1,6 @@
|
||||
// Re-export all public APIs from packages
|
||||
export * from '@skillkit/core';
|
||||
export * from '@skillkit/agents';
|
||||
|
||||
export async function startTUI(...args: unknown[]): Promise<unknown> {
|
||||
const mod = await import('@skillkit/tui');
|
||||
return mod.startTUI(...(args as Parameters<typeof mod.startTUI>));
|
||||
}
|
||||
// Re-export TUI entry point
|
||||
export { startTUI } from '@skillkit/tui';
|
||||
|
||||
@@ -7,7 +7,4 @@ export default defineConfig({
|
||||
splitting: false,
|
||||
sourcemap: true,
|
||||
clean: true,
|
||||
platform: 'node',
|
||||
target: 'node18',
|
||||
skipNodeModulesBundle: true,
|
||||
});
|
||||
|
||||
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 804 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 454 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 452 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 813 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 459 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 804 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 820 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 448 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 804 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 453 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 454 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 459 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 810 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 459 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 813 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 460 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 807 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 808 B |
@@ -1,5 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 452 B |
@@ -1,10 +0,0 @@
|
||||
<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>
|
||||
|
Before Width: | Height: | Size: 803 B |
@@ -1,11 +1,11 @@
|
||||
---
|
||||
title: Supported Agents
|
||||
description: 45 AI coding agents supported by SkillKit
|
||||
description: 44 AI coding agents supported by SkillKit
|
||||
---
|
||||
|
||||
# Supported Agents
|
||||
|
||||
SkillKit uses an adapter pattern to support 45 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
||||
SkillKit uses an adapter pattern to support 44 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
||||
|
||||
## Agent Directory Mapping
|
||||
|
||||
|
||||
@@ -70,24 +70,11 @@ skillkit install anthropics/skills --agent claude --agent cursor
|
||||
skillkit remove <skill-names> [options]
|
||||
```
|
||||
|
||||
| Option | Short | Purpose |
|
||||
|--------|-------|---------|
|
||||
| `--agent` | — | Target specific agents (default: all) |
|
||||
| `--yes` | — | Skip confirmation |
|
||||
| `--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.
|
||||
| Option | Purpose |
|
||||
|--------|---------|
|
||||
| `--agent` | Target specific agents (default: all) |
|
||||
| `--yes` | Skip confirmation |
|
||||
| `--keep-metadata` | Remove skill but preserve metadata |
|
||||
|
||||
## Update Command
|
||||
|
||||
@@ -95,19 +82,11 @@ When using `--source`, SkillKit matches against the source field in each skill's
|
||||
skillkit update [skill-names] [options]
|
||||
```
|
||||
|
||||
| Option | Short | Purpose |
|
||||
|--------|-------|---------|
|
||||
| `--dry-run` | — | Check for updates without installing |
|
||||
| `--yes` | — | Skip confirmation prompts |
|
||||
| `--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.
|
||||
| Option | Purpose |
|
||||
|--------|---------|
|
||||
| `--dry-run` | Check for updates without installing |
|
||||
| `--yes` | Skip confirmation prompts |
|
||||
| `--agent` | Update in specific agents only |
|
||||
|
||||
## Enable/Disable Commands
|
||||
|
||||
@@ -118,26 +97,6 @@ skillkit disable <skill-names> [options]
|
||||
|
||||
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
|
||||
|
||||
```bash
|
||||
@@ -498,48 +457,6 @@ skillkit publish --dry-run # Preview without writing
|
||||
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
|
||||
|
||||
```bash
|
||||
@@ -573,23 +490,6 @@ Skills are automatically scanned during `skillkit install`. Use `--no-scan` to s
|
||||
- `table` - tabular format
|
||||
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
|
||||
|
||||
## Integrity Verification
|
||||
|
||||
```bash
|
||||
skillkit verify <path> # Print SRI digest (sha256-<base64>)
|
||||
skillkit verify <path> --files # Show per-file digests
|
||||
skillkit verify <path> --format hex # Print raw 64-char hex digest
|
||||
skillkit verify <path> --json # Machine-readable JSON
|
||||
skillkit verify <path> --expected sha256-... # Verify against a known publisher digest
|
||||
skillkit verify <path> --against-lock # Verify against ~/.skillkit/lock.json
|
||||
```
|
||||
|
||||
`skillkit verify` computes a deterministic SHA-256 over every file in the skill (excluding `.skillkit.json` metadata, VCS artifacts, and editor noise) and emits a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string. The digest matches the `integrity` field that `skillkit publish` writes into `.well-known/skills/index.json`, so a downstream consumer can detect tampering between publish and install.
|
||||
|
||||
`skillkit install` and `skillkit update` automatically record the full SRI digest into `~/.skillkit/lock.json`, enabling `--against-lock` audits in CI pipelines and supply-chain workflows.
|
||||
|
||||
**Exit codes:** `0` on match, `1` on mismatch, missing path, or malformed `--expected` value.
|
||||
|
||||
## Interactive TUI
|
||||
|
||||
```bash
|
||||
|
||||
@@ -152,61 +152,11 @@ primer:
|
||||
- .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
|
||||
|
||||
```
|
||||
~/.skillkit/
|
||||
├── preferences.json # User preferences
|
||||
├── lock.json # Installed skill tracking
|
||||
├── taps.json # Custom skill sources
|
||||
├── cache/ # Marketplace cache
|
||||
├── memory/ # Learning storage
|
||||
│ ├── observations/
|
||||
|
||||
@@ -29,7 +29,7 @@ skillkit/
|
||||
│ ├── core/ # Business logic
|
||||
│ ├── cli/ # CLI
|
||||
│ ├── tui/ # Terminal UI
|
||||
│ └── agents/ # 45 adapters
|
||||
│ └── agents/ # 44 adapters
|
||||
├── marketplace/ # Skills data
|
||||
│ ├── skills.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.
|
||||
|
||||
SkillKit fixes this. Write a skill once, deploy it to all 45 agents.
|
||||
SkillKit fixes this. Write a skill once, deploy it to all 44 agents.
|
||||
|
||||
## Get Started
|
||||
|
||||
@@ -31,10 +31,9 @@ Four commands. Your agents now have skills for PDF processing, code review, and
|
||||
### Install skills from anywhere
|
||||
|
||||
```bash
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install skills.sh/owner/repo/skill # skills.sh registry
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local
|
||||
```
|
||||
|
||||
### Translate between agents
|
||||
@@ -95,26 +94,23 @@ SkillKit sits between your skills and your agents. It handles format translation
|
||||
|
||||
## Supported Agents
|
||||
|
||||
45 agents and counting:
|
||||
44 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
|
||||
|
||||
[Full agent details](/docs/agents)
|
||||
|
||||
### Security & integrity
|
||||
### Security scanning
|
||||
|
||||
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more — and content integrity is verifiable against the publisher digest:
|
||||
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more:
|
||||
|
||||
```bash
|
||||
skillkit scan ./my-skill # 46+ detection rules
|
||||
skillkit scan ./my-skill --format sarif # GitHub Code Scanning
|
||||
skillkit scan ./my-skill --fail-on high # CI gate
|
||||
|
||||
skillkit verify ./my-skill # SHA-256 SRI digest
|
||||
skillkit verify ./my-skill --against-lock # Detect supply-chain tampering
|
||||
```
|
||||
|
||||
[Security & Integrity](/docs/security)
|
||||
[Security Scanner](/docs/security)
|
||||
|
||||
## Beyond Basic Skills
|
||||
|
||||
@@ -171,11 +167,10 @@ Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
- [Installation](/docs/installation) — Install and configure
|
||||
- [Quick Start](/docs/quickstart) — First project setup
|
||||
- [Methodology Packs](/docs/methodology) — Debugging, testing, planning skills
|
||||
- [Security & Integrity](/docs/security) — Threat detection plus SHA-256 content verification
|
||||
- [Security Scanner](/docs/security) — Threat detection for skills
|
||||
- [Commands](/docs/commands) — Full CLI reference
|
||||
- [REST API](/docs/rest-api) — Runtime discovery server
|
||||
- [MCP Server](/docs/mcp-server) — Agent-native discovery
|
||||
- [Python Client](/docs/python-client) — Python SDK
|
||||
|
||||
**Current version:** v1.19.2 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
|
||||
**Current version:** v1.18.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
|
||||
|
||||
@@ -33,61 +33,6 @@ bun add -g skillkit
|
||||
|
||||
Both `skillkit` and `sk` work as command aliases.
|
||||
|
||||
## Full vs slim install
|
||||
|
||||
SkillKit ships four power features as **optional dependencies** so the
|
||||
core install stays small. The default `npm install -g skillkit` installs
|
||||
every feature; `--omit=optional` installs only the core CLI.
|
||||
|
||||
| Feature | Package | Command |
|
||||
| ------------------------ | -------------------- | ------------------------------ |
|
||||
| Interactive terminal UI | `@skillkit/tui` | `skillkit ui` / `skillkit tui` |
|
||||
| REST/OpenAPI server | `@skillkit/api` | `skillkit serve` |
|
||||
| Peer mesh networking | `@skillkit/mesh` | `skillkit mesh …` |
|
||||
| Inter-agent messaging | `@skillkit/messaging`| `skillkit message …` |
|
||||
|
||||
```bash
|
||||
# Full (default) — every feature works out of the box:
|
||||
npm install -g skillkit
|
||||
|
||||
# Slim — core commands only, ~75% smaller, no native addons, 0 deprecation warnings:
|
||||
npm install -g skillkit --omit=optional
|
||||
```
|
||||
|
||||
Add one later:
|
||||
|
||||
```bash
|
||||
npm install -g @skillkit/tui # enables: skillkit ui
|
||||
npm install -g @skillkit/api # enables: skillkit serve
|
||||
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||
npm install -g @skillkit/messaging # enables: skillkit message
|
||||
```
|
||||
|
||||
The CLI catches a missing optional feature and prints a one-line hint,
|
||||
so you'll never see an unhandled stack trace.
|
||||
|
||||
## Using `npx`
|
||||
|
||||
`npx skillkit add <owner/repo>` runs without a global install. First run
|
||||
downloads into the npx cache (`~/.npm/_npx/`); every call after that is
|
||||
instant until the cache expires or a new version ships.
|
||||
|
||||
```bash
|
||||
# Full — every feature works:
|
||||
npx skillkit add anthropics/skills
|
||||
|
||||
# Slim — core commands only, 75% fewer packages, 0 warnings:
|
||||
npx --omit=optional skillkit add anthropics/skills
|
||||
```
|
||||
|
||||
If you use `npx skillkit` more than a couple of times, install globally
|
||||
to skip the prompt-to-proceed and avoid the per-release cache refetch:
|
||||
|
||||
```bash
|
||||
npm install -g skillkit --omit=optional
|
||||
skillkit add anthropics/skills
|
||||
```
|
||||
|
||||
## Verify
|
||||
|
||||
```bash
|
||||
@@ -113,7 +58,7 @@ The init command:
|
||||
|
||||
```bash
|
||||
skillkit init --agent cursor
|
||||
skillkit init --list # Show all 45 supported agents
|
||||
skillkit init --list # Show all 44 supported agents
|
||||
skillkit init --quiet # Skip logo and prompts (for CI)
|
||||
```
|
||||
|
||||
|
||||
@@ -14,7 +14,6 @@
|
||||
"recommendations",
|
||||
"primer",
|
||||
"memory",
|
||||
"methodology",
|
||||
"mesh",
|
||||
"messaging",
|
||||
"workflows",
|
||||
|
||||
@@ -1,93 +0,0 @@
|
||||
---
|
||||
title: Methodology Packs
|
||||
description: Curated skill packs for debugging, testing, planning, and collaboration
|
||||
---
|
||||
|
||||
# Methodology Packs
|
||||
|
||||
Methodology packs are curated collections of skills that guide AI agents through structured workflows. Each pack bundles related skills around a domain — debugging, testing, planning, or collaboration.
|
||||
|
||||
## Available Packs
|
||||
|
||||
| Pack | Skills | Description |
|
||||
|------|--------|-------------|
|
||||
| **debugging** | root-cause-analysis, trace-and-isolate, hypothesis-testing | Systematic bug investigation |
|
||||
| **testing** | red-green-refactor, test-patterns, anti-patterns | Test-driven development |
|
||||
| **planning** | design-first, task-decomposition, verification-gates | Design and decomposition |
|
||||
| **collaboration** | structured-review, parallel-investigation, handoff-protocols | Code review and handoffs |
|
||||
| **meta** | skill-authoring | Writing effective skills |
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
skillkit methodology list # List available packs
|
||||
skillkit methodology install debugging # Install a pack
|
||||
skillkit methodology apply testing # Apply pack to current project
|
||||
skillkit methodology validate planning # Validate pack skills
|
||||
skillkit methodology load collaboration # Load pack into agent context
|
||||
```
|
||||
|
||||
## Pack Structure
|
||||
|
||||
Each pack lives under `packages/core/src/methodology/packs/` with this structure:
|
||||
|
||||
```
|
||||
packs/
|
||||
debugging/
|
||||
pack.json # Pack manifest (name, skills, tags)
|
||||
root-cause-analysis/
|
||||
SKILL.md # Skill content
|
||||
trace-and-isolate/
|
||||
SKILL.md
|
||||
hypothesis-testing/
|
||||
SKILL.md
|
||||
```
|
||||
|
||||
## Skills Reference
|
||||
|
||||
### Debugging
|
||||
|
||||
- **root-cause-analysis** — Five Whys method, structured investigation phases, evidence collection, causal chain verification
|
||||
- **trace-and-isolate** — Binary search debugging, git bisect, strategic logging, component isolation, minimal reproduction
|
||||
- **hypothesis-testing** — Scientific method for debugging: observe, hypothesize, predict, test, conclude
|
||||
|
||||
### Testing
|
||||
|
||||
- **red-green-refactor** — Write a failing test, make it pass with minimal code, then refactor while green
|
||||
- **test-patterns** — AAA, Given-When-Then, Test Data Builders, Object Mother, parameterized tests, fixtures, spies
|
||||
- **anti-patterns** — Flaky tests, over-mocking, brittle assertions, test interdependency, hidden logic
|
||||
|
||||
### Planning
|
||||
|
||||
- **design-first** — Technical design documents before code: architecture, data models, API definitions, trade-off analysis
|
||||
- **task-decomposition** — Vertical slicing, horizontal layering, workflow and component decomposition
|
||||
- **verification-gates** — Validation checkpoints between phases with checklists and approval criteria
|
||||
|
||||
### Collaboration
|
||||
|
||||
- **structured-review** — Five-stage code review: requirements, correctness, quality, testing, security
|
||||
- **parallel-investigation** — Coordinate multiple investigation threads with sync points and convergence decisions
|
||||
- **handoff-protocols** — Structured work transitions: planned, unplanned, and partial handoffs
|
||||
|
||||
### Meta
|
||||
|
||||
- **skill-authoring** — Guidelines for writing SKILL.md files: frontmatter, triggers, directive language, content patterns
|
||||
|
||||
## Using with Agents
|
||||
|
||||
Once installed, methodology skills activate automatically based on trigger phrases. For example:
|
||||
|
||||
```
|
||||
You: "I need to debug this failing API endpoint"
|
||||
Agent: [Activates root-cause-analysis skill]
|
||||
|
||||
You: "Let's write tests first for this feature"
|
||||
Agent: [Activates red-green-refactor skill]
|
||||
|
||||
You: "Break down this feature into tasks"
|
||||
Agent: [Activates task-decomposition skill]
|
||||
```
|
||||
|
||||
## TUI Integration
|
||||
|
||||
Access methodology packs from the TUI by pressing `o` (Methodology screen). Browse, install, and apply packs interactively.
|
||||
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
|
||||
|
||||
# Primer
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -16,7 +16,7 @@ skillkit primer
|
||||
# Generate for specific agents
|
||||
skillkit primer --agent claude,cursor,windsurf
|
||||
|
||||
# Generate for all 45 agents
|
||||
# Generate for all 44 agents
|
||||
skillkit primer --all-agents
|
||||
|
||||
# Preview without writing files
|
||||
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
|
||||
└── copilot-instructions.md
|
||||
```
|
||||
|
||||
### All 45 Agents
|
||||
### All 44 Agents
|
||||
Each agent gets optimized instructions in their native format.
|
||||
|
||||
## Example Output
|
||||
|
||||
@@ -158,7 +158,7 @@ curl http://localhost:3737/health
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
"version": "1.19.2",
|
||||
"version": "1.12.0",
|
||||
"skillCount": 15062,
|
||||
"uptime": 3600
|
||||
}
|
||||
|
||||
@@ -1,16 +1,11 @@
|
||||
---
|
||||
title: Security & Integrity
|
||||
description: Scan skills for malicious patterns, verify content integrity, and lock against supply-chain tampering
|
||||
title: Security Scanner
|
||||
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
|
||||
---
|
||||
|
||||
# Security & Integrity
|
||||
# Security Scanner
|
||||
|
||||
SkillKit ships two complementary supply-chain defenses:
|
||||
|
||||
1. **`skillkit scan`** — static security scanner detecting prompt injection, command injection, data exfiltration, hardcoded secrets, tool abuse, and unicode steganography (46+ rules).
|
||||
2. **`skillkit verify`** — SHA-256 content-integrity check that compares the locally installed skill against the publisher's recorded digest (full SRI, recorded automatically in `~/.skillkit/lock.json`).
|
||||
|
||||
Run `scan` to ask _"is this skill dangerous?"_. Run `verify` to ask _"is this skill what the publisher actually shipped?"_.
|
||||
SkillKit includes a built-in security scanner that analyzes skills for prompt injection, command injection, data exfiltration, hardcoded secrets, and other threats before installation.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -247,28 +242,6 @@ console.log(`Findings: ${result.findings.length}`);
|
||||
| **Low** | 1 (with `--fail-on low`) | Minor issue or best practice |
|
||||
| **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
|
||||
|
||||
The scanner automatically filters:
|
||||
@@ -284,42 +257,3 @@ To skip specific rules:
|
||||
```bash
|
||||
skillkit scan . --skip-rules UC001,UC002,MF004
|
||||
```
|
||||
|
||||
## Integrity Verification (`skillkit verify`)
|
||||
|
||||
`skillkit verify` is the supply-chain counterpart to `skillkit scan`. The scanner answers _"is this skill dangerous?"_; `verify` answers _"is this skill what the publisher actually shipped?"_.
|
||||
|
||||
```bash
|
||||
skillkit verify ./my-skill # Print SRI digest
|
||||
skillkit verify ./my-skill --expected sha256-iQo/... # Compare against publisher digest
|
||||
skillkit verify ./my-skill --against-lock # Compare against ~/.skillkit/lock.json
|
||||
skillkit verify ./my-skill --json # JSON for CI pipelines
|
||||
```
|
||||
|
||||
### How the digest is computed
|
||||
|
||||
`verify` walks every file in the skill in deterministic alphabetical order, computes SHA-256 per file, and rolls those file hashes (plus their POSIX-normalized relative paths) into a single SHA-256 digest, emitted as a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string of the form `sha256-<base64>`. Skipped: `.skillkit.json`, `.DS_Store`, `.git`, `node_modules`, `dist`, `.turbo`, and any `*.skillkit.json` sidecar.
|
||||
|
||||
Because file _paths_ feed the hash alongside _content_, renaming, adding, or removing a file all change the digest — not just edits to file bodies.
|
||||
|
||||
### Publish, install, and lock integration
|
||||
|
||||
- `skillkit publish` writes the digest into the `integrity` field of `.well-known/skills/index.json` for every published skill.
|
||||
- `skillkit install` records the full SRI digest into `~/.skillkit/lock.json` (falling back to the legacy short checksum only if integrity computation fails).
|
||||
- `skillkit update` refreshes the lock entry on successful update.
|
||||
|
||||
### CI usage
|
||||
|
||||
```yaml
|
||||
- name: Verify all installed skills
|
||||
run: |
|
||||
for skill in .claude/skills/*/; do
|
||||
npx skillkit verify "$skill" --against-lock --json
|
||||
done
|
||||
```
|
||||
|
||||
Exit codes: `0` on match, `1` on mismatch, missing path, or malformed `--expected` value. Reason codes in JSON output: `mismatch`, `invalid-expected-format`, `missing-expected`, `no-lock-entry`.
|
||||
|
||||
### Roadmap
|
||||
|
||||
Cryptographic skill signing (ed25519 publisher keys + verified-publisher registry) is tracked separately as Phase 2 of [#90](https://github.com/rohitg00/skillkit/issues/90). Phase 1 (content integrity) is shipping now in response to the ClawHavoc supply-chain campaign and OWASP Agentic Skills Top 10 guidance.
|
||||
|
||||
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
|
||||
|
||||
# Translation
|
||||
|
||||
SkillKit automatically converts between all 45 agent formats using an adapter pattern.
|
||||
SkillKit automatically converts between all 44 agent formats using an adapter pattern.
|
||||
|
||||
## Basic Translation
|
||||
|
||||
|
||||
@@ -8,34 +8,6 @@ const config = {
|
||||
trailingSlash: false,
|
||||
skipTrailingSlashRedirect: true,
|
||||
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);
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.24.0",
|
||||
"version": "1.19.2",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -1,138 +0,0 @@
|
||||
# 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
|
||||
@@ -18,7 +18,7 @@ export default function HomePage() {
|
||||
|
||||
<p className="text-lg text-zinc-400 mb-8 max-w-2xl mx-auto font-mono">
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
|
||||
Windsurf, Copilot, and 40 more agents. 15,000+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap justify-center gap-4 mb-12">
|
||||
@@ -39,12 +39,12 @@ export default function HomePage() {
|
||||
{/* Features Grid */}
|
||||
<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">
|
||||
<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 40 more supported out of the box.</p>
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">44 Agents</h3>
|
||||
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.</p>
|
||||
</div>
|
||||
<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>
|
||||
<p className="text-zinc-500 text-sm">Aggregated from 34+ registries and repositories. Install with a single command.</p>
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">15,000+ Skills</h3>
|
||||
<p className="text-zinc-500 text-sm">Browse the marketplace or create your own. Install with a single command.</p>
|
||||
</div>
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">Auto Translation</h3>
|
||||
|
||||
@@ -13,7 +13,7 @@ export const metadata: Metadata = {
|
||||
default: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
template: '%s | SkillKit',
|
||||
},
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.',
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.',
|
||||
icons: {
|
||||
icon: [
|
||||
{ url: '/favicon.svg', type: 'image/svg+xml' },
|
||||
|
||||
@@ -18,7 +18,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{
|
||||
name: 'Discovery',
|
||||
commands: [
|
||||
{ cmd: 'find', desc: 'Search marketplace (400K+ skills)' },
|
||||
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
|
||||
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
|
||||
{ cmd: 'check', desc: 'Dry-run update check' },
|
||||
{ cmd: 'list', desc: 'View installed skills' },
|
||||
|
||||
@@ -44,12 +44,12 @@ const sections: DocSection[] = [
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
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.
|
||||
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.
|
||||
</p>
|
||||
<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">
|
||||
<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 46 agent-specific formats</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace 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">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -61,42 +61,14 @@ const sections: DocSection[] = [
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
||||
<CodeBlock>{`# Full install — every feature works out of the box (default):
|
||||
<CodeBlock>{`# Install globally via npm
|
||||
npm install -g skillkit
|
||||
|
||||
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
|
||||
npm install -g skillkit --omit=optional
|
||||
# Or use npx directly
|
||||
npx skillkit --help
|
||||
|
||||
# Or use npx directly:
|
||||
npx skillkit --help`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
|
||||
dependencies. They install by default, or add later à la carte:
|
||||
</p>
|
||||
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
|
||||
npm install -g @skillkit/api # enables: skillkit serve
|
||||
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
<code className="text-zinc-200">npx skillkit add <owner/repo></code> runs with zero install.
|
||||
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
|
||||
run after that is instant until a new version ships.
|
||||
</p>
|
||||
<CodeBlock>{`# Full (default):
|
||||
npx skillkit add anthropics/skills
|
||||
|
||||
# Slim — core only, 75% fewer packages, 0 warnings:
|
||||
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
Using npx more than a couple times? Install globally to skip the
|
||||
prompt-to-proceed and avoid the per-release cache refetch:
|
||||
</p>
|
||||
<CodeBlock>{`npm install -g skillkit --omit=optional
|
||||
skillkit add anthropics/skills`}</CodeBlock>
|
||||
# Or install via pnpm
|
||||
pnpm add -g skillkit`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
||||
<CodeBlock>{`skillkit --version
|
||||
@@ -130,7 +102,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
<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">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 46 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -158,7 +130,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Multi-Agent',
|
||||
description: 'Deploy to 46 AI coding agents with one command.',
|
||||
description: 'Deploy to 44 AI coding agents with one command.',
|
||||
icon: (
|
||||
<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" />
|
||||
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agents', '1', '46'],
|
||||
['Agents', '1', '44'],
|
||||
['Translation', 'Manual', 'Auto'],
|
||||
['Sharing', 'Copy/paste', '.skills manifest'],
|
||||
['Discovery', 'Forums', 'CLI + AI'],
|
||||
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
|
||||
</p>
|
||||
<div className="flex gap-6 sm:gap-8">
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">46</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
|
||||
@@ -135,7 +135,7 @@ export function Hero(): React.ReactElement {
|
||||
|
||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
|
||||
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-3 mb-4">
|
||||
|
||||
@@ -1,22 +0,0 @@
|
||||
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,82 +1,70 @@
|
||||
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#09090b"/>
|
||||
<stop offset="50%" style="stop-color:#111115"/>
|
||||
<stop offset="100%" style="stop-color:#09090b"/>
|
||||
<stop offset="0%" style="stop-color:#0a0a0a"/>
|
||||
<stop offset="50%" style="stop-color:#111111"/>
|
||||
<stop offset="100%" style="stop-color:#0a0a0a"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||
<stop offset="0%" style="stop-color:#27272a"/>
|
||||
<stop offset="50%" style="stop-color:#3f3f46"/>
|
||||
<stop offset="100%" style="stop-color:#27272a"/>
|
||||
<stop offset="0%" style="stop-color:#333"/>
|
||||
<stop offset="50%" style="stop-color:#555"/>
|
||||
<stop offset="100%" style="stop-color:#333"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#27272a"/>
|
||||
<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"/>
|
||||
<stop offset="0%" style="stop-color:#2a2a2a"/>
|
||||
<stop offset="100%" style="stop-color:#1a1a1a"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
|
||||
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
|
||||
<rect x="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
|
||||
<line x1="60" y1="354" x2="1140" y2="354" stroke="#1f1f23" stroke-width="1"/>
|
||||
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
|
||||
|
||||
<g transform="translate(60, 72)">
|
||||
<rect width="16" height="16" fill="white" rx="2"/>
|
||||
</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="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)">
|
||||
<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="#71717a" stroke-width="1.5"/>
|
||||
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
|
||||
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" 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="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="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="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
||||
</g>
|
||||
|
||||
<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="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="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>
|
||||
<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>
|
||||
|
||||
<g transform="translate(240, 280)">
|
||||
<rect width="280" height="40" fill="#18181b" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#71717a">$</text>
|
||||
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#e4e4e7">npm i -g skillkit</text>
|
||||
<g transform="translate(240, 282)">
|
||||
<rect width="260" height="38" fill="#1a1a1a" stroke="#333" 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="32" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</text>
|
||||
</g>
|
||||
|
||||
<g transform="translate(540, 280)">
|
||||
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||
<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 transform="translate(520, 282)">
|
||||
<rect width="150" height="38" fill="transparent" stroke="#444" 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>
|
||||
</g>
|
||||
|
||||
<g transform="translate(700, 280)">
|
||||
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||
<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 transform="translate(690, 282)">
|
||||
<rect width="140" height="38" fill="transparent" stroke="#444" 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>
|
||||
</g>
|
||||
|
||||
<g transform="translate(860, 280)">
|
||||
<rect width="110" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
|
||||
<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 transform="translate(850, 282)">
|
||||
<rect width="120" height="38" fill="transparent" stroke="#444" 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>
|
||||
</g>
|
||||
|
||||
<g transform="translate(60, 374)">
|
||||
<circle cx="5" cy="5" r="3" fill="#71717a"/>
|
||||
<circle cx="15" cy="5" r="3" fill="#52525b"/>
|
||||
<circle cx="25" cy="5" r="3" fill="#3f3f46"/>
|
||||
<circle cx="35" cy="5" r="3" fill="#27272a"/>
|
||||
<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 transform="translate(60, 370)">
|
||||
<circle cx="5" cy="5" r="3" fill="#666"/>
|
||||
<circle cx="15" cy="5" r="3" fill="#555"/>
|
||||
<circle cx="25" cy="5" r="3" fill="#444"/>
|
||||
<circle cx="35" cy="5" r="3" fill="#333"/>
|
||||
<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>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 4.8 KiB After Width: | Height: | Size: 3.9 KiB |
@@ -15,7 +15,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
id: 'generate',
|
||||
title: 'AI Generate',
|
||||
subtitle: 'Create Skills from Natural Language',
|
||||
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 400K+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
|
||||
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 15,000+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
|
||||
highlight: 'Multi-provider AI with 4 context sources',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
@@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
id: 'primer',
|
||||
title: 'Primer',
|
||||
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 46 agents.',
|
||||
highlight: 'Auto-generates instructions for 46 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 44 agents.',
|
||||
highlight: 'Auto-generates instructions for 44 agents',
|
||||
icon: (
|
||||
<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" />
|
||||
@@ -78,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 46 agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 44 agents' },
|
||||
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
||||
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
||||
],
|
||||
|
||||
@@ -293,123 +293,6 @@ const AGENTS: Agent[] = [
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Devin",
|
||||
url: "https://devin.ai",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M35 35h10c8.284 0 15 6.716 15 15s-6.716 15-15 15H35V35zm6 6v18h4c4.97 0 9-4.03 9-9s-4.03-9-9-9h-4z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Aider",
|
||||
url: "https://aider.chat",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33l-17 34h8l3-6h12l3 6h8L50 33zm0 12l4 10h-8l4-10z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Cody",
|
||||
url: "https://sourcegraph.com/cody",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm-7 21l-3-4 3-4 3 4-3 4zm7 5l-3-4 3-4 3 4-3 4zm7-5l-3-4 3-4 3 4-3 4z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Amazon Q",
|
||||
url: "https://aws.amazon.com/q",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17c3.144 0 6.09-.855 8.618-2.343l4.725 4.725 4.243-4.243-4.725-4.725A16.928 16.928 0 0067 50c0-9.389-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Augment",
|
||||
url: "https://augmentcode.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6v8h-8v6h8v8h6v-8h8v-6h-8v-8h-6z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Replit",
|
||||
url: "https://replit.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M40 33c-2.761 0-5 2.239-5 5v8h15c2.761 0 5 2.239 5 5s-2.239 5-5 5H35v8c0 2.761 2.239 5 5 5h20c2.761 0 5-2.239 5-5V38c0-2.761-2.239-5-5-5H40z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Bolt",
|
||||
url: "https://bolt.new",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M55 33H40l-5 20h10l-5 14 20-20H50l5-14z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Lovable",
|
||||
url: "https://lovable.dev",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 62l-12.728-12.728c-3.515-3.515-3.515-9.213 0-12.728 3.514-3.515 9.213-3.515 12.728 0 3.515-3.515 9.214-3.515 12.728 0 3.515 3.515 3.515 9.213 0 12.728L50 62z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Tabby",
|
||||
url: "https://tabby.tabbyml.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M35 45l5-12h6l-5 12h-6zm14 0l5-12h6l-5 12h-6zM33 48v17h34V48H33zm6 6h6v5h-6v-5zm10 0h6v5h-6v-5zm10 0h6v5h-6v-5z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Tabnine",
|
||||
url: "https://tabnine.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M38 35v6h9v24h6V41h9v-6H38z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "CodeGPT",
|
||||
url: "https://codegpt.co",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M42 40l-9 10 9 10 4-4-6-6 6-6-4-4zm16 0l-4 4 6 6-6 6 4 4 9-10-9-10z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "PlayCode",
|
||||
url: "https://playcode.io",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M38 33v34l28-17-28-17z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Universal",
|
||||
url: "https://github.com/rohitg00/skillkit",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11zm0 4c-3.866 0-7 3.134-7 7s3.134 7 7 7 7-3.134 7-7-3.134-7-7-7z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
];
|
||||
|
||||
const SCROLL_ANIMATION_STYLES = `
|
||||
@@ -418,7 +301,7 @@ const SCROLL_ANIMATION_STYLES = `
|
||||
100% { transform: translateX(-50%); }
|
||||
}
|
||||
.animate-scroll {
|
||||
animation: scroll 45s linear infinite;
|
||||
animation: scroll 35s linear infinite;
|
||||
}
|
||||
`;
|
||||
|
||||
@@ -429,7 +312,7 @@ export function Agents(): React.ReactElement {
|
||||
<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">
|
||||
<p className="text-zinc-500 font-mono text-[11px] uppercase tracking-widest mb-6 text-center">
|
||||
Works with 46 AI Agents
|
||||
Works with 44 AI Agents
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -1,15 +1,34 @@
|
||||
import React from 'react';
|
||||
import sourcesData from '../../../marketplace/sources.json';
|
||||
|
||||
interface Source {
|
||||
source: string;
|
||||
name: string;
|
||||
official?: boolean;
|
||||
registry?: string;
|
||||
}
|
||||
const OFFICIAL_SOURCES = [
|
||||
{ repo: 'anthropics/skills', name: 'Anthropic' },
|
||||
{ repo: 'vercel-labs/agent-skills', name: 'Vercel' },
|
||||
{ repo: 'expo/skills', name: 'Expo' },
|
||||
{ repo: 'remotion-dev/skills', name: 'Remotion' },
|
||||
{ repo: 'supabase/agent-skills', name: 'Supabase' },
|
||||
{ repo: 'stripe/ai', name: 'Stripe' },
|
||||
];
|
||||
|
||||
const OFFICIAL_SOURCES = (sourcesData.sources as Source[]).filter(s => s.official);
|
||||
const COMMUNITY_SOURCES = (sourcesData.sources as Source[]).filter(s => !s.official && s.source !== 'skills.sh');
|
||||
const COMMUNITY_SOURCES = [
|
||||
'trailofbits/skills',
|
||||
'obra/superpowers',
|
||||
'wshobson/agents',
|
||||
'ComposioHQ/awesome-claude-skills',
|
||||
'travisvn/awesome-claude-skills',
|
||||
'mhattingpete/claude-skills-marketplace',
|
||||
'langgenius/dify',
|
||||
'better-auth/skills',
|
||||
'onmax/nuxt-skills',
|
||||
'elysiajs/skills',
|
||||
'kadajett/agent-nestjs-skills',
|
||||
'cloudai-x/threejs-skills',
|
||||
'dimillian/skills',
|
||||
'waynesutton/convexskills',
|
||||
'kepano/obsidian-skills',
|
||||
'giuseppe-trisciuoglio/developer-kit',
|
||||
'openrouterteam/agent-skills',
|
||||
'intellectronica/agent-skills',
|
||||
];
|
||||
|
||||
export function Attribution(): React.ReactElement {
|
||||
return (
|
||||
@@ -18,19 +37,19 @@ export function Attribution(): React.ReactElement {
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Skill Sources</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
{sourcesData.sources.length} sources aggregated from open source repositories and registries
|
||||
Skills aggregated from open source repositories
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Official ({OFFICIAL_SOURCES.length})
|
||||
Official
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{OFFICIAL_SOURCES.map(source => (
|
||||
<a
|
||||
key={source.source}
|
||||
href={source.registry ? `https://${source.source}` : `https://github.com/${source.source}`}
|
||||
key={source.repo}
|
||||
href={`https://github.com/${source.repo}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-zinc-900 border border-zinc-800 px-3 py-2 hover:border-zinc-600 hover:text-white transition-colors text-zinc-400 font-mono text-xs"
|
||||
@@ -46,18 +65,18 @@ export function Attribution(): React.ReactElement {
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Community ({COMMUNITY_SOURCES.length})
|
||||
Community
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-1.5">
|
||||
{COMMUNITY_SOURCES.map(source => (
|
||||
{COMMUNITY_SOURCES.map(repo => (
|
||||
<a
|
||||
key={source.source}
|
||||
href={`https://github.com/${source.source}`}
|
||||
key={repo}
|
||||
href={`https://github.com/${repo}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-white transition-colors font-mono text-[11px] px-2 py-1 bg-zinc-900/50 border border-zinc-800/50 hover:border-zinc-700"
|
||||
>
|
||||
{source.source}
|
||||
{repo}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
|
||||
@@ -23,19 +23,9 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'list', desc: 'View installed skills' },
|
||||
{ cmd: 'sync', desc: 'Deploy to all agents' },
|
||||
{ cmd: 'translate --to <agent>', desc: 'Convert formats' },
|
||||
{ cmd: 'update', desc: 'Update with change detection' },
|
||||
{ cmd: 'update', desc: 'Update all skills' },
|
||||
{ cmd: 'remove <skill>', desc: 'Remove a skill' },
|
||||
{ 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' },
|
||||
{ cmd: 'status', desc: 'Show skill status' },
|
||||
],
|
||||
},
|
||||
{
|
||||
@@ -77,7 +67,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'manifest init', desc: 'Create .skills file' },
|
||||
{ cmd: 'team init', desc: 'Initialize team' },
|
||||
{ cmd: 'team share', desc: 'Share via Git' },
|
||||
{ cmd: 'publish submit', desc: 'Submit via CLI' },
|
||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
||||
{ cmd: 'cicd init', desc: 'CI/CD templates' },
|
||||
{ cmd: 'team sync', desc: 'Sync team skills' },
|
||||
],
|
||||
@@ -99,9 +89,6 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
|
||||
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
|
||||
{ cmd: 'install --no-scan', desc: 'Skip scan' },
|
||||
{ cmd: 'verify <path>', desc: 'SHA-256 integrity (SRI)' },
|
||||
{ cmd: 'verify --expected sha256-...', desc: 'Match publisher digest' },
|
||||
{ cmd: 'verify --against-lock', desc: 'Verify vs lockfile' },
|
||||
{ cmd: 'audit log', desc: 'View audit logs' },
|
||||
{ cmd: 'validate', desc: 'Validate format' },
|
||||
],
|
||||
|
||||
@@ -246,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
|
||||
<div>
|
||||
<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">
|
||||
Skill support across all 46 agents and {CATEGORIES.length} categories.
|
||||
Skill support across all 44 agents and {CATEGORIES.length} categories.
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
|
||||
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
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.
|
||||
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.
|
||||
</p>
|
||||
<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">
|
||||
<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">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
|
||||
<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">Skill Discovery</span> - Browse 15,000+ skills from marketplace 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">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -60,42 +60,14 @@ const sections: DocSection[] = [
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<h3 className="text-lg font-semibold text-white">Quick Start</h3>
|
||||
<CodeBlock>{`# Full install — every feature works out of the box (default):
|
||||
<CodeBlock>{`# Install globally via npm
|
||||
npm install -g skillkit
|
||||
|
||||
# Slim install — core commands only, ~75% smaller, 0 deprecation warnings:
|
||||
npm install -g skillkit --omit=optional
|
||||
# Or use npx directly
|
||||
npx skillkit --help
|
||||
|
||||
# Or use npx directly:
|
||||
npx skillkit --help`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Optional Features</h3>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
TUI, REST server, peer mesh, and inter-agent messaging ship as optional
|
||||
dependencies. They install by default, or add later à la carte:
|
||||
</p>
|
||||
<CodeBlock>{`npm install -g @skillkit/tui # enables: skillkit ui
|
||||
npm install -g @skillkit/api # enables: skillkit serve
|
||||
npm install -g @skillkit/mesh # enables: skillkit mesh
|
||||
npm install -g @skillkit/messaging # enables: skillkit message`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Using npx (no install)</h3>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
<code className="text-zinc-200">npx skillkit add <owner/repo></code> runs with zero install.
|
||||
First call caches the package at <code className="text-zinc-200">~/.npm/_npx/</code>; every
|
||||
run after that is instant until a new version ships.
|
||||
</p>
|
||||
<CodeBlock>{`# Full (default):
|
||||
npx skillkit add anthropics/skills
|
||||
|
||||
# Slim — core only, 75% fewer packages, 0 warnings:
|
||||
npx --omit=optional skillkit add anthropics/skills`}</CodeBlock>
|
||||
<p className="text-zinc-300 text-sm">
|
||||
Using npx more than a couple times? Install globally to skip the
|
||||
prompt-to-proceed and avoid the per-release cache refetch:
|
||||
</p>
|
||||
<CodeBlock>{`npm install -g skillkit --omit=optional
|
||||
skillkit add anthropics/skills`}</CodeBlock>
|
||||
# Or install via pnpm
|
||||
pnpm add -g skillkit`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Verify Installation</h3>
|
||||
<CodeBlock>{`skillkit --version
|
||||
@@ -129,7 +101,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
<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">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 46 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -157,7 +129,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
@@ -234,7 +206,7 @@ skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
|
||||
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
|
||||
skillkit primer --all-agents # Generate for all 46 agents
|
||||
skillkit primer --all-agents # Generate for all 44 agents
|
||||
skillkit primer --agent claude-code,cursor # Specific agents only
|
||||
skillkit primer --analyze-only # Only show codebase analysis
|
||||
skillkit primer --dry-run # Preview without writing files
|
||||
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Smart Recommendations',
|
||||
description: 'AI analyzes your codebase and recommends from 400K+ skills.',
|
||||
description: 'AI analyzes your codebase and recommends from 15,000+ skills.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
|
||||
@@ -18,7 +18,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Auto Translation',
|
||||
description: 'The npm for agent skills. Write once, auto-translate to 45 formats.',
|
||||
description: 'The npm for agent skills. Write once, auto-translate to 44 formats.',
|
||||
icon: (
|
||||
<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" />
|
||||
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Primer',
|
||||
description: 'Auto-generate agent instructions for all 46 agents from your codebase.',
|
||||
description: 'Auto-generate agent instructions for all 44 agents from your codebase.',
|
||||
icon: (
|
||||
<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" />
|
||||
@@ -45,7 +45,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Skill Tree',
|
||||
description: 'Browse 400K+ skills in a hierarchical taxonomy with 12 categories.',
|
||||
description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
|
||||
@@ -79,15 +79,6 @@ const FEATURES: Feature[] = [
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Content Integrity',
|
||||
description: 'SHA-256 SRI digests on publish, install, and lock. Detect supply-chain tampering with skillkit verify.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 5.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-.34-.024-.673-.07-1.002z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Testing',
|
||||
description: 'Built-in test framework with assertions.',
|
||||
@@ -118,12 +109,11 @@ const FEATURES: Feature[] = [
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agent Support', '1-17 agents', '46 agents'],
|
||||
['Sources', 'Single registry', '34+ aggregated'],
|
||||
['Translation', 'None or limited', 'All 45 formats'],
|
||||
['Agent Support', '1-17 agents', '44 agents'],
|
||||
['Sources', 'Single registry', '31+ aggregated'],
|
||||
['Translation', 'None or limited', 'All 44 formats'],
|
||||
['Memory', 'None', 'Persistent learning'],
|
||||
['Security', 'None', '46-rule scanner'],
|
||||
['Integrity', 'None', 'SHA-256 SRI + lockfile'],
|
||||
['Team Sync', 'None', '.skills manifest'],
|
||||
['Telemetry', 'Varies', 'Zero. Ever.'],
|
||||
['API Access', 'None', 'REST + MCP + Python'],
|
||||
@@ -141,15 +131,15 @@ export function Features(): React.ReactElement {
|
||||
</p>
|
||||
<div className="flex gap-6 sm:gap-8">
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">45</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">34+</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">31+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Sources</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">400K+</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -22,10 +22,10 @@ interface TerminalLine {
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
||||
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
|
||||
{ type: 'out', text: '→ Translated to 46 agent formats' },
|
||||
{ type: 'out', text: '→ Translated to 44 agent formats' },
|
||||
{ type: 'out', text: '→ Scanned: 0 issues found' },
|
||||
{ type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' },
|
||||
{ type: 'out', text: '→ Installed 12 skills from skills.sh' },
|
||||
{ type: 'cmd', text: 'skillkit install vercel-labs/agent-skills' },
|
||||
{ type: 'out', text: '→ Installed 12 skills from Vercel' },
|
||||
{ type: 'cmd', text: 'skillkit translate --all --to cursor' },
|
||||
{ type: 'out', text: '→ 26 skills → .cursor/skills/' },
|
||||
{ type: 'cmd', text: 'skillkit recommend' },
|
||||
@@ -148,9 +148,9 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
</h1>
|
||||
|
||||
<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,
|
||||
scans 400K+ skills from registries, auto-translates to 46 agent formats,
|
||||
and adds memory, security scanning, and team workflows. Everything runs locally.
|
||||
The open source package manager that aggregates 31+ skill sources,
|
||||
auto-translates to 44 agent formats, and adds memory, security scanning,
|
||||
and team workflows. No account required. Everything runs locally.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-2 mb-4">
|
||||
|
||||
@@ -31,7 +31,7 @@ export function SkillGenerator(): React.ReactElement {
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Find Skills</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Search 400K+ skills across registries
|
||||
Search 15,000+ skills from the marketplace
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -13,14 +13,14 @@ const CATEGORIES = [
|
||||
] as const;
|
||||
|
||||
const TRENDING_SKILLS = [
|
||||
'anthropics/skills/frontend-design',
|
||||
'anthropics/skills/typescript-best-practices',
|
||||
'obra/superpowers/test-driven-development',
|
||||
'vercel-labs/agent-skills/vercel-react-best-practices',
|
||||
'trailofbits/skills/semgrep',
|
||||
'expo/skills/building-native-ui',
|
||||
'sickn33/antigravity-awesome-skills/senior-architect',
|
||||
'supabase/agent-skills/supabase-postgres-best-practices',
|
||||
'anthropics/skills/claude-code-guide',
|
||||
'anthropics/skills/claude-code-setup',
|
||||
'obra/superpowers/tdd',
|
||||
'vercel-labs/agent-skills/nextjs',
|
||||
'trailofbits/skills/security-review',
|
||||
'expo/skills/react-native',
|
||||
'remotion-dev/skills/video',
|
||||
'supabase/agent-skills/database',
|
||||
];
|
||||
|
||||
function getTrendingSkills(): IndexedSkill[] {
|
||||
|
||||
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
|
||||
{
|
||||
persona: 'Multi-Agent Developer',
|
||||
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 46 agents. Write once, deploy everywhere.',
|
||||
solution: 'SkillKit translates skills between all 44 agents. Write once, deploy everywhere.',
|
||||
command: 'skillkit translate --to cursor,windsurf',
|
||||
gradient: 'from-violet-500/10 to-purple-500/10',
|
||||
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: '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: 'SkillKit', type: 'Platform', agents: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||
{ name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||
];
|
||||
|
||||
const SOURCES = [
|
||||
@@ -114,7 +114,7 @@ export function WhySkillKit(): React.ReactElement {
|
||||
</h3>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm mb-6">
|
||||
SkillKit doesn't compete with skill sources — it aggregates them.
|
||||
Install from 34+ curated repositories, any GitHub/GitLab repo, or local paths.
|
||||
Install from 31+ curated repositories, any GitHub/GitLab repo, or local paths.
|
||||
Everything runs locally. No accounts, no tracking, no lock-in.
|
||||
</p>
|
||||
|
||||
@@ -134,7 +134,7 @@ export function WhySkillKit(): React.ReactElement {
|
||||
</a>
|
||||
))}
|
||||
<div className="flex items-center gap-2 px-3 py-2 border border-dashed border-zinc-800 text-zinc-600 text-xs font-mono">
|
||||
+ 22 more community sources
|
||||
+ 19 more community sources
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -4,13 +4,13 @@
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>SkillKit - Universal Skills for AI Coding Agents</title>
|
||||
<meta name="description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
|
||||
<!-- Open Graph -->
|
||||
<meta property="og:type" content="website">
|
||||
<meta property="og:url" content="https://skillkit.sh/">
|
||||
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||
<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:description" content="Write once, deploy to 44 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:width" content="1200">
|
||||
<meta property="og:image:height" content="630">
|
||||
@@ -20,7 +20,7 @@
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:url" content="https://skillkit.sh/">
|
||||
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
|
||||
<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:description" content="Write once, deploy to 44 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">
|
||||
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "SkillKit",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 46 agents.",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.",
|
||||
"requestFramePermissions": []
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.24.0",
|
||||
"version": "1.19.2",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>SkillKit API</title>
|
||||
<meta name="description" content="SkillKit REST API — discover and retrieve 400K+ AI agent skills on demand">
|
||||
<meta name="description" content="SkillKit REST API — discover and retrieve 15,000+ AI agent skills on demand">
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
|
||||
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
|
||||
<style>
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
"info": {
|
||||
"title": "SkillKit",
|
||||
"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 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```",
|
||||
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n15,000+ 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```",
|
||||
"license": {
|
||||
"name": "Apache-2.0",
|
||||
"url": "https://opensource.org/licenses/Apache-2.0"
|
||||
|
||||
@@ -1,138 +0,0 @@
|
||||
# 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
|
||||
@@ -23,7 +23,6 @@
|
||||
"./*"
|
||||
]
|
||||
},
|
||||
"resolveJsonModule": true,
|
||||
"allowImportingTsExtensions": true,
|
||||
"noEmit": true
|
||||
}
|
||||
|
||||
@@ -21,47 +21,5 @@
|
||||
"source": "/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);
|
||||
});
|
||||
|
||||
it('should display all 46 agents', async () => {
|
||||
it('should display all 44 agents', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
@@ -93,7 +93,6 @@ describe('E2E: Onboarding UI', () => {
|
||||
'Tabnine',
|
||||
'CodeGPT',
|
||||
'PlayCode',
|
||||
'Hermes',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
|
||||
@@ -28,7 +28,7 @@ import {
|
||||
type CrossAgentSkill,
|
||||
} from '@skillkit/core';
|
||||
|
||||
// All 46 supported agents
|
||||
// All 44 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -74,7 +74,6 @@ const SUPPORTED_AGENTS = [
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translator - Parsing', () => {
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
* E2E Tests: Skill Translation Commands
|
||||
*
|
||||
* Tests for: translate, context, recommend
|
||||
* Validates translation to all 45 supported agents
|
||||
* Validates translation to all 44 supported agents
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
@@ -16,7 +16,7 @@ import {
|
||||
testFileExists,
|
||||
} from './helpers/cli-runner.js';
|
||||
|
||||
// All 46 supported agents
|
||||
// All 44 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -62,7 +62,6 @@ const SUPPORTED_AGENTS = [
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translation', () => {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"$schema": "./sources-schema.json",
|
||||
"version": 1,
|
||||
"updatedAt": "2026-04-10",
|
||||
"updatedAt": "2026-01-26",
|
||||
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
|
||||
"sources": [
|
||||
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
|
||||
@@ -35,9 +35,6 @@
|
||||
{ "source": "giuseppe-trisciuoglio/developer-kit", "name": "Shadcn / Radix" },
|
||||
{ "source": "openrouterteam/agent-skills", "name": "OpenRouter SDK" },
|
||||
{ "source": "intellectronica/agent-skills", "name": "Context7" },
|
||||
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
|
||||
{ "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" }
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.24.0",
|
||||
"version": "1.19.2",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 46 coding agents",
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "turbo run build",
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[](https://www.npmjs.com/package/@skillkit/agents)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**Agent adapters for SkillKit** - configuration and detection for 46 AI coding agents.
|
||||
**Agent adapters for SkillKit** - configuration and detection for 32 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
npm install @skillkit/agents
|
||||
```
|
||||
|
||||
## Supported Agents (46)
|
||||
## Supported Agents (32)
|
||||
|
||||
| Agent | Config Format | Project Skills | Global Skills |
|
||||
|-------|--------------|----------------|---------------|
|
||||
@@ -23,14 +23,11 @@ npm install @skillkit/agents
|
||||
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
|
||||
| Amp | SKILL.md | `.amp/skills/` | - |
|
||||
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
|
||||
| OpenClaw | SKILL.md | `.openclaw/skills/` | `~/.openclaw/workspace/skills/` |
|
||||
| Cline | SKILL.md | `.cline/skills/` | - |
|
||||
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
|
||||
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
|
||||
| CommandCode | SKILL.md | `.commandcode/skills/` | - |
|
||||
| Continue | SKILL.md | `.continue/skills/` | `~/.continue/skills/` |
|
||||
| Crush | SKILL.md | `.crush/skills/` | - |
|
||||
| Devin | SKILL.md | `.devin/skills/` | - |
|
||||
| Droid (Factory) | SKILL.md | `.factory/skills/` | - |
|
||||
| Factory | SKILL.md | `.factory/skills/` | - |
|
||||
| GitHub Copilot | Markdown | `.github/skills/` | - |
|
||||
@@ -42,7 +39,6 @@ npm install @skillkit/agents
|
||||
| Neovate | SKILL.md | `.neovate/skills/` | - |
|
||||
| OpenHands | SKILL.md | `.openhands/skills/` | - |
|
||||
| Pi | SKILL.md | `.pi/skills/` | - |
|
||||
| PlayCode Agent | SKILL.md | `.playcode/skills/` | - |
|
||||
| Qoder | SKILL.md | `.qoder/skills/` | - |
|
||||
| Qwen | SKILL.md | `.qwen/skills/` | - |
|
||||
| Roo Code | SKILL.md | `.roo/skills/` | `~/.roo/skills/` |
|
||||
@@ -50,15 +46,6 @@ npm install @skillkit/agents
|
||||
| Vercel | SKILL.md | `.vercel/skills/` | - |
|
||||
| Windsurf | Markdown | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
|
||||
| Zencoder | SKILL.md | `.zencoder/skills/` | - |
|
||||
| Aider | SKILL.md | `.aider/skills/` | - |
|
||||
| Amazon Q | SKILL.md | `.amazonq/skills/` | - |
|
||||
| Augment Code | SKILL.md | `.augment/skills/` | - |
|
||||
| Bolt | SKILL.md | `.bolt/skills/` | - |
|
||||
| Lovable | SKILL.md | `.lovable/skills/` | - |
|
||||
| Replit Agent | SKILL.md | `.replit/skills/` | - |
|
||||
| Sourcegraph Cody | SKILL.md | `.cody/skills/` | - |
|
||||
| Tabby | SKILL.md | `.tabby/skills/` | - |
|
||||
| Tabnine | SKILL.md | `.tabnine/skills/` | - |
|
||||
| Universal | SKILL.md | `skills/` | - |
|
||||
|
||||
## Usage
|
||||
@@ -183,14 +170,11 @@ type AgentType =
|
||||
| 'antigravity'
|
||||
| 'amp'
|
||||
| 'clawdbot'
|
||||
| 'openclaw'
|
||||
| 'cline'
|
||||
| 'codebuddy'
|
||||
| 'codegpt'
|
||||
| 'commandcode'
|
||||
| 'continue'
|
||||
| 'crush'
|
||||
| 'devin'
|
||||
| 'droid'
|
||||
| 'factory'
|
||||
| 'github-copilot'
|
||||
@@ -202,7 +186,6 @@ type AgentType =
|
||||
| 'neovate'
|
||||
| 'openhands'
|
||||
| 'pi'
|
||||
| 'playcode-agent'
|
||||
| 'qoder'
|
||||
| 'qwen'
|
||||
| 'roo'
|
||||
@@ -210,15 +193,6 @@ type AgentType =
|
||||
| 'vercel'
|
||||
| 'windsurf'
|
||||
| 'zencoder'
|
||||
| 'aider'
|
||||
| 'amazon-q'
|
||||
| 'augment-code'
|
||||
| 'bolt'
|
||||
| 'lovable'
|
||||
| 'replit-agent'
|
||||
| 'sourcegraph-cody'
|
||||
| 'tabby'
|
||||
| 'tabnine'
|
||||
| 'universal';
|
||||
```
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.24.0",
|
||||
"description": "Agent adapters for SkillKit - supports 46 AI coding agents",
|
||||
"version": "1.19.2",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
"types": "./dist/index.d.ts",
|
||||
|
||||
@@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options;
|
||||
|
||||
describe('Agent Adapters', () => {
|
||||
describe('getAllAdapters', () => {
|
||||
it('should return all 46 registered adapters', () => {
|
||||
it('should return all 44 registered adapters', () => {
|
||||
const adapters = getAllAdapters();
|
||||
expect(adapters).toBeInstanceOf(Array);
|
||||
expect(adapters.length).toBe(46);
|
||||
expect(adapters.length).toBe(44);
|
||||
});
|
||||
|
||||
it('should include common agents', () => {
|
||||
@@ -140,43 +140,4 @@ describe('Agent Adapters', () => {
|
||||
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,6 +236,16 @@ describe('ClawdbotAdapter', () => {
|
||||
});
|
||||
|
||||
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 () => {
|
||||
mockExistsSync.mockImplementation((path) => {
|
||||
return path === join(homedir(), '.clawdbot');
|
||||
@@ -277,6 +287,7 @@ describe('ClawdbotAdapter', () => {
|
||||
|
||||
await adapter.isDetected();
|
||||
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'skills'));
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(homedir(), '.clawdbot'));
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'clawdbot.json'));
|
||||
});
|
||||
|
||||
@@ -10,9 +10,9 @@ const config = AGENT_CONFIG.clawdbot;
|
||||
|
||||
export class ClawdbotAdapter implements AgentAdapter {
|
||||
readonly type: AgentType = 'clawdbot';
|
||||
readonly name: string = 'Clawdbot';
|
||||
readonly skillsDir: string = config.skillsDir;
|
||||
readonly configFile: string = config.configFile;
|
||||
readonly name = 'Clawdbot';
|
||||
readonly skillsDir = config.skillsDir;
|
||||
readonly configFile = config.configFile;
|
||||
|
||||
generateConfig(skills: Skill[]): string {
|
||||
const enabledSkills = skills.filter(s => s.enabled);
|
||||
@@ -69,9 +69,10 @@ ${skillsXml}
|
||||
}
|
||||
|
||||
async isDetected(): Promise<boolean> {
|
||||
const projectSkills = join(process.cwd(), 'skills');
|
||||
const globalClawdbot = join(homedir(), '.clawdbot');
|
||||
const clawdbotConfig = join(process.cwd(), 'clawdbot.json');
|
||||
|
||||
return existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
||||
return existsSync(projectSkills) || existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -33,7 +33,6 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
|
||||
'tabnine': 'Tabnine',
|
||||
'codegpt': 'CodeGPT',
|
||||
'playcode-agent': 'PlayCode Agent',
|
||||
'hermes': 'Hermes',
|
||||
};
|
||||
|
||||
export class GenericAgentAdapter implements AgentAdapter {
|
||||
|
||||
@@ -1,93 +0,0 @@
|
||||
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,7 +8,6 @@ import { OpenCodeAdapter } from './opencode.js';
|
||||
import { AntigravityAdapter } from './antigravity.js';
|
||||
import { AmpAdapter } from './amp.js';
|
||||
import { ClawdbotAdapter } from './clawdbot.js';
|
||||
import { OpenClawAdapter } from './openclaw.js';
|
||||
import { DroidAdapter } from './droid.js';
|
||||
import { FactoryAdapter } from './factory.js';
|
||||
import { GitHubCopilotAdapter } from './github-copilot.js';
|
||||
@@ -19,7 +18,6 @@ import { RooAdapter } from './roo.js';
|
||||
import { TraeAdapter } from './trae.js';
|
||||
import { WindsurfAdapter } from './windsurf.js';
|
||||
import { UniversalAdapter } from './universal.js';
|
||||
import { HermesAdapter } from './hermes.js';
|
||||
import { GenericAgentAdapter } from './generic.js';
|
||||
|
||||
export * from './base.js';
|
||||
@@ -31,7 +29,6 @@ export * from './opencode.js';
|
||||
export * from './antigravity.js';
|
||||
export * from './amp.js';
|
||||
export * from './clawdbot.js';
|
||||
export * from './openclaw.js';
|
||||
export * from './droid.js';
|
||||
export * from './factory.js';
|
||||
export * from './github-copilot.js';
|
||||
@@ -42,7 +39,6 @@ export * from './roo.js';
|
||||
export * from './trae.js';
|
||||
export * from './windsurf.js';
|
||||
export * from './universal.js';
|
||||
export * from './hermes.js';
|
||||
export * from './generic.js';
|
||||
|
||||
// Agent features
|
||||
@@ -57,7 +53,6 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
||||
antigravity: new AntigravityAdapter(),
|
||||
amp: new AmpAdapter(),
|
||||
clawdbot: new ClawdbotAdapter(),
|
||||
openclaw: new OpenClawAdapter(),
|
||||
droid: new DroidAdapter(),
|
||||
'github-copilot': new GitHubCopilotAdapter(),
|
||||
goose: new GooseAdapter(),
|
||||
@@ -94,7 +89,6 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
||||
tabnine: new GenericAgentAdapter('tabnine'),
|
||||
codegpt: new GenericAgentAdapter('codegpt'),
|
||||
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
|
||||
hermes: new HermesAdapter(),
|
||||
};
|
||||
|
||||
export function getAdapter(type: AgentType): AgentAdapter {
|
||||
@@ -113,10 +107,6 @@ export function getAllAdapters(): AgentAdapterWithType[] {
|
||||
}));
|
||||
}
|
||||
|
||||
export function getAdapterCount(): number {
|
||||
return Object.keys(adapters).length;
|
||||
}
|
||||
|
||||
export async function detectAgent(): Promise<AgentType> {
|
||||
const checkOrder: AgentType[] = [
|
||||
'claude-code',
|
||||
@@ -126,7 +116,6 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'opencode',
|
||||
'antigravity',
|
||||
'amp',
|
||||
'openclaw',
|
||||
'clawdbot',
|
||||
'droid',
|
||||
'github-copilot',
|
||||
@@ -163,7 +152,6 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
'universal',
|
||||
];
|
||||
|
||||
|
||||
@@ -1,25 +0,0 @@
|
||||
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",
|
||||
"version": "1.24.0",
|
||||
"version": "1.19.2",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import type { Context, Next } from "hono";
|
||||
import type { Context, Next } from 'hono';
|
||||
|
||||
interface RateLimitEntry {
|
||||
count: number;
|
||||
@@ -18,12 +18,8 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
|
||||
}, windowMs).unref();
|
||||
|
||||
return async (c: Context, next: Next): Promise<Response | void> => {
|
||||
const xRealIp = c.req.header("x-real-ip");
|
||||
const forwarded = c.req.header("x-forwarded-for");
|
||||
const forwardedIp = forwarded
|
||||
? forwarded.split(",").at(-1)?.trim()
|
||||
: undefined;
|
||||
const ip = xRealIp || forwardedIp || "unknown";
|
||||
const forwardedFor = c.req.header('x-forwarded-for');
|
||||
const ip = (forwardedFor?.split(',')[0]?.trim()) || c.req.header('x-real-ip') || 'unknown';
|
||||
const now = Date.now();
|
||||
|
||||
let entry = windows.get(ip);
|
||||
@@ -34,21 +30,12 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
|
||||
|
||||
entry.count++;
|
||||
|
||||
c.header("X-RateLimit-Limit", String(maxRequests));
|
||||
c.header(
|
||||
"X-RateLimit-Remaining",
|
||||
String(Math.max(0, maxRequests - entry.count)),
|
||||
);
|
||||
c.header("X-RateLimit-Reset", String(Math.ceil(entry.resetAt / 1000)));
|
||||
c.header('X-RateLimit-Limit', String(maxRequests));
|
||||
c.header('X-RateLimit-Remaining', String(Math.max(0, maxRequests - entry.count)));
|
||||
c.header('X-RateLimit-Reset', String(Math.ceil(entry.resetAt / 1000)));
|
||||
|
||||
if (entry.count > maxRequests) {
|
||||
return c.json(
|
||||
{
|
||||
error: "Too many requests",
|
||||
retryAfter: Math.ceil((entry.resetAt - now) / 1000),
|
||||
},
|
||||
429,
|
||||
);
|
||||
return c.json({ error: 'Too many requests', retryAfter: Math.ceil((entry.resetAt - now) / 1000) }, 429);
|
||||
}
|
||||
|
||||
await next();
|
||||
|
||||
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
|
||||
info: {
|
||||
title: 'SkillKit',
|
||||
version: '1.12.0',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 46 agents).',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ skills across 44 agents).',
|
||||
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
||||
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
||||
},
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { Hono } from "hono";
|
||||
import { ContentExtractor, SkillGenerator, AutoTagger } from "@skillkit/core";
|
||||
import { Hono } from 'hono';
|
||||
import { ContentExtractor, SkillGenerator, AutoTagger } from '@skillkit/core';
|
||||
|
||||
interface SaveRequest {
|
||||
url?: string;
|
||||
@@ -10,40 +10,25 @@ interface SaveRequest {
|
||||
|
||||
const MAX_TEXT_LENGTH = 500_000;
|
||||
|
||||
const BLOCKED_HOSTS = new Set([
|
||||
"localhost",
|
||||
"127.0.0.1",
|
||||
"[::1]",
|
||||
"::1",
|
||||
"0.0.0.0",
|
||||
]);
|
||||
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
|
||||
|
||||
function isAllowedUrl(url: string): boolean {
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
|
||||
return false;
|
||||
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return false;
|
||||
|
||||
const hostname = parsed.hostname.toLowerCase();
|
||||
const bare = hostname.replace(/^\[|\]$/g, "");
|
||||
const bare = hostname.replace(/^\[|\]$/g, '');
|
||||
|
||||
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
|
||||
if (bare.startsWith("::ffff:"))
|
||||
return isAllowedUrl(`http://${bare.slice(7)}`);
|
||||
if (bare.startsWith('::ffff:')) return isAllowedUrl(`http://${bare.slice(7)}`);
|
||||
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
|
||||
if (bare.startsWith("10.") || bare.startsWith("192.168.")) return false;
|
||||
if (bare.startsWith('10.') || bare.startsWith('192.168.')) return false;
|
||||
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
|
||||
if (bare.startsWith("169.254.")) return false;
|
||||
if (bare.includes(":")) {
|
||||
if (
|
||||
bare.startsWith("fe80:") ||
|
||||
bare.startsWith("fc") ||
|
||||
bare.startsWith("fd")
|
||||
)
|
||||
return false;
|
||||
if (bare.startsWith("ff")) return false;
|
||||
}
|
||||
if (bare.startsWith('169.254.')) return false;
|
||||
if (bare.startsWith('fe80:') || bare.startsWith('fc') || bare.startsWith('fd')) return false;
|
||||
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
|
||||
if (bare.startsWith('ff')) return false;
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
@@ -56,12 +41,12 @@ export function saveRoutes() {
|
||||
const generator = new SkillGenerator();
|
||||
const tagger = new AutoTagger();
|
||||
|
||||
app.post("/save", async (c) => {
|
||||
app.post('/save', async (c) => {
|
||||
let body: SaveRequest;
|
||||
try {
|
||||
body = await c.req.json();
|
||||
} catch {
|
||||
return c.json({ error: "Invalid JSON body" }, 400);
|
||||
return c.json({ error: 'Invalid JSON body' }, 400);
|
||||
}
|
||||
|
||||
if (!body.url && !body.text) {
|
||||
@@ -69,26 +54,11 @@ export function saveRoutes() {
|
||||
}
|
||||
|
||||
if (body.url && !isAllowedUrl(body.url)) {
|
||||
return c.json({ error: "URL must be a public HTTP(S) address" }, 400);
|
||||
}
|
||||
|
||||
if (body.name && !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(body.name)) {
|
||||
return c.json(
|
||||
{
|
||||
error:
|
||||
"Name must be alphanumeric (hyphens, underscores, dots allowed)",
|
||||
},
|
||||
400,
|
||||
);
|
||||
return c.json({ error: 'URL must be a public HTTP(S) address' }, 400);
|
||||
}
|
||||
|
||||
if (body.text && body.text.length > MAX_TEXT_LENGTH) {
|
||||
return c.json(
|
||||
{
|
||||
error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters`,
|
||||
},
|
||||
400,
|
||||
);
|
||||
return c.json({ error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters` }, 400);
|
||||
}
|
||||
|
||||
try {
|
||||
@@ -108,17 +78,16 @@ export function saveRoutes() {
|
||||
tags: tagger.detectTags(content),
|
||||
});
|
||||
} catch (err) {
|
||||
console.error("Save extraction failed:", err);
|
||||
const message = err instanceof Error ? err.message : 'Unknown error';
|
||||
const isTimeout =
|
||||
(err instanceof DOMException && err.name === "TimeoutError") ||
|
||||
(err instanceof Error &&
|
||||
(err.name === "TimeoutError" || err.name === "AbortError"));
|
||||
(err instanceof DOMException && err.name === 'TimeoutError') ||
|
||||
(err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError'));
|
||||
|
||||
if (isTimeout) {
|
||||
return c.json({ error: "Fetch timed out" }, 504);
|
||||
return c.json({ error: `Fetch timeout: ${message}` }, 504);
|
||||
}
|
||||
|
||||
return c.json({ error: "Extraction failed" }, 422);
|
||||
return c.json({ error: `Extraction failed: ${message}` }, 422);
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
import { Hono } from "hono";
|
||||
import { cors } from "hono/cors";
|
||||
import { MemoryCache } from "@skillkit/core";
|
||||
import { rateLimiter } from "./middleware/rate-limit.js";
|
||||
import { healthRoutes } from "./routes/health.js";
|
||||
import { searchRoutes } from "./routes/search.js";
|
||||
import { skillRoutes } from "./routes/skills.js";
|
||||
import { trendingRoutes } from "./routes/trending.js";
|
||||
import { categoryRoutes } from "./routes/categories.js";
|
||||
import { docsRoutes } from "./routes/docs.js";
|
||||
import { saveRoutes } from "./routes/save.js";
|
||||
import type { ApiSkill, SearchResponse } from "./types.js";
|
||||
import { Hono } from 'hono';
|
||||
import { cors } from 'hono/cors';
|
||||
import { MemoryCache } from '@skillkit/core';
|
||||
import { rateLimiter } from './middleware/rate-limit.js';
|
||||
import { healthRoutes } from './routes/health.js';
|
||||
import { searchRoutes } from './routes/search.js';
|
||||
import { skillRoutes } from './routes/skills.js';
|
||||
import { trendingRoutes } from './routes/trending.js';
|
||||
import { categoryRoutes } from './routes/categories.js';
|
||||
import { docsRoutes } from './routes/docs.js';
|
||||
import { saveRoutes } from './routes/save.js';
|
||||
import type { ApiSkill, SearchResponse } from './types.js';
|
||||
|
||||
export interface ServerOptions {
|
||||
port?: number;
|
||||
@@ -29,36 +29,26 @@ export function createApp(options: ServerOptions = {}) {
|
||||
|
||||
const app = new Hono();
|
||||
|
||||
app.use("*", cors({ origin: options.corsOrigin || "*" }));
|
||||
app.use("*", async (c, next) => {
|
||||
await next();
|
||||
c.header("X-Content-Type-Options", "nosniff");
|
||||
c.header("X-Frame-Options", "DENY");
|
||||
c.header(
|
||||
"Content-Security-Policy",
|
||||
"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'",
|
||||
);
|
||||
c.header("Referrer-Policy", "strict-origin-when-cross-origin");
|
||||
});
|
||||
app.use("*", rateLimiter(options.rateLimitMax ?? 60));
|
||||
app.use('*', cors({ origin: options.corsOrigin || '*' }));
|
||||
app.use('*', rateLimiter(options.rateLimitMax ?? 60));
|
||||
|
||||
app.route("/", healthRoutes(skills.length, cache));
|
||||
app.route("/", searchRoutes(skills, cache));
|
||||
app.route("/", skillRoutes(skills));
|
||||
app.route("/", trendingRoutes(skills));
|
||||
app.route("/", categoryRoutes(skills));
|
||||
app.route("/", docsRoutes());
|
||||
app.route("/", saveRoutes());
|
||||
app.route('/', healthRoutes(skills.length, cache));
|
||||
app.route('/', searchRoutes(skills, cache));
|
||||
app.route('/', skillRoutes(skills));
|
||||
app.route('/', trendingRoutes(skills));
|
||||
app.route('/', categoryRoutes(skills));
|
||||
app.route('/', docsRoutes());
|
||||
app.route('/', saveRoutes());
|
||||
|
||||
return { app, cache };
|
||||
}
|
||||
|
||||
export async function startServer(options: ServerOptions = {}) {
|
||||
const port = options.port ?? 3737;
|
||||
const host = options.host ?? "127.0.0.1";
|
||||
const host = options.host ?? '0.0.0.0';
|
||||
const { app, cache } = createApp(options);
|
||||
|
||||
const { serve } = await import("@hono/node-server");
|
||||
const { serve } = await import('@hono/node-server');
|
||||
|
||||
const server = serve({ fetch: app.fetch, port, hostname: host }, () => {
|
||||
console.log(`SkillKit API server running at http://${host}:${port}`);
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[](https://www.npmjs.com/package/@skillkit/cli)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 46 AI coding agents.
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -264,7 +264,7 @@ const recs = await recommendCommand({
|
||||
| Gemini CLI | SKILL.md |
|
||||
| Windsurf | Markdown |
|
||||
| GitHub Copilot | Markdown |
|
||||
| + 39 more | SKILL.md |
|
||||
| + 26 more | SKILL.md |
|
||||
|
||||
## Documentation
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.24.0",
|
||||
"version": "1.19.2",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -22,9 +22,14 @@
|
||||
},
|
||||
"dependencies": {
|
||||
"@clack/prompts": "^0.11.0",
|
||||
"@skillkit/api": "workspace:*",
|
||||
"@skillkit/core": "workspace:*",
|
||||
"@skillkit/agents": "workspace:*",
|
||||
"@skillkit/resources": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
"@skillkit/memory": "workspace:*",
|
||||
"@skillkit/mesh": "workspace:*",
|
||||
"@skillkit/messaging": "workspace:*",
|
||||
"chalk": "^5.3.0",
|
||||
"clipanion": "^4.0.0-rc.4",
|
||||
"got": "^14.4.1",
|
||||
@@ -33,12 +38,6 @@
|
||||
"picocolors": "^1.1.1",
|
||||
"yaml": "^2.7.0"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@skillkit/api": "workspace:*",
|
||||
"@skillkit/tui": "workspace:*",
|
||||
"@skillkit/mesh": "workspace:*",
|
||||
"@skillkit/messaging": "workspace:*"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
"tsup": "^8.3.5",
|
||||
|
||||
@@ -30,8 +30,6 @@ describe('CLI Commands', () => {
|
||||
expect(commands.SessionSnapshotListCommand).toBeDefined();
|
||||
expect(commands.SessionSnapshotDeleteCommand).toBeDefined();
|
||||
expect(commands.SessionExplainCommand).toBeDefined();
|
||||
expect(commands.VerifyCommand).toBeDefined();
|
||||
expect(commands.ScanCommand).toBeDefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
@@ -96,10 +96,10 @@ describe('Onboarding Module', () => {
|
||||
it('should generate full logo with version', async () => {
|
||||
const { getFullLogo } = await import('../onboarding/logo.js');
|
||||
|
||||
const logo = getFullLogo('1.7.2', 46);
|
||||
const logo = getFullLogo('1.7.2', 44);
|
||||
expect(logo).toContain('\u2588');
|
||||
expect(logo).toContain('v1.7.2');
|
||||
expect(logo).toContain('46 agents');
|
||||
expect(logo).toContain('44 agents');
|
||||
});
|
||||
|
||||
it('should generate compact logo', async () => {
|
||||
|
||||