Compare commits

..
Author SHA1 Message Date
Rohit Ghumare 145bf80342 chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags
Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.

Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.

Measured on a fresh npm cache (overrides-pinned file: tarballs):
  before:   475 pkgs / 18s / 3 deprecation warnings
  1.23.0:   418 pkgs / 18s / 2 deprecation warnings
  slim:     118 pkgs /  9s / 0 deprecation warnings
The two remaining warnings are upstream:
  - prebuild-install@7.1.3 from better-sqlite3 (must stay)
  - glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver

README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.

Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
2026-04-21 00:11:44 +01:00
95 changed files with 156 additions and 1515 deletions
-24
View File
@@ -1,24 +0,0 @@
# Changelog
All notable changes to SkillKit are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions use [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Added
- **Skill integrity verification (`skillkit verify`).** New command computes a deterministic SHA-256 over every file in a skill (excluding metadata, VCS, and editor artifacts) and emits the result as a Subresource Integrity string (`sha256-<base64>`). Supports:
- `--expected <sri|hex>` to verify against a known publisher digest
- `--against-lock` to verify against the local `~/.skillkit/lock.json` entry
- `--files` to dump per-file digests
- `--json` for CI pipelines
- **`computeSkillIntegrity` / `verifySkillIntegrity`** exported from `@skillkit/core` for programmatic use.
- **`integrity` field** in `WellKnownSkill` index. `skillkit publish` now records a full SRI digest for each published skill alongside the file list.
- **Lockfile records full integrity.** `skillkit install` and `skillkit update` now persist the full SRI digest to `~/.skillkit/lock.json` (with graceful fallback to the legacy short checksum when integrity computation fails).
- Phase 1 of supply-chain integrity (issue #90). Phase 2 (ed25519 signing + publisher key registry) tracked separately.
### Tests
- 11 unit tests for the integrity module (`packages/core/src/integrity/__tests__/integrity.test.ts`).
- 5 CLI end-to-end tests for `skillkit verify` (`packages/cli/src/__tests__/verify.test.ts`).
## [1.24.0] - 2026-04-XX
See [GitHub releases](https://github.com/rohitg00/skillkit/releases) for prior history.
+13 -9
View File
@@ -8,7 +8,7 @@
<br/>
### *One skill. Every agent. 46 of them.*
### *One skill. Every agent. 45 of them.*
<br/>
@@ -18,20 +18,27 @@
[![CI](https://img.shields.io/github/actions/workflow/status/rohitg00/skillkit/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&labelColor=0D1117&color=6BCB77)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![license](https://img.shields.io/badge/License-Apache_2.0-4D96FF?style=for-the-badge&labelColor=0D1117)](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="46 agents"></a>
<a href="#supported-agents"><img src="assets/tags/agents.svg" alt="45 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.24.0.svg" alt="v1.24.0"></a>
<a href="https://github.com/rohitg00/skillkit/releases/latest"><img src="assets/tags/v1.23.0.svg" alt="v1.23.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)
@@ -67,7 +74,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 46 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 45 agents at once.
```bash
npx skillkit add anthropics/skills
@@ -347,9 +354,6 @@ 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>
@@ -422,9 +426,9 @@ skillkit cicd init # CI/CD templates
</details>
<details>
<summary><b>Plus 35 more</b></summary>
<summary><b>Plus 34 more</b></summary>
Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Hermes Agent, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenClaw, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal.
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.
</details>
[Full agent details](https://skillkit.sh/docs/agents)
+3 -3
View File
@@ -1,6 +1,6 @@
# SkillKit
Universal skills manager for AI coding agents. Install, manage, and sync skills across 46 AI agents including Claude Code, Cursor, Codex, Gemini CLI, and more.
Universal skills manager for AI coding agents. Install, manage, and sync skills across 45 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 (46)
## Supported Agents (45)
**Primary (19):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Hermes Agent, Kilo, Kiro, Roo, Trae, Universal
**Primary (18):** Claude Code, Cursor, Codex, Gemini CLI, Windsurf, GitHub Copilot, OpenCode, Antigravity, Amp, Clawdbot, OpenClaw, Droid, Goose, Kilo, Kiro, Roo, Trae, Universal
**Extended (27):** Aider, Amazon Q, Augment Code, Bolt, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Devin, Factory, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode Agent, Qoder, Qwen, Replit Agent, Sourcegraph Cody, Tabby, Tabnine, Vercel, Zencoder
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.24.0",
"version": "1.23.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": {
-2
View File
@@ -112,7 +112,6 @@ import {
SkillMdCheckCommand,
ServeCommand,
ScanCommand,
VerifyCommand,
EvalCommand,
DoctorCommand,
SaveCommand,
@@ -266,7 +265,6 @@ cli.register(SkillMdCheckCommand);
cli.register(ServeCommand);
cli.register(ScanCommand);
cli.register(VerifyCommand);
cli.register(EvalCommand);
cli.register(DoctorCommand);
cli.register(SaveCommand);
+1 -1
View File
@@ -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">46</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>
</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.24.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.23.0</text>
</svg>

Before

Width:  |  Height:  |  Size: 452 B

After

Width:  |  Height:  |  Size: 452 B

-17
View File
@@ -573,23 +573,6 @@ Skills are automatically scanned during `skillkit install`. Use `--no-scan` to s
- `table` - tabular format
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
## Integrity Verification
```bash
skillkit verify <path> # Print SRI digest (sha256-<base64>)
skillkit verify <path> --files # Show per-file digests
skillkit verify <path> --format hex # Print raw 64-char hex digest
skillkit verify <path> --json # Machine-readable JSON
skillkit verify <path> --expected sha256-... # Verify against a known publisher digest
skillkit verify <path> --against-lock # Verify against ~/.skillkit/lock.json
```
`skillkit verify` computes a deterministic SHA-256 over every file in the skill (excluding `.skillkit.json` metadata, VCS artifacts, and editor noise) and emits a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string. The digest matches the `integrity` field that `skillkit publish` writes into `.well-known/skills/index.json`, so a downstream consumer can detect tampering between publish and install.
`skillkit install` and `skillkit update` automatically record the full SRI digest into `~/.skillkit/lock.json`, enabling `--against-lock` audits in CI pipelines and supply-chain workflows.
**Exit codes:** `0` on match, `1` on mismatch, missing path, or malformed `--expected` value.
## Interactive TUI
```bash
+4 -7
View File
@@ -101,20 +101,17 @@ SkillKit sits between your skills and your agents. It handles format translation
[Full agent details](/docs/agents)
### Security & integrity
### Security scanning
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more — and content integrity is verifiable against the publisher digest:
Every skill is scanned for threats before installation — prompt injection, hardcoded secrets, command injection, and more:
```bash
skillkit scan ./my-skill # 46+ detection rules
skillkit scan ./my-skill --format sarif # GitHub Code Scanning
skillkit scan ./my-skill --fail-on high # CI gate
skillkit verify ./my-skill # SHA-256 SRI digest
skillkit verify ./my-skill --against-lock # Detect supply-chain tampering
```
[Security & Integrity](/docs/security)
[Security Scanner](/docs/security)
## Beyond Basic Skills
@@ -172,7 +169,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 & Integrity](/docs/security) — Threat detection plus SHA-256 content verification
- [Security Scanner](/docs/security) — Threat detection for skills
- [Commands](/docs/commands) — Full CLI reference
- [REST API](/docs/rest-api) — Runtime discovery server
- [MCP Server](/docs/mcp-server) — Agent-native discovery
+4 -48
View File
@@ -1,16 +1,11 @@
---
title: Security & Integrity
description: Scan skills for malicious patterns, verify content integrity, and lock against supply-chain tampering
title: Security Scanner
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
---
# Security & Integrity
# Security Scanner
SkillKit ships two complementary supply-chain defenses:
1. **`skillkit scan`** — static security scanner detecting prompt injection, command injection, data exfiltration, hardcoded secrets, tool abuse, and unicode steganography (46+ rules).
2. **`skillkit verify`** — SHA-256 content-integrity check that compares the locally installed skill against the publisher's recorded digest (full SRI, recorded automatically in `~/.skillkit/lock.json`).
Run `scan` to ask _"is this skill dangerous?"_. Run `verify` to ask _"is this skill what the publisher actually shipped?"_.
SkillKit includes a built-in security scanner that analyzes skills for prompt injection, command injection, data exfiltration, hardcoded secrets, and other threats before installation.
## Quick Start
@@ -284,42 +279,3 @@ To skip specific rules:
```bash
skillkit scan . --skip-rules UC001,UC002,MF004
```
## Integrity Verification (`skillkit verify`)
`skillkit verify` is the supply-chain counterpart to `skillkit scan`. The scanner answers _"is this skill dangerous?"_; `verify` answers _"is this skill what the publisher actually shipped?"_.
```bash
skillkit verify ./my-skill # Print SRI digest
skillkit verify ./my-skill --expected sha256-iQo/... # Compare against publisher digest
skillkit verify ./my-skill --against-lock # Compare against ~/.skillkit/lock.json
skillkit verify ./my-skill --json # JSON for CI pipelines
```
### How the digest is computed
`verify` walks every file in the skill in deterministic alphabetical order, computes SHA-256 per file, and rolls those file hashes (plus their POSIX-normalized relative paths) into a single SHA-256 digest, emitted as a [Subresource Integrity](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity) string of the form `sha256-<base64>`. Skipped: `.skillkit.json`, `.DS_Store`, `.git`, `node_modules`, `dist`, `.turbo`, and any `*.skillkit.json` sidecar.
Because file _paths_ feed the hash alongside _content_, renaming, adding, or removing a file all change the digest — not just edits to file bodies.
### Publish, install, and lock integration
- `skillkit publish` writes the digest into the `integrity` field of `.well-known/skills/index.json` for every published skill.
- `skillkit install` records the full SRI digest into `~/.skillkit/lock.json` (falling back to the legacy short checksum only if integrity computation fails).
- `skillkit update` refreshes the lock entry on successful update.
### CI usage
```yaml
- name: Verify all installed skills
run: |
for skill in .claude/skills/*/; do
npx skillkit verify "$skill" --against-lock --json
done
```
Exit codes: `0` on match, `1` on mismatch, missing path, or malformed `--expected` value. Reason codes in JSON output: `mismatch`, `invalid-expected-format`, `missing-expected`, `no-lock-entry`.
### Roadmap
Cryptographic skill signing (ed25519 publisher keys + verified-publisher registry) is tracked separately as Phase 2 of [#90](https://github.com/rohitg00/skillkit/issues/90). Phase 1 (content integrity) is shipping now in response to the ClawHavoc supply-chain campaign and OWASP Agentic Skills Top 10 guidance.
-28
View File
@@ -8,34 +8,6 @@ const config = {
trailingSlash: false,
skipTrailingSlashRedirect: true,
assetPrefix: 'https://skillkit-docs.vercel.app',
async headers() {
return [
{
source: '/:path*.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico)',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000' },
],
},
{
source: '/_next/static/:path*',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=31536000, immutable' },
],
},
{
source: '/docs/:path*',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
],
},
{
source: '/',
headers: [
{ key: 'Cache-Control', value: 'public, max-age=300, s-maxage=86400, stale-while-revalidate=604800' },
],
},
];
},
};
export default withMDX(config);
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.24.0",
"version": "1.23.0",
"private": true,
"scripts": {
"build": "next build",
-138
View File
@@ -1,138 +0,0 @@
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
User-agent: Googlebot
Allow: /
User-agent: Bingbot
Allow: /
User-agent: DuckDuckBot
Allow: /
User-agent: Applebot
Allow: /
User-agent: ChatGPT-User
Allow: /
User-agent: OAI-SearchBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: Perplexity-User
Allow: /
User-agent: Claude-User
Allow: /
User-agent: Claude-SearchBot
Allow: /
User-agent: FirecrawlAgent
Allow: /
User-agent: firecrawl
Allow: /
User-agent: Context7Bot
Allow: /
User-agent: Crawl4AI
Allow: /
User-agent: Clawdbot
Allow: /
User-agent: OpenClaw
Allow: /
User-agent: Hermes
Allow: /
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: anthropic-ai
Disallow: /
User-agent: CCBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: Applebot-Extended
Disallow: /
User-agent: Bytespider
Disallow: /
User-agent: Amazonbot
Disallow: /
User-agent: FacebookBot
Disallow: /
User-agent: Meta-ExternalAgent
Disallow: /
User-agent: cohere-ai
Disallow: /
User-agent: Diffbot
Disallow: /
User-agent: ImagesiftBot
Disallow: /
User-agent: Omgilibot
Disallow: /
User-agent: peer39_crawler
Disallow: /
User-agent: YouBot
Disallow: /
User-agent: Timpibot
Disallow: /
User-agent: ICC-Crawler
Disallow: /
User-agent: AhrefsBot
Disallow: /
User-agent: SemrushBot
Disallow: /
User-agent: MJ12bot
Disallow: /
User-agent: DotBot
Disallow: /
User-agent: PetalBot
Disallow: /
User-agent: BLEXBot
Disallow: /
User-agent: MegaIndex
Disallow: /
User-agent: SeznamBot
Disallow: /
User-agent: DataForSeoBot
Disallow: /
User-agent: *
Allow: /
Sitemap: https://skillkit-docs.vercel.app/sitemap.xml
@@ -44,12 +44,12 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 45 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 46 AI agents</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 45 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 46 AI coding agents with automatic format translation:
SkillKit supports 45 AI coding agents with automatic format translation:
</p>
<Table
+3 -3
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 46 AI coding agents with one command.',
description: 'Deploy to 45 AI coding agents with one command.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agents', '1', '46'],
['Agents', '1', '45'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">46</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">45</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
-22
View File
@@ -1,22 +0,0 @@
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';
const BLOCK = /GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot/i;
const ALLOW = /Googlebot|Bingbot|DuckDuckBot|Applebot(?!-Extended)|ChatGPT-User|OAI-SearchBot|PerplexityBot|Perplexity-User|Claude-User|Claude-SearchBot|FirecrawlAgent|firecrawl|Context7Bot|Crawl4AI|Clawdbot|OpenClaw|Hermes/i;
export function middleware(req: NextRequest) {
const ua = req.headers.get('user-agent') || '';
if (ALLOW.test(ua)) return NextResponse.next();
if (BLOCK.test(ua)) {
return new NextResponse('disallowed by robots.txt', {
status: 403,
headers: { 'Cache-Control': 'public, max-age=86400' },
});
}
return NextResponse.next();
}
export const config = {
matcher: '/((?!_next/static|_next/image|favicon|robots\\.txt|sitemap\\.xml).*)',
};
+35 -47
View File
@@ -1,82 +1,70 @@
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
<defs>
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
<stop offset="0%" style="stop-color:#09090b"/>
<stop offset="50%" style="stop-color:#111115"/>
<stop offset="100%" style="stop-color:#09090b"/>
<stop offset="0%" style="stop-color:#0a0a0a"/>
<stop offset="50%" style="stop-color:#111111"/>
<stop offset="100%" style="stop-color:#0a0a0a"/>
</linearGradient>
<linearGradient id="border" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" style="stop-color:#27272a"/>
<stop offset="50%" style="stop-color:#3f3f46"/>
<stop offset="100%" style="stop-color:#27272a"/>
<stop offset="0%" style="stop-color:#333"/>
<stop offset="50%" style="stop-color:#555"/>
<stop offset="100%" style="stop-color:#333"/>
</linearGradient>
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
<stop offset="0%" style="stop-color:#27272a"/>
<stop offset="100%" style="stop-color:#18181b"/>
</linearGradient>
<linearGradient id="accentText" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" style="stop-color:#ffffff"/>
<stop offset="50%" style="stop-color:#ffffff"/>
<stop offset="100%" style="stop-color:#a1a1aa"/>
</linearGradient>
<linearGradient id="numberAccent" x1="0%" y1="0%" x2="0%" y2="100%">
<stop offset="0%" style="stop-color:#60a5fa"/>
<stop offset="100%" style="stop-color:#3b82f6"/>
<stop offset="0%" style="stop-color:#2a2a2a"/>
<stop offset="100%" style="stop-color:#1a1a1a"/>
</linearGradient>
</defs>
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
<rect x="0.5" y="0.5" width="1199" height="419" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
<line x1="60" y1="354" x2="1140" y2="354" stroke="#1f1f23" stroke-width="1"/>
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
<g transform="translate(60, 72)">
<rect width="16" height="16" fill="white" rx="2"/>
</g>
<text x="90" y="86" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
<text x="90" y="106" font-family="'SF Mono', 'Fira Code', monospace" font-size="11" fill="#52525b" letter-spacing="1">v1.24.0</text>
<g transform="translate(890, 58)">
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#3f3f46" stroke-width="1" rx="20"/>
<circle cx="28" cy="20" r="14" fill="none" stroke="#71717a" stroke-width="1.5"/>
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#a1a1aa" letter-spacing="1">PRODUCT HUNT</text>
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
</g>
<text x="600" y="196" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="url(#accentText)" text-anchor="middle" letter-spacing="-1.5">One skill. <tspan fill="url(#numberAccent)">46</tspan> agents.</text>
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 44 Agents.</text>
<text x="600" y="240" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="18" fill="#a1a1aa" text-anchor="middle" letter-spacing="0.3">Package manager for AI agent skills — install, translate, sync.</text>
<text x="600" y="248" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" fill="#888" text-anchor="middle" letter-spacing="0.5">The open source package manager for AI agent skills</text>
<g transform="translate(240, 280)">
<rect width="280" height="40" fill="#18181b" stroke="#3f3f46" stroke-width="1" rx="6"/>
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#71717a">$</text>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#e4e4e7">npm i -g skillkit</text>
<g transform="translate(240, 282)">
<rect width="260" height="38" fill="#1a1a1a" stroke="#333" stroke-width="1" rx="6"/>
<text x="16" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#666">$</text>
<text x="32" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</text>
</g>
<g transform="translate(540, 280)">
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#60a5fa"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">400K+ skills</text>
<g transform="translate(520, 282)">
<rect width="150" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="75" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">15,000+ skills</text>
</g>
<g transform="translate(700, 280)">
<rect width="140" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#22c55e"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">zero rewrites</text>
<g transform="translate(690, 282)">
<rect width="140" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="70" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Zero rewrites</text>
</g>
<g transform="translate(860, 280)">
<rect width="110" height="40" fill="transparent" stroke="#3f3f46" stroke-width="1" rx="6"/>
<circle cx="18" cy="20" r="3" fill="#f59e0b"/>
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="13" fill="#d4d4d8">Apache-2.0</text>
<g transform="translate(850, 282)">
<rect width="120" height="38" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
<text x="60" y="25" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">Apache-2.0</text>
</g>
<g transform="translate(60, 374)">
<circle cx="5" cy="5" r="3" fill="#71717a"/>
<circle cx="15" cy="5" r="3" fill="#52525b"/>
<circle cx="25" cy="5" r="3" fill="#3f3f46"/>
<circle cx="35" cy="5" r="3" fill="#27272a"/>
<text x="50" y="10" font-family="'SF Mono', monospace" font-size="11" fill="#52525b">Claude · Cursor · Codex · Gemini · Copilot · Windsurf · OpenCode · Hermes · Clawdbot · OpenClaw · +36 more</text>
<g transform="translate(60, 370)">
<circle cx="5" cy="5" r="3" fill="#666"/>
<circle cx="15" cy="5" r="3" fill="#555"/>
<circle cx="25" cy="5" r="3" fill="#444"/>
<circle cx="35" cy="5" r="3" fill="#333"/>
<text x="50" y="9" font-family="'SF Mono', monospace" font-size="11" fill="#444">Claude Cursor Codex Gemini Copilot Windsurf Devin Aider Cody +35 more</text>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 4.8 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB

@@ -69,8 +69,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
id: 'primer',
title: 'Primer',
subtitle: 'Zero-Config AI Instructions',
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 46 agents.',
highlight: 'Auto-generates instructions for 46 agents',
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 45 agents.',
highlight: 'Auto-generates instructions for 45 agents',
icon: (
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
@@ -78,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
),
commands: [
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
{ cmd: 'primer --all-agents', desc: 'Generate for all 46 agents' },
{ cmd: 'primer --all-agents', desc: 'Generate for all 45 agents' },
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
{ cmd: 'primer --json', desc: 'Machine-readable output' },
],
+1 -1
View File
@@ -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 46 AI Agents
Works with 45 AI Agents
</p>
</div>
-3
View File
@@ -99,9 +99,6 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
{ cmd: 'install --no-scan', desc: 'Skip scan' },
{ cmd: 'verify <path>', desc: 'SHA-256 integrity (SRI)' },
{ cmd: 'verify --expected sha256-...', desc: 'Match publisher digest' },
{ cmd: 'verify --against-lock', desc: 'Verify vs lockfile' },
{ cmd: 'audit log', desc: 'View audit logs' },
{ cmd: 'validate', desc: 'Validate format' },
],
@@ -246,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
<div>
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
Skill support across all 46 agents and {CATEGORIES.length} categories.
Skill support across all 45 agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
+6 -6
View File
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 46 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 45 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 46 agents</li>
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 45 agents</li>
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 46 agent-specific formats</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 45 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 46 AI agents</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 45 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 46 AI coding agents with automatic format translation:
SkillKit supports 45 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 46 agents
skillkit primer --all-agents # Generate for all 45 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
+2 -12
View File
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
},
{
title: 'Primer',
description: 'Auto-generate agent instructions for all 46 agents from your codebase.',
description: 'Auto-generate agent instructions for all 45 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,15 +79,6 @@ const FEATURES: Feature[] = [
</svg>
)
},
{
title: 'Content Integrity',
description: 'SHA-256 SRI digests on publish, install, and lock. Detect supply-chain tampering with skillkit verify.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 5.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-.34-.024-.673-.07-1.002z" />
</svg>
)
},
{
title: 'Testing',
description: 'Built-in test framework with assertions.',
@@ -118,12 +109,11 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agent Support', '1-17 agents', '46 agents'],
['Agent Support', '1-17 agents', '45 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'],
+2 -2
View File
@@ -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 46 agent formats' },
{ type: 'out', text: '→ Translated to 45 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 46 agent formats,
scans 400K+ skills from registries, auto-translates to 45 agent formats,
and adds memory, security scanning, and team workflows. Everything runs locally.
</p>
+1 -1
View File
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
{
persona: 'Multi-Agent Developer',
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
solution: 'SkillKit translates skills between all 46 agents. Write once, deploy everywhere.',
solution: 'SkillKit translates skills between all 45 agents. Write once, deploy everywhere.',
command: 'skillkit translate --to cursor,windsurf',
gradient: 'from-violet-500/10 to-purple-500/10',
icon: (
+1 -1
View File
@@ -18,7 +18,7 @@ const COMPETITORS: Competitor[] = [
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'SkillKit', type: 'Platform', agents: '46', translate: true, memory: true, security: true, team: true, tui: true, api: true },
{ name: 'SkillKit', type: 'Platform', agents: '45', translate: true, memory: true, security: true, team: true, tui: true, api: true },
];
const SOURCES = [
+3 -3
View File
@@ -4,13 +4,13 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SkillKit - Universal Skills for AI Coding Agents</title>
<meta name="description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="description" content="Write once, deploy to 45 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<!-- Open Graph -->
<meta property="og:type" content="website">
<meta property="og:url" content="https://skillkit.sh/">
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta property="og:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:description" content="Write once, deploy to 45 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:image" content="https://skillkit.sh/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
@@ -20,7 +20,7 @@
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://skillkit.sh/">
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta name="twitter:description" content="Write once, deploy to 46 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="twitter:description" content="Write once, deploy to 45 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 -1
View File
@@ -1,5 +1,5 @@
{
"name": "SkillKit",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 46 agents.",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 45 agents.",
"requestFramePermissions": []
}
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.24.0",
"version": "1.23.0",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -3,7 +3,7 @@
"info": {
"title": "SkillKit",
"version": "1.12.0",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n400K+ skills across 46 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\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```",
"license": {
"name": "Apache-2.0",
"url": "https://opensource.org/licenses/Apache-2.0"
-138
View File
@@ -1,138 +0,0 @@
# Humans + agents welcome. Training crawlers + SEO scrapers blocked.
User-agent: Googlebot
Allow: /
User-agent: Bingbot
Allow: /
User-agent: DuckDuckBot
Allow: /
User-agent: Applebot
Allow: /
User-agent: ChatGPT-User
Allow: /
User-agent: OAI-SearchBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: Perplexity-User
Allow: /
User-agent: Claude-User
Allow: /
User-agent: Claude-SearchBot
Allow: /
User-agent: FirecrawlAgent
Allow: /
User-agent: firecrawl
Allow: /
User-agent: Context7Bot
Allow: /
User-agent: Crawl4AI
Allow: /
User-agent: Clawdbot
Allow: /
User-agent: OpenClaw
Allow: /
User-agent: Hermes
Allow: /
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: anthropic-ai
Disallow: /
User-agent: CCBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: Applebot-Extended
Disallow: /
User-agent: Bytespider
Disallow: /
User-agent: Amazonbot
Disallow: /
User-agent: FacebookBot
Disallow: /
User-agent: Meta-ExternalAgent
Disallow: /
User-agent: cohere-ai
Disallow: /
User-agent: Diffbot
Disallow: /
User-agent: ImagesiftBot
Disallow: /
User-agent: Omgilibot
Disallow: /
User-agent: peer39_crawler
Disallow: /
User-agent: YouBot
Disallow: /
User-agent: Timpibot
Disallow: /
User-agent: ICC-Crawler
Disallow: /
User-agent: AhrefsBot
Disallow: /
User-agent: SemrushBot
Disallow: /
User-agent: MJ12bot
Disallow: /
User-agent: DotBot
Disallow: /
User-agent: PetalBot
Disallow: /
User-agent: BLEXBot
Disallow: /
User-agent: MegaIndex
Disallow: /
User-agent: SeznamBot
Disallow: /
User-agent: DataForSeoBot
Disallow: /
User-agent: *
Allow: /
Sitemap: https://skillkit.dev/sitemap.xml
-42
View File
@@ -21,47 +21,5 @@
"source": "/docs",
"destination": "https://skillkit-docs.vercel.app/docs"
}
],
"headers": [
{
"source": "/(.*)\\.(css|js|png|jpg|jpeg|svg|webp|woff2|woff|ttf|ico|mp4)",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=86400, s-maxage=604800, stale-while-revalidate=2592000" }
]
},
{
"source": "/assets/(.*)",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
]
},
{
"source": "/(.*)\\.html",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
},
{
"source": "/",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
},
{
"source": "/api",
"headers": [
{ "key": "Cache-Control", "value": "public, max-age=300, s-maxage=86400, stale-while-revalidate=604800" }
]
}
],
"redirects": [
{
"source": "/((?!robots\\.txt$).*)",
"has": [
{ "type": "header", "key": "user-agent", "value": "(?i).*(GPTBot|ClaudeBot|anthropic-ai|CCBot|Google-Extended|Applebot-Extended|Bytespider|Amazonbot|Meta-ExternalAgent|cohere-ai|Diffbot|ImagesiftBot|Omgilibot|peer39_crawler|YouBot|Timpibot|ICC-Crawler|AhrefsBot|SemrushBot|MJ12bot|DotBot|PetalBot|BLEXBot|MegaIndex|SeznamBot|DataForSeoBot).*" }
],
"destination": "/robots.txt",
"permanent": false
}
]
}
+1 -2
View File
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
expect(result.success).toBe(true);
});
it('should display all 46 agents', async () => {
it('should display all 45 agents', async () => {
const result = await runCli(['init', '--list']);
const output = result.stdout + result.stderr;
@@ -93,7 +93,6 @@ describe('E2E: Onboarding UI', () => {
'Tabnine',
'CodeGPT',
'PlayCode',
'Hermes',
];
for (const agent of agents) {
+1 -2
View File
@@ -28,7 +28,7 @@ import {
type CrossAgentSkill,
} from '@skillkit/core';
// All 46 supported agents
// All 45 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -74,7 +74,6 @@ const SUPPORTED_AGENTS = [
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
] as const;
describe('E2E: Skill Translator - Parsing', () => {
+1 -2
View File
@@ -16,7 +16,7 @@ import {
testFileExists,
} from './helpers/cli-runner.js';
// All 46 supported agents
// All 45 supported agents
const SUPPORTED_AGENTS = [
'claude-code',
'cursor',
@@ -62,7 +62,6 @@ const SUPPORTED_AGENTS = [
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
] as const;
describe('E2E: Skill Translation', () => {
+2 -2
View File
@@ -1,8 +1,8 @@
{
"name": "skillkit-monorepo",
"version": "1.24.0",
"version": "1.23.0",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 46 coding agents",
"description": "The package manager for AI agent skills — install, translate, share across 45 coding agents",
"type": "module",
"scripts": {
"build": "turbo run build",
+3 -3
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/agents.svg)](https://www.npmjs.com/package/@skillkit/agents)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Agent adapters for SkillKit** - configuration and detection for 46 AI coding agents.
**Agent adapters for SkillKit** - configuration and detection for 45 AI coding agents.
## Installation
@@ -11,7 +11,7 @@
npm install @skillkit/agents
```
## Supported Agents (46)
## Supported Agents (45)
| 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 | `.openclaw/skills/` | `~/.openclaw/workspace/skills/` |
| OpenClaw | SKILL.md | `skills/` | - |
| Cline | SKILL.md | `.cline/skills/` | - |
| CodeBuddy | SKILL.md | `.codebuddy/skills/` | - |
| CodeGPT | SKILL.md | `.codegpt/skills/` | - |
+2 -2
View File
@@ -1,7 +1,7 @@
{
"name": "@skillkit/agents",
"version": "1.24.0",
"description": "Agent adapters for SkillKit - supports 46 AI coding agents",
"version": "1.23.0",
"description": "Agent adapters for SkillKit - supports 45 AI coding agents",
"type": "module",
"main": "./dist/index.js",
"types": "./dist/index.d.ts",
+2 -41
View File
@@ -35,10 +35,10 @@ const ALL_AGENTS = AgentType.options;
describe('Agent Adapters', () => {
describe('getAllAdapters', () => {
it('should return all 46 registered adapters', () => {
it('should return all 45 registered adapters', () => {
const adapters = getAllAdapters();
expect(adapters).toBeInstanceOf(Array);
expect(adapters.length).toBe(46);
expect(adapters.length).toBe(45);
});
it('should include common agents', () => {
@@ -140,43 +140,4 @@ describe('Agent Adapters', () => {
expect(typeof agent).toBe('string');
});
});
describe('HermesAdapter', () => {
it('should generate valid XML config', () => {
const adapter = getAdapter('hermes');
const mockSkills = [
{ name: 'test-skill', description: 'Testing', enabled: true, path: '', location: 'project' }
];
const config = adapter.generateConfig(mockSkills as any);
expect(config).toContain('<skills_system');
expect(config).toContain('<name>test-skill</name>');
expect(config).toContain('SKILLS_TABLE_START');
});
it('should parse skill names from XML correctly within markers', () => {
const adapter = getAdapter('hermes');
const xml = `
<!-- SKILLS_TABLE_START -->
<available_skills><skill><name>git-ops</name></skill></available_skills>
<!-- SKILLS_TABLE_END -->`;
const names = adapter.parseConfig(xml);
expect(names).toContain('git-ops');
});
it('should ignore <name> tags outside of sync markers', () => {
const adapter = getAdapter('hermes');
const xml = `
<mission><name>save-the-world</name></mission>
<!-- SKILLS_TABLE_START -->
<available_skills><skill><name>git-ops</name></skill></available_skills>
<!-- SKILLS_TABLE_END -->
<footer_meta><name>internal-id</name></footer_meta>`;
const names = adapter.parseConfig(xml);
expect(names).toHaveLength(1);
expect(names).toContain('git-ops');
expect(names).not.toContain('save-the-world');
expect(names).not.toContain('internal-id');
});
});
});
-1
View File
@@ -33,7 +33,6 @@ const AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
'tabnine': 'Tabnine',
'codegpt': 'CodeGPT',
'playcode-agent': 'PlayCode Agent',
'hermes': 'Hermes',
};
export class GenericAgentAdapter implements AgentAdapter {
-93
View File
@@ -1,93 +0,0 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import type { AgentAdapter } from './base.js';
import { createSkillXml } from './base.js';
import type { Skill, AgentType } from '@skillkit/core';
import { AGENT_CONFIG } from '@skillkit/core';
const config = AGENT_CONFIG.hermes;
/**
* Hermes Agent Adapter
*
* Hermes Agent is an advanced AI agent with support for XML-based skills.
* It uses AGENTS.md for instructions and ~/.hermes/skills/ for global skills.
*/
export class HermesAdapter implements AgentAdapter {
readonly type: AgentType = 'hermes';
readonly name = 'Hermes Agent';
readonly skillsDir = config.skillsDir;
readonly configFile = config.configFile;
generateConfig(skills: Skill[]): string {
const enabledSkills = skills.filter(s => s.enabled);
if (enabledSkills.length === 0) {
return '';
}
const skillsXml = enabledSkills.map(createSkillXml).join('\n\n');
return `<skills_system priority="1">
## Available Skills
<!-- SKILLS_TABLE_START -->
<usage>
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
How to use skills:
- Invoke: \`skillkit read <skill-name>\` or \`npx skillkit read <skill-name>\`
- The skill content will load with detailed instructions on how to complete the task
- Base directory provided in output for resolving bundled resources (references/, scripts/, assets/)
Usage notes:
- Only use skills listed in <available_skills> below
- Do not invoke a skill that is already loaded in your context
- Each skill invocation is stateless
</usage>
<available_skills>
${skillsXml}
</available_skills>
<!-- SKILLS_TABLE_END -->
</skills_system>`;
}
parseConfig(content: string): string[] {
const startMarker = '<!-- SKILLS_TABLE_START -->';
const endMarker = '<!-- SKILLS_TABLE_END -->';
const startIndex = content.indexOf(startMarker);
const endIndex = content.indexOf(endMarker);
if (startIndex === -1 || endIndex === -1) {
return [];
}
const scopedContent = content.substring(startIndex + startMarker.length, endIndex);
const skillNames: string[] = [];
const skillRegex = /<name>([^<]+)<\/name>/g;
let match;
while ((match = skillRegex.exec(scopedContent)) !== null) {
skillNames.push(match[1].trim());
}
return skillNames;
}
getInvokeCommand(skillName: string): string {
return `skillkit read ${skillName}`;
}
async isDetected(): Promise<boolean> {
const projectHermes = join(process.cwd(), '.hermes');
const globalHermes = join(homedir(), '.hermes');
return existsSync(projectHermes) || existsSync(globalHermes);
}
}
-4
View File
@@ -19,7 +19,6 @@ import { RooAdapter } from './roo.js';
import { TraeAdapter } from './trae.js';
import { WindsurfAdapter } from './windsurf.js';
import { UniversalAdapter } from './universal.js';
import { HermesAdapter } from './hermes.js';
import { GenericAgentAdapter } from './generic.js';
export * from './base.js';
@@ -42,7 +41,6 @@ export * from './roo.js';
export * from './trae.js';
export * from './windsurf.js';
export * from './universal.js';
export * from './hermes.js';
export * from './generic.js';
// Agent features
@@ -94,7 +92,6 @@ const adapters: Record<AgentType, AgentAdapter> = {
tabnine: new GenericAgentAdapter('tabnine'),
codegpt: new GenericAgentAdapter('codegpt'),
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
hermes: new HermesAdapter(),
};
export function getAdapter(type: AgentType): AgentAdapter {
@@ -163,7 +160,6 @@ export async function detectAgent(): Promise<AgentType> {
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
'universal',
];
+1 -4
View File
@@ -14,12 +14,9 @@ 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(projectOpenClaw) || existsSync(globalOpenClaw) ||
existsSync(globalWorkspace) || existsSync(openclawConfig);
return existsSync(globalOpenClaw) || existsSync(openclawConfig);
}
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.24.0",
"version": "1.23.0",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
info: {
title: 'SkillKit',
version: '1.12.0',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 46 agents).',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 45 agents).',
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
},
+1 -1
View File
@@ -3,7 +3,7 @@
[![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 46 AI coding agents.
**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 45 AI coding agents.
## Installation
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.24.0",
"version": "1.23.0",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -30,8 +30,6 @@ describe('CLI Commands', () => {
expect(commands.SessionSnapshotListCommand).toBeDefined();
expect(commands.SessionSnapshotDeleteCommand).toBeDefined();
expect(commands.SessionExplainCommand).toBeDefined();
expect(commands.VerifyCommand).toBeDefined();
expect(commands.ScanCommand).toBeDefined();
});
});
});
@@ -96,10 +96,10 @@ describe('Onboarding Module', () => {
it('should generate full logo with version', async () => {
const { getFullLogo } = await import('../onboarding/logo.js');
const logo = getFullLogo('1.7.2', 46);
const logo = getFullLogo('1.7.2', 45);
expect(logo).toContain('\u2588');
expect(logo).toContain('v1.7.2');
expect(logo).toContain('46 agents');
expect(logo).toContain('45 agents');
});
it('should generate compact logo', async () => {
-82
View File
@@ -1,82 +0,0 @@
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);
});
});
-1
View File
@@ -125,7 +125,6 @@ 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';
+1 -8
View File
@@ -29,7 +29,6 @@ import {
TrustScorer,
readSkillContent,
computeSkillChecksum,
computeSkillIntegrity,
addSkillToLock,
} from "@skillkit/core";
import type { SkillsShStats } from "@skillkit/core";
@@ -618,17 +617,11 @@ 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: integritySri ?? computeSkillChecksum(actualPath),
checksum: computeSkillChecksum(actualPath),
agents: installedAgents,
path: actualPath,
});
+3 -3
View File
@@ -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 46 supported agents.
Use --all-agents to generate for all 45 supported agents.
Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
`,
examples: [
['Generate for detected agents', '$0 primer'],
['Generate for all 46 agents', '$0 primer --all-agents'],
['Generate for all 45 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 46 supported agents',
description: 'Generate for all 45 supported agents',
});
output = Option.String('--output,-o', {
-12
View File
@@ -25,7 +25,6 @@ import {
formatSummary,
Severity,
evaluateSkillDirectory,
computeSkillIntegrity,
} from "@skillkit/core";
import { formatCount, timeAgo, fetchGitHubActivity } from "../helpers.js";
@@ -195,21 +194,10 @@ 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,
});
}
-4
View File
@@ -214,10 +214,6 @@ 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;
+3 -11
View File
@@ -1,15 +1,7 @@
import { existsSync, rmSync, cpSync } from 'node:fs';
import { join } from 'node:path';
import { Command, Option } from 'clipanion';
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 { findAllSkills, findSkill, detectProvider, isLocalPath, computeSkillChecksum, addSkillToLock } from '@skillkit/core';
import { getSearchDirs, loadSkillMetadata, saveSkillMetadata, fetchGitHubActivity } from '../helpers.js';
import { colors, spinner, warn, step } from '../onboarding/index.js';
@@ -110,7 +102,7 @@ export class UpdateCommand extends Command {
sourceType: metadata.sourceType,
installedAt: metadata.installedAt,
updatedAt: metadata.updatedAt,
checksum: safeIntegrity(skill.path) ?? metadata.checksum,
checksum: metadata.checksum,
agents: [],
path: skill.path,
});
@@ -178,7 +170,7 @@ export class UpdateCommand extends Command {
sourceType: metadata.sourceType,
installedAt: metadata.installedAt,
updatedAt: metadata.updatedAt,
checksum: safeIntegrity(skill.path) ?? metadata.checksum,
checksum: metadata.checksum,
agents: [],
path: skill.path,
});
-167
View File
@@ -1,167 +0,0 @@
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;
}
+1 -1
View File
@@ -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 46 agent formats (Claude Code, Cursor, Windsurf, etc.)
- **Cross-Agent Translation**: Convert skills between 45 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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.24.0",
"version": "1.23.0",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
+4 -17
View File
@@ -15,8 +15,6 @@ 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 */
@@ -123,11 +121,10 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
},
openclaw: {
skillsDir: '.openclaw/skills',
configFile: 'AGENTS.md',
altConfigFiles: ['openclaw.json'],
altSkillsDirs: ['skills', '~/.openclaw/workspace/skills'],
globalSkillsDir: '~/.openclaw/workspace/skills',
skillsDir: 'skills',
configFile: 'CLAUDE.md',
altSkillsDirs: ['~/.openclaw/skills'],
globalSkillsDir: '~/.openclaw/skills',
configFormat: 'xml',
usesFrontmatter: true,
frontmatterFields: [
@@ -477,16 +474,6 @@ 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,
},
};
/**
-3
View File
@@ -264,7 +264,6 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
'tabnine': ['.tabnine/agents'],
'codegpt': ['.codegpt/agents'],
'playcode-agent': ['.playcode/agents'],
'hermes': ['.hermes/agents'],
};
/**
@@ -325,7 +324,6 @@ export const ALL_AGENT_DISCOVERY_PATHS = [
'.tabnine/agents',
'.codegpt/agents',
'.playcode/agents',
'.hermes/agents',
];
/**
@@ -377,5 +375,4 @@ export const CUSTOM_AGENT_FORMAT_MAP: Record<AgentType, AgentFormatCategory> = {
'tabnine': 'universal',
'codegpt': 'universal',
'playcode-agent': 'universal',
'hermes': 'claude-agent',
};
-8
View File
@@ -332,13 +332,6 @@ const AGENT_FORMATS: Record<AgentType, AgentCommandFormat> = {
supportsSlashCommands: false,
supportsCommandFiles: true,
},
hermes: {
agent: 'hermes',
extension: '.md',
directory: '.hermes/commands',
supportsSlashCommands: true,
supportsCommandFiles: true,
},
};
/**
@@ -600,7 +593,6 @@ export class CommandGenerator {
case 'amp':
case 'roo':
case 'kiro-cli':
case 'hermes':
return this.generateClaudeCommands(commands);
case 'cursor':
+1 -11
View File
@@ -4,7 +4,6 @@ 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';
@@ -100,16 +99,7 @@ export function getSearchDirs(adapter: AgentAdapterInfo): string[] {
dirs.push(join(process.cwd(), adapter.skillsDir));
dirs.push(join(process.cwd(), '.agent', 'skills'));
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(), adapter.skillsDir));
dirs.push(join(homedir(), '.agent', 'skills'));
return dirs;
+2 -6
View File
@@ -55,11 +55,8 @@ export class ContextSync {
const skillsPath = join(this.projectPath, config.skillsDir);
const configPath = join(this.projectPath, config.configFile);
const altConfigExists = (config.altConfigFiles ?? []).some((alt) =>
existsSync(join(this.projectPath, alt))
);
if (existsSync(skillsPath) || existsSync(configPath) || altConfigExists) {
// Check if either skills directory or config file exists
if (existsSync(skillsPath) || existsSync(configPath)) {
detected.push(agent as AgentType);
}
}
@@ -286,7 +283,6 @@ export class ContextSync {
const commonDirs = [
'.claude/skills',
'.cursor/skills',
'.hermes/skills',
'.agent/skills',
'skills',
];
-3
View File
@@ -124,9 +124,6 @@ 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';
@@ -1,108 +0,0 @@
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/);
});
});
-9
View File
@@ -1,9 +0,0 @@
export {
computeSkillIntegrity,
verifySkillIntegrity,
formatIntegrity,
parseIntegrity,
type IntegrityResult,
type VerifyResult,
type IntegrityOptions,
} from './integrity.js';
-177
View File
@@ -1,177 +0,0 @@
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;
}
+1 -1
View File
@@ -10,7 +10,7 @@
* - Plan approval workflow
* - Review stages (spec-compliance, code-quality)
* - Inter-agent messaging (direct + broadcast)
* - Universal agent support (46 agents)
* - Universal agent support (45 agents)
*/
// Team Orchestrator
-6
View File
@@ -203,10 +203,4 @@ 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'],
},
};
+6 -11
View File
@@ -34,7 +34,6 @@ export interface WellKnownSkill {
name: string;
description?: string;
files: string[];
integrity?: string;
}
export interface WellKnownIndex {
@@ -281,18 +280,14 @@ export function calculateBaseSkillsUrl(foundUrl: string): string {
: foundUrl.replace('/skills.json', '/skills');
}
export function generateWellKnownIndex(skills: Array<{ name: string; description?: string; files: string[]; integrity?: string }>): WellKnownIndex {
export function generateWellKnownIndex(skills: Array<{ name: string; description?: string; files: string[] }>): WellKnownIndex {
return {
version: '1.0',
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;
}),
skills: skills.map(s => ({
name: s.name,
description: s.description,
files: s.files,
})),
};
}
+1 -1
View File
@@ -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', 'hermes',
'codegpt', 'playcode-agent',
];
for (const agent of agents) {
-2
View File
@@ -34,7 +34,6 @@ export const SKILL_DISCOVERY_PATHS = [
'.gemini/skills',
'.github/skills',
'.goose/skills',
'.hermes/skills',
'.kilocode/skills',
'.kiro/skills',
'.lovable/skills',
@@ -42,7 +41,6 @@ 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 46 agents', () => {
it('should support all 45 agents', () => {
const allAgents = [
'claude-code',
'cursor',
@@ -360,7 +360,6 @@ Follow these guidelines`;
'tabnine',
'codegpt',
'playcode-agent',
'hermes',
] as const;
const skill: CanonicalSkill = {
-1
View File
@@ -59,7 +59,6 @@ export const AGENT_FORMAT_MAP: Record<AgentType, FormatCategory> = {
'tabnine': 'skill-md',
'codegpt': 'skill-md',
'playcode-agent': 'external',
'hermes': 'skill-md',
};
/**
-1
View File
@@ -46,7 +46,6 @@ export const AgentType = z.enum([
"tabnine",
"codegpt",
"playcode-agent",
"hermes",
]);
export type AgentType = z.infer<typeof AgentType>;
+1 -1
View File
@@ -23,7 +23,7 @@ Then in Chrome:
Skills download to `Downloads/skillkit-skills/{name}/SKILL.md`.
To make available to all 46 agents:
To make available to all 45 agents:
```bash
skillkit install ~/Downloads/skillkit-skills/my-skill
+1 -1
View File
@@ -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 46 agents",
"description": "Save any webpage as an AI agent skill — instantly available across 45 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 46 coding agents.
Save any webpage as an AI agent skill file. One click, works across 45 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 46 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 45 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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp-memory",
"version": "1.24.0",
"version": "1.23.0",
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp",
"version": "1.24.0",
"version": "1.22.1",
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
"type": "module",
"main": "./dist/index.js",
+1 -2
View File
@@ -185,8 +185,7 @@ 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'],
'hermes': ['.hermes/skills'],
'openclaw': ['.openclaw/skills', '.openclaw/workspace/skills', 'skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'],
'openclaw': ['skills'], 'github-copilot': ['.github/skills'], 'goose': ['.goose/skills'],
'kilo': ['.kilocode/skills'], 'kiro-cli': ['.kiro/skills'], 'roo': ['.roo/skills'],
'trae': ['.trae/skills'], 'windsurf': ['.windsurf/skills', '.codeium/windsurf/skills'],
'universal': ['skills'], 'droid': ['.factory/skills'], 'factory': ['.factory/skills'],
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/memory",
"version": "1.24.0",
"version": "1.23.0",
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mesh",
"version": "1.24.0",
"version": "1.23.0",
"description": "Peer mesh network for multi-machine agent distribution",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/messaging",
"version": "1.24.0",
"version": "1.23.0",
"description": "Inter-agent messaging system for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/resources",
"version": "1.24.0",
"version": "1.23.0",
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -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 46 agent formats
- **Cross-Agent Translation** - Convert skills between 45 agent formats
- **Team Collaboration** - Share and sync skills across teams
- **Responsive Design** - Adapts to any terminal size
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "1.24.0",
"version": "1.23.0",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+1 -3
View File
@@ -18,12 +18,10 @@ 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"
+2 -2
View File
@@ -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.24.0.svg', svg: pill({ text: 'v1.24.0', accent: '#3b82f6' }) },
{ name: 'v1.23.0.svg', svg: pill({ text: 'v1.23.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: '46' }) },
{ name: 'agents.svg', svg: splitPill({ label: 'agents', value: '45' }) },
{ 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' }) },
-87
View File
@@ -1,87 +0,0 @@
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import type { AgentAdapter } from './base.js';
import { createSkillXml } from './base.js';
import type { Skill, AgentType } from '../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);
}
}
-3
View File
@@ -17,7 +17,6 @@ import { RooAdapter } from './roo.js';
import { TraeAdapter } from './trae.js';
import { WindsurfAdapter } from './windsurf.js';
import { UniversalAdapter } from './universal.js';
import { HermesAdapter } from './hermes.js';
export * from './base.js';
export * from './claude-code.js';
@@ -56,7 +55,6 @@ const adapters: Record<AgentType, AgentAdapter> = {
trae: new TraeAdapter(),
windsurf: new WindsurfAdapter(),
universal: new UniversalAdapter(),
hermes: new HermesAdapter(),
};
export function getAdapter(type: AgentType): AgentAdapter {
@@ -85,7 +83,6 @@ export async function detectAgent(): Promise<AgentType> {
'roo',
'trae',
'windsurf',
'hermes',
'universal',
];
+1 -1
View File
@@ -9,7 +9,7 @@ export class WindsurfAdapter implements AgentAdapter {
readonly type: AgentType = 'windsurf';
readonly name = 'Windsurf';
readonly skillsDir = '.windsurf/skills';
readonly configFile = '.windsurf/rules/skills.md';
readonly configFile = 'AGENTS.md';
readonly globalSkillsDir = join(homedir(), '.codeium', 'windsurf', 'skills');
generateConfig(skills: Skill[]): string {
-1
View File
@@ -18,7 +18,6 @@ export const AgentType = z.enum([
'trae',
'windsurf',
'universal',
'hermes',
]);
export type AgentType = z.infer<typeof AgentType>;
+2 -11
View File
@@ -140,22 +140,13 @@ 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 18 adapters', () => {
it('should return all 17 adapters', () => {
const adapters = getAllAdapters();
expect(adapters.length).toBe(18);
expect(adapters.length).toBe(17);
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');