mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 12:23:29 +00:00
Compare commits
22
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
1436180933 | ||
|
|
a9e5c83a4c | ||
|
|
e42ae9d87a | ||
|
|
bf6ec9008b | ||
|
|
c4959a50b3 | ||
|
|
9e4739b195 | ||
|
|
a974515520 | ||
|
|
b5b251acff | ||
|
|
1e7cad18c1 | ||
|
|
17e9720834 | ||
|
|
821e9f714b | ||
|
|
7e6612d424 | ||
|
|
27afc45dea | ||
|
|
fb95260eb5 | ||
|
|
9cbd0e394b | ||
|
|
0b94c6001a | ||
|
|
94fa5c8bce | ||
|
|
5bd2822f12 | ||
|
|
e5d18eba28 | ||
|
|
1af78cbf26 | ||
|
|
97c7b2f16b | ||
|
|
5878e9f80c |
@@ -0,0 +1,24 @@
|
||||
# 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.
|
||||
@@ -8,7 +8,7 @@
|
||||
|
||||
<br/>
|
||||
|
||||
### *One skill. Every agent. 45 of them.*
|
||||
### *One skill. Every agent. 46 of them.*
|
||||
|
||||
<br/>
|
||||
|
||||
@@ -18,27 +18,20 @@
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](LICENSE)
|
||||
|
||||
<br/>
|
||||
|
||||
<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="45 agents"></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>
|
||||
|
||||
<br/>
|
||||
|
||||
<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.23.0.svg" alt="v1.23.0"></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">
|
||||
|
||||
<sub>Tags are SVGs under <a href="assets/tags/"><code>/assets/tags/</code></a>. Fork and remix.</sub>
|
||||
|
||||
<br/>
|
||||
|
||||
### Quick nav
|
||||
|
||||
[**Quick start**](#quick-start) · [**Install**](#install) · [**Commands**](#commands) · [**Agents**](#supported-agents) · [**Sources**](#skill-sources) · [**API**](#programmatic-api) · [**Website**](https://skillkit.sh)
|
||||
@@ -74,7 +67,7 @@ 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 45 agents at once.
|
||||
SkillKit is the package manager for AI agent skills. Install from 400K+ skills across 31 sources. Auto-translate between formats. Persist session learnings. Ship to 46 agents at once.
|
||||
|
||||
```bash
|
||||
npx skillkit add anthropics/skills
|
||||
@@ -354,6 +347,9 @@ 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>
|
||||
|
||||
@@ -426,9 +422,9 @@ skillkit cicd init # CI/CD templates
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Plus 34 more</b></summary>
|
||||
<summary><b>Plus 35 more</b></summary>
|
||||
|
||||
Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
|
||||
Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Hermes Agent, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
|
||||
</details>
|
||||
|
||||
[Full agent details](https://skillkit.sh/docs/agents)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# SkillKit
|
||||
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 45 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
Universal skills manager for AI coding agents. Install, manage, and sync skills across 46 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -188,9 +188,9 @@ skillkit memory compress
|
||||
skillkit memory export auth-insight --output auth-skill.md
|
||||
```
|
||||
|
||||
## Supported Agents (45)
|
||||
## Supported Agents (46)
|
||||
|
||||
**Primary (18):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
|
||||
**Primary (19):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Hermes Agent, Kilo, Kiro, Roo, Trae, Universal
|
||||
|
||||
**Extended (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
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.23.0",
|
||||
"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",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
|
||||
@@ -112,6 +112,7 @@ import {
|
||||
SkillMdCheckCommand,
|
||||
ServeCommand,
|
||||
ScanCommand,
|
||||
VerifyCommand,
|
||||
EvalCommand,
|
||||
DoctorCommand,
|
||||
SaveCommand,
|
||||
@@ -265,6 +266,7 @@ cli.register(SkillMdCheckCommand);
|
||||
|
||||
cli.register(ServeCommand);
|
||||
cli.register(ScanCommand);
|
||||
cli.register(VerifyCommand);
|
||||
cli.register(EvalCommand);
|
||||
cli.register(DoctorCommand);
|
||||
cli.register(SaveCommand);
|
||||
|
||||
@@ -5,6 +5,6 @@
|
||||
<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">45</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 After Width: | Height: | Size: 804 B |
@@ -1,5 +1,5 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="78" height="28" viewBox="0 0 78 28" role="img">
|
||||
<rect x="0.5" y="0.5" width="77" height="27" rx="4" ry="4" fill="#09090b" stroke="#3f3f46"/>
|
||||
<rect x="0" y="0" width="4" height="28" fill="#3b82f6"/>
|
||||
<text x="18" y="18" text-anchor="start" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12" font-weight="600" fill="#fafafa" letter-spacing="0.3">v1.23.0</text>
|
||||
<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 After Width: | Height: | Size: 452 B |
@@ -573,6 +573,23 @@ 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
|
||||
|
||||
@@ -101,17 +101,20 @@ SkillKit sits between your skills and your agents. It handles format translation
|
||||
|
||||
[Full agent details](/docs/agents)
|
||||
|
||||
### Security scanning
|
||||
### Security & integrity
|
||||
|
||||
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more:
|
||||
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:
|
||||
|
||||
```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 Scanner](/docs/security)
|
||||
[Security & Integrity](/docs/security)
|
||||
|
||||
## Beyond Basic Skills
|
||||
|
||||
@@ -169,7 +172,7 @@ 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 Scanner](/docs/security) — Threat detection for skills
|
||||
- [Security & Integrity](/docs/security) — Threat detection plus SHA-256 content verification
|
||||
- [Commands](/docs/commands) — Full CLI reference
|
||||
- [REST API](/docs/rest-api) — Runtime discovery server
|
||||
- [MCP Server](/docs/mcp-server) — Agent-native discovery
|
||||
|
||||
@@ -1,11 +1,16 @@
|
||||
---
|
||||
title: Security Scanner
|
||||
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
|
||||
title: Security & Integrity
|
||||
description: Scan skills for malicious patterns, verify content integrity, and lock against supply-chain tampering
|
||||
---
|
||||
|
||||
# Security Scanner
|
||||
# Security & Integrity
|
||||
|
||||
SkillKit includes a built-in security scanner that analyzes skills for prompt injection, command injection, data exfiltration, hardcoded secrets, and other threats before installation.
|
||||
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?"_.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -279,3 +284,42 @@ 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.
|
||||
|
||||
@@ -8,6 +8,34 @@ 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.23.0",
|
||||
"version": "1.24.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -0,0 +1,138 @@
|
||||
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
|
||||
|
||||
User-agent: Googlebot
|
||||
Allow: /
|
||||
|
||||
User-agent: Bingbot
|
||||
Allow: /
|
||||
|
||||
User-agent: DuckDuckBot
|
||||
Allow: /
|
||||
|
||||
User-agent: Applebot
|
||||
Allow: /
|
||||
|
||||
User-agent: ChatGPT-User
|
||||
Allow: /
|
||||
|
||||
User-agent: OAI-SearchBot
|
||||
Allow: /
|
||||
|
||||
User-agent: PerplexityBot
|
||||
Allow: /
|
||||
|
||||
User-agent: Perplexity-User
|
||||
Allow: /
|
||||
|
||||
User-agent: Claude-User
|
||||
Allow: /
|
||||
|
||||
User-agent: Claude-SearchBot
|
||||
Allow: /
|
||||
|
||||
User-agent: FirecrawlAgent
|
||||
Allow: /
|
||||
|
||||
User-agent: firecrawl
|
||||
Allow: /
|
||||
|
||||
User-agent: Context7Bot
|
||||
Allow: /
|
||||
|
||||
User-agent: Crawl4AI
|
||||
Allow: /
|
||||
|
||||
User-agent: Clawdbot
|
||||
Allow: /
|
||||
|
||||
User-agent: OpenClaw
|
||||
Allow: /
|
||||
|
||||
User-agent: Hermes
|
||||
Allow: /
|
||||
|
||||
User-agent: GPTBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ClaudeBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: anthropic-ai
|
||||
Disallow: /
|
||||
|
||||
User-agent: CCBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Google-Extended
|
||||
Disallow: /
|
||||
|
||||
User-agent: Applebot-Extended
|
||||
Disallow: /
|
||||
|
||||
User-agent: Bytespider
|
||||
Disallow: /
|
||||
|
||||
User-agent: Amazonbot
|
||||
Disallow: /
|
||||
|
||||
User-agent: FacebookBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Meta-ExternalAgent
|
||||
Disallow: /
|
||||
|
||||
User-agent: cohere-ai
|
||||
Disallow: /
|
||||
|
||||
User-agent: Diffbot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ImagesiftBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Omgilibot
|
||||
Disallow: /
|
||||
|
||||
User-agent: peer39_crawler
|
||||
Disallow: /
|
||||
|
||||
User-agent: YouBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Timpibot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ICC-Crawler
|
||||
Disallow: /
|
||||
|
||||
User-agent: AhrefsBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: SemrushBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: MJ12bot
|
||||
Disallow: /
|
||||
|
||||
User-agent: DotBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: PetalBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: BLEXBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: MegaIndex
|
||||
Disallow: /
|
||||
|
||||
User-agent: SeznamBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: DataForSeoBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: *
|
||||
Allow: /
|
||||
|
||||
Sitemap: https://skillkit-docs.vercel.app/sitemap.xml
|
||||
@@ -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 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
</p>
|
||||
<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 45 agent-specific formats</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -130,7 +130,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 45 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -158,7 +158,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 45 AI coding agents with automatic format translation:
|
||||
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Multi-Agent',
|
||||
description: 'Deploy to 45 AI coding agents with one command.',
|
||||
description: 'Deploy to 46 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', '45'],
|
||||
['Agents', '1', '46'],
|
||||
['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">45</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">46</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
import { NextResponse } from 'next/server';
|
||||
import type { NextRequest } from 'next/server';
|
||||
|
||||
const BLOCK = /GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot/i;
|
||||
|
||||
const ALLOW = /Googlebot|Bingbot|DuckDuckBot|Applebot(?!-Extended)|ChatGPT-User|OAI-SearchBot|PerplexityBot|Perplexity-User|Claude-User|Claude-SearchBot|FirecrawlAgent|firecrawl|Context7Bot|Crawl4AI|Clawdbot|OpenClaw|Hermes/i;
|
||||
|
||||
export function middleware(req: NextRequest) {
|
||||
const ua = req.headers.get('user-agent') || '';
|
||||
if (ALLOW.test(ua)) return NextResponse.next();
|
||||
if (BLOCK.test(ua)) {
|
||||
return new NextResponse('disallowed by robots.txt', {
|
||||
status: 403,
|
||||
headers: { 'Cache-Control': 'public, max-age=86400' },
|
||||
});
|
||||
}
|
||||
return NextResponse.next();
|
||||
}
|
||||
|
||||
export const config = {
|
||||
matcher: '/((?!_next/static|_next/image|favicon|robots\\.txt|sitemap\\.xml).*)',
|
||||
};
|
||||
+47
-35
@@ -1,70 +1,82 @@
|
||||
<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:#0a0a0a"/>
|
||||
<stop offset="50%" style="stop-color:#111111"/>
|
||||
<stop offset="100%" style="stop-color:#0a0a0a"/>
|
||||
<stop offset="0%" style="stop-color:#09090b"/>
|
||||
<stop offset="50%" style="stop-color:#111115"/>
|
||||
<stop offset="100%" style="stop-color:#09090b"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||
<stop offset="0%" style="stop-color:#333"/>
|
||||
<stop offset="50%" style="stop-color:#555"/>
|
||||
<stop offset="100%" style="stop-color:#333"/>
|
||||
<stop offset="0%" style="stop-color:#27272a"/>
|
||||
<stop offset="50%" style="stop-color:#3f3f46"/>
|
||||
<stop offset="100%" style="stop-color:#27272a"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#2a2a2a"/>
|
||||
<stop offset="100%" style="stop-color:#1a1a1a"/>
|
||||
<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"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
|
||||
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
|
||||
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
<rect x="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
|
||||
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
|
||||
<line x1="60" y1="354" x2="1140" y2="354" stroke="#1f1f23" stroke-width="1"/>
|
||||
|
||||
<g transform="translate(60, 72)">
|
||||
<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="#444" stroke-width="1" rx="20"/>
|
||||
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
|
||||
<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"/>
|
||||
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
|
||||
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
|
||||
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#a1a1aa" letter-spacing="1">PRODUCT HUNT</text>
|
||||
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
||||
</g>
|
||||
|
||||
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 44 Agents.</text>
|
||||
<text x="600" y="196" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="url(#accentText)" text-anchor="middle" letter-spacing="-1.5">One skill. <tspan fill="url(#numberAccent)">46</tspan> agents.</text>
|
||||
|
||||
<text x="600" y="248" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" fill="#888" text-anchor="middle" letter-spacing="0.5">The open source package manager for AI agent skills</text>
|
||||
<text x="600" y="240" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="18" fill="#a1a1aa" text-anchor="middle" letter-spacing="0.3">Package manager for AI agent skills — install, translate, sync.</text>
|
||||
|
||||
<g transform="translate(240, 282)">
|
||||
<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 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>
|
||||
|
||||
<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 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>
|
||||
|
||||
<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 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>
|
||||
|
||||
<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 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>
|
||||
|
||||
<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 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>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 4.8 KiB |
@@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
id: 'primer',
|
||||
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 45 agents.',
|
||||
highlight: 'Auto-generates instructions for 45 agents',
|
||||
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 46 agents.',
|
||||
highlight: 'Auto-generates instructions for 46 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 45 agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 46 agents' },
|
||||
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
||||
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
||||
],
|
||||
|
||||
@@ -429,7 +429,7 @@ export function Agents(): React.ReactElement {
|
||||
<section className="py-6 border-b border-zinc-800 overflow-hidden">
|
||||
<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 45 AI Agents
|
||||
Works with 46 AI Agents
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -99,6 +99,9 @@ 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 45 agents and {CATEGORIES.length} categories.
|
||||
Skill support across all 46 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 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
</p>
|
||||
<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 45 agents</li>
|
||||
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 46 agents</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 45 agent-specific formats</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -129,7 +129,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 45 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 46 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -157,7 +157,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 45 AI coding agents with automatic format translation:
|
||||
SkillKit supports 46 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
@@ -234,7 +234,7 @@ skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
|
||||
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
|
||||
skillkit primer --all-agents # Generate for all 45 agents
|
||||
skillkit primer --all-agents # Generate for all 46 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
|
||||
|
||||
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Primer',
|
||||
description: 'Auto-generate agent instructions for all 45 agents from your codebase.',
|
||||
description: 'Auto-generate agent instructions for all 46 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" />
|
||||
@@ -79,6 +79,15 @@ 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.',
|
||||
@@ -109,11 +118,12 @@ const FEATURES: Feature[] = [
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agent Support', '1-17 agents', '45 agents'],
|
||||
['Agent Support', '1-17 agents', '46 agents'],
|
||||
['Sources', 'Single registry', '34+ aggregated'],
|
||||
['Translation', 'None or limited', 'All 45 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'],
|
||||
|
||||
@@ -22,7 +22,7 @@ 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 45 agent formats' },
|
||||
{ type: 'out', text: '→ Translated to 46 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' },
|
||||
@@ -149,7 +149,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
|
||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||
The open source package manager that aggregates 34+ skill sources,
|
||||
scans 400K+ skills from registries, auto-translates to 45 agent formats,
|
||||
scans 400K+ skills from registries, auto-translates to 46 agent formats,
|
||||
and adds memory, security scanning, and team workflows. Everything runs locally.
|
||||
</p>
|
||||
|
||||
|
||||
@@ -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 45 agents. Write once, deploy everywhere.',
|
||||
solution: 'SkillKit translates skills between all 46 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: '45', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||
{ name: 'SkillKit', type: 'Platform', agents: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||
];
|
||||
|
||||
const SOURCES = [
|
||||
|
||||
@@ -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 45 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
|
||||
<!-- Open Graph -->
|
||||
<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 45 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta property="og:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta property="og:image" content="https://skillkit.sh/og-image.png">
|
||||
<meta property="og:image: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 45 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="twitter:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
|
||||
|
||||
<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 45 agents.",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 46 agents.",
|
||||
"requestFramePermissions": []
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
@@ -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 45 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
||||
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
||||
"license": {
|
||||
"name": "Apache-2.0",
|
||||
"url": "https://opensource.org/licenses/Apache-2.0"
|
||||
|
||||
@@ -0,0 +1,138 @@
|
||||
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
|
||||
|
||||
User-agent: Googlebot
|
||||
Allow: /
|
||||
|
||||
User-agent: Bingbot
|
||||
Allow: /
|
||||
|
||||
User-agent: DuckDuckBot
|
||||
Allow: /
|
||||
|
||||
User-agent: Applebot
|
||||
Allow: /
|
||||
|
||||
User-agent: ChatGPT-User
|
||||
Allow: /
|
||||
|
||||
User-agent: OAI-SearchBot
|
||||
Allow: /
|
||||
|
||||
User-agent: PerplexityBot
|
||||
Allow: /
|
||||
|
||||
User-agent: Perplexity-User
|
||||
Allow: /
|
||||
|
||||
User-agent: Claude-User
|
||||
Allow: /
|
||||
|
||||
User-agent: Claude-SearchBot
|
||||
Allow: /
|
||||
|
||||
User-agent: FirecrawlAgent
|
||||
Allow: /
|
||||
|
||||
User-agent: firecrawl
|
||||
Allow: /
|
||||
|
||||
User-agent: Context7Bot
|
||||
Allow: /
|
||||
|
||||
User-agent: Crawl4AI
|
||||
Allow: /
|
||||
|
||||
User-agent: Clawdbot
|
||||
Allow: /
|
||||
|
||||
User-agent: OpenClaw
|
||||
Allow: /
|
||||
|
||||
User-agent: Hermes
|
||||
Allow: /
|
||||
|
||||
User-agent: GPTBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ClaudeBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: anthropic-ai
|
||||
Disallow: /
|
||||
|
||||
User-agent: CCBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Google-Extended
|
||||
Disallow: /
|
||||
|
||||
User-agent: Applebot-Extended
|
||||
Disallow: /
|
||||
|
||||
User-agent: Bytespider
|
||||
Disallow: /
|
||||
|
||||
User-agent: Amazonbot
|
||||
Disallow: /
|
||||
|
||||
User-agent: FacebookBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Meta-ExternalAgent
|
||||
Disallow: /
|
||||
|
||||
User-agent: cohere-ai
|
||||
Disallow: /
|
||||
|
||||
User-agent: Diffbot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ImagesiftBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Omgilibot
|
||||
Disallow: /
|
||||
|
||||
User-agent: peer39_crawler
|
||||
Disallow: /
|
||||
|
||||
User-agent: YouBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: Timpibot
|
||||
Disallow: /
|
||||
|
||||
User-agent: ICC-Crawler
|
||||
Disallow: /
|
||||
|
||||
User-agent: AhrefsBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: SemrushBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: MJ12bot
|
||||
Disallow: /
|
||||
|
||||
User-agent: DotBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: PetalBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: BLEXBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: MegaIndex
|
||||
Disallow: /
|
||||
|
||||
User-agent: SeznamBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: DataForSeoBot
|
||||
Disallow: /
|
||||
|
||||
User-agent: *
|
||||
Allow: /
|
||||
|
||||
Sitemap: https://skillkit.dev/sitemap.xml
|
||||
@@ -21,5 +21,47 @@
|
||||
"source": "/docs",
|
||||
"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 45 agents', async () => {
|
||||
it('should display all 46 agents', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
@@ -93,6 +93,7 @@ describe('E2E: Onboarding UI', () => {
|
||||
'Tabnine',
|
||||
'CodeGPT',
|
||||
'PlayCode',
|
||||
'Hermes',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
|
||||
@@ -28,7 +28,7 @@ import {
|
||||
type CrossAgentSkill,
|
||||
} from '@skillkit/core';
|
||||
|
||||
// All 45 supported agents
|
||||
// All 46 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -74,6 +74,7 @@ const SUPPORTED_AGENTS = [
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translator - Parsing', () => {
|
||||
|
||||
@@ -16,7 +16,7 @@ import {
|
||||
testFileExists,
|
||||
} from './helpers/cli-runner.js';
|
||||
|
||||
// All 45 supported agents
|
||||
// All 46 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -62,6 +62,7 @@ const SUPPORTED_AGENTS = [
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translation', () => {
|
||||
|
||||
+2
-2
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 45 coding agents",
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 46 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 45 AI coding agents.
|
||||
**Agent adapters for SkillKit** - configuration and detection for 46 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
npm install @skillkit/agents
|
||||
```
|
||||
|
||||
## Supported Agents (45)
|
||||
## Supported Agents (46)
|
||||
|
||||
| Agent | Config Format | Project Skills | Global Skills |
|
||||
|-------|--------------|----------------|---------------|
|
||||
@@ -23,7 +23,7 @@ npm install @skillkit/agents
|
||||
| Antigravity | SKILL.md | `.antigravity/skills/` | - |
|
||||
| Amp | SKILL.md | `.amp/skills/` | - |
|
||||
| Clawdbot | SKILL.md | `.clawdbot/skills/` | - |
|
||||
| OpenClaw | SKILL.md | `skills/` | - |
|
||||
| OpenClaw | SKILL.md | `.openclaw/skills/` | `~/.openclaw/workspace/skills/` |
|
||||
| Cline | SKILL.md | `.cline/skills/` | - |
|
||||
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
|
||||
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.23.0",
|
||||
"description": "Agent adapters for SkillKit - supports 45 AI coding agents",
|
||||
"version": "1.24.0",
|
||||
"description": "Agent adapters for SkillKit - supports 46 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 45 registered adapters', () => {
|
||||
it('should return all 46 registered adapters', () => {
|
||||
const adapters = getAllAdapters();
|
||||
expect(adapters).toBeInstanceOf(Array);
|
||||
expect(adapters.length).toBe(45);
|
||||
expect(adapters.length).toBe(46);
|
||||
});
|
||||
|
||||
it('should include common agents', () => {
|
||||
@@ -140,4 +140,43 @@ 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');
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
@@ -33,6 +33,7 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
|
||||
'tabnine': 'Tabnine',
|
||||
'codegpt': 'CodeGPT',
|
||||
'playcode-agent': 'PlayCode Agent',
|
||||
'hermes': 'Hermes',
|
||||
};
|
||||
|
||||
export class GenericAgentAdapter implements AgentAdapter {
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
import { existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import type { AgentAdapter } from './base.js';
|
||||
import { createSkillXml } from './base.js';
|
||||
import type { Skill, AgentType } from '@skillkit/core';
|
||||
import { AGENT_CONFIG } from '@skillkit/core';
|
||||
|
||||
const config = AGENT_CONFIG.hermes;
|
||||
|
||||
/**
|
||||
* Hermes Agent Adapter
|
||||
*
|
||||
* Hermes Agent is an advanced AI agent with support for XML-based skills.
|
||||
* It uses AGENTS.md for instructions and ~/.hermes/skills/ for global skills.
|
||||
*/
|
||||
export class HermesAdapter implements AgentAdapter {
|
||||
readonly type: AgentType = 'hermes';
|
||||
readonly name = 'Hermes Agent';
|
||||
readonly skillsDir = config.skillsDir;
|
||||
readonly configFile = config.configFile;
|
||||
|
||||
generateConfig(skills: Skill[]): string {
|
||||
const enabledSkills = skills.filter(s => s.enabled);
|
||||
|
||||
if (enabledSkills.length === 0) {
|
||||
return '';
|
||||
}
|
||||
|
||||
const skillsXml = enabledSkills.map(createSkillXml).join('\n\n');
|
||||
|
||||
return `<skills_system priority="1">
|
||||
|
||||
## Available Skills
|
||||
|
||||
<!-- SKILLS_TABLE_START -->
|
||||
<usage>
|
||||
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
|
||||
|
||||
How to use skills:
|
||||
- Invoke: \`skillkit read <skill-name>\` or \`npx skillkit read <skill-name>\`
|
||||
- The skill content will load with detailed instructions on how to complete the task
|
||||
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
|
||||
|
||||
Usage notes:
|
||||
- Only use skills listed in <available_skills> below
|
||||
- Do not invoke a skill that is already loaded in your context
|
||||
- Each skill invocation is stateless
|
||||
</usage>
|
||||
|
||||
<available_skills>
|
||||
|
||||
${skillsXml}
|
||||
|
||||
</available_skills>
|
||||
<!-- SKILLS_TABLE_END -->
|
||||
|
||||
</skills_system>`;
|
||||
}
|
||||
|
||||
parseConfig(content: string): string[] {
|
||||
const startMarker = '<!-- SKILLS_TABLE_START -->';
|
||||
const endMarker = '<!-- SKILLS_TABLE_END -->';
|
||||
const startIndex = content.indexOf(startMarker);
|
||||
const endIndex = content.indexOf(endMarker);
|
||||
|
||||
if (startIndex === -1 || endIndex === -1) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const scopedContent = content.substring(startIndex + startMarker.length, endIndex);
|
||||
const skillNames: string[] = [];
|
||||
const skillRegex = /<name>([^<]+)<\/name>/g;
|
||||
let match;
|
||||
|
||||
while ((match = skillRegex.exec(scopedContent)) !== null) {
|
||||
skillNames.push(match[1].trim());
|
||||
}
|
||||
|
||||
return skillNames;
|
||||
}
|
||||
|
||||
getInvokeCommand(skillName: string): string {
|
||||
return `skillkit read ${skillName}`;
|
||||
}
|
||||
|
||||
async isDetected(): Promise<boolean> {
|
||||
const projectHermes = join(process.cwd(), '.hermes');
|
||||
const globalHermes = join(homedir(), '.hermes');
|
||||
|
||||
return existsSync(projectHermes) || existsSync(globalHermes);
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,7 @@ 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';
|
||||
@@ -41,6 +42,7 @@ 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
|
||||
@@ -92,6 +94,7 @@ 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 {
|
||||
@@ -160,6 +163,7 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
'universal',
|
||||
];
|
||||
|
||||
|
||||
@@ -14,9 +14,12 @@ export class OpenClawAdapter extends ClawdbotAdapter {
|
||||
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(globalOpenClaw) || existsSync(openclawConfig);
|
||||
return existsSync(projectOpenClaw) || existsSync(globalOpenClaw) ||
|
||||
existsSync(globalWorkspace) || existsSync(openclawConfig);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/api",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -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 45 agents).',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 46 agents).',
|
||||
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
||||
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
||||
},
|
||||
|
||||
@@ -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 45 AI coding agents.
|
||||
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 46 AI coding agents.
|
||||
|
||||
## Installation
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -30,6 +30,8 @@ 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', 45);
|
||||
const logo = getFullLogo('1.7.2', 46);
|
||||
expect(logo).toContain('\u2588');
|
||||
expect(logo).toContain('v1.7.2');
|
||||
expect(logo).toContain('45 agents');
|
||||
expect(logo).toContain('46 agents');
|
||||
});
|
||||
|
||||
it('should generate compact logo', async () => {
|
||||
|
||||
@@ -0,0 +1,82 @@
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import { mkdtempSync, writeFileSync, rmSync, mkdirSync } from 'node:fs';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { join } from 'node:path';
|
||||
import { execFileSync } from 'node:child_process';
|
||||
|
||||
const CLI = join(__dirname, '../../../../apps/skillkit/dist/cli.js');
|
||||
|
||||
function run(args: string[]): { code: number; stdout: string; stderr: string } {
|
||||
try {
|
||||
const stdout = execFileSync(process.execPath, [CLI, ...args], {
|
||||
encoding: 'utf-8',
|
||||
stdio: ['ignore', 'pipe', 'pipe'],
|
||||
});
|
||||
return { code: 0, stdout, stderr: '' };
|
||||
} catch (err: any) {
|
||||
return {
|
||||
code: err.status ?? 1,
|
||||
stdout: err.stdout?.toString() ?? '',
|
||||
stderr: err.stderr?.toString() ?? '',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
describe('skillkit verify', () => {
|
||||
let dir: string;
|
||||
|
||||
beforeEach(() => {
|
||||
dir = mkdtempSync(join(tmpdir(), 'skillkit-verify-cli-'));
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
rmSync(dir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
it('prints an SRI digest by default', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), '# test\n');
|
||||
const r = run(['verify', dir]);
|
||||
expect(r.code).toBe(0);
|
||||
expect(r.stdout.trim()).toMatch(/^sha256-[A-Za-z0-9+/]+=*$/);
|
||||
});
|
||||
|
||||
it('emits JSON with --json', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), '# test\n');
|
||||
mkdirSync(join(dir, 'scripts'));
|
||||
writeFileSync(join(dir, 'scripts', 'a.sh'), 'echo');
|
||||
const r = run(['verify', dir, '--json']);
|
||||
expect(r.code).toBe(0);
|
||||
const payload = JSON.parse(r.stdout);
|
||||
expect(payload.ok).toBe(true);
|
||||
expect(payload.algorithm).toBe('sha256');
|
||||
expect(payload.sri).toMatch(/^sha256-/);
|
||||
expect(typeof payload.digest).toBe('string');
|
||||
expect(payload.totalBytes).toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it('returns exit 1 on integrity mismatch', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'hello');
|
||||
const bogus = 'sha256-' + Buffer.alloc(32, 7).toString('base64');
|
||||
const r = run(['verify', dir, '--expected', bogus, '--json']);
|
||||
expect(r.code).toBe(1);
|
||||
const payload = JSON.parse(r.stdout);
|
||||
expect(payload.ok).toBe(false);
|
||||
expect(payload.reason).toBe('mismatch');
|
||||
});
|
||||
|
||||
it('returns exit 0 when --expected matches', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'matched');
|
||||
const computed = run(['verify', dir]);
|
||||
const sri = computed.stdout.trim();
|
||||
const r = run(['verify', dir, '--expected', sri, '--json']);
|
||||
expect(r.code).toBe(0);
|
||||
const payload = JSON.parse(r.stdout);
|
||||
expect(payload.ok).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects garbage --expected', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'x');
|
||||
const r = run(['verify', dir, '--expected', 'garbage']);
|
||||
expect(r.code).toBe(1);
|
||||
});
|
||||
});
|
||||
@@ -125,6 +125,7 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
|
||||
// API server
|
||||
export { ServeCommand } from './serve.js';
|
||||
export { ScanCommand } from './scan.js';
|
||||
export { VerifyCommand } from './verify.js';
|
||||
export { EvalCommand } from './eval.js';
|
||||
export { IssuePlanCommand, IssueListCommand } from './issue.js';
|
||||
export { DoctorCommand } from './doctor.js';
|
||||
|
||||
@@ -29,6 +29,7 @@ import {
|
||||
TrustScorer,
|
||||
readSkillContent,
|
||||
computeSkillChecksum,
|
||||
computeSkillIntegrity,
|
||||
addSkillToLock,
|
||||
} from "@skillkit/core";
|
||||
import type { SkillsShStats } from "@skillkit/core";
|
||||
@@ -617,11 +618,17 @@ export class InstallCommand extends Command {
|
||||
const actualPath = isStandalone
|
||||
? join(firstAgentInstallDir, skillName.endsWith(".md") ? skillName : `${skillName}.md`)
|
||||
: join(firstAgentInstallDir, skillName);
|
||||
let integritySri: string | undefined;
|
||||
try {
|
||||
integritySri = computeSkillIntegrity(actualPath).sri;
|
||||
} catch {
|
||||
integritySri = undefined;
|
||||
}
|
||||
addSkillToLock(skillName, {
|
||||
source: this.source,
|
||||
sourceType: providerAdapter!.type,
|
||||
installedAt: new Date().toISOString(),
|
||||
checksum: computeSkillChecksum(actualPath),
|
||||
checksum: integritySri ?? computeSkillChecksum(actualPath),
|
||||
agents: installedAgents,
|
||||
path: actualPath,
|
||||
});
|
||||
|
||||
@@ -22,13 +22,13 @@ export class PrimerCommand extends Command {
|
||||
for AI coding agents.
|
||||
|
||||
By default, it generates instructions for detected agents in your project.
|
||||
Use --all-agents to generate for all 45 supported agents.
|
||||
Use --all-agents to generate for all 46 supported agents.
|
||||
|
||||
Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
|
||||
`,
|
||||
examples: [
|
||||
['Generate for detected agents', '$0 primer'],
|
||||
['Generate for all 45 agents', '$0 primer --all-agents'],
|
||||
['Generate for all 46 agents', '$0 primer --all-agents'],
|
||||
['Generate for specific agents', '$0 primer --agent claude-code,cursor,github-copilot'],
|
||||
['Custom output directory', '$0 primer --output ./instructions'],
|
||||
['Preview without writing files', '$0 primer --dry-run'],
|
||||
@@ -42,7 +42,7 @@ export class PrimerCommand extends Command {
|
||||
});
|
||||
|
||||
allAgents = Option.Boolean('--all-agents,-A', false, {
|
||||
description: 'Generate for all 45 supported agents',
|
||||
description: 'Generate for all 46 supported agents',
|
||||
});
|
||||
|
||||
output = Option.String('--output,-o', {
|
||||
|
||||
@@ -25,6 +25,7 @@ import {
|
||||
formatSummary,
|
||||
Severity,
|
||||
evaluateSkillDirectory,
|
||||
computeSkillIntegrity,
|
||||
} from "@skillkit/core";
|
||||
import { formatCount, timeAgo, fetchGitHubActivity } from "../helpers.js";
|
||||
|
||||
@@ -194,10 +195,21 @@ export class PublishCommand extends Command {
|
||||
description: skill.description,
|
||||
path: skill.path,
|
||||
});
|
||||
let integritySri: string | undefined;
|
||||
try {
|
||||
integritySri = computeSkillIntegrity(skill.path).sri;
|
||||
} catch {
|
||||
integritySri = undefined;
|
||||
}
|
||||
if (integritySri) {
|
||||
console.log(colors.muted(` Integrity: ${integritySri}`));
|
||||
}
|
||||
|
||||
wellKnownSkills.push({
|
||||
name: safeName,
|
||||
description: skill.description,
|
||||
files,
|
||||
integrity: integritySri,
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
@@ -214,6 +214,10 @@ function updateConfigContent(existing: string, newConfig: string, agentType: Age
|
||||
start: '<!-- SKILLKIT_SKILLS_START -->',
|
||||
end: '<!-- SKILLKIT_SKILLS_END -->',
|
||||
},
|
||||
hermes: {
|
||||
start: '<!-- SKILLS_TABLE_START -->',
|
||||
end: '<!-- SKILLS_TABLE_END -->',
|
||||
},
|
||||
};
|
||||
|
||||
const agentMarkers = markers[agentType] || markers.universal;
|
||||
|
||||
@@ -1,7 +1,15 @@
|
||||
import { existsSync, rmSync, cpSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { findAllSkills, findSkill, detectProvider, isLocalPath, computeSkillChecksum, addSkillToLock } from '@skillkit/core';
|
||||
import { findAllSkills, findSkill, detectProvider, isLocalPath, computeSkillChecksum, computeSkillIntegrity, addSkillToLock } from '@skillkit/core';
|
||||
|
||||
function safeIntegrity(path: string): string | undefined {
|
||||
try {
|
||||
return computeSkillIntegrity(path).sri;
|
||||
} catch {
|
||||
return undefined;
|
||||
}
|
||||
}
|
||||
import { getSearchDirs, loadSkillMetadata, saveSkillMetadata, fetchGitHubActivity } from '../helpers.js';
|
||||
import { colors, spinner, warn, step } from '../onboarding/index.js';
|
||||
|
||||
@@ -102,7 +110,7 @@ export class UpdateCommand extends Command {
|
||||
sourceType: metadata.sourceType,
|
||||
installedAt: metadata.installedAt,
|
||||
updatedAt: metadata.updatedAt,
|
||||
checksum: metadata.checksum,
|
||||
checksum: safeIntegrity(skill.path) ?? metadata.checksum,
|
||||
agents: [],
|
||||
path: skill.path,
|
||||
});
|
||||
@@ -170,7 +178,7 @@ export class UpdateCommand extends Command {
|
||||
sourceType: metadata.sourceType,
|
||||
installedAt: metadata.installedAt,
|
||||
updatedAt: metadata.updatedAt,
|
||||
checksum: metadata.checksum,
|
||||
checksum: safeIntegrity(skill.path) ?? metadata.checksum,
|
||||
agents: [],
|
||||
path: skill.path,
|
||||
});
|
||||
|
||||
@@ -0,0 +1,167 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import { existsSync } from 'node:fs';
|
||||
import {
|
||||
computeSkillIntegrity,
|
||||
verifySkillIntegrity,
|
||||
loadLockFile,
|
||||
parseIntegrity,
|
||||
} from '@skillkit/core';
|
||||
import { colors, success, error, warn, step } from '../onboarding/index.js';
|
||||
|
||||
export class VerifyCommand extends Command {
|
||||
static override paths = [['verify']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Compute or verify the SHA-256 integrity of a skill',
|
||||
details: `
|
||||
Computes a deterministic SHA-256 digest over every file in the skill
|
||||
(excluding .skillkit.json metadata and version-control artifacts). The
|
||||
digest is emitted as a Subresource Integrity (SRI) string by default
|
||||
(sha256-<base64>) and is compatible with the published well-known/skills.json
|
||||
index.
|
||||
|
||||
Pass --expected to verify against a known value, or --against-lock to
|
||||
cross-check against the locally recorded checksum in ~/.skillkit/lock.json.
|
||||
`,
|
||||
examples: [
|
||||
['Print integrity of current directory', '$0 verify .'],
|
||||
['Print full per-file table', '$0 verify ./my-skill --files'],
|
||||
['Verify against an expected digest', '$0 verify ./my-skill --expected=sha256-abc...'],
|
||||
['Verify against the local lockfile', '$0 verify ./my-skill --against-lock'],
|
||||
['Emit JSON for CI pipelines', '$0 verify ./my-skill --json'],
|
||||
],
|
||||
});
|
||||
|
||||
skillPath = Option.String({ required: true, name: 'path' });
|
||||
|
||||
expected = Option.String('--expected', { description: 'Expected integrity (SRI or hex sha256)' });
|
||||
|
||||
againstLock = Option.Boolean('--against-lock', false, {
|
||||
description: 'Verify against the checksum recorded in ~/.skillkit/lock.json',
|
||||
});
|
||||
|
||||
showFiles = Option.Boolean('--files', false, { description: 'Print per-file digests' });
|
||||
|
||||
json = Option.Boolean('--json', false, { description: 'Emit machine-readable JSON' });
|
||||
|
||||
format = Option.String('--format', 'sri', {
|
||||
description: 'Output digest format: sri (default) or hex',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const target = resolve(this.skillPath);
|
||||
if (!existsSync(target)) {
|
||||
error(`Path not found: ${target}`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (this.format !== 'sri' && this.format !== 'hex') {
|
||||
error(`Invalid --format value: "${this.format}" (must be 'sri' or 'hex')`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
let computed;
|
||||
try {
|
||||
computed = computeSkillIntegrity(target);
|
||||
} catch (err) {
|
||||
error((err as Error).message);
|
||||
return 1;
|
||||
}
|
||||
|
||||
const expectedFromArgs = this.expected?.trim();
|
||||
const expectedFromLock = this.againstLock ? findLockChecksum(target) : null;
|
||||
const expected = expectedFromArgs ?? expectedFromLock ?? null;
|
||||
|
||||
if (this.againstLock && !expectedFromLock) {
|
||||
if (this.json) {
|
||||
this.context.stdout.write(
|
||||
JSON.stringify({ ok: false, reason: 'no-lock-entry', target }, null, 2) + '\n',
|
||||
);
|
||||
} else {
|
||||
warn(`No lock entry found for ${target}`);
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (expected) {
|
||||
const parsed = parseIntegrity(expected);
|
||||
if (!parsed) {
|
||||
error(`Invalid --expected value (must be sha256-<base64> or 64-char hex)`);
|
||||
return 1;
|
||||
}
|
||||
const result = verifySkillIntegrity(target, expected);
|
||||
if (this.json) {
|
||||
this.context.stdout.write(
|
||||
JSON.stringify(
|
||||
{
|
||||
ok: result.valid,
|
||||
algorithm: result.algorithm,
|
||||
expected: parsed.digest,
|
||||
computed: result.computed,
|
||||
sri: computed.sri,
|
||||
files: computed.files.length,
|
||||
totalBytes: computed.totalBytes,
|
||||
reason: result.reason,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
) + '\n',
|
||||
);
|
||||
return result.valid ? 0 : 1;
|
||||
}
|
||||
if (result.valid) {
|
||||
success(`Integrity verified (${computed.files.length} files, ${computed.totalBytes} bytes)`);
|
||||
this.context.stdout.write(` ${colors.dim('expected')} ${parsed.digest}\n`);
|
||||
this.context.stdout.write(` ${colors.dim('computed')} ${result.computed}\n`);
|
||||
return 0;
|
||||
}
|
||||
error('Integrity mismatch — skill content has changed since signing');
|
||||
this.context.stdout.write(` ${colors.dim('expected')} ${parsed.digest}\n`);
|
||||
this.context.stdout.write(` ${colors.dim('computed')} ${result.computed}\n`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
this.context.stdout.write(
|
||||
JSON.stringify(
|
||||
{
|
||||
ok: true,
|
||||
algorithm: computed.algorithm,
|
||||
sri: computed.sri,
|
||||
digest: computed.digest,
|
||||
files: this.showFiles ? computed.files : computed.files.length,
|
||||
totalBytes: computed.totalBytes,
|
||||
},
|
||||
null,
|
||||
2,
|
||||
) + '\n',
|
||||
);
|
||||
return 0;
|
||||
}
|
||||
|
||||
const out = this.format === 'hex' ? computed.digest : computed.sri;
|
||||
this.context.stdout.write(out + '\n');
|
||||
if (this.showFiles) {
|
||||
step(`${computed.files.length} files, ${computed.totalBytes} bytes`);
|
||||
for (const f of computed.files) {
|
||||
this.context.stdout.write(` ${colors.dim(f.sha256.slice(0, 12))} ${f.path}\n`);
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function findLockChecksum(target: string): string | null {
|
||||
try {
|
||||
const lock = loadLockFile();
|
||||
for (const entry of Object.values(lock.skills)) {
|
||||
if (entry.path === target && entry.checksum) {
|
||||
return entry.checksum;
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
@@ -14,7 +14,7 @@ npm install @skillkit/core
|
||||
## Key Features
|
||||
|
||||
- **Skill Discovery**: Find and parse SKILL.md files from any source
|
||||
- **Cross-Agent Translation**: Convert skills between 45 agent formats (Claude Code, Cursor, Windsurf, etc.)
|
||||
- **Cross-Agent Translation**: Convert skills between 46 agent formats (Claude Code, Cursor, Windsurf, etc.)
|
||||
- **Project Context Detection**: Analyze project stack, dependencies, and configurations
|
||||
- **Smart Recommendations**: AI-powered skill suggestions based on project profile
|
||||
- **Session Memory**: Capture and persist learnings across AI coding sessions
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -15,6 +15,8 @@ export interface AgentDirectoryConfig {
|
||||
skillsDir: string;
|
||||
/** Config file that references skills */
|
||||
configFile: string;
|
||||
/** Alternative config files that also mark this agent as present */
|
||||
altConfigFiles?: string[];
|
||||
/** Alternative skills directories */
|
||||
altSkillsDirs?: string[];
|
||||
/** Global skills directory */
|
||||
@@ -121,10 +123,11 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
|
||||
},
|
||||
|
||||
openclaw: {
|
||||
skillsDir: 'skills',
|
||||
configFile: 'CLAUDE.md',
|
||||
altSkillsDirs: ['~/.openclaw/skills'],
|
||||
globalSkillsDir: '~/.openclaw/skills',
|
||||
skillsDir: '.openclaw/skills',
|
||||
configFile: 'AGENTS.md',
|
||||
altConfigFiles: ['openclaw.json'],
|
||||
altSkillsDirs: ['skills', '~/.openclaw/workspace/skills'],
|
||||
globalSkillsDir: '~/.openclaw/workspace/skills',
|
||||
configFormat: 'xml',
|
||||
usesFrontmatter: true,
|
||||
frontmatterFields: [
|
||||
@@ -474,6 +477,16 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
|
||||
usesFrontmatter: true,
|
||||
supportsAutoDiscovery: true,
|
||||
},
|
||||
|
||||
// Hermes Agent
|
||||
hermes: {
|
||||
skillsDir: '.hermes/skills',
|
||||
configFile: 'AGENTS.md',
|
||||
globalSkillsDir: '~/.hermes/skills',
|
||||
configFormat: 'xml',
|
||||
usesFrontmatter: true,
|
||||
supportsAutoDiscovery: true,
|
||||
},
|
||||
};
|
||||
|
||||
/**
|
||||
|
||||
@@ -264,6 +264,7 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
|
||||
'tabnine': ['.tabnine/agents'],
|
||||
'codegpt': ['.codegpt/agents'],
|
||||
'playcode-agent': ['.playcode/agents'],
|
||||
'hermes': ['.hermes/agents'],
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -324,6 +325,7 @@ export const ALL_AGENT_DISCOVERY_PATHS = [
|
||||
'.tabnine/agents',
|
||||
'.codegpt/agents',
|
||||
'.playcode/agents',
|
||||
'.hermes/agents',
|
||||
];
|
||||
|
||||
/**
|
||||
@@ -375,4 +377,5 @@ export const CUSTOM_AGENT_FORMAT_MAP: Record<AgentType, AgentFormatCategory> = {
|
||||
'tabnine': 'universal',
|
||||
'codegpt': 'universal',
|
||||
'playcode-agent': 'universal',
|
||||
'hermes': 'claude-agent',
|
||||
};
|
||||
|
||||
@@ -332,6 +332,13 @@ const AGENT_FORMATS: Record<AgentType, AgentCommandFormat> = {
|
||||
supportsSlashCommands: false,
|
||||
supportsCommandFiles: true,
|
||||
},
|
||||
hermes: {
|
||||
agent: 'hermes',
|
||||
extension: '.md',
|
||||
directory: '.hermes/commands',
|
||||
supportsSlashCommands: true,
|
||||
supportsCommandFiles: true,
|
||||
},
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -593,6 +600,7 @@ export class CommandGenerator {
|
||||
case 'amp':
|
||||
case 'roo':
|
||||
case 'kiro-cli':
|
||||
case 'hermes':
|
||||
return this.generateClaudeCommands(commands);
|
||||
|
||||
case 'cursor':
|
||||
|
||||
@@ -4,6 +4,7 @@ import { homedir } from 'node:os';
|
||||
import { createHash } from 'node:crypto';
|
||||
import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
|
||||
import { SkillkitConfig, LockFile, type AgentType, type SkillMetadata, type AgentAdapterInfo, type LockEntry } from './types.js';
|
||||
import { AGENT_CONFIG } from './agent-config.js';
|
||||
|
||||
const CONFIG_FILE = 'skillkit.yaml';
|
||||
const METADATA_FILE = '.skillkit.json';
|
||||
@@ -99,7 +100,16 @@ export function getSearchDirs(adapter: AgentAdapterInfo): string[] {
|
||||
|
||||
dirs.push(join(process.cwd(), adapter.skillsDir));
|
||||
dirs.push(join(process.cwd(), '.agent', 'skills'));
|
||||
dirs.push(join(homedir(), adapter.skillsDir));
|
||||
|
||||
const globalDir = AGENT_CONFIG[adapter.type]?.globalSkillsDir;
|
||||
if (globalDir) {
|
||||
const resolved = globalDir.startsWith('~/')
|
||||
? join(homedir(), globalDir.slice(2))
|
||||
: globalDir;
|
||||
dirs.push(resolved);
|
||||
} else {
|
||||
dirs.push(join(homedir(), adapter.skillsDir));
|
||||
}
|
||||
dirs.push(join(homedir(), '.agent', 'skills'));
|
||||
|
||||
return dirs;
|
||||
|
||||
@@ -55,8 +55,11 @@ export class ContextSync {
|
||||
const skillsPath = join(this.projectPath, config.skillsDir);
|
||||
const configPath = join(this.projectPath, config.configFile);
|
||||
|
||||
// Check if either skills directory or config file exists
|
||||
if (existsSync(skillsPath) || existsSync(configPath)) {
|
||||
const altConfigExists = (config.altConfigFiles ?? []).some((alt) =>
|
||||
existsSync(join(this.projectPath, alt))
|
||||
);
|
||||
|
||||
if (existsSync(skillsPath) || existsSync(configPath) || altConfigExists) {
|
||||
detected.push(agent as AgentType);
|
||||
}
|
||||
}
|
||||
@@ -283,6 +286,7 @@ export class ContextSync {
|
||||
const commonDirs = [
|
||||
'.claude/skills',
|
||||
'.cursor/skills',
|
||||
'.hermes/skills',
|
||||
'.agent/skills',
|
||||
'skills',
|
||||
];
|
||||
|
||||
@@ -124,6 +124,9 @@ export * from './runtime/index.js';
|
||||
// Security Scanner
|
||||
export * from './scanner/index.js';
|
||||
|
||||
// Skill Integrity (SHA-256 content hashing + verification)
|
||||
export * from './integrity/index.js';
|
||||
|
||||
// Spec Validation
|
||||
export * from './validation/index.js';
|
||||
|
||||
|
||||
@@ -0,0 +1,108 @@
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import { mkdtempSync, writeFileSync, rmSync, mkdirSync } from 'node:fs';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { join } from 'node:path';
|
||||
import {
|
||||
computeSkillIntegrity,
|
||||
verifySkillIntegrity,
|
||||
formatIntegrity,
|
||||
parseIntegrity,
|
||||
} from '../integrity.js';
|
||||
|
||||
describe('integrity', () => {
|
||||
let dir: string;
|
||||
|
||||
beforeEach(() => {
|
||||
dir = mkdtempSync(join(tmpdir(), 'skillkit-integrity-'));
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
rmSync(dir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
it('computes a stable digest for a single-file skill', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), '# Hello\n\nbody\n');
|
||||
const a = computeSkillIntegrity(dir);
|
||||
const b = computeSkillIntegrity(dir);
|
||||
expect(a.digest).toBe(b.digest);
|
||||
expect(a.digest).toMatch(/^[a-f0-9]{64}$/);
|
||||
expect(a.sri.startsWith('sha256-')).toBe(true);
|
||||
expect(a.files).toHaveLength(1);
|
||||
expect(a.files[0].path).toBe('SKILL.md');
|
||||
});
|
||||
|
||||
it('hashes file contents recursively and ignores metadata files', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'a');
|
||||
mkdirSync(join(dir, 'scripts'));
|
||||
writeFileSync(join(dir, 'scripts', 'do.sh'), 'echo hi');
|
||||
writeFileSync(join(dir, '.skillkit.json'), '{}');
|
||||
writeFileSync(join(dir, '.DS_Store'), 'noise');
|
||||
|
||||
const result = computeSkillIntegrity(dir);
|
||||
const paths = result.files.map((f) => f.path).sort();
|
||||
expect(paths).toEqual(['SKILL.md', 'scripts/do.sh']);
|
||||
});
|
||||
|
||||
it('detects content drift', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'original');
|
||||
const before = computeSkillIntegrity(dir).digest;
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'tampered');
|
||||
const after = computeSkillIntegrity(dir).digest;
|
||||
expect(before).not.toBe(after);
|
||||
});
|
||||
|
||||
it('detects new file additions (path matters, not just contents)', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'x');
|
||||
const before = computeSkillIntegrity(dir).digest;
|
||||
writeFileSync(join(dir, 'extra.txt'), 'x');
|
||||
const after = computeSkillIntegrity(dir).digest;
|
||||
expect(before).not.toBe(after);
|
||||
});
|
||||
|
||||
it('verifies matching SRI strings', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), '# test');
|
||||
const result = computeSkillIntegrity(dir);
|
||||
expect(verifySkillIntegrity(dir, result.sri).valid).toBe(true);
|
||||
expect(verifySkillIntegrity(dir, result.digest).valid).toBe(true);
|
||||
});
|
||||
|
||||
it('rejects mismatched integrity strings', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), '# test');
|
||||
const result = verifySkillIntegrity(dir, 'sha256-' + Buffer.alloc(32).toString('base64'));
|
||||
expect(result.valid).toBe(false);
|
||||
expect(result.reason).toBe('mismatch');
|
||||
});
|
||||
|
||||
it('rejects malformed integrity strings', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'x');
|
||||
const r = verifySkillIntegrity(dir, 'not-a-hash');
|
||||
expect(r.valid).toBe(false);
|
||||
expect(r.reason).toBe('invalid-expected-format');
|
||||
});
|
||||
|
||||
it('parses both SRI and bare hex', () => {
|
||||
const hex = 'a'.repeat(64);
|
||||
expect(parseIntegrity(hex)?.digest).toBe(hex);
|
||||
const sri = 'sha256-' + Buffer.alloc(32, 1).toString('base64');
|
||||
const parsed = parseIntegrity(sri);
|
||||
expect(parsed?.digest).toMatch(/^[a-f0-9]{64}$/);
|
||||
expect(parseIntegrity('garbage')).toBeNull();
|
||||
});
|
||||
|
||||
it('formats integrity in hex or SRI', () => {
|
||||
writeFileSync(join(dir, 'SKILL.md'), 'fmt');
|
||||
const r = computeSkillIntegrity(dir);
|
||||
expect(formatIntegrity(r, 'sri')).toBe(r.sri);
|
||||
expect(formatIntegrity(r, 'hex')).toBe(r.digest);
|
||||
});
|
||||
|
||||
it('throws on missing path', () => {
|
||||
expect(() => computeSkillIntegrity(join(dir, 'nope'))).toThrow();
|
||||
});
|
||||
|
||||
it('enforces maxBytes limit', () => {
|
||||
const buf = Buffer.alloc(1024).fill('x');
|
||||
writeFileSync(join(dir, 'SKILL.md'), buf);
|
||||
expect(() => computeSkillIntegrity(dir, { maxBytes: 100 })).toThrow(/max integrity size/);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,9 @@
|
||||
export {
|
||||
computeSkillIntegrity,
|
||||
verifySkillIntegrity,
|
||||
formatIntegrity,
|
||||
parseIntegrity,
|
||||
type IntegrityResult,
|
||||
type VerifyResult,
|
||||
type IntegrityOptions,
|
||||
} from './integrity.js';
|
||||
@@ -0,0 +1,177 @@
|
||||
import { createHash } from 'node:crypto';
|
||||
import { readFileSync, statSync, readdirSync, existsSync } from 'node:fs';
|
||||
import { join, relative, sep, posix } from 'node:path';
|
||||
|
||||
export interface IntegrityOptions {
|
||||
exclude?: string[];
|
||||
maxBytes?: number;
|
||||
}
|
||||
|
||||
export interface IntegrityResult {
|
||||
algorithm: 'sha256';
|
||||
digest: string;
|
||||
sri: string;
|
||||
files: Array<{ path: string; sha256: string; bytes: number }>;
|
||||
totalBytes: number;
|
||||
}
|
||||
|
||||
export interface VerifyResult {
|
||||
valid: boolean;
|
||||
expected: string;
|
||||
computed: string;
|
||||
algorithm: 'sha256';
|
||||
reason?: string;
|
||||
}
|
||||
|
||||
const DEFAULT_EXCLUDES = new Set([
|
||||
'.skillkit.json',
|
||||
'.DS_Store',
|
||||
'.git',
|
||||
'node_modules',
|
||||
'dist',
|
||||
'.turbo',
|
||||
]);
|
||||
|
||||
const DEFAULT_MAX_BYTES = 50 * 1024 * 1024;
|
||||
|
||||
function shouldExclude(name: string, extra: Set<string>): boolean {
|
||||
if (DEFAULT_EXCLUDES.has(name)) return true;
|
||||
if (extra.has(name)) return true;
|
||||
if (name.endsWith('.skillkit.json')) return true;
|
||||
return false;
|
||||
}
|
||||
|
||||
function walk(root: string, dir: string, extra: Set<string>, out: string[]): void {
|
||||
for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
|
||||
if (shouldExclude(entry.name, extra)) continue;
|
||||
const full = join(dir, entry.name);
|
||||
if (entry.isDirectory()) {
|
||||
walk(root, full, extra, out);
|
||||
} else if (entry.isFile()) {
|
||||
out.push(full);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function toPosix(p: string): string {
|
||||
return p.split(sep).join(posix.sep);
|
||||
}
|
||||
|
||||
export function computeSkillIntegrity(skillPath: string, options: IntegrityOptions = {}): IntegrityResult {
|
||||
if (!existsSync(skillPath)) {
|
||||
throw new Error(`Skill path not found: ${skillPath}`);
|
||||
}
|
||||
|
||||
const stats = statSync(skillPath);
|
||||
const extra = new Set(options.exclude ?? []);
|
||||
const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
|
||||
|
||||
let root: string;
|
||||
const files: string[] = [];
|
||||
|
||||
if (stats.isFile()) {
|
||||
if (!skillPath.toLowerCase().endsWith('.md')) {
|
||||
throw new Error(`Single-file skill must be a .md file: ${skillPath}`);
|
||||
}
|
||||
root = skillPath;
|
||||
files.push(skillPath);
|
||||
} else if (stats.isDirectory()) {
|
||||
root = skillPath;
|
||||
walk(root, root, extra, files);
|
||||
} else {
|
||||
throw new Error(`Unsupported skill path type: ${skillPath}`);
|
||||
}
|
||||
|
||||
const fileEntries: IntegrityResult['files'] = [];
|
||||
const rollup = createHash('sha256');
|
||||
let totalBytes = 0;
|
||||
|
||||
for (const file of files) {
|
||||
const data = readFileSync(file);
|
||||
totalBytes += data.byteLength;
|
||||
if (totalBytes > maxBytes) {
|
||||
throw new Error(`Skill exceeds max integrity size (${maxBytes} bytes)`);
|
||||
}
|
||||
|
||||
const fileHash = createHash('sha256').update(data).digest('hex');
|
||||
const rel = stats.isFile() ? toPosix(file.split(sep).pop()!) : toPosix(relative(root, file));
|
||||
|
||||
fileEntries.push({ path: rel, sha256: fileHash, bytes: data.byteLength });
|
||||
|
||||
rollup.update(rel);
|
||||
rollup.update('\0');
|
||||
rollup.update(fileHash);
|
||||
rollup.update('\n');
|
||||
}
|
||||
|
||||
const digest = rollup.digest('hex');
|
||||
const sri = `sha256-${Buffer.from(digest, 'hex').toString('base64')}`;
|
||||
|
||||
return {
|
||||
algorithm: 'sha256',
|
||||
digest,
|
||||
sri,
|
||||
files: fileEntries,
|
||||
totalBytes,
|
||||
};
|
||||
}
|
||||
|
||||
export function verifySkillIntegrity(skillPath: string, expected: string, options: IntegrityOptions = {}): VerifyResult {
|
||||
if (!expected || typeof expected !== 'string') {
|
||||
return {
|
||||
valid: false,
|
||||
expected: expected ?? '',
|
||||
computed: '',
|
||||
algorithm: 'sha256',
|
||||
reason: 'missing-expected',
|
||||
};
|
||||
}
|
||||
|
||||
const result = computeSkillIntegrity(skillPath, options);
|
||||
const parsed = parseIntegrity(expected);
|
||||
|
||||
if (!parsed) {
|
||||
return {
|
||||
valid: false,
|
||||
expected,
|
||||
computed: result.digest,
|
||||
algorithm: 'sha256',
|
||||
reason: 'invalid-expected-format',
|
||||
};
|
||||
}
|
||||
|
||||
const valid = parsed.digest === result.digest;
|
||||
return {
|
||||
valid,
|
||||
expected: parsed.digest,
|
||||
computed: result.digest,
|
||||
algorithm: 'sha256',
|
||||
reason: valid ? undefined : 'mismatch',
|
||||
};
|
||||
}
|
||||
|
||||
export function formatIntegrity(result: IntegrityResult, format: 'sri' | 'hex' = 'sri'): string {
|
||||
return format === 'sri' ? result.sri : result.digest;
|
||||
}
|
||||
|
||||
export function parseIntegrity(input: string): { algorithm: 'sha256'; digest: string } | null {
|
||||
if (!input) return null;
|
||||
const trimmed = input.trim();
|
||||
|
||||
if (trimmed.startsWith('sha256-')) {
|
||||
const b64 = trimmed.slice('sha256-'.length);
|
||||
try {
|
||||
const buf = Buffer.from(b64, 'base64');
|
||||
if (buf.length !== 32) return null;
|
||||
return { algorithm: 'sha256', digest: buf.toString('hex') };
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
if (/^[a-f0-9]{64}$/i.test(trimmed)) {
|
||||
return { algorithm: 'sha256', digest: trimmed.toLowerCase() };
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
@@ -10,7 +10,7 @@
|
||||
* - Plan approval workflow
|
||||
* - Review stages (spec-compliance, code-quality)
|
||||
* - Inter-agent messaging (direct + broadcast)
|
||||
* - Universal agent support (45 agents)
|
||||
* - Universal agent support (46 agents)
|
||||
*/
|
||||
|
||||
// Team Orchestrator
|
||||
|
||||
@@ -203,4 +203,10 @@ export const AGENT_INSTRUCTION_TEMPLATES: Record<string, AgentInstructionTemplat
|
||||
format: 'markdown',
|
||||
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'guidelines'],
|
||||
},
|
||||
'hermes': {
|
||||
agent: 'hermes',
|
||||
filename: 'AGENTS.md',
|
||||
format: 'xml',
|
||||
sectionOrder: ['overview', 'stack', 'commands', 'conventions', 'structure', 'guidelines'],
|
||||
},
|
||||
};
|
||||
|
||||
@@ -34,6 +34,7 @@ export interface WellKnownSkill {
|
||||
name: string;
|
||||
description?: string;
|
||||
files: string[];
|
||||
integrity?: string;
|
||||
}
|
||||
|
||||
export interface WellKnownIndex {
|
||||
@@ -280,14 +281,18 @@ export function calculateBaseSkillsUrl(foundUrl: string): string {
|
||||
: foundUrl.replace('/skills.json', '/skills');
|
||||
}
|
||||
|
||||
export function generateWellKnownIndex(skills: Array<{ name: string; description?: string; files: string[] }>): WellKnownIndex {
|
||||
export function generateWellKnownIndex(skills: Array<{ name: string; description?: string; files: string[]; integrity?: string }>): WellKnownIndex {
|
||||
return {
|
||||
version: '1.0',
|
||||
skills: skills.map(s => ({
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
files: s.files,
|
||||
})),
|
||||
skills: skills.map(s => {
|
||||
const entry: WellKnownSkill = {
|
||||
name: s.name,
|
||||
description: s.description,
|
||||
files: s.files,
|
||||
};
|
||||
if (s.integrity) entry.integrity = s.integrity;
|
||||
return entry;
|
||||
}),
|
||||
};
|
||||
}
|
||||
|
||||
|
||||
@@ -405,7 +405,7 @@ export function translateSkillToAll(
|
||||
'mcpjam', 'mux', 'neovate', 'openhands', 'pi', 'qoder', 'qwen',
|
||||
'vercel', 'zencoder', 'devin', 'aider', 'sourcegraph-cody', 'amazon-q',
|
||||
'augment-code', 'replit-agent', 'bolt', 'lovable', 'tabby', 'tabnine',
|
||||
'codegpt', 'playcode-agent',
|
||||
'codegpt', 'playcode-agent', 'hermes',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
|
||||
@@ -34,6 +34,7 @@ export const SKILL_DISCOVERY_PATHS = [
|
||||
'.gemini/skills',
|
||||
'.github/skills',
|
||||
'.goose/skills',
|
||||
'.hermes/skills',
|
||||
'.kilocode/skills',
|
||||
'.kiro/skills',
|
||||
'.lovable/skills',
|
||||
@@ -41,6 +42,7 @@ export const SKILL_DISCOVERY_PATHS = [
|
||||
'.mux/skills',
|
||||
'.neovate/skills',
|
||||
'.opencode/skills',
|
||||
'.openclaw/skills',
|
||||
'.openhands/skills',
|
||||
'.pi/skills',
|
||||
'.playcode/skills',
|
||||
|
||||
@@ -329,7 +329,7 @@ Follow these guidelines`;
|
||||
});
|
||||
|
||||
describe('supported agents', () => {
|
||||
it('should support all 45 agents', () => {
|
||||
it('should support all 46 agents', () => {
|
||||
const allAgents = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -360,6 +360,7 @@ Follow these guidelines`;
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'hermes',
|
||||
] as const;
|
||||
|
||||
const skill: CanonicalSkill = {
|
||||
|
||||
@@ -59,6 +59,7 @@ export const AGENT_FORMAT_MAP: Record<AgentType, FormatCategory> = {
|
||||
'tabnine': 'skill-md',
|
||||
'codegpt': 'skill-md',
|
||||
'playcode-agent': 'external',
|
||||
'hermes': 'skill-md',
|
||||
};
|
||||
|
||||
/**
|
||||
|
||||
@@ -46,6 +46,7 @@ export const AgentType = z.enum([
|
||||
"tabnine",
|
||||
"codegpt",
|
||||
"playcode-agent",
|
||||
"hermes",
|
||||
]);
|
||||
export type AgentType = z.infer<typeof AgentType>;
|
||||
|
||||
|
||||
@@ -23,7 +23,7 @@ Then in Chrome:
|
||||
|
||||
Skills download to `Downloads/skillkit-skills/{name}/SKILL.md`.
|
||||
|
||||
To make available to all 45 agents:
|
||||
To make available to all 46 agents:
|
||||
|
||||
```bash
|
||||
skillkit install ~/Downloads/skillkit-skills/my-skill
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"manifest_version": 3,
|
||||
"name": "SkillKit - Save as Skill",
|
||||
"version": "1.20.0",
|
||||
"description": "Save any webpage as an AI agent skill — instantly available across 45 agents",
|
||||
"description": "Save any webpage as an AI agent skill — instantly available across 46 agents",
|
||||
"permissions": ["contextMenus", "activeTab", "downloads", "scripting"],
|
||||
"background": {
|
||||
"service_worker": "background.global.js"
|
||||
|
||||
@@ -4,10 +4,10 @@
|
||||
SkillKit - Save as Skill
|
||||
|
||||
## Summary (132 chars max)
|
||||
Save any webpage as an AI agent skill file. One click, works across 45 coding agents.
|
||||
Save any webpage as an AI agent skill file. One click, works across 46 coding agents.
|
||||
|
||||
## Description
|
||||
SkillKit lets you save any webpage as a reusable AI agent skill with one click. The extension extracts page content directly in your browser and generates a SKILL.md file that works instantly across 45 coding agents including Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and more.
|
||||
SkillKit lets you save any webpage as a reusable AI agent skill with one click. The extension extracts page content directly in your browser and generates a SKILL.md file that works instantly across 46 coding agents including Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and more.
|
||||
|
||||
How it works:
|
||||
- Click the extension icon to save the current page as a skill
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp-memory",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp",
|
||||
"version": "1.22.1",
|
||||
"version": "1.24.0",
|
||||
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -185,7 +185,8 @@ const AGENT_DIR_MAP: Record<string, string[]> = {
|
||||
'claude-code': ['.claude/skills'], 'cursor': ['.cursor/skills'], 'codex': ['.codex/skills'],
|
||||
'gemini-cli': ['.gemini/skills'], 'opencode': ['.opencode/skills', '.config/opencode/skills'],
|
||||
'antigravity': ['.antigravity/skills'], 'amp': ['.amp/skills'], 'clawdbot': ['.clawdbot/skills'],
|
||||
'openclaw': ['skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'],
|
||||
'hermes': ['.hermes/skills'],
|
||||
'openclaw': ['.openclaw/skills', '.openclaw/workspace/skills', 'skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'],
|
||||
'kilo': ['.kilocode/skills'], 'kiro-cli': ['.kiro/skills'], 'roo': ['.roo/skills'],
|
||||
'trae': ['.trae/skills'], 'windsurf': ['.windsurf/skills', '.codeium/windsurf/skills'],
|
||||
'universal': ['skills'], 'droid': ['.factory/skills'], 'factory': ['.factory/skills'],
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/memory",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mesh",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "Peer mesh network for multi-machine agent distribution",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/messaging",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "Inter-agent messaging system for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/resources",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -34,7 +34,7 @@ pnpm ui
|
||||
- **Animated UI** - Smooth entrance animations and transitions
|
||||
- **Browse Skills** - Explore skill repositories with search and filtering
|
||||
- **Smart Recommendations** - AI-powered skill suggestions with match scores
|
||||
- **Cross-Agent Translation** - Convert skills between 45 agent formats
|
||||
- **Cross-Agent Translation** - Convert skills between 46 agent formats
|
||||
- **Team Collaboration** - Share and sync skills across teams
|
||||
- **Responsive Design** - Adapts to any terminal size
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/tui",
|
||||
"version": "1.23.0",
|
||||
"version": "1.24.0",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -18,10 +18,12 @@ PACKAGES=(
|
||||
"packages/core/package.json"
|
||||
"packages/tui/package.json"
|
||||
"packages/agents/package.json"
|
||||
"packages/api/package.json"
|
||||
"packages/mcp/package.json"
|
||||
"packages/mcp-memory/package.json"
|
||||
"packages/memory/package.json"
|
||||
"packages/mesh/package.json"
|
||||
"packages/messaging/package.json"
|
||||
"packages/mcp-memory/package.json"
|
||||
"packages/resources/package.json"
|
||||
"docs/skillkit/package.json"
|
||||
"docs/fumadocs/package.json"
|
||||
|
||||
@@ -46,7 +46,7 @@ function splitPill({ label, value, labelBg = '#18181b', valueBg = '#09090b', lab
|
||||
const tags = [
|
||||
{ name: 'slim-install.svg', svg: pill({ text: 'slim install', accent: '#3b82f6' }) },
|
||||
{ name: 'new.svg', svg: pill({ text: 'new', accent: '#22c55e' }) },
|
||||
{ name: 'v1.23.0.svg', svg: pill({ text: 'v1.23.0', accent: '#3b82f6' }) },
|
||||
{ name: 'v1.24.0.svg', svg: pill({ text: 'v1.24.0', accent: '#3b82f6' }) },
|
||||
{ name: 'official.svg', svg: pill({ text: 'official', accent: '#f59e0b' }) },
|
||||
{ name: 'community.svg', svg: pill({ text: 'community', accent: '#a78bfa' }) },
|
||||
{ name: 'curated.svg', svg: pill({ text: 'curated', accent: '#06b6d4' }) },
|
||||
@@ -55,7 +55,7 @@ const tags = [
|
||||
{ name: 'one-skill.svg', svg: pill({ text: 'one skill', accent: '#3b82f6' }) },
|
||||
{ name: 'every-agent.svg', svg: pill({ text: 'every agent', accent: '#3b82f6' }) },
|
||||
|
||||
{ name: 'agents.svg', svg: splitPill({ label: 'agents', value: '45' }) },
|
||||
{ name: 'agents.svg', svg: splitPill({ label: 'agents', value: '46' }) },
|
||||
{ name: 'skills.svg', svg: splitPill({ label: 'skills', value: '400K+' }) },
|
||||
{ name: 'sources.svg', svg: splitPill({ label: 'sources', value: '31' }) },
|
||||
{ name: 'tests.svg', svg: splitPill({ label: 'tests', value: '757' }) },
|
||||
|
||||
@@ -0,0 +1,87 @@
|
||||
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 '../core/types.js';
|
||||
|
||||
/**
|
||||
* Hermes Agent Adapter (Legacy)
|
||||
*/
|
||||
export class HermesAdapter implements AgentAdapter {
|
||||
readonly type: AgentType = 'hermes';
|
||||
readonly name = 'Hermes Agent';
|
||||
readonly skillsDir = '.hermes/skills';
|
||||
readonly configFile = 'AGENTS.md';
|
||||
|
||||
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);
|
||||
}
|
||||
}
|
||||
@@ -17,6 +17,7 @@ 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';
|
||||
|
||||
export * from './base.js';
|
||||
export * from './claude-code.js';
|
||||
@@ -55,6 +56,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
||||
trae: new TraeAdapter(),
|
||||
windsurf: new WindsurfAdapter(),
|
||||
universal: new UniversalAdapter(),
|
||||
hermes: new HermesAdapter(),
|
||||
};
|
||||
|
||||
export function getAdapter(type: AgentType): AgentAdapter {
|
||||
@@ -83,6 +85,7 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'roo',
|
||||
'trae',
|
||||
'windsurf',
|
||||
'hermes',
|
||||
'universal',
|
||||
];
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ export class WindsurfAdapter implements AgentAdapter {
|
||||
readonly type: AgentType = 'windsurf';
|
||||
readonly name = 'Windsurf';
|
||||
readonly skillsDir = '.windsurf/skills';
|
||||
readonly configFile = 'AGENTS.md';
|
||||
readonly configFile = '.windsurf/rules/skills.md';
|
||||
readonly globalSkillsDir = join(homedir(), '.codeium', 'windsurf', 'skills');
|
||||
|
||||
generateConfig(skills: Skill[]): string {
|
||||
|
||||
@@ -18,6 +18,7 @@ export const AgentType = z.enum([
|
||||
'trae',
|
||||
'windsurf',
|
||||
'universal',
|
||||
'hermes',
|
||||
]);
|
||||
export type AgentType = z.infer<typeof AgentType>;
|
||||
|
||||
|
||||
+11
-2
@@ -140,13 +140,22 @@ describe('agents', () => {
|
||||
expect(adapter.type).toBe('windsurf');
|
||||
expect(adapter.name).toBe('Windsurf');
|
||||
expect(adapter.skillsDir).toBe('.windsurf/skills');
|
||||
expect(adapter.configFile).toBe('.windsurf/rules/skills.md');
|
||||
});
|
||||
|
||||
it('should return adapter for hermes', () => {
|
||||
const adapter = getAdapter('hermes');
|
||||
expect(adapter.type).toBe('hermes');
|
||||
expect(adapter.name).toBe('Hermes Agent');
|
||||
expect(adapter.skillsDir).toBe('.hermes/skills');
|
||||
expect(adapter.configFile).toBe('AGENTS.md');
|
||||
});
|
||||
});
|
||||
|
||||
describe('getAllAdapters', () => {
|
||||
it('should return all 17 adapters', () => {
|
||||
it('should return all 18 adapters', () => {
|
||||
const adapters = getAllAdapters();
|
||||
expect(adapters.length).toBe(17);
|
||||
expect(adapters.length).toBe(18);
|
||||
expect(adapters.map(a => a.type)).toContain('claude-code');
|
||||
expect(adapters.map(a => a.type)).toContain('cursor');
|
||||
expect(adapters.map(a => a.type)).toContain('universal');
|
||||
|
||||
Reference in New Issue
Block a user