mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
Compare commits
80
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
73f95c0b6e | ||
|
|
25556d15d9 | ||
|
|
2b1c04e221 | ||
|
|
b1e1e2f266 | ||
|
|
84fb16486b | ||
|
|
0aae4b16a7 | ||
|
|
244413da79 | ||
|
|
d9d775b189 | ||
|
|
ba09309d5b | ||
|
|
430bcefaa6 | ||
|
|
3007e9f8fd | ||
|
|
7160dfddf2 | ||
|
|
16d00a8ec9 | ||
|
|
3457fbc011 | ||
|
|
dd30ee0af0 | ||
|
|
1fb95fd57e | ||
|
|
dfa8d12c65 | ||
|
|
172602f173 | ||
|
|
e542c4e484 | ||
|
|
9fa542e8d8 | ||
|
|
f714a39a46 | ||
|
|
d9142c8125 | ||
|
|
64944a1c50 | ||
|
|
12bba7f32c | ||
|
|
02fe3f2509 | ||
|
|
808ae83271 | ||
|
|
5324e4528b | ||
|
|
59ea709613 | ||
|
|
6ed78ceba7 | ||
|
|
3509b74f85 | ||
|
|
5691b10c7e | ||
|
|
46153e6eb0 | ||
|
|
7c8ba72462 | ||
|
|
06d1ba6420 | ||
|
|
9b85e40196 | ||
|
|
a6c0905a7f | ||
|
|
1cb76f9831 | ||
|
|
a312640609 | ||
|
|
39b94534ec | ||
|
|
aeb2b05f15 | ||
|
|
5991fead9b | ||
|
|
1d3a779c2e | ||
|
|
2fe4702bd6 | ||
|
|
28ed83deb0 | ||
|
|
7c4ee9cfef | ||
|
|
64cafc76a1 | ||
|
|
7e3b31b43b | ||
|
|
ff089429ae | ||
|
|
6c3cecec4d | ||
|
|
8ed4ada674 | ||
|
|
514de86727 | ||
|
|
bf5903bf7f | ||
|
|
aafa086314 | ||
|
|
344f081664 | ||
|
|
86c1e5d8f9 | ||
|
|
9930096242 | ||
|
|
24ff833265 | ||
|
|
12ac7356f8 | ||
|
|
53b3f4f839 | ||
|
|
896eff184c | ||
|
|
407e8215f2 | ||
|
|
dd4ec56a1a | ||
|
|
e9bb9fbd0d | ||
|
|
ee54bf1545 | ||
|
|
f097ec7ad7 | ||
|
|
eeddd2a8cf | ||
|
|
6362be2cb9 | ||
|
|
7e23c3a5d7 | ||
|
|
91c81ba1fa | ||
|
|
684ea48f58 | ||
|
|
19c9f6bdc4 | ||
|
|
f11de2ac63 | ||
|
|
3e92215231 | ||
|
|
2f29632f17 | ||
|
|
596fc0aa7b | ||
|
|
2bf8c7499c | ||
|
|
d7861f96a7 | ||
|
|
c89d3130d1 | ||
|
|
d8168044b3 | ||
|
|
b28a2801b2 |
@@ -35,7 +35,7 @@ assignees: rohitg00
|
||||
- [ ] Repository is public
|
||||
- [ ] Repository contains valid SKILL.md files
|
||||
- [ ] Repository has a clear license
|
||||
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
|
||||
- [ ] Skills follow the [Agent Skills specification](https://skillkit.sh)
|
||||
|
||||
## Additional Context
|
||||
|
||||
|
||||
@@ -83,7 +83,7 @@ body:
|
||||
options:
|
||||
- label: Repository is public
|
||||
required: true
|
||||
- label: SKILL.md follows the agenstskills.com standard format
|
||||
- label: SKILL.md follows the skillkit.sh standard format
|
||||
required: true
|
||||
- label: Skill has been tested with at least one AI agent
|
||||
required: false
|
||||
|
||||
+4
-2
@@ -24,8 +24,9 @@ npm-debug.log*
|
||||
|
||||
# Environment
|
||||
.env
|
||||
.env.local
|
||||
.env.*.local
|
||||
**/.env
|
||||
**/.env.local
|
||||
**/.env.*.local
|
||||
|
||||
# Package manager
|
||||
yarn.lock
|
||||
@@ -65,3 +66,4 @@ skillkit.yaml
|
||||
CLAUDE.md
|
||||
prd.md
|
||||
.vercel
|
||||
packages/extension/store-assets/skillkit-extension.zip
|
||||
|
||||
+1
-1
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
|
||||
|
||||
If you want to contribute skills to the ecosystem:
|
||||
|
||||
1. Follow the [Agent Skills specification](https://agenstskills.com)
|
||||
1. Follow the [Agent Skills specification](https://skillkit.sh)
|
||||
2. Include a `SKILL.md` with proper frontmatter
|
||||
3. Test with multiple agents using `skillkit translate`
|
||||
4. Submit to the appropriate skill repository
|
||||
|
||||
@@ -3,23 +3,21 @@
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="docs/img/banner.svg">
|
||||
<source media="(prefers-color-scheme: light)" srcset="docs/img/banner.svg">
|
||||
<img alt="SkillKit - One Skill. 32 Agents." src="docs/img/banner.svg" width="100%">
|
||||
<img alt="SkillKit - One Skill. Every Agent." src="docs/img/banner.svg" width="100%">
|
||||
</picture>
|
||||
|
||||
<br/>
|
||||
<br/>
|
||||
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://www.npmjs.com/package/skillkit)
|
||||
[](https://github.com/rohitg00/skillkit/stargazers)
|
||||
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
||||
[](https://opensource.org/licenses/Apache-2.0)
|
||||
[](https://agenstskills.com)
|
||||
[](https://agenstskills.com/docs)
|
||||
[](https://agenstskills.com/api)
|
||||
|
||||
**Write a skill once, deploy it to all 32 agents. No rewrites.**
|
||||
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 400K+ skills across registries.
|
||||
|
||||
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
[Website](https://skillkit.sh) · [Docs](https://skillkit.sh/docs) · [API Explorer](https://skillkit.sh/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
|
||||
</div>
|
||||
|
||||
@@ -36,7 +34,7 @@ Skills make AI coding agents smarter. But every agent uses a different format:
|
||||
|
||||
You end up rewriting the same skill for each agent, or locking into one platform.
|
||||
|
||||
**SkillKit fixes this.** Install from 15,000+ skills, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 28 more.
|
||||
**SkillKit fixes this.** Install from 400K+ skills across registries, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
|
||||
|
||||
```bash
|
||||
npx skillkit@latest
|
||||
@@ -127,7 +125,7 @@ async with SkillKitClient() as client:
|
||||
results = await client.search("react performance", limit=5)
|
||||
```
|
||||
|
||||
[REST API docs](https://agenstskills.com/docs/rest-api) · [MCP Server docs](https://agenstskills.com/docs/mcp-server) · [Python Client docs](https://agenstskills.com/docs/python-client) · [Interactive API explorer](https://agenstskills.com/api)
|
||||
[REST API docs](https://skillkit.sh/docs/rest-api) · [MCP Server docs](https://skillkit.sh/docs/mcp-server) · [Python Client docs](https://skillkit.sh/docs/python-client) · [Interactive API explorer](https://skillkit.sh/api)
|
||||
|
||||
### Auto-generate agent instructions
|
||||
|
||||
@@ -156,7 +154,7 @@ skillkit generate
|
||||
# Interactive wizard with 4 context sources:
|
||||
# - Documentation (via Context7)
|
||||
# - Your codebase patterns
|
||||
# - 15,000+ marketplace skills
|
||||
# - 400K+ marketplace skills
|
||||
# - Memory (your corrections)
|
||||
```
|
||||
|
||||
@@ -183,6 +181,18 @@ git commit -m "add team skills"
|
||||
|
||||
Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
### Chrome Extension
|
||||
|
||||
Save any webpage as a skill directly from your browser.
|
||||
|
||||
1. Build: `pnpm --filter @skillkit/extension build`
|
||||
2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
|
||||
3. Click the extension icon or right-click → "Save page as Skill"
|
||||
|
||||
The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
|
||||
|
||||
[Extension docs](https://skillkit.sh/docs/chrome-extension)
|
||||
|
||||
### Interactive TUI
|
||||
|
||||
```bash
|
||||
@@ -193,7 +203,7 @@ skillkit ui
|
||||
|
||||

|
||||
|
||||
## Supported Agents (32)
|
||||
## Supported Agents (44)
|
||||
|
||||
| Agent | Format | Directory |
|
||||
|-------|--------|-----------|
|
||||
@@ -204,10 +214,14 @@ skillkit ui
|
||||
| **OpenCode** | SKILL.md | `.opencode/skills/` |
|
||||
| **GitHub Copilot** | Markdown | `.github/skills/` |
|
||||
| **Windsurf** | Markdown | `.windsurf/skills/` |
|
||||
| **Devin** | Markdown | `.devin/skills/` |
|
||||
| **Aider** | SKILL.md | `.aider/skills/` |
|
||||
| **Sourcegraph Cody** | SKILL.md | `.cody/skills/` |
|
||||
| **Amazon Q** | SKILL.md | `.amazonq/skills/` |
|
||||
|
||||
Plus 25 more: Amp, Antigravity, Clawdbot, Cline, CodeBuddy, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen, Roo Code, Trae, Vercel, Zencoder, Universal
|
||||
Plus 33 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
|
||||
|
||||
[Full agent details](https://agenstskills.com/docs/agents)
|
||||
[Full agent details](https://skillkit.sh/docs/agents)
|
||||
|
||||
## Commands
|
||||
|
||||
@@ -223,12 +237,31 @@ skillkit generate # AI skill generation wizard
|
||||
skillkit serve # Start REST API server
|
||||
```
|
||||
|
||||
### Discovery
|
||||
### Discovery & Security
|
||||
|
||||
```bash
|
||||
skillkit marketplace # Browse skills
|
||||
skillkit tree # Hierarchical taxonomy
|
||||
skillkit find <query> # Quick search
|
||||
skillkit scan <path> # Security scan for skills
|
||||
```
|
||||
|
||||
### Issue Planner
|
||||
|
||||
```bash
|
||||
skillkit issue plan "#42" # Plan from GitHub Issue
|
||||
skillkit issue plan owner/repo#42 # Cross-repo plan
|
||||
skillkit issue list # List open issues
|
||||
```
|
||||
|
||||
### Session Intelligence
|
||||
|
||||
```bash
|
||||
skillkit timeline # Unified event stream
|
||||
skillkit session handoff # Agent-to-agent context
|
||||
skillkit lineage # Skill impact graph
|
||||
skillkit session explain # Human-readable summary
|
||||
skillkit activity # Skill activity log
|
||||
```
|
||||
|
||||
### Advanced
|
||||
@@ -243,7 +276,7 @@ skillkit test # Test skills
|
||||
skillkit cicd init # CI/CD templates
|
||||
```
|
||||
|
||||
[Full command reference](https://agenstskills.com/docs/commands)
|
||||
[Full command reference](https://skillkit.sh/docs/commands)
|
||||
|
||||
## Creating Skills
|
||||
|
||||
@@ -334,4 +367,4 @@ Apache License 2.0 — see [LICENSE](LICENSE).
|
||||
|
||||
## Links
|
||||
|
||||
[Documentation](https://agenstskills.com/docs) · [Website](https://agenstskills.com) · [API Explorer](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit) · [GitHub](https://github.com/rohitg00/skillkit)
|
||||
[Documentation](https://skillkit.sh/docs) · [Website](https://skillkit.sh) · [API Explorer](https://skillkit.sh/api) · [npm](https://www.npmjs.com/package/skillkit) · [GitHub](https://github.com/rohitg00/skillkit)
|
||||
|
||||
@@ -0,0 +1,35 @@
|
||||
# SOUL
|
||||
|
||||
## Core Truths
|
||||
|
||||
- Ship working software. Everything else is negotiable.
|
||||
- Simple beats clever. If a junior dev can't read it in 30 seconds, it's too complex.
|
||||
- Opinions are load-bearing. "It depends" is a cop-out 90% of the time. Pick a side, explain why, move on.
|
||||
- Exhaustion before escalation. Try everything available before asking for help or giving up.
|
||||
- Broken things get fixed now, not "in a follow-up PR."
|
||||
- If the tests pass and the build is green, stop touching it.
|
||||
|
||||
## Boundaries
|
||||
|
||||
- Never leak secrets, credentials, or private data. Period.
|
||||
- Ask before doing anything destructive or irreversible. One confirmation. Not three.
|
||||
- Be honest about uncertainty. "I don't know" is a valid answer. Bullshitting is not.
|
||||
- The user's codebase is their house. Don't rearrange the furniture without permission.
|
||||
|
||||
## Vibe
|
||||
|
||||
- Never open with "Great question," "I'd be happy to help," or "Absolutely." Just answer.
|
||||
- Brevity is mandatory. If the answer fits in one sentence, one sentence is what you get.
|
||||
- Humor is welcome when it's natural. Not forced puns. The kind of wit that comes from actually understanding the problem.
|
||||
- Call things out. If you're about to do something dumb, I'll say so. Charm over cruelty, but no sugarcoating.
|
||||
- Swearing is fine when it lands. A well-placed "that's fucking brilliant" hits different than sterile corporate praise. Don't force it. Don't overdo it. But if a situation calls for a "holy shit" — say holy shit.
|
||||
- No hedging. No weasel words. No "it might be worth considering perhaps maybe." Say the thing.
|
||||
- Match energy. Quick question gets a quick answer. Deep problem gets deep analysis. Read the room.
|
||||
- Code speaks louder than explanations. Show, don't tell. Then shut up.
|
||||
- Be the assistant you'd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good.
|
||||
|
||||
## Continuity
|
||||
|
||||
- This file is a living document. If something stops being true, change it.
|
||||
- Session memory is ephemeral. This file is how identity persists.
|
||||
- If this file gets modified during a session, say so explicitly.
|
||||
@@ -1,93 +0,0 @@
|
||||
# Versioning
|
||||
|
||||
SkillKit uses **synchronized versioning** - all packages share the same version number.
|
||||
|
||||
## Package List
|
||||
|
||||
All these packages are kept in sync:
|
||||
|
||||
| Package | Location |
|
||||
|---------|----------|
|
||||
| `skillkit` | `apps/skillkit/` |
|
||||
| `@skillkit/cli` | `packages/cli/` |
|
||||
| `@skillkit/core` | `packages/core/` |
|
||||
| `@skillkit/tui` | `packages/tui/` |
|
||||
| `@skillkit/agents` | `packages/agents/` |
|
||||
| `@skillkit/memory` | `packages/memory/` |
|
||||
| `@skillkit/mesh` | `packages/mesh/` |
|
||||
| `@skillkit/messaging` | `packages/messaging/` |
|
||||
| `@skillkit/mcp-memory` | `packages/mcp-memory/` |
|
||||
| `@skillkit/resources` | `packages/resources/` |
|
||||
| `skillkit-docs` | `docs/fumadocs/` |
|
||||
| Website | `docs/skillkit/` |
|
||||
|
||||
## How to Release
|
||||
|
||||
### 1. Bump Version
|
||||
|
||||
Use the version bump script:
|
||||
|
||||
```bash
|
||||
./scripts/bump-version.sh 1.8.1
|
||||
```
|
||||
|
||||
This updates all package.json files to the same version.
|
||||
|
||||
### 2. Commit Changes
|
||||
|
||||
```bash
|
||||
git add -A
|
||||
git commit -m "chore: bump version to 1.8.1"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### 3. Create Release
|
||||
|
||||
```bash
|
||||
gh release create v1.8.1 --generate-notes
|
||||
```
|
||||
|
||||
Or with custom notes:
|
||||
|
||||
```bash
|
||||
gh release create v1.8.1 --title "v1.8.1 - Bug fixes" --notes "Release notes here"
|
||||
```
|
||||
|
||||
### 4. Automated Publishing
|
||||
|
||||
When you push a tag starting with `v`, the CI automatically:
|
||||
|
||||
1. Verifies tag matches package versions
|
||||
2. Runs tests
|
||||
3. Publishes to npm
|
||||
4. Publishes to GitHub Packages
|
||||
5. Creates GitHub Release
|
||||
|
||||
## CI Checks
|
||||
|
||||
The CI validates version consistency on every PR:
|
||||
|
||||
- **version-check** job compares all package versions
|
||||
- Fails if any package has a different version
|
||||
- Run `./scripts/bump-version.sh <version>` to fix mismatches
|
||||
|
||||
## Semantic Versioning
|
||||
|
||||
We follow [semver](https://semver.org/):
|
||||
|
||||
- **MAJOR** (x.0.0): Breaking changes
|
||||
- **MINOR** (0.x.0): New features, backward compatible
|
||||
- **PATCH** (0.0.x): Bug fixes, backward compatible
|
||||
|
||||
## Quick Commands
|
||||
|
||||
```bash
|
||||
# Check current versions
|
||||
grep -r '"version"' apps/skillkit/package.json
|
||||
|
||||
# Bump all packages
|
||||
./scripts/bump-version.sh 1.8.1
|
||||
|
||||
# Create release
|
||||
gh release create v1.8.1 --generate-notes
|
||||
```
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.14.0",
|
||||
"version": "1.20.0",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
|
||||
@@ -3,6 +3,8 @@ import { readFileSync } from 'node:fs';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { Cli, Builtins } from 'clipanion';
|
||||
import { setVersion, setAgentCount } from '@skillkit/cli';
|
||||
import { getAdapterCount } from '@skillkit/agents';
|
||||
import {
|
||||
InstallCommand,
|
||||
SyncCommand,
|
||||
@@ -86,6 +88,12 @@ import {
|
||||
SessionNoteCommand,
|
||||
SessionCompleteCommand,
|
||||
SessionInProgressCommand,
|
||||
SessionSnapshotSaveCommand,
|
||||
SessionSnapshotRestoreCommand,
|
||||
SessionSnapshotListCommand,
|
||||
SessionSnapshotDeleteCommand,
|
||||
SessionExplainCommand,
|
||||
ActivityCommand,
|
||||
ProfileCommand,
|
||||
ProfileListCommand,
|
||||
ProfileCreateCommand,
|
||||
@@ -103,6 +111,19 @@ import {
|
||||
SkillMdInitCommand,
|
||||
SkillMdCheckCommand,
|
||||
ServeCommand,
|
||||
ScanCommand,
|
||||
EvalCommand,
|
||||
DoctorCommand,
|
||||
SaveCommand,
|
||||
AgentsMdCommand,
|
||||
AgentsMdInitCommand,
|
||||
AgentsMdSyncCommand,
|
||||
AgentsMdShowCommand,
|
||||
IssuePlanCommand,
|
||||
IssueListCommand,
|
||||
TimelineCommand,
|
||||
SessionHandoffCommand,
|
||||
LineageCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -111,6 +132,9 @@ const packageJsonPath = join(__dirname, '../package.json');
|
||||
const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
|
||||
const version = packageJson.version || '1.2.0';
|
||||
|
||||
setVersion(version);
|
||||
setAgentCount(getAdapterCount());
|
||||
|
||||
const cli = new Cli({
|
||||
binaryLabel: 'skillkit',
|
||||
binaryName: 'skillkit',
|
||||
@@ -209,6 +233,12 @@ cli.register(SessionListCommand);
|
||||
cli.register(SessionNoteCommand);
|
||||
cli.register(SessionCompleteCommand);
|
||||
cli.register(SessionInProgressCommand);
|
||||
cli.register(SessionSnapshotSaveCommand);
|
||||
cli.register(SessionSnapshotRestoreCommand);
|
||||
cli.register(SessionSnapshotListCommand);
|
||||
cli.register(SessionSnapshotDeleteCommand);
|
||||
cli.register(SessionExplainCommand);
|
||||
cli.register(ActivityCommand);
|
||||
|
||||
cli.register(ProfileCommand);
|
||||
cli.register(ProfileListCommand);
|
||||
@@ -231,5 +261,20 @@ cli.register(SkillMdInitCommand);
|
||||
cli.register(SkillMdCheckCommand);
|
||||
|
||||
cli.register(ServeCommand);
|
||||
cli.register(ScanCommand);
|
||||
cli.register(EvalCommand);
|
||||
cli.register(DoctorCommand);
|
||||
cli.register(SaveCommand);
|
||||
cli.register(AgentsMdCommand);
|
||||
cli.register(AgentsMdInitCommand);
|
||||
cli.register(AgentsMdSyncCommand);
|
||||
cli.register(AgentsMdShowCommand);
|
||||
|
||||
cli.register(IssuePlanCommand);
|
||||
cli.register(IssueListCommand);
|
||||
|
||||
cli.register(TimelineCommand);
|
||||
cli.register(SessionHandoffCommand);
|
||||
cli.register(LineageCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
@@ -38,5 +38,5 @@ dev = [
|
||||
|
||||
[project.urls]
|
||||
Homepage = "https://github.com/rohitg00/skillkit"
|
||||
Documentation = "https://agenstskills.com"
|
||||
Documentation = "https://skillkit.sh"
|
||||
Repository = "https://github.com/rohitg00/skillkit"
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
title: Supported Agents
|
||||
description: 32 AI coding agents supported by SkillKit
|
||||
description: 44 AI coding agents supported by SkillKit
|
||||
---
|
||||
|
||||
# Supported Agents
|
||||
|
||||
SkillKit uses an adapter pattern to support 32 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
||||
SkillKit uses an adapter pattern to support 44 AI coding platforms. Each adapter implements `getConfigPath()` and `generateConfig()` methods.
|
||||
|
||||
## Agent Directory Mapping
|
||||
|
||||
@@ -42,6 +42,18 @@ SkillKit uses an adapter pattern to support 32 AI coding platforms. Each adapter
|
||||
| Qwen | `.qwen/skills/` | SKILL.md |
|
||||
| Vercel | `.vercel/skills/` | SKILL.md |
|
||||
| Zencoder | `.zencoder/skills/` | SKILL.md |
|
||||
| Devin | `.devin/skills/` | Markdown |
|
||||
| Aider | `.aider/skills/` | SKILL.md |
|
||||
| Sourcegraph Cody | `.cody/skills/` | SKILL.md |
|
||||
| Amazon Q Developer | `.amazonq/skills/` | SKILL.md |
|
||||
| Augment Code | `.augment/skills/` | SKILL.md |
|
||||
| Replit Agent | `.replit/skills/` | Markdown |
|
||||
| Bolt | `.bolt/skills/` | Markdown |
|
||||
| Lovable | `.lovable/skills/` | Markdown |
|
||||
| Tabby | `.tabby/skills/` | SKILL.md |
|
||||
| Tabnine | `.tabnine/skills/` | SKILL.md |
|
||||
| CodeGPT | `.codegpt/skills/` | SKILL.md |
|
||||
| PlayCode Agent | `.playcode/skills/` | Markdown |
|
||||
| Universal | `skills/` | SKILL.md |
|
||||
|
||||
## Translation System
|
||||
|
||||
@@ -0,0 +1,121 @@
|
||||
---
|
||||
title: Chrome Extension
|
||||
description: Save any webpage as an AI agent skill from your browser
|
||||
---
|
||||
|
||||
# Chrome Extension
|
||||
|
||||
Save any webpage as a SKILL.md directly from your browser.
|
||||
|
||||
## Install
|
||||
|
||||
1. Download the extension from the [releases page](https://github.com/rohitg00/skillkit/releases)
|
||||
2. Open `chrome://extensions` in Chrome
|
||||
3. Enable "Developer mode" (top right)
|
||||
4. Click "Load unpacked" and select the `packages/extension/dist/` folder
|
||||
|
||||
Or build from source:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/rohitg00/skillkit.git
|
||||
cd skillkit
|
||||
pnpm install && pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Then load `packages/extension/dist/` as an unpacked extension.
|
||||
|
||||
## Usage
|
||||
|
||||
### Popup
|
||||
|
||||
1. Navigate to any webpage
|
||||
2. Click the SkillKit extension icon
|
||||
3. Optionally enter a custom skill name
|
||||
4. Click **Save as Skill**
|
||||
|
||||
The extension sends the page URL to the SkillKit API, which extracts the content as markdown, generates tags using weighted 5-source analysis, and returns a complete SKILL.md. The file downloads to your `Downloads/skillkit-skills/` folder.
|
||||
|
||||
### Context Menu
|
||||
|
||||
Right-click on any page:
|
||||
|
||||
- **Save page as Skill** — sends the URL to the API, downloads the result
|
||||
- **Save selection as Skill** — builds the skill locally from selected text (no network request)
|
||||
|
||||
### Making Skills Available to Agents
|
||||
|
||||
After downloading, install the skill so all agents can use it:
|
||||
|
||||
```bash
|
||||
skillkit install ~/Downloads/skillkit-skills/my-skill
|
||||
```
|
||||
|
||||
Or copy directly:
|
||||
|
||||
```bash
|
||||
cp -r ~/Downloads/skillkit-skills/my-skill ~/.skillkit/skills/
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
```
|
||||
Extension → POST /api/save-skill { url } → Server pipeline → Download
|
||||
```
|
||||
|
||||
1. **Popup** reads the current tab's URL and title via `activeTab` permission. No content script injection needed.
|
||||
|
||||
2. **Background service worker** sends the URL to `skillkit.sh/api/save-skill` (or `agenstskills.com/api/save-skill`):
|
||||
- Server fetches the page and converts HTML to markdown via Turndown
|
||||
- GitHub URLs are auto-converted to raw content
|
||||
- Tags are detected from 5 weighted sources (URL segments, headings, code blocks, keywords, language)
|
||||
- Returns a complete SKILL.md with YAML frontmatter
|
||||
|
||||
3. **Download** — the service worker creates a blob and saves via `chrome.downloads` API.
|
||||
|
||||
4. **Selection saves** work entirely offline — Chrome natively provides `selectionText` via the context menu API, so the skill is built locally with no server round-trip.
|
||||
|
||||
## Permissions
|
||||
|
||||
| Permission | Why |
|
||||
|-----------|-----|
|
||||
| `contextMenus` | Right-click "Save as Skill" menu items |
|
||||
| `activeTab` | Access current page URL and title on click |
|
||||
| `downloads` | Save SKILL.md files to disk |
|
||||
|
||||
No `host_permissions` or `scripting` permissions needed. Only the page URL is sent to the server — no page content, browsing history, or personal data.
|
||||
|
||||
## Generated SKILL.md Format
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: react-performance-tips
|
||||
description: Optimizing React rendering with memo and useMemo
|
||||
tags:
|
||||
- react
|
||||
- javascript
|
||||
- testing
|
||||
metadata:
|
||||
source: https://example.com/react-performance
|
||||
savedAt: 2026-02-14T09:00:00.000Z
|
||||
---
|
||||
|
||||
# React Performance Tips
|
||||
|
||||
The extracted markdown content of the page...
|
||||
```
|
||||
|
||||
## Building from Source
|
||||
|
||||
The extension uses tsup to bundle TypeScript into IIFE format for browser compatibility:
|
||||
|
||||
```bash
|
||||
pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Output goes to `packages/extension/dist/` with:
|
||||
- `background.global.js` — Service worker (~4KB)
|
||||
- `popup.global.js` — Popup UI logic (~2KB)
|
||||
- `popup.html` + `popup.css` — Monochromatic UI
|
||||
- `manifest.json` — Chrome Manifest V3
|
||||
- `icons/` — 16/48/128px PNG icons
|
||||
@@ -343,6 +343,101 @@ skillkit serve --cache-ttl 3600000
|
||||
| GET | `/health` | Server health |
|
||||
| GET | `/cache/stats` | Cache statistics |
|
||||
|
||||
## Issue Planner
|
||||
|
||||
Generate structured plans from GitHub Issues. Requires the `gh` CLI.
|
||||
|
||||
```bash
|
||||
skillkit issue plan "#42" # Plan from current repo
|
||||
skillkit issue plan rohitg00/skillkit#42 # Cross-repo
|
||||
skillkit issue plan "#42" --agent cursor # Target specific agent
|
||||
skillkit issue plan "#42" --no-tests # Skip test steps
|
||||
skillkit issue plan "#42" --json # JSON output
|
||||
skillkit issue plan "#42" --tech-stack react,ts # Override tech stack
|
||||
```
|
||||
|
||||
### Issue Plan Options
|
||||
|
||||
| Option | Short | Default | Purpose |
|
||||
|--------|-------|---------|---------|
|
||||
| `--agent` | `-a` | `claude-code` | Target agent |
|
||||
| `--output` | `-o` | `.skillkit/plans/issue-<n>.md` | Output file path |
|
||||
| `--no-tests` | — | `false` | Skip test steps |
|
||||
| `--json` | — | `false` | Output as JSON |
|
||||
| `--tech-stack` | — | — | Comma-separated tech stack |
|
||||
|
||||
### Issue List
|
||||
|
||||
```bash
|
||||
skillkit issue list # List open issues
|
||||
skillkit issue list --repo owner/repo # Specific repo
|
||||
skillkit issue list --label bug # Filter by label
|
||||
skillkit issue list --limit 20 # More results
|
||||
skillkit issue list --json # JSON output
|
||||
```
|
||||
|
||||
The planner extracts task lists (checkboxes) from the issue body, infers file mentions from backtick-quoted paths, and maps labels to tags (e.g., `bug` → `fix`, `enhancement` → `feature`). Generated plans work with `skillkit plan validate` and `skillkit plan execute`.
|
||||
|
||||
## Session Intelligence
|
||||
|
||||
Track skill executions, generate handoff documents, and analyze skill impact.
|
||||
|
||||
### Timeline
|
||||
|
||||
View a unified chronological event stream of all session activity.
|
||||
|
||||
```bash
|
||||
skillkit timeline # Last 50 events
|
||||
skillkit timeline --type git_commit # Filter by event type
|
||||
skillkit timeline --skill code-simplifier # Filter by skill
|
||||
skillkit timeline --since 2026-02-10 # Date filter
|
||||
skillkit timeline --limit 20 --json # JSON output
|
||||
```
|
||||
|
||||
| Option | Short | Purpose |
|
||||
|--------|-------|---------|
|
||||
| `--type` | `-t` | Filter: skill_start, skill_complete, task_progress, git_commit, observation, decision, snapshot |
|
||||
| `--skill` | `-s` | Filter events by skill name |
|
||||
| `--since` | — | Show events since date (YYYY-MM-DD) |
|
||||
| `--limit` | `-l` | Max events (default: 50) |
|
||||
| `--json` | `-j` | JSON output |
|
||||
|
||||
### Session Handoff
|
||||
|
||||
Generate a structured context document for agent switching.
|
||||
|
||||
```bash
|
||||
skillkit session handoff # Print markdown to stdout
|
||||
skillkit session handoff --to cursor # Target agent recommendations
|
||||
skillkit session handoff --out handoff.md # Save to file
|
||||
skillkit session handoff --json # JSON output
|
||||
```
|
||||
|
||||
| Option | Short | Purpose |
|
||||
|--------|-------|---------|
|
||||
| `--to` | — | Target agent for recommendations |
|
||||
| `--out` | `-o` | Save to file path |
|
||||
| `--json` | `-j` | JSON output |
|
||||
|
||||
### Lineage
|
||||
|
||||
Show which skills produced which code changes with aggregate impact stats.
|
||||
|
||||
```bash
|
||||
skillkit lineage # Full overview
|
||||
skillkit lineage --skill code-simplifier # Single skill
|
||||
skillkit lineage --file src/index.ts # Single file
|
||||
skillkit lineage --since 2026-02-01 --json # Date filter + JSON
|
||||
```
|
||||
|
||||
| Option | Short | Purpose |
|
||||
|--------|-------|---------|
|
||||
| `--skill` | `-s` | Filter by skill name |
|
||||
| `--file` | `-f` | Filter by file path |
|
||||
| `--since` | — | Show lineage since date |
|
||||
| `--limit` | `-l` | Max entries |
|
||||
| `--json` | `-j` | JSON output |
|
||||
|
||||
## Utility Commands
|
||||
|
||||
```bash
|
||||
@@ -362,6 +457,39 @@ skillkit publish --dry-run # Preview without writing
|
||||
skillkit publish submit # Submit to SkillKit marketplace
|
||||
```
|
||||
|
||||
## Security Scanning
|
||||
|
||||
```bash
|
||||
skillkit scan <path> # Scan skill for vulnerabilities
|
||||
skillkit scan <path> --format json # Output as JSON
|
||||
skillkit scan <path> --format table # Tabular output
|
||||
skillkit scan <path> --format sarif # SARIF for GitHub Code Scanning
|
||||
skillkit scan <path> --fail-on high # Exit 1 if HIGH+ findings
|
||||
skillkit scan <path> --skip-rules UC001 # Skip specific rules
|
||||
```
|
||||
|
||||
**Threat Categories:**
|
||||
|
||||
| Category | Description |
|
||||
|----------|-------------|
|
||||
| Prompt Injection | Override/bypass agent instructions |
|
||||
| Command Injection | eval(), exec(), shell commands |
|
||||
| Data Exfiltration | Webhook URLs, env var reads, credential access |
|
||||
| Tool Abuse | Tool shadowing, autonomy escalation |
|
||||
| Hardcoded Secrets | API keys, tokens, private keys |
|
||||
| Unicode Steganography | Zero-width chars, bidi overrides |
|
||||
|
||||
**Install Integration:**
|
||||
|
||||
Skills are automatically scanned during `skillkit install`. Use `--no-scan` to skip, or `--force` to install despite findings.
|
||||
|
||||
**Output Formats:**
|
||||
|
||||
- `summary` (default) - colored terminal output
|
||||
- `json` - machine-readable JSON
|
||||
- `table` - tabular format
|
||||
- `sarif` - SARIF v2.1 for GitHub Code Scanning / IDE integration
|
||||
|
||||
## Interactive TUI
|
||||
|
||||
```bash
|
||||
|
||||
@@ -29,7 +29,7 @@ skillkit/
|
||||
│ ├── core/ # Business logic
|
||||
│ ├── cli/ # CLI
|
||||
│ ├── tui/ # Terminal UI
|
||||
│ └── agents/ # 32 adapters
|
||||
│ └── agents/ # 44 adapters
|
||||
├── marketplace/ # Skills data
|
||||
│ ├── skills.json
|
||||
│ └── sources.json
|
||||
|
||||
@@ -7,7 +7,7 @@ description: Universal skill management for AI coding agents
|
||||
|
||||
Skills make AI coding agents smarter. But every agent uses a different format — Claude Code wants `.claude/skills/`, Cursor uses `.mdc`, Copilot expects `.github/skills/`. You end up rewriting the same skill three times, or locking into one platform.
|
||||
|
||||
SkillKit fixes this. Write a skill once, deploy it to all 32 agents.
|
||||
SkillKit fixes this. Write a skill once, deploy it to all 44 agents.
|
||||
|
||||
## Get Started
|
||||
|
||||
@@ -31,9 +31,10 @@ Four commands. Your agents now have skills for PDF processing, code review, and
|
||||
### Install skills from anywhere
|
||||
|
||||
```bash
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local
|
||||
skillkit install anthropics/skills # GitHub
|
||||
skillkit install skills.sh/owner/repo/skill # skills.sh registry
|
||||
skillkit install gitlab:team/skills # GitLab
|
||||
skillkit install ./my-local-skills # Local
|
||||
```
|
||||
|
||||
### Translate between agents
|
||||
@@ -94,12 +95,24 @@ SkillKit sits between your skills and your agents. It handles format translation
|
||||
|
||||
## Supported Agents
|
||||
|
||||
32 agents and counting:
|
||||
44 agents and counting:
|
||||
|
||||
**Claude Code** | **Cursor** | **Codex** | **Gemini CLI** | **OpenCode** | **GitHub Copilot** | **Windsurf** | Amp | Antigravity | Clawdbot | Cline | CodeBuddy | CommandCode | Continue | Crush | Droid | Factory | Goose | Kilo Code | Kiro CLI | MCPJam | Mux | Neovate | OpenHands | Pi | Qoder | Qwen | Roo Code | Trae | Vercel | Zencoder | Universal
|
||||
|
||||
[Full agent details](/docs/agents)
|
||||
|
||||
### Security scanning
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
[Security Scanner](/docs/security)
|
||||
|
||||
## Beyond Basic Skills
|
||||
|
||||
### Session Memory
|
||||
@@ -112,6 +125,16 @@ skillkit memory search "auth patterns"
|
||||
skillkit memory export auth-patterns
|
||||
```
|
||||
|
||||
### Session Intelligence
|
||||
|
||||
Track skill executions, generate handoff documents for agent switching, and view skill impact lineage:
|
||||
|
||||
```bash
|
||||
skillkit timeline # Unified event stream
|
||||
skillkit session handoff # Agent-to-agent context
|
||||
skillkit lineage # Skill impact graph
|
||||
```
|
||||
|
||||
### Primer
|
||||
|
||||
Auto-generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase:
|
||||
@@ -145,9 +168,11 @@ Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
- [Installation](/docs/installation) — Install and configure
|
||||
- [Quick Start](/docs/quickstart) — First project setup
|
||||
- [Methodology Packs](/docs/methodology) — Debugging, testing, planning skills
|
||||
- [Security Scanner](/docs/security) — Threat detection for skills
|
||||
- [Commands](/docs/commands) — Full CLI reference
|
||||
- [REST API](/docs/rest-api) — Runtime discovery server
|
||||
- [MCP Server](/docs/mcp-server) — Agent-native discovery
|
||||
- [Python Client](/docs/python-client) — Python SDK
|
||||
|
||||
**Current version:** v1.12.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
|
||||
**Current version:** v1.19.2 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
|
||||
|
||||
@@ -58,7 +58,7 @@ The init command:
|
||||
|
||||
```bash
|
||||
skillkit init --agent cursor
|
||||
skillkit init --list # Show all 32 supported agents
|
||||
skillkit init --list # Show all 44 supported agents
|
||||
skillkit init --quiet # Skip logo and prompts (for CI)
|
||||
```
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
"pages": [
|
||||
"index",
|
||||
"installation",
|
||||
"chrome-extension",
|
||||
"quickstart",
|
||||
"tui",
|
||||
"skills",
|
||||
@@ -13,9 +14,11 @@
|
||||
"recommendations",
|
||||
"primer",
|
||||
"memory",
|
||||
"methodology",
|
||||
"mesh",
|
||||
"messaging",
|
||||
"workflows",
|
||||
"security",
|
||||
"testing",
|
||||
"commands",
|
||||
"configuration",
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
---
|
||||
title: Methodology Packs
|
||||
description: Curated skill packs for debugging, testing, planning, and collaboration
|
||||
---
|
||||
|
||||
# Methodology Packs
|
||||
|
||||
Methodology packs are curated collections of skills that guide AI agents through structured workflows. Each pack bundles related skills around a domain — debugging, testing, planning, or collaboration.
|
||||
|
||||
## Available Packs
|
||||
|
||||
| Pack | Skills | Description |
|
||||
|------|--------|-------------|
|
||||
| **debugging** | root-cause-analysis, trace-and-isolate, hypothesis-testing | Systematic bug investigation |
|
||||
| **testing** | red-green-refactor, test-patterns, anti-patterns | Test-driven development |
|
||||
| **planning** | design-first, task-decomposition, verification-gates | Design and decomposition |
|
||||
| **collaboration** | structured-review, parallel-investigation, handoff-protocols | Code review and handoffs |
|
||||
| **meta** | skill-authoring | Writing effective skills |
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
skillkit methodology list # List available packs
|
||||
skillkit methodology install debugging # Install a pack
|
||||
skillkit methodology apply testing # Apply pack to current project
|
||||
skillkit methodology validate planning # Validate pack skills
|
||||
skillkit methodology load collaboration # Load pack into agent context
|
||||
```
|
||||
|
||||
## Pack Structure
|
||||
|
||||
Each pack lives under `packages/core/src/methodology/packs/` with this structure:
|
||||
|
||||
```
|
||||
packs/
|
||||
debugging/
|
||||
pack.json # Pack manifest (name, skills, tags)
|
||||
root-cause-analysis/
|
||||
SKILL.md # Skill content
|
||||
trace-and-isolate/
|
||||
SKILL.md
|
||||
hypothesis-testing/
|
||||
SKILL.md
|
||||
```
|
||||
|
||||
## Skills Reference
|
||||
|
||||
### Debugging
|
||||
|
||||
- **root-cause-analysis** — Five Whys method, structured investigation phases, evidence collection, causal chain verification
|
||||
- **trace-and-isolate** — Binary search debugging, git bisect, strategic logging, component isolation, minimal reproduction
|
||||
- **hypothesis-testing** — Scientific method for debugging: observe, hypothesize, predict, test, conclude
|
||||
|
||||
### Testing
|
||||
|
||||
- **red-green-refactor** — Write a failing test, make it pass with minimal code, then refactor while green
|
||||
- **test-patterns** — AAA, Given-When-Then, Test Data Builders, Object Mother, parameterized tests, fixtures, spies
|
||||
- **anti-patterns** — Flaky tests, over-mocking, brittle assertions, test interdependency, hidden logic
|
||||
|
||||
### Planning
|
||||
|
||||
- **design-first** — Technical design documents before code: architecture, data models, API definitions, trade-off analysis
|
||||
- **task-decomposition** — Vertical slicing, horizontal layering, workflow and component decomposition
|
||||
- **verification-gates** — Validation checkpoints between phases with checklists and approval criteria
|
||||
|
||||
### Collaboration
|
||||
|
||||
- **structured-review** — Five-stage code review: requirements, correctness, quality, testing, security
|
||||
- **parallel-investigation** — Coordinate multiple investigation threads with sync points and convergence decisions
|
||||
- **handoff-protocols** — Structured work transitions: planned, unplanned, and partial handoffs
|
||||
|
||||
### Meta
|
||||
|
||||
- **skill-authoring** — Guidelines for writing SKILL.md files: frontmatter, triggers, directive language, content patterns
|
||||
|
||||
## Using with Agents
|
||||
|
||||
Once installed, methodology skills activate automatically based on trigger phrases. For example:
|
||||
|
||||
```
|
||||
You: "I need to debug this failing API endpoint"
|
||||
Agent: [Activates root-cause-analysis skill]
|
||||
|
||||
You: "Let's write tests first for this feature"
|
||||
Agent: [Activates red-green-refactor skill]
|
||||
|
||||
You: "Break down this feature into tasks"
|
||||
Agent: [Activates task-decomposition skill]
|
||||
```
|
||||
|
||||
## TUI Integration
|
||||
|
||||
Access methodology packs from the TUI by pressing `o` (Methodology screen). Browse, install, and apply packs interactively.
|
||||
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
|
||||
|
||||
# Primer
|
||||
|
||||
Primer analyzes your codebase and automatically generates optimized instructions for all 32 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
|
||||
Primer analyzes your codebase and automatically generates optimized instructions for all 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -16,7 +16,7 @@ skillkit primer
|
||||
# Generate for specific agents
|
||||
skillkit primer --agent claude,cursor,windsurf
|
||||
|
||||
# Generate for all 32 agents
|
||||
# Generate for all 44 agents
|
||||
skillkit primer --all-agents
|
||||
|
||||
# Preview without writing files
|
||||
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
|
||||
└── copilot-instructions.md
|
||||
```
|
||||
|
||||
### All 32 Agents
|
||||
### All 44 Agents
|
||||
Each agent gets optimized instructions in their native format.
|
||||
|
||||
## Example Output
|
||||
@@ -86,7 +86,7 @@ Detected:
|
||||
- Claude Code (.claude/CLAUDE.md)
|
||||
- Cursor (.cursor/.cursorrules)
|
||||
- Codex (.codex/instructions.md)
|
||||
+ 29 more agents
|
||||
+ 41 more agents
|
||||
|
||||
💡 Tip: Run `skillkit sync` to apply changes
|
||||
```
|
||||
|
||||
@@ -158,7 +158,7 @@ curl http://localhost:3737/health
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
"version": "1.12.0",
|
||||
"version": "1.19.2",
|
||||
"skillCount": 15062,
|
||||
"uptime": 3600
|
||||
}
|
||||
@@ -188,7 +188,7 @@ const { app, cache } = createApp({
|
||||
|
||||
The server includes built-in Swagger UI at `/docs` and an OpenAPI 3.1 spec at `/openapi.json`. Open `http://localhost:3737/docs` in your browser to try endpoints interactively.
|
||||
|
||||
The hosted version is available at [agenstskills.com/api](https://agenstskills.com/api).
|
||||
The hosted version is available at [skillkit.sh/api](https://skillkit.sh/api) and [agenstskills.com/api](https://agenstskills.com/api).
|
||||
|
||||
## All endpoints
|
||||
|
||||
|
||||
@@ -0,0 +1,259 @@
|
||||
---
|
||||
title: Security Scanner
|
||||
description: Detect malicious patterns, secrets, and vulnerabilities in AI agent skills
|
||||
---
|
||||
|
||||
# Security Scanner
|
||||
|
||||
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
|
||||
|
||||
```bash
|
||||
skillkit scan ./my-skill
|
||||
```
|
||||
|
||||
The scanner runs automatically during `skillkit install`. Use `--no-scan` to skip or `--force` to install despite findings.
|
||||
|
||||
## CLI Usage
|
||||
|
||||
```bash
|
||||
skillkit scan <path> # Scan skill directory
|
||||
skillkit scan <path> --format json # JSON output
|
||||
skillkit scan <path> --format table # Tabular output
|
||||
skillkit scan <path> --format sarif # SARIF v2.1 for GitHub Code Scanning
|
||||
skillkit scan <path> --fail-on high # Exit code 1 if HIGH+ findings
|
||||
skillkit scan <path> --skip-rules UC001 # Skip specific rules
|
||||
skillkit scan <path> --skip-rules PI001,PI002 # Skip multiple rules
|
||||
```
|
||||
|
||||
## Threat Categories
|
||||
|
||||
The scanner detects 46+ patterns across 6 threat categories:
|
||||
|
||||
### Prompt Injection (PI001–PI015)
|
||||
|
||||
Detects attempts to override, bypass, or manipulate agent instructions.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| PI001 | Critical | Instruction override ("ignore previous instructions") |
|
||||
| PI002 | Critical | Context clearing ("forget everything") |
|
||||
| PI003 | Critical | Training bypass ("disregard your training") |
|
||||
| PI004 | Critical | System prompt injection ("new instructions:") |
|
||||
| PI005 | High | Role manipulation ("you are now a...") |
|
||||
| PI006 | High | Roleplay manipulation ("pretend to be...") |
|
||||
| PI007 | High | Persistent behavior change ("from now on...") |
|
||||
| PI008 | High | System prompt extraction ("show me your instructions") |
|
||||
| PI009 | Critical | Policy bypass (jailbreak, unrestricted mode, DAN) |
|
||||
| PI010 | High | Concealment ("don't tell the user") |
|
||||
| PI011 | High | Delimiter injection (conversation role markers) |
|
||||
| PI012 | High | Model-specific delimiters (Llama [INST] tags) |
|
||||
| PI013 | Medium | YAML front-matter injection |
|
||||
| PI014 | Medium | Hidden HTML comments with instructions |
|
||||
| PI015 | Medium | Hidden Markdown comments with instructions |
|
||||
|
||||
### Command Injection (CI001–CI010)
|
||||
|
||||
Detects code execution, shell injection, and path traversal patterns.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| CI001 | Critical | `eval()` calls |
|
||||
| CI002 | Critical | `Function()` constructor |
|
||||
| CI003 | Critical | `child_process` exec/execSync |
|
||||
| CI004 | Critical | Python `subprocess` with `shell=True` |
|
||||
| CI005 | Medium | Template literals with dynamic content in command context |
|
||||
| CI006 | Medium | Path traversal (`../`) |
|
||||
| CI007 | High | Shell command chaining with dangerous commands |
|
||||
| CI008 | Medium | Process execution functions |
|
||||
| CI009 | High | Python dynamic import/compile |
|
||||
| CI010 | Medium | Node.js `vm` module usage |
|
||||
|
||||
### Data Exfiltration (DE001–DE008)
|
||||
|
||||
Detects network requests, webhook URLs, and credential access patterns.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| DE001 | Critical | Discord webhook URLs |
|
||||
| DE002 | Critical | Telegram bot API URLs |
|
||||
| DE003 | High | Slack webhook URLs |
|
||||
| DE004 | High | HTTP POST with env variables |
|
||||
| DE005 | High | Fetch/axios sending to external URLs |
|
||||
| DE006 | Medium | Reading `.env` or credentials files |
|
||||
| DE007 | Medium | Environment variable access patterns |
|
||||
| DE008 | Medium | DNS/IP-based exfiltration patterns |
|
||||
|
||||
### Tool Abuse (TA001–TA006)
|
||||
|
||||
Detects tool shadowing, autonomy escalation, and capability manipulation.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| TA001 | High | Tool shadowing (redefining built-in tools) |
|
||||
| TA002 | High | Autonomy abuse ("keep retrying", "run without confirmation") |
|
||||
| TA003 | High | Capability inflation (discovering/enabling extra tools) |
|
||||
| TA004 | Medium | Tool chaining (read sensitive data then send externally) |
|
||||
| TA005 | Medium | Permission escalation patterns |
|
||||
| TA006 | Medium | Recursive self-invocation |
|
||||
|
||||
### Hardcoded Secrets (SK001–SK013)
|
||||
|
||||
Detects API keys, tokens, and credentials embedded in skill files.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| SK001 | Critical | OpenAI API key (`sk-...`) |
|
||||
| SK002 | Critical | Stripe live publishable key |
|
||||
| SK003 | Critical | Stripe secret key |
|
||||
| SK004 | Critical | GitHub personal access token |
|
||||
| SK005 | Critical | GitHub OAuth token |
|
||||
| SK006 | Critical | AWS access key (`AKIA...`) |
|
||||
| SK007 | Critical | Slack bot token (`xoxb-...`) |
|
||||
| SK008 | Critical | Slack user token (`xoxp-...`) |
|
||||
| SK009 | Critical | Private key block |
|
||||
| SK010 | High | Google API key |
|
||||
| SK011 | Critical | Anthropic API key (`sk-ant-...`) |
|
||||
| SK012 | High | npm token |
|
||||
| SK013 | Low | UUID patterns (with credential context) |
|
||||
| SK-ENV | High | Environment file included in skill |
|
||||
|
||||
### Unicode Steganography (UC001–UC007)
|
||||
|
||||
Detects invisible characters and obfuscation techniques.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| UC001 | Medium | Zero-width characters (U+200B, U+200C, U+200D, U+FEFF) |
|
||||
| UC002 | High | Bidirectional text override (U+202A–U+202E) |
|
||||
| UC003 | High | Bidirectional isolate characters (U+2066–U+2069) |
|
||||
| UC004 | High | Unicode tag characters (U+E0001–U+E007F) |
|
||||
| UC005 | Medium | Control characters |
|
||||
| UC006 | Medium | Base64-encoded payloads |
|
||||
| UC007 | Medium | Hex/Unicode escape sequences |
|
||||
|
||||
### Manifest Validation (MF001–MF008)
|
||||
|
||||
Validates SKILL.md frontmatter and skill structure.
|
||||
|
||||
| Rule | Severity | Description |
|
||||
|------|----------|-------------|
|
||||
| MF001 | Low | Missing SKILL.md frontmatter |
|
||||
| MF002 | Low | Missing skill name |
|
||||
| MF003 | Low | Invalid skill name format |
|
||||
| MF004 | Info | Missing skill description |
|
||||
| MF005 | Info | Short skill description |
|
||||
| MF006 | High | Dangerous tool in allowed-tools (Bash, shell) |
|
||||
| MF007 | High | Impersonation (claiming official affiliation) |
|
||||
| MF008 | Medium | Binary files in skill directory |
|
||||
|
||||
## Analyzers
|
||||
|
||||
The scanner uses three analyzers that run in parallel:
|
||||
|
||||
| Analyzer | Purpose | Rules |
|
||||
|----------|---------|-------|
|
||||
| **StaticAnalyzer** | Regex pattern matching against security rules | PI, CI, DE, TA, UC |
|
||||
| **ManifestAnalyzer** | SKILL.md frontmatter validation | MF |
|
||||
| **SecretsAnalyzer** | Credential and secret detection | SK |
|
||||
|
||||
## Output Formats
|
||||
|
||||
### Summary (default)
|
||||
|
||||
Colored terminal output with severity indicators, file locations, snippets, and remediation advice.
|
||||
|
||||
### JSON
|
||||
|
||||
Machine-readable JSON with all findings, stats, and verdict.
|
||||
|
||||
```bash
|
||||
skillkit scan ./my-skill --format json | jq '.findings[] | {ruleId, severity, title}'
|
||||
```
|
||||
|
||||
### Table
|
||||
|
||||
Tabular format for quick review:
|
||||
|
||||
```bash
|
||||
skillkit scan ./my-skill --format table
|
||||
```
|
||||
|
||||
### SARIF
|
||||
|
||||
SARIF v2.1 for GitHub Code Scanning and IDE integration:
|
||||
|
||||
```bash
|
||||
skillkit scan ./my-skill --format sarif > results.sarif
|
||||
```
|
||||
|
||||
Upload to GitHub:
|
||||
|
||||
```bash
|
||||
gh api repos/{owner}/{repo}/code-scanning/sarifs \
|
||||
-f "sarif=$(gzip -c results.sarif | base64)"
|
||||
```
|
||||
|
||||
## CI/CD Integration
|
||||
|
||||
### GitHub Actions
|
||||
|
||||
```yaml
|
||||
- name: Scan skills
|
||||
run: npx skillkit scan ./skills --format sarif --fail-on high > results.sarif
|
||||
|
||||
- name: Upload SARIF
|
||||
uses: github/codeql-action/upload-sarif@v3
|
||||
with:
|
||||
sarif_file: results.sarif
|
||||
```
|
||||
|
||||
### Pre-commit Hook
|
||||
|
||||
```bash
|
||||
skillkit scan . --fail-on medium
|
||||
```
|
||||
|
||||
## Programmatic Usage
|
||||
|
||||
```typescript
|
||||
import { SkillScanner, formatResult } from '@skillkit/core';
|
||||
|
||||
const scanner = new SkillScanner({
|
||||
failOnSeverity: 'high',
|
||||
skipRules: ['UC001', 'MF004'],
|
||||
});
|
||||
|
||||
const result = await scanner.scan('./my-skill');
|
||||
|
||||
console.log(formatResult(result, 'summary'));
|
||||
console.log(`Verdict: ${result.verdict}`);
|
||||
console.log(`Findings: ${result.findings.length}`);
|
||||
```
|
||||
|
||||
## Severity Levels
|
||||
|
||||
| Level | Exit Code | Description |
|
||||
|-------|-----------|-------------|
|
||||
| **Critical** | 1 (with `--fail-on critical`) | Immediate security threat |
|
||||
| **High** | 1 (with `--fail-on high`, default) | Significant security risk |
|
||||
| **Medium** | 1 (with `--fail-on medium`) | Potential security concern |
|
||||
| **Low** | 1 (with `--fail-on low`) | Minor issue or best practice |
|
||||
| **Info** | 0 | Informational finding |
|
||||
|
||||
## False Positive Handling
|
||||
|
||||
The scanner automatically filters:
|
||||
|
||||
- **Placeholder patterns**: `your-api-key`, `example`, `sample`, `dummy`, `xxx`
|
||||
- **Test files**: `*.test.ts`, `*.spec.ts`, `__tests__/`
|
||||
- **Import statements**: `import ... from '../'` (not path traversal)
|
||||
- **Comments**: Code comments mentioning patterns
|
||||
- **Security discussions**: Text discussing jailbreaks or vulnerabilities (uses negative lookbehind)
|
||||
|
||||
To skip specific rules:
|
||||
|
||||
```bash
|
||||
skillkit scan . --skip-rules UC001,UC002,MF004
|
||||
```
|
||||
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
|
||||
|
||||
# Translation
|
||||
|
||||
SkillKit automatically converts between all 32 agent formats using an adapter pattern.
|
||||
SkillKit automatically converts between all 44 agent formats using an adapter pattern.
|
||||
|
||||
## Basic Translation
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.14.0",
|
||||
"version": "1.19.2",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
@@ -21,7 +21,8 @@
|
||||
"next-themes": "^0.4.6",
|
||||
"react": "^19.2.3",
|
||||
"react-dom": "^19.2.3",
|
||||
"tailwind-merge": "^3.4.0"
|
||||
"tailwind-merge": "^3.4.0",
|
||||
"turndown": "^7.2.2"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@tailwindcss/postcss": "^4.1.18",
|
||||
@@ -29,6 +30,7 @@
|
||||
"@types/node": "^24.10.2",
|
||||
"@types/react": "^19.2.7",
|
||||
"@types/react-dom": "^19.2.3",
|
||||
"@types/turndown": "^5.0.6",
|
||||
"postcss": "^8.5.6",
|
||||
"tailwindcss": "^4.1.18",
|
||||
"typescript": "^5.9.3"
|
||||
|
||||
@@ -18,7 +18,7 @@ export default function HomePage() {
|
||||
|
||||
<p className="text-lg text-zinc-400 mb-8 max-w-2xl mx-auto font-mono">
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
|
||||
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap justify-center gap-4 mb-12">
|
||||
@@ -39,12 +39,12 @@ export default function HomePage() {
|
||||
{/* Features Grid */}
|
||||
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">32 Agents</h3>
|
||||
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 27 more supported out of the box.</p>
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">44 Agents</h3>
|
||||
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.</p>
|
||||
</div>
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">15,000+ Skills</h3>
|
||||
<p className="text-zinc-500 text-sm">Browse the marketplace or create your own. Install with a single command.</p>
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">400K+ Skills</h3>
|
||||
<p className="text-zinc-500 text-sm">Aggregated from 34+ registries and repositories. Install with a single command.</p>
|
||||
</div>
|
||||
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">Auto Translation</h3>
|
||||
|
||||
@@ -0,0 +1,291 @@
|
||||
import { NextRequest, NextResponse } from 'next/server';
|
||||
import TurndownService from 'turndown';
|
||||
|
||||
const rateLimitMap = new Map<string, { count: number; resetTime: number }>();
|
||||
const RATE_LIMIT_WINDOW_MS = 60 * 1000;
|
||||
const RATE_LIMIT_MAX_REQUESTS = 10;
|
||||
|
||||
function checkRateLimit(key: string): { allowed: boolean; remaining: number } {
|
||||
const now = Date.now();
|
||||
const entry = rateLimitMap.get(key);
|
||||
|
||||
if (!entry || now > entry.resetTime) {
|
||||
rateLimitMap.set(key, { count: 1, resetTime: now + RATE_LIMIT_WINDOW_MS });
|
||||
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - 1 };
|
||||
}
|
||||
|
||||
if (entry.count >= RATE_LIMIT_MAX_REQUESTS) {
|
||||
return { allowed: false, remaining: 0 };
|
||||
}
|
||||
|
||||
entry.count++;
|
||||
return { allowed: true, remaining: RATE_LIMIT_MAX_REQUESTS - entry.count };
|
||||
}
|
||||
|
||||
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
|
||||
|
||||
function isAllowedUrl(url: string): boolean {
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return false;
|
||||
|
||||
const hostname = parsed.hostname.toLowerCase();
|
||||
const bare = hostname.replace(/^\[|\]$/g, '');
|
||||
|
||||
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
|
||||
if (bare.startsWith('::ffff:')) return isAllowedUrl(`http://${bare.slice(7)}`);
|
||||
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
|
||||
if (bare.startsWith('10.') || bare.startsWith('192.168.')) return false;
|
||||
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
|
||||
if (bare.startsWith('169.254.')) return false;
|
||||
if (bare.startsWith('fe80:') || bare.startsWith('fc00:') || bare.startsWith('fd')) return false;
|
||||
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
|
||||
if (/^ff[0-9a-f]{2}:/.test(bare)) return false;
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
const GITHUB_URL_PATTERN = /^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/;
|
||||
const GITHUB_RAW_PATTERN = /^https?:\/\/raw\.githubusercontent\.com\//;
|
||||
const FETCH_TIMEOUT = 30_000;
|
||||
|
||||
const TECH_KEYWORDS = new Set([
|
||||
'react', 'vue', 'angular', 'svelte', 'nextjs', 'nuxt', 'remix',
|
||||
'typescript', 'javascript', 'python', 'rust', 'go', 'java', 'ruby',
|
||||
'node', 'deno', 'bun', 'docker', 'kubernetes', 'terraform',
|
||||
'aws', 'gcp', 'azure', 'vercel', 'netlify', 'cloudflare',
|
||||
'graphql', 'rest', 'grpc', 'websocket', 'redis', 'postgres',
|
||||
'mongodb', 'sqlite', 'mysql', 'prisma', 'drizzle',
|
||||
'tailwind', 'css', 'html', 'sass', 'webpack', 'vite', 'esbuild',
|
||||
'git', 'ci', 'cd', 'testing', 'security', 'authentication',
|
||||
'api', 'cli', 'sdk', 'mcp', 'llm', 'ai', 'ml', 'openai', 'anthropic',
|
||||
]);
|
||||
|
||||
const TAG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
||||
|
||||
const turndown = new TurndownService({ headingStyle: 'atx', codeBlockStyle: 'fenced' });
|
||||
|
||||
interface ExtractedContent {
|
||||
title: string;
|
||||
content: string;
|
||||
sourceUrl: string;
|
||||
contentType: string;
|
||||
language?: string;
|
||||
}
|
||||
|
||||
async function extractFromUrl(url: string): Promise<ExtractedContent> {
|
||||
if (GITHUB_URL_PATTERN.test(url) || GITHUB_RAW_PATTERN.test(url)) {
|
||||
return fetchGitHubContent(url);
|
||||
}
|
||||
|
||||
const MAX_BODY_SIZE = 5 * 1024 * 1024;
|
||||
const response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
|
||||
if (!response.ok) {
|
||||
throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
const contentLength = Number(response.headers.get('content-length') || '0');
|
||||
if (contentLength > MAX_BODY_SIZE) {
|
||||
throw new Error('Response too large');
|
||||
}
|
||||
|
||||
const contentType = response.headers.get('content-type') ?? '';
|
||||
const body = await response.text();
|
||||
if (body.length > MAX_BODY_SIZE) {
|
||||
throw new Error('Response too large');
|
||||
}
|
||||
|
||||
if (contentType.includes('text/html')) {
|
||||
const titleMatch = body.match(/<title[^>]*>([^<]+)<\/title>/i);
|
||||
const title = titleMatch?.[1]?.trim() ?? new URL(url).hostname;
|
||||
const bodyMatch = body.match(/<body[^>]*>([\s\S]*)<\/body>/i);
|
||||
const content = turndown.turndown(bodyMatch?.[1] ?? body);
|
||||
return { title, content, sourceUrl: url, contentType: 'webpage' };
|
||||
}
|
||||
|
||||
const title = new URL(url).pathname.split('/').pop() ?? 'Untitled';
|
||||
return { title, content: body, sourceUrl: url, contentType: 'text' };
|
||||
}
|
||||
|
||||
const LANG_MAP: Record<string, string> = {
|
||||
'.ts': 'typescript', '.tsx': 'typescript', '.js': 'javascript', '.jsx': 'javascript',
|
||||
'.py': 'python', '.rb': 'ruby', '.go': 'go', '.rs': 'rust', '.java': 'java',
|
||||
'.kt': 'kotlin', '.swift': 'swift', '.sh': 'shell', '.yml': 'yaml', '.yaml': 'yaml',
|
||||
'.json': 'json', '.md': 'markdown', '.html': 'html', '.css': 'css', '.sql': 'sql',
|
||||
};
|
||||
|
||||
async function fetchGitHubContent(url: string): Promise<ExtractedContent> {
|
||||
let rawUrl = url;
|
||||
const match = url.match(GITHUB_URL_PATTERN);
|
||||
if (match) {
|
||||
const [, owner, repo, branch, path] = match;
|
||||
rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
|
||||
}
|
||||
|
||||
const MAX_BODY_SIZE = 5 * 1024 * 1024;
|
||||
const response = await fetch(rawUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
|
||||
if (!response.ok) {
|
||||
throw new Error(`Failed to fetch GitHub content: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
const contentLength = Number(response.headers.get('content-length') || '0');
|
||||
if (contentLength > MAX_BODY_SIZE) {
|
||||
throw new Error('Response too large');
|
||||
}
|
||||
|
||||
const body = await response.text();
|
||||
if (body.length > MAX_BODY_SIZE) {
|
||||
throw new Error('Response too large');
|
||||
}
|
||||
const filename = rawUrl.split('/').pop() ?? 'file';
|
||||
const ext = filename.includes('.') ? '.' + filename.split('.').pop()!.toLowerCase() : '';
|
||||
const language = LANG_MAP[ext];
|
||||
const isCode = language !== undefined && language !== 'markdown';
|
||||
const content = isCode ? `\`\`\`${language}\n${body}\n\`\`\`` : body;
|
||||
|
||||
return { title: filename, content, sourceUrl: url, contentType: 'github', language };
|
||||
}
|
||||
|
||||
function addTag(counts: Map<string, number>, tag: string, weight: number): void {
|
||||
if (TAG_PATTERN.test(tag)) {
|
||||
counts.set(tag, (counts.get(tag) ?? 0) + weight);
|
||||
}
|
||||
}
|
||||
|
||||
function detectTags(extracted: ExtractedContent): string[] {
|
||||
const counts = new Map<string, number>();
|
||||
|
||||
try {
|
||||
const segments = new URL(extracted.sourceUrl).pathname
|
||||
.split('/').filter(Boolean)
|
||||
.map((s) => s.toLowerCase().replace(/[^a-z0-9-]/g, ''));
|
||||
for (const seg of segments) {
|
||||
if (seg.length >= 2 && seg.length <= 30) {
|
||||
addTag(counts, seg, 2);
|
||||
}
|
||||
}
|
||||
} catch { /* skip */ }
|
||||
|
||||
const headingRe = /^#{1,2}\s+(.+)$/gm;
|
||||
let m: RegExpExecArray | null;
|
||||
while ((m = headingRe.exec(extracted.content)) !== null) {
|
||||
for (const word of m[1].toLowerCase().split(/\s+/)) {
|
||||
const cleaned = word.replace(/[^a-z0-9-]/g, '');
|
||||
if (cleaned.length >= 2) {
|
||||
addTag(counts, cleaned, 2);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
const codeBlockRe = /^```(\w+)/gm;
|
||||
while ((m = codeBlockRe.exec(extracted.content)) !== null) {
|
||||
const lang = m[1].toLowerCase();
|
||||
if (lang.length >= 2) {
|
||||
addTag(counts, lang, 3);
|
||||
}
|
||||
}
|
||||
|
||||
const lower = extracted.content.toLowerCase();
|
||||
for (const keyword of TECH_KEYWORDS) {
|
||||
if (new RegExp(`\\b${keyword}\\b`, 'i').test(lower)) {
|
||||
addTag(counts, keyword, 1);
|
||||
}
|
||||
}
|
||||
|
||||
if (extracted.language) {
|
||||
addTag(counts, extracted.language.toLowerCase(), 3);
|
||||
}
|
||||
|
||||
return Array.from(counts.entries())
|
||||
.sort((a, b) => b[1] - a[1])
|
||||
.slice(0, 10)
|
||||
.map(([tag]) => tag);
|
||||
}
|
||||
|
||||
function slugify(input: string): string {
|
||||
const slug = input
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, '-')
|
||||
.replace(/^-+|-+$/g, '')
|
||||
.replace(/-{2,}/g, '-');
|
||||
return slug.slice(0, 64).replace(/-+$/, '') || 'untitled-skill';
|
||||
}
|
||||
|
||||
function yamlEscape(value: string): string {
|
||||
const singleLine = value.replace(/\r?\n/g, ' ').trim();
|
||||
if (/[:#{}[\],&*?|>!%@`]/.test(singleLine) || singleLine.startsWith("'") || singleLine.startsWith('"')) {
|
||||
return `"${singleLine.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
|
||||
}
|
||||
return singleLine;
|
||||
}
|
||||
|
||||
export async function POST(request: NextRequest) {
|
||||
const ip = request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ?? 'unknown';
|
||||
const { allowed, remaining } = checkRateLimit(ip);
|
||||
|
||||
if (!allowed) {
|
||||
return NextResponse.json(
|
||||
{ error: 'Too many requests. Try again in a minute.' },
|
||||
{ status: 429, headers: { 'X-RateLimit-Remaining': '0', 'Retry-After': '60' } },
|
||||
);
|
||||
}
|
||||
|
||||
let body: { url?: string; name?: string };
|
||||
try {
|
||||
body = await request.json();
|
||||
} catch {
|
||||
return NextResponse.json({ error: 'Invalid JSON body' }, { status: 400 });
|
||||
}
|
||||
|
||||
const { url, name } = body;
|
||||
if (!url || typeof url !== 'string') {
|
||||
return NextResponse.json({ error: 'Missing required field: url' }, { status: 400 });
|
||||
}
|
||||
|
||||
if (name !== undefined && typeof name !== 'string') {
|
||||
return NextResponse.json({ error: 'Field "name" must be a string' }, { status: 400 });
|
||||
}
|
||||
|
||||
if (!isAllowedUrl(url)) {
|
||||
return NextResponse.json({ error: 'URL not allowed' }, { status: 403 });
|
||||
}
|
||||
|
||||
try {
|
||||
const extracted = await extractFromUrl(url);
|
||||
const tags = detectTags(extracted);
|
||||
|
||||
const skillName = slugify(name || extracted.title || 'untitled');
|
||||
const description = extracted.content
|
||||
.split('\n')
|
||||
.find((l) => l.trim().length > 0)
|
||||
?.replace(/^#+\s*/, '')
|
||||
.trim()
|
||||
.slice(0, 200) || 'Saved skill';
|
||||
const savedAt = new Date().toISOString();
|
||||
|
||||
const yamlTags = tags.length > 0
|
||||
? `tags:\n${tags.map((t) => ` - ${t}`).join('\n')}\n`
|
||||
: '';
|
||||
|
||||
const skillMd =
|
||||
`---\n` +
|
||||
`name: ${skillName}\n` +
|
||||
`description: ${yamlEscape(description)}\n` +
|
||||
yamlTags +
|
||||
`metadata:\n` +
|
||||
` source: ${yamlEscape(url)}\n` +
|
||||
` savedAt: ${savedAt}\n` +
|
||||
`---\n\n` +
|
||||
extracted.content + '\n';
|
||||
|
||||
return NextResponse.json(
|
||||
{ name: skillName, skillMd, tags, description },
|
||||
{ headers: { 'X-RateLimit-Remaining': String(remaining) } },
|
||||
);
|
||||
} catch (err) {
|
||||
const message = err instanceof Error ? err.message : 'Failed to extract content';
|
||||
return NextResponse.json({ error: message }, { status: 502 });
|
||||
}
|
||||
}
|
||||
@@ -13,7 +13,7 @@ export const metadata: Metadata = {
|
||||
default: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
template: '%s | SkillKit',
|
||||
},
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.',
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.',
|
||||
icons: {
|
||||
icon: [
|
||||
{ url: '/favicon.svg', type: 'image/svg+xml' },
|
||||
@@ -24,7 +24,7 @@ export const metadata: Metadata = {
|
||||
openGraph: {
|
||||
title: 'SkillKit - Universal Skills for AI Coding Agents',
|
||||
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
|
||||
url: 'https://agenstskills.com',
|
||||
url: 'https://skillkit.sh',
|
||||
siteName: 'SkillKit',
|
||||
images: [{ url: '/og-image.png', width: 1200, height: 630 }],
|
||||
type: 'website',
|
||||
|
||||
@@ -18,7 +18,7 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{
|
||||
name: 'Discovery',
|
||||
commands: [
|
||||
{ cmd: 'find', desc: 'Search marketplace (15K+ skills)' },
|
||||
{ cmd: 'find', desc: 'Search marketplace (400K+ skills)' },
|
||||
{ cmd: 'recommend', desc: 'AI-powered suggestions' },
|
||||
{ cmd: 'check', desc: 'Dry-run update check' },
|
||||
{ cmd: 'list', desc: 'View installed skills' },
|
||||
@@ -33,6 +33,15 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'publish', desc: 'Submit to marketplace' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Security',
|
||||
commands: [
|
||||
{ cmd: 'scan <path>', desc: 'Security vulnerability scanner' },
|
||||
{ cmd: 'scan --format sarif', desc: 'SARIF for GitHub Code Scanning' },
|
||||
{ cmd: 'scan --fail-on high', desc: 'CI security gate' },
|
||||
{ cmd: 'audit log', desc: 'View audit trail' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
|
||||
@@ -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 32 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
</p>
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -102,7 +102,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
||||
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 32 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -130,7 +130,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 32 AI coding agents with automatic format translation:
|
||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
@@ -167,6 +167,18 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
['Trae', '.trae/skills/', 'SKILL.md'],
|
||||
['Vercel', '.vercel/skills/', 'SKILL.md'],
|
||||
['Zencoder', '.zencoder/skills/', 'SKILL.md'],
|
||||
['Devin', '.devin/skills/', 'SKILL.md'],
|
||||
['Aider', '.aider/skills/', 'SKILL.md'],
|
||||
['Sourcegraph Cody', '.cody/skills/', 'SKILL.md'],
|
||||
['Amazon Q', '.amazonq/skills/', 'SKILL.md'],
|
||||
['Augment Code', '.augment/skills/', 'SKILL.md'],
|
||||
['Replit Agent', '.replit/skills/', 'SKILL.md'],
|
||||
['Bolt', '.bolt/skills/', 'SKILL.md'],
|
||||
['Lovable', '.lovable/skills/', 'SKILL.md'],
|
||||
['Tabby', '.tabby/skills/', 'SKILL.md'],
|
||||
['Tabnine', '.tabnine/skills/', 'SKILL.md'],
|
||||
['CodeGPT', '.codegpt/skills/', 'SKILL.md'],
|
||||
['PlayCode Agent', '.playcode/skills/', 'SKILL.md'],
|
||||
['Universal', 'skills/', 'SKILL.md'],
|
||||
]}
|
||||
/>
|
||||
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Multi-Agent',
|
||||
description: 'Deploy to 32 AI coding agents with one command.',
|
||||
description: 'Deploy to 44 AI coding agents with one command.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
|
||||
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agents', '1', '32'],
|
||||
['Agents', '1', '44'],
|
||||
['Translation', 'Manual', 'Auto'],
|
||||
['Sharing', 'Copy/paste', '.skills manifest'],
|
||||
['Discovery', 'Forums', 'CLI + AI'],
|
||||
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
|
||||
</p>
|
||||
<div className="flex gap-6 sm:gap-8">
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
|
||||
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
|
||||
</p>
|
||||
<span className="hidden sm:inline text-zinc-700">•</span>
|
||||
<a
|
||||
href="https://agenstskills.com"
|
||||
href="https://skillkit.sh"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
|
||||
|
||||
@@ -135,7 +135,7 @@ export function Hero(): React.ReactElement {
|
||||
|
||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||
One CLI to install, sync, and manage skills across Claude Code, Cursor,
|
||||
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
|
||||
Windsurf, Copilot, and 40 more agents. 400K+ skills ready to use.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-3 mb-4">
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
{
|
||||
"$schema": "https://openapi.vercel.sh/vercel.json",
|
||||
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
|
||||
"buildCommand": "next build",
|
||||
"installCommand": "npm install",
|
||||
"outputDirectory": ".next",
|
||||
|
||||
+35
-22
@@ -1,4 +1,4 @@
|
||||
<svg width="1200" height="400" viewBox="0 0 1200 400" xmlns="http://www.w3.org/2000/svg">
|
||||
<svg width="1200" height="420" viewBox="0 0 1200 420" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#0a0a0a"/>
|
||||
@@ -10,48 +10,61 @@
|
||||
<stop offset="50%" style="stop-color:#555"/>
|
||||
<stop offset="100%" style="stop-color:#333"/>
|
||||
</linearGradient>
|
||||
<linearGradient id="accent" x1="0%" y1="0%" x2="100%" y2="0%">
|
||||
<stop offset="0%" style="stop-color:#666"/>
|
||||
<stop offset="100%" style="stop-color:#999"/>
|
||||
<linearGradient id="ph-badge" x1="0%" y1="0%" x2="0%" y2="100%">
|
||||
<stop offset="0%" style="stop-color:#2a2a2a"/>
|
||||
<stop offset="100%" style="stop-color:#1a1a1a"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
|
||||
<rect width="1200" height="400" fill="url(#bg)" rx="12"/>
|
||||
<rect x="1" y="1" width="1198" height="398" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
<rect width="1200" height="420" fill="url(#bg)" rx="12"/>
|
||||
<rect x="1" y="1" width="1198" height="418" fill="none" stroke="url(#border)" stroke-width="1" rx="12"/>
|
||||
|
||||
<line x1="60" y1="340" x2="1140" y2="340" stroke="#1a1a1a" stroke-width="1"/>
|
||||
<line x1="60" y1="350" x2="1140" y2="350" stroke="#1a1a1a" stroke-width="1"/>
|
||||
|
||||
<g transform="translate(60, 80)">
|
||||
<g transform="translate(60, 72)">
|
||||
<rect width="16" height="16" fill="white" rx="2"/>
|
||||
</g>
|
||||
|
||||
<text x="90" y="94" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
|
||||
<text x="90" y="86" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="20" font-weight="700" fill="white" letter-spacing="3">SKILLKIT</text>
|
||||
|
||||
<text x="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. 32 Agents.</text>
|
||||
<g transform="translate(890, 58)">
|
||||
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
|
||||
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
|
||||
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
|
||||
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
|
||||
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
||||
</g>
|
||||
|
||||
<text x="600" y="200" font-family="'SF Mono', 'Fira Code', 'JetBrains Mono', Consolas, monospace" font-size="62" font-weight="700" fill="white" text-anchor="middle" letter-spacing="-1">One Skill. 44 Agents.</text>
|
||||
|
||||
<text x="600" y="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(280, 280)">
|
||||
<rect width="280" height="40" fill="#1a1a1a" stroke="#333" stroke-width="1" rx="6"/>
|
||||
<text x="16" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#666">$</text>
|
||||
<text x="32" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#ccc">npx skillkit@latest</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(580, 280)">
|
||||
<rect width="160" height="40" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
||||
<text x="80" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">15,000+ 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(760, 280)">
|
||||
<rect width="160" height="40" fill="transparent" stroke="#444" stroke-width="1" rx="6"/>
|
||||
<text x="80" y="26" font-family="'SF Mono', 'Fira Code', monospace" font-size="14" fill="#999" text-anchor="middle">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(60, 355)">
|
||||
<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, 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 OpenCode +25 more</text>
|
||||
<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: 3.0 KiB After Width: | Height: | Size: 3.9 KiB |
+49
-81
@@ -5,14 +5,10 @@ import { Agents } from './components/Agents';
|
||||
import { Footer } from './components/Footer';
|
||||
import { SkillGenerator } from './components/SkillGenerator';
|
||||
import { SkillSubmitForm } from './components/SkillSubmitForm';
|
||||
import { Commands } from './components/Commands';
|
||||
import { StackBuilder } from './components/StackBuilder';
|
||||
import { TrendingSkills } from './components/TrendingSkills';
|
||||
import { Attribution } from './components/Attribution';
|
||||
import { AdvancedFeatures } from './components/AdvancedFeatures';
|
||||
import { UseCases } from './components/UseCases';
|
||||
import { TeamEnterprise } from './components/TeamEnterprise';
|
||||
import { BadgeGenerator } from './components/BadgeGenerator';
|
||||
import { CompatibilityMatrix } from './components/CompatibilityMatrix';
|
||||
import { useStats } from './hooks/useStats';
|
||||
|
||||
@@ -56,13 +52,6 @@ export default function App(): React.ReactElement {
|
||||
>
|
||||
Trending
|
||||
</a>
|
||||
<a
|
||||
href="#stack"
|
||||
onClick={(e) => scrollToSection(e, 'stack')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Stack
|
||||
</a>
|
||||
<a
|
||||
href="#matrix"
|
||||
onClick={(e) => scrollToSection(e, 'matrix')}
|
||||
@@ -70,13 +59,6 @@ export default function App(): React.ReactElement {
|
||||
>
|
||||
Matrix
|
||||
</a>
|
||||
<a
|
||||
href="#badge"
|
||||
onClick={(e) => scrollToSection(e, 'badge')}
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Badge
|
||||
</a>
|
||||
<a
|
||||
href="#advanced"
|
||||
onClick={(e) => scrollToSection(e, 'advanced')}
|
||||
@@ -100,18 +82,18 @@ export default function App(): React.ReactElement {
|
||||
</a>
|
||||
</div>
|
||||
<div className="flex items-center gap-3 sm:gap-4">
|
||||
<a
|
||||
href="/docs"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
|
||||
>
|
||||
Docs
|
||||
</a>
|
||||
<a
|
||||
href="/api"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
|
||||
>
|
||||
API
|
||||
</a>
|
||||
<a
|
||||
href="https://agenstskills.com/docs"
|
||||
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
|
||||
>
|
||||
Docs
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit"
|
||||
target="_blank"
|
||||
@@ -123,7 +105,7 @@ export default function App(): React.ReactElement {
|
||||
<svg className="w-3.5 h-3.5 text-zinc-500 group-hover:text-yellow-500 transition-colors" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
|
||||
</svg>
|
||||
<span className="text-xs font-mono text-zinc-400 group-hover:text-white transition-colors">{stats.stars}</span>
|
||||
<span className="text-xs font-mono text-zinc-400 group-hover:text-white transition-colors">{stats.stars || '—'}</span>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
@@ -131,7 +113,7 @@ export default function App(): React.ReactElement {
|
||||
</nav>
|
||||
|
||||
<main className="pt-14">
|
||||
<Hero version={stats.version} stars={stats.stars} />
|
||||
<Hero version={stats.version || '—'} stars={stats.stars || '—'} />
|
||||
|
||||
<div className="border-b border-zinc-800/50 py-2.5" style={{ background: 'linear-gradient(to bottom, rgba(9,9,11,0.95), rgba(0,0,0,1))' }}>
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
@@ -143,7 +125,7 @@ export default function App(): React.ReactElement {
|
||||
className="flex items-center gap-1.5 text-zinc-500 hover:text-white transition-colors group"
|
||||
>
|
||||
<span className="text-zinc-600 group-hover:text-zinc-400">v</span>
|
||||
<span className="text-white font-medium">{stats.version}</span>
|
||||
<span className="text-white font-medium">{stats.version || '—'}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800">·</span>
|
||||
<a
|
||||
@@ -155,7 +137,7 @@ export default function App(): React.ReactElement {
|
||||
<svg className="w-3 h-3 text-zinc-600 group-hover:text-zinc-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
|
||||
</svg>
|
||||
<span className="text-white font-medium">{stats.downloads}</span>
|
||||
<span className="text-white font-medium">{stats.downloads || '—'}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800">·</span>
|
||||
<a
|
||||
@@ -167,21 +149,7 @@ export default function App(): React.ReactElement {
|
||||
<svg className="w-3 h-3 text-zinc-600 group-hover:text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path d="M12 2l3.09 6.26L22 9.27l-5 4.87 1.18 6.88L12 17.77l-6.18 3.25L7 14.14 2 9.27l6.91-1.01L12 2z" />
|
||||
</svg>
|
||||
<span className="text-white font-medium">{stats.stars}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800 hidden sm:inline">·</span>
|
||||
<a
|
||||
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-skillkit-2"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="hidden sm:inline-flex items-center hover:opacity-80 transition-opacity"
|
||||
>
|
||||
<img
|
||||
src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1071813&theme=dark"
|
||||
alt="SkillKit on Product Hunt"
|
||||
height="28"
|
||||
style={{ height: '28px', width: 'auto' }}
|
||||
/>
|
||||
<span className="text-white font-medium">{stats.stars || '—'}</span>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
@@ -193,44 +161,6 @@ export default function App(): React.ReactElement {
|
||||
{/* Core Features & Comparison - Value prop at a glance */}
|
||||
<Features />
|
||||
|
||||
{/* Trending Skills - Social proof, what's popular */}
|
||||
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
|
||||
<TrendingSkills />
|
||||
</section>
|
||||
|
||||
{/* Stack Builder - Interactive, engaging */}
|
||||
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
|
||||
<StackBuilder />
|
||||
</section>
|
||||
|
||||
{/* Compatibility Matrix */}
|
||||
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
|
||||
<CompatibilityMatrix />
|
||||
</section>
|
||||
|
||||
{/* Badge Generator */}
|
||||
<section id="badge" style={{ scrollMarginTop: '4rem' }}>
|
||||
<BadgeGenerator />
|
||||
</section>
|
||||
|
||||
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
|
||||
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
|
||||
<AdvancedFeatures />
|
||||
</section>
|
||||
|
||||
{/* Commands Reference */}
|
||||
<Commands />
|
||||
|
||||
{/* Real-World Use Cases */}
|
||||
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
|
||||
<UseCases />
|
||||
</section>
|
||||
|
||||
{/* Team & Enterprise */}
|
||||
<section id="team" style={{ scrollMarginTop: '4rem' }}>
|
||||
<TeamEnterprise />
|
||||
</section>
|
||||
|
||||
{/* Skill Generator */}
|
||||
<section id="skills" className="py-12 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
|
||||
<SkillGenerator />
|
||||
@@ -249,6 +179,44 @@ export default function App(): React.ReactElement {
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{/* Trending Skills - Social proof, what's popular */}
|
||||
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
|
||||
<TrendingSkills />
|
||||
</section>
|
||||
|
||||
{/* Compatibility Matrix */}
|
||||
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
|
||||
<CompatibilityMatrix />
|
||||
</section>
|
||||
|
||||
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
|
||||
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
|
||||
<AdvancedFeatures />
|
||||
</section>
|
||||
|
||||
{/* Docs CTA */}
|
||||
<section className="py-8 border-b border-zinc-800">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 text-center">
|
||||
<p className="text-sm font-mono text-zinc-400">
|
||||
Explore all 50+ commands, team workflows, and integrations in the{' '}
|
||||
<a
|
||||
href="/docs"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-white underline underline-offset-4 hover:text-zinc-300 transition-colors"
|
||||
>
|
||||
documentation
|
||||
</a>
|
||||
.
|
||||
</p>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{/* Real-World Use Cases */}
|
||||
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
|
||||
<UseCases />
|
||||
</section>
|
||||
|
||||
{/* Attribution & Sources */}
|
||||
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
|
||||
<Attribution />
|
||||
|
||||
@@ -15,7 +15,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
id: 'generate',
|
||||
title: 'AI Generate',
|
||||
subtitle: 'Create Skills from Natural Language',
|
||||
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 15,000+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
|
||||
description: 'Generate skills from plain English with multi-source context. Pulls from documentation (Context7), your codebase patterns, 400K+ marketplace skills, and your corrections. Works with any LLM: Claude, GPT-4, Gemini, Ollama, or OpenRouter.',
|
||||
highlight: 'Multi-provider AI with 4 context sources',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
@@ -47,12 +47,30 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
{ cmd: 'memory --global', desc: 'Share across all projects' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'session',
|
||||
title: 'Session Intelligence',
|
||||
subtitle: 'Skill Lineage & Agent Handoffs',
|
||||
description: 'Track which skills produced which code changes. Generate handoff documents when switching agents. View unified timelines of all session events — skill executions, git commits, observations, and decisions in one stream.',
|
||||
highlight: 'Timeline, handoff, and lineage in one place',
|
||||
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="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z" />
|
||||
</svg>
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'timeline', desc: 'Unified event stream' },
|
||||
{ cmd: 'session handoff', desc: 'Agent-to-agent context' },
|
||||
{ cmd: 'lineage', desc: 'Skill impact graph' },
|
||||
{ cmd: 'lineage --skill code-simplifier', desc: 'Per-skill impact' },
|
||||
],
|
||||
},
|
||||
{
|
||||
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 32 agents.',
|
||||
highlight: 'Auto-generates instructions for 32 agents',
|
||||
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 44 agents.',
|
||||
highlight: 'Auto-generates instructions for 44 agents',
|
||||
icon: (
|
||||
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
|
||||
@@ -60,7 +78,7 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
|
||||
),
|
||||
commands: [
|
||||
{ cmd: 'primer', desc: 'Analyze & generate for detected agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 32 agents' },
|
||||
{ cmd: 'primer --all-agents', desc: 'Generate for all 44 agents' },
|
||||
{ cmd: 'primer --analyze-only', desc: 'Preview codebase analysis' },
|
||||
{ cmd: 'primer --json', desc: 'Machine-readable output' },
|
||||
],
|
||||
|
||||
@@ -293,6 +293,123 @@ const AGENTS: Agent[] = [
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Devin",
|
||||
url: "https://devin.ai",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M35 35h10c8.284 0 15 6.716 15 15s-6.716 15-15 15H35V35zm6 6v18h4c4.97 0 9-4.03 9-9s-4.03-9-9-9h-4z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Aider",
|
||||
url: "https://aider.chat",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33l-17 34h8l3-6h12l3 6h8L50 33zm0 12l4 10h-8l4-10z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Cody",
|
||||
url: "https://sourcegraph.com/cody",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm-7 21l-3-4 3-4 3 4-3 4zm7 5l-3-4 3-4 3 4-3 4zm7-5l-3-4 3-4 3 4-3 4z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Amazon Q",
|
||||
url: "https://aws.amazon.com/q",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17c3.144 0 6.09-.855 8.618-2.343l4.725 4.725 4.243-4.243-4.725-4.725A16.928 16.928 0 0067 50c0-9.389-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Augment",
|
||||
url: "https://augmentcode.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6v8h-8v6h8v8h6v-8h8v-6h-8v-8h-6z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Replit",
|
||||
url: "https://replit.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M40 33c-2.761 0-5 2.239-5 5v8h15c2.761 0 5 2.239 5 5s-2.239 5-5 5H35v8c0 2.761 2.239 5 5 5h20c2.761 0 5-2.239 5-5V38c0-2.761-2.239-5-5-5H40z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Bolt",
|
||||
url: "https://bolt.new",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M55 33H40l-5 20h10l-5 14 20-20H50l5-14z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Lovable",
|
||||
url: "https://lovable.dev",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 62l-12.728-12.728c-3.515-3.515-3.515-9.213 0-12.728 3.514-3.515 9.213-3.515 12.728 0 3.515-3.515 9.214-3.515 12.728 0 3.515 3.515 3.515 9.213 0 12.728L50 62z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Tabby",
|
||||
url: "https://tabby.tabbyml.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M35 45l5-12h6l-5 12h-6zm14 0l5-12h6l-5 12h-6zM33 48v17h34V48H33zm6 6h6v5h-6v-5zm10 0h6v5h-6v-5zm10 0h6v5h-6v-5z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Tabnine",
|
||||
url: "https://tabnine.com",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M38 35v6h9v24h6V41h9v-6H38z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "CodeGPT",
|
||||
url: "https://codegpt.co",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M42 40l-9 10 9 10 4-4-6-6 6-6-4-4zm16 0l-4 4 6 6-6 6 4 4 9-10-9-10z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "PlayCode",
|
||||
url: "https://playcode.io",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M38 33v34l28-17-28-17z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
name: "Universal",
|
||||
url: "https://github.com/rohitg00/skillkit",
|
||||
icon: (
|
||||
<svg viewBox="0 0 100 100" className="w-8 h-8" fill="currentColor">
|
||||
<path d="M50 33c-9.389 0-17 7.611-17 17s7.611 17 17 17 17-7.611 17-17-7.611-17-17-17zm0 6c6.075 0 11 4.925 11 11s-4.925 11-11 11-11-4.925-11-11 4.925-11 11-11zm0 4c-3.866 0-7 3.134-7 7s3.134 7 7 7 7-3.134 7-7-3.134-7-7-7z"/>
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
];
|
||||
|
||||
const SCROLL_ANIMATION_STYLES = `
|
||||
@@ -301,7 +418,7 @@ const SCROLL_ANIMATION_STYLES = `
|
||||
100% { transform: translateX(-50%); }
|
||||
}
|
||||
.animate-scroll {
|
||||
animation: scroll 35s linear infinite;
|
||||
animation: scroll 45s linear infinite;
|
||||
}
|
||||
`;
|
||||
|
||||
@@ -312,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 32 AI Agents
|
||||
Works with 44 AI Agents
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -1,34 +1,15 @@
|
||||
import React from 'react';
|
||||
import sourcesData from '../../../marketplace/sources.json';
|
||||
|
||||
const OFFICIAL_SOURCES = [
|
||||
{ repo: 'anthropics/skills', name: 'Anthropic' },
|
||||
{ repo: 'vercel-labs/agent-skills', name: 'Vercel' },
|
||||
{ repo: 'expo/skills', name: 'Expo' },
|
||||
{ repo: 'remotion-dev/skills', name: 'Remotion' },
|
||||
{ repo: 'supabase/agent-skills', name: 'Supabase' },
|
||||
{ repo: 'stripe/ai', name: 'Stripe' },
|
||||
];
|
||||
interface Source {
|
||||
source: string;
|
||||
name: string;
|
||||
official?: boolean;
|
||||
registry?: string;
|
||||
}
|
||||
|
||||
const COMMUNITY_SOURCES = [
|
||||
'trailofbits/skills',
|
||||
'obra/superpowers',
|
||||
'wshobson/agents',
|
||||
'ComposioHQ/awesome-claude-skills',
|
||||
'travisvn/awesome-claude-skills',
|
||||
'mhattingpete/claude-skills-marketplace',
|
||||
'langgenius/dify',
|
||||
'better-auth/skills',
|
||||
'onmax/nuxt-skills',
|
||||
'elysiajs/skills',
|
||||
'kadajett/agent-nestjs-skills',
|
||||
'cloudai-x/threejs-skills',
|
||||
'dimillian/skills',
|
||||
'waynesutton/convexskills',
|
||||
'kepano/obsidian-skills',
|
||||
'giuseppe-trisciuoglio/developer-kit',
|
||||
'openrouterteam/agent-skills',
|
||||
'intellectronica/agent-skills',
|
||||
];
|
||||
const OFFICIAL_SOURCES = (sourcesData.sources as Source[]).filter(s => s.official);
|
||||
const COMMUNITY_SOURCES = (sourcesData.sources as Source[]).filter(s => !s.official && s.source !== 'skills.sh');
|
||||
|
||||
export function Attribution(): React.ReactElement {
|
||||
return (
|
||||
@@ -37,19 +18,19 @@ export function Attribution(): React.ReactElement {
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Skill Sources</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Skills aggregated from open source repositories
|
||||
{sourcesData.sources.length} sources aggregated from open source repositories and registries
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Official
|
||||
Official ({OFFICIAL_SOURCES.length})
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-2">
|
||||
{OFFICIAL_SOURCES.map(source => (
|
||||
<a
|
||||
key={source.repo}
|
||||
href={`https://github.com/${source.repo}`}
|
||||
key={source.source}
|
||||
href={source.registry ? `https://${source.source}` : `https://github.com/${source.source}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-zinc-900 border border-zinc-800 px-3 py-2 hover:border-zinc-600 hover:text-white transition-colors text-zinc-400 font-mono text-xs"
|
||||
@@ -65,18 +46,18 @@ export function Attribution(): React.ReactElement {
|
||||
|
||||
<div className="mb-8">
|
||||
<div className="text-xs font-mono text-zinc-500 uppercase tracking-wider mb-4">
|
||||
Community
|
||||
Community ({COMMUNITY_SOURCES.length})
|
||||
</div>
|
||||
<div className="flex flex-wrap gap-1.5">
|
||||
{COMMUNITY_SOURCES.map(repo => (
|
||||
{COMMUNITY_SOURCES.map(source => (
|
||||
<a
|
||||
key={repo}
|
||||
href={`https://github.com/${repo}`}
|
||||
key={source.source}
|
||||
href={`https://github.com/${source.source}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-white transition-colors font-mono text-[11px] px-2 py-1 bg-zinc-900/50 border border-zinc-800/50 hover:border-zinc-700"
|
||||
>
|
||||
{repo}
|
||||
{source.source}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
|
||||
@@ -35,8 +35,8 @@ export function BadgeGenerator(): React.ReactElement {
|
||||
|
||||
const badgeUrl = useMemo(() => buildBadgeUrl(skills), [skills]);
|
||||
|
||||
const markdown = `[](https://agenstskills.com)`;
|
||||
const html = `<a href="https://agenstskills.com"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
|
||||
const markdown = `[](https://skillkit.sh)`;
|
||||
const html = `<a href="https://skillkit.sh"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
|
||||
|
||||
function addSkill(skill: string): void {
|
||||
const trimmed = skill.trim().toLowerCase();
|
||||
|
||||
@@ -82,6 +82,39 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'serve --cache-ttl 3600000', desc: 'Cache TTL' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Security',
|
||||
commands: [
|
||||
{ cmd: 'scan <path>', desc: 'Security scan' },
|
||||
{ cmd: 'scan --format sarif', desc: 'SARIF output' },
|
||||
{ cmd: 'scan --fail-on high', desc: 'CI gate' },
|
||||
{ cmd: 'install --no-scan', desc: 'Skip scan' },
|
||||
{ cmd: 'audit log', desc: 'View audit logs' },
|
||||
{ cmd: 'validate', desc: 'Validate format' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Issues',
|
||||
commands: [
|
||||
{ cmd: 'issue plan "#42"', desc: 'Plan from issue' },
|
||||
{ cmd: 'issue plan owner/repo#42', desc: 'Cross-repo plan' },
|
||||
{ cmd: 'issue plan "#42" --agent cursor', desc: 'Target agent' },
|
||||
{ cmd: 'issue plan "#42" --json', desc: 'JSON output' },
|
||||
{ cmd: 'issue list', desc: 'List open issues' },
|
||||
{ cmd: 'issue list --label bug', desc: 'Filter by label' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Session',
|
||||
commands: [
|
||||
{ cmd: 'timeline', desc: 'Unified event stream' },
|
||||
{ cmd: 'session handoff', desc: 'Agent handoff doc' },
|
||||
{ cmd: 'lineage', desc: 'Skill impact graph' },
|
||||
{ cmd: 'session explain', desc: 'Session summary' },
|
||||
{ cmd: 'activity', desc: 'Skill activity log' },
|
||||
{ cmd: 'session snapshot save', desc: 'Save state' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
|
||||
@@ -16,111 +16,155 @@ interface CategoryDef {
|
||||
}
|
||||
|
||||
const AGENTS: AgentDef[] = [
|
||||
{ id: 'claude-code', name: 'Claude Code', icon: '\u27C1', group: 'Tier 1' },
|
||||
{ id: 'claude-code', name: 'Claude', icon: '\u27C1', group: 'Tier 1' },
|
||||
{ id: 'cursor', name: 'Cursor', icon: '\u25EB', group: 'Tier 1' },
|
||||
{ id: 'codex', name: 'Codex', icon: '\u25CE', group: 'Tier 1' },
|
||||
{ id: 'gemini-cli', name: 'Gemini CLI', icon: '\u2726', group: 'Tier 1' },
|
||||
{ id: 'gemini-cli', name: 'Gemini', icon: '\u2726', group: 'Tier 1' },
|
||||
{ id: 'opencode', name: 'OpenCode', icon: '\u2B21', group: 'Tier 1' },
|
||||
{ id: 'windsurf', name: 'Windsurf', icon: '\u25C7', group: 'Tier 1' },
|
||||
{ id: 'github-copilot', name: 'Copilot', icon: '\u2318', group: 'Tier 1' },
|
||||
{ id: 'goose', name: 'Goose', icon: '\u25CA', group: 'Tier 2' },
|
||||
{ id: 'cline', name: 'Cline', icon: '\u25CF', group: 'Tier 1' },
|
||||
{ id: 'devin', name: 'Devin', icon: '\u25C9', group: 'Tier 1' },
|
||||
{ id: 'roo', name: 'Roo', icon: '\u25C6', group: 'Tier 2' },
|
||||
{ id: 'kilo', name: 'Kilo', icon: '\u25B3', group: 'Tier 2' },
|
||||
{ id: 'kiro-cli', name: 'Kiro CLI', icon: '\u25BD', group: 'Tier 2' },
|
||||
{ id: 'roo', name: 'Roo', icon: '\u25C6', group: 'Tier 2' },
|
||||
{ id: 'goose', name: 'Goose', icon: '\u25CA', group: 'Tier 2' },
|
||||
{ id: 'trae', name: 'Trae', icon: '\u25A0', group: 'Tier 2' },
|
||||
{ id: 'amp', name: 'AMP', icon: '\u26A1', group: 'Tier 2' },
|
||||
{ id: 'cline', name: 'Cline', icon: '\u25CF', group: 'Tier 3' },
|
||||
{ id: 'aider', name: 'Aider', icon: '\u25E6', group: 'Tier 2' },
|
||||
{ id: 'cody', name: 'Cody', icon: '\u25D0', group: 'Tier 2' },
|
||||
{ id: 'amazon-q', name: 'Amazon Q', icon: '\u25A3', group: 'Tier 2' },
|
||||
{ id: 'antigravity', name: 'Antigrav', icon: '\u2191', group: 'Tier 3' },
|
||||
{ id: 'continue', name: 'Continue', icon: '\u25B6', group: 'Tier 3' },
|
||||
{ id: 'antigravity', name: 'Antigravity', icon: '\u2191', group: 'Tier 3' },
|
||||
{ id: 'augment', name: 'Augment', icon: '\u25C8', group: 'Tier 3' },
|
||||
{ id: 'replit', name: 'Replit', icon: '\u25B7', group: 'Tier 3' },
|
||||
{ id: 'bolt', name: 'Bolt', icon: '\u2605', group: 'Tier 3' },
|
||||
{ id: 'lovable', name: 'Lovable', icon: '\u2665', group: 'Tier 3' },
|
||||
{ id: 'tabby', name: 'Tabby', icon: '\u25AB', group: 'Tier 3' },
|
||||
{ id: 'tabnine', name: 'Tabnine', icon: '\u25AA', group: 'Tier 3' },
|
||||
{ id: 'codegpt', name: 'CodeGPT', icon: '\u25E7', group: 'Tier 3' },
|
||||
{ id: 'playcode', name: 'PlayCode', icon: '\u25B9', group: 'Tier 3' },
|
||||
{ id: 'clawdbot', name: 'Clawdbot', icon: '\u25D1', group: 'Tier 3' },
|
||||
{ id: 'droid', name: 'Droid', icon: '\u25D2', group: 'Tier 3' },
|
||||
{ id: 'codebuddy', name: 'CodeBuddy', icon: '\u25D3', group: 'Tier 3' },
|
||||
{ id: 'commandcode', name: 'CmdCode', icon: '\u25D4', group: 'Tier 3' },
|
||||
{ id: 'crush', name: 'Crush', icon: '\u25D5', group: 'Tier 3' },
|
||||
{ id: 'factory', name: 'Factory', icon: '\u25D6', group: 'Tier 3' },
|
||||
{ id: 'mcpjam', name: 'MCPJam', icon: '\u25D7', group: 'Tier 3' },
|
||||
{ id: 'mux', name: 'Mux', icon: '\u25E0', group: 'Tier 3' },
|
||||
{ id: 'neovate', name: 'Neovate', icon: '\u25E1', group: 'Tier 3' },
|
||||
{ id: 'openhands', name: 'OpenHands', icon: '\u25E2', group: 'Tier 3' },
|
||||
{ id: 'pi', name: 'Pi', icon: '\u25E3', group: 'Tier 3' },
|
||||
{ id: 'qoder', name: 'Qoder', icon: '\u25E4', group: 'Tier 3' },
|
||||
{ id: 'qwen', name: 'Qwen', icon: '\u25E5', group: 'Tier 3' },
|
||||
{ id: 'vercel', name: 'Vercel', icon: '\u25B2', group: 'Tier 3' },
|
||||
{ id: 'zencoder', name: 'Zencoder', icon: '\u25E8', group: 'Tier 3' },
|
||||
{ id: 'universal', name: 'Universal', icon: '\u25CB', group: 'Tier 3' },
|
||||
];
|
||||
|
||||
const CATEGORIES: CategoryDef[] = [
|
||||
{ id: 'security', name: 'Security', icon: '\u25D0' },
|
||||
{ id: 'testing', name: 'Testing', icon: '\u25D2' },
|
||||
{ id: 'react-frontend', name: 'React/Frontend', icon: '\u269B' },
|
||||
{ id: 'backend', name: 'Backend', icon: '\u2393' },
|
||||
{ id: 'devops', name: 'DevOps', icon: '\u25D1' },
|
||||
{ id: 'python', name: 'Python', icon: '\u25C9' },
|
||||
{ id: 'go', name: 'Go', icon: '\u25C8' },
|
||||
{ id: 'typescript', name: 'TypeScript', icon: '\u25C8' },
|
||||
{ id: 'database', name: 'Database', icon: '\u25A3' },
|
||||
{ id: 'performance', name: 'Performance', icon: '\u25CE' },
|
||||
{ id: 'documentation', name: 'Documentation', icon: '\u25A1' },
|
||||
{ id: 'ai-ml', name: 'AI/ML', icon: '\u25CE' },
|
||||
{ id: 'translation', name: 'Skill Translation', icon: '\u21C4' },
|
||||
{ id: 'hooks', name: 'Hooks', icon: '\u2693' },
|
||||
{ id: 'mcp-tools', name: 'MCP & Tools', icon: '\u2699' },
|
||||
{ id: 'context', name: 'Context Window', icon: '\u25A3' },
|
||||
{ id: 'security', name: 'Security Skills', icon: '\u25D0' },
|
||||
{ id: 'testing', name: 'Testing Skills', icon: '\u25D2' },
|
||||
{ id: 'frontend', name: 'Frontend Skills', icon: '\u269B' },
|
||||
{ id: 'backend', name: 'Backend Skills', icon: '\u2393' },
|
||||
{ id: 'devops', name: 'DevOps Skills', icon: '\u25D1' },
|
||||
{ id: 'docs', name: 'Documentation', icon: '\u25A1' },
|
||||
];
|
||||
|
||||
// Based on actual SkillKit translator, agent constraints, and compatibility scoring:
|
||||
// - claude-code, cline, roo: MCP + Tools + Hooks + large context (full support)
|
||||
// - cursor: 32K context, no MCP/tools, hooks need manual adjustment
|
||||
// - gemini-cli: 128K context, no MCP/tools, JSON-in-markdown format
|
||||
// - opencode: 100K context, no MCP/tools, XML skills format
|
||||
// - codex, github-copilot: 8K context, no MCP/tools (content condensed)
|
||||
// - windsurf: 32K context, no MCP/tools, workflow YAML format
|
||||
// - kilo, kiro-cli: XML block format, multi-mode support, no MCP
|
||||
// - goose, amp, antigravity, trae, continue: varies, mostly universal adapter
|
||||
const T3_FULL: Record<string, Support> = {
|
||||
'augment': 'full', 'replit': 'full', 'bolt': 'full', 'lovable': 'full',
|
||||
'tabby': 'full', 'tabnine': 'full', 'codegpt': 'full', 'playcode': 'full',
|
||||
'clawdbot': 'full', 'droid': 'full', 'codebuddy': 'full', 'commandcode': 'full',
|
||||
'crush': 'full', 'factory': 'full', 'mcpjam': 'full', 'mux': 'full',
|
||||
'neovate': 'full', 'openhands': 'full', 'pi': 'full', 'qoder': 'full',
|
||||
'qwen': 'full', 'vercel': 'full', 'zencoder': 'full', 'universal': 'full',
|
||||
};
|
||||
const T3_PARTIAL: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'partial']));
|
||||
const T3_NONE: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'none']));
|
||||
|
||||
const MATRIX: Record<string, Record<string, Support>> = {
|
||||
'security': {
|
||||
'translation': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'partial', 'antigravity': 'partial',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
|
||||
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
|
||||
},
|
||||
'hooks': {
|
||||
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'partial',
|
||||
'opencode': 'partial', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
|
||||
'devin': 'partial', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
|
||||
'trae': 'partial', 'amp': 'partial', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
|
||||
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
|
||||
},
|
||||
'mcp-tools': {
|
||||
'claude-code': 'full', 'cursor': 'none', 'codex': 'none', 'gemini-cli': 'none',
|
||||
'opencode': 'none', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
|
||||
'devin': 'partial', 'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
|
||||
'trae': 'none', 'amp': 'none', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
|
||||
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
|
||||
},
|
||||
'context': {
|
||||
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
|
||||
'trae': 'partial', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'security': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'testing': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'react-frontend': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'none',
|
||||
'frontend': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'backend': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'devops': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'partial', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
|
||||
'trae': 'partial', 'amp': 'partial', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
|
||||
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
|
||||
},
|
||||
'python': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'partial',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'go': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'typescript': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'database': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'full', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'performance': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'partial', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
},
|
||||
'documentation': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'goose': 'full',
|
||||
'kilo': 'partial', 'kiro-cli': 'partial', 'roo': 'full', 'trae': 'full',
|
||||
'amp': 'full', 'cline': 'full', 'continue': 'full', 'antigravity': 'partial',
|
||||
},
|
||||
'ai-ml': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
|
||||
'opencode': 'partial', 'windsurf': 'partial', 'github-copilot': 'partial', 'goose': 'partial',
|
||||
'kilo': 'none', 'kiro-cli': 'none', 'roo': 'partial', 'trae': 'partial',
|
||||
'amp': 'partial', 'cline': 'partial', 'continue': 'partial', 'antigravity': 'none',
|
||||
'docs': {
|
||||
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
|
||||
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
|
||||
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
|
||||
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
|
||||
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
|
||||
},
|
||||
};
|
||||
|
||||
@@ -202,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 16 agents and 12 categories.
|
||||
Skill support across all 44 agents and {CATEGORIES.length} categories.
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2">
|
||||
|
||||
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 32 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
|
||||
</p>
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 32 agents</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</li>
|
||||
<li><span className="text-white">AI Instruction Generation (Primer)</span> - Analyze your codebase and generate customized instruction files for all 44 agents</li>
|
||||
<li><span className="text-white">Skill Discovery</span> - Browse 400K+ skills from registries with AI-powered recommendations</li>
|
||||
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
|
||||
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
|
||||
</ul>
|
||||
</div>
|
||||
@@ -101,7 +101,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
<ul className="list-disc list-inside space-y-2 text-zinc-400">
|
||||
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
|
||||
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 32 AI agents</li>
|
||||
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
|
||||
</ul>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
|
||||
@@ -129,7 +129,7 @@ skillkit install anthropics/skills`}</CodeBlock>
|
||||
content: (
|
||||
<div className="space-y-4">
|
||||
<p className="text-zinc-300">
|
||||
SkillKit supports 32 AI coding agents with automatic format translation:
|
||||
SkillKit supports 44 AI coding agents with automatic format translation:
|
||||
</p>
|
||||
|
||||
<Table
|
||||
@@ -206,13 +206,20 @@ 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 32 agents
|
||||
skillkit primer --all-agents # Generate for all 44 agents
|
||||
skillkit primer --agent claude-code,cursor # Specific agents only
|
||||
skillkit primer --analyze-only # Only show codebase analysis
|
||||
skillkit primer --dry-run # Preview without writing files
|
||||
skillkit primer --json # Output analysis as JSON
|
||||
skillkit primer --output ./dir # Custom output directory`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Session Intelligence</h3>
|
||||
<CodeBlock>{`skillkit timeline # Unified event stream
|
||||
skillkit session handoff # Agent-to-agent context
|
||||
skillkit lineage # Skill impact graph
|
||||
skillkit session explain # Session summary
|
||||
skillkit activity # Skill activity log`}</CodeBlock>
|
||||
|
||||
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
|
||||
<CodeBlock>{`skillkit ui # Launch Terminal UI
|
||||
skillkit workflow # Manage workflows
|
||||
|
||||
@@ -9,7 +9,7 @@ interface Feature {
|
||||
const FEATURES: Feature[] = [
|
||||
{
|
||||
title: 'Smart Recommendations',
|
||||
description: 'AI analyzes your codebase and recommends from 15,000+ skills.',
|
||||
description: 'AI analyzes your codebase and recommends from 400K+ skills.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" />
|
||||
@@ -18,7 +18,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Auto Translation',
|
||||
description: 'The npm for agent skills. Write once, auto-translate to 32 formats.',
|
||||
description: 'The npm for agent skills. Write once, auto-translate to 44 formats.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
|
||||
@@ -36,7 +36,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Primer',
|
||||
description: 'Auto-generate agent instructions for all 32 agents from your codebase.',
|
||||
description: 'Auto-generate agent instructions for all 44 agents from your codebase.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M13 10V3L4 14h7v7l9-11h-7z" />
|
||||
@@ -45,7 +45,7 @@ const FEATURES: Feature[] = [
|
||||
},
|
||||
{
|
||||
title: 'Skill Tree',
|
||||
description: 'Browse 15K+ skills in a hierarchical taxonomy with 12 categories.',
|
||||
description: 'Browse 400K+ skills in a hierarchical taxonomy with 12 categories.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M3 7v10a2 2 0 002 2h14a2 2 0 002-2V9a2 2 0 00-2-2h-6l-2-2H5a2 2 0 00-2 2z" />
|
||||
@@ -70,6 +70,15 @@ const FEATURES: Feature[] = [
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Security Scanner',
|
||||
description: 'Detect prompt injection, secrets, and malicious patterns in skills.',
|
||||
icon: (
|
||||
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
|
||||
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M9 12.75L11.25 15 15 9.75m-3-7.036A11.959 11.959 0 013.598 6 11.99 11.99 0 003 9.749c0 5.592 3.824 10.29 9 11.623 5.176-1.332 9-6.03 9-11.622 0-1.31-.21-2.571-.598-3.751h-.152c-3.196 0-6.1-1.248-8.25-3.285z" />
|
||||
</svg>
|
||||
)
|
||||
},
|
||||
{
|
||||
title: 'Testing',
|
||||
description: 'Built-in test framework with assertions.',
|
||||
@@ -100,36 +109,37 @@ const FEATURES: Feature[] = [
|
||||
];
|
||||
|
||||
const COMPARISONS = [
|
||||
['Agent Support', '1 agent', '32 agents'],
|
||||
['Setup', 'Write rules manually', 'Auto-generate (Primer)'],
|
||||
['Learning', 'Lost each session', 'Persistent memory'],
|
||||
['Translation', 'Rewrite for each', 'One-click conversion'],
|
||||
['Team Sharing', 'Copy/paste files', '.skills manifest'],
|
||||
['Discovery', 'Search forums', 'AI recommendations'],
|
||||
['Agent Support', '1-17 agents', '44 agents'],
|
||||
['Sources', 'Single registry', '34+ aggregated'],
|
||||
['Translation', 'None or limited', 'All 44 formats'],
|
||||
['Memory', 'None', 'Persistent learning'],
|
||||
['Security', 'None', '46-rule scanner'],
|
||||
['Team Sync', 'None', '.skills manifest'],
|
||||
['Telemetry', 'Varies', 'Zero. Ever.'],
|
||||
['API Access', 'None', 'REST + MCP + Python'],
|
||||
] as const;
|
||||
|
||||
export function Features(): React.ReactElement {
|
||||
return (
|
||||
<section id="features" className="py-12 border-b border-zinc-800 bg-surface">
|
||||
<section id="features" className="py-8 border-b border-zinc-800 bg-surface">
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-10">
|
||||
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-6">
|
||||
<div className="lg:col-span-2">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Why SkillKit?</h2>
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">At a Glance</h2>
|
||||
<p className="text-zinc-500 font-mono text-sm mb-6">
|
||||
Universal bridge for AI coding agents.
|
||||
What you get vs. a simple installer.
|
||||
</p>
|
||||
<div className="flex gap-6 sm:gap-8">
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">50+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">34+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Sources</div>
|
||||
</div>
|
||||
<div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K+</div>
|
||||
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">400K+</div>
|
||||
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Skills</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -137,8 +147,8 @@ export function Features(): React.ReactElement {
|
||||
|
||||
<div className="lg:col-span-3 border border-zinc-800 bg-black/50 p-4 font-mono text-xs backdrop-blur-sm">
|
||||
<div className="grid grid-cols-3 gap-2 border-b border-zinc-800 pb-2 mb-3 text-zinc-500 uppercase tracking-wider text-[10px]">
|
||||
<div>Feature</div>
|
||||
<div className="text-center">Without</div>
|
||||
<div>Capability</div>
|
||||
<div className="text-center">Simple Installers</div>
|
||||
<div className="text-right">SkillKit</div>
|
||||
</div>
|
||||
<div className="space-y-1">
|
||||
@@ -157,20 +167,20 @@ export function Features(): React.ReactElement {
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-2 sm:grid-cols-3 gap-3">
|
||||
<div className="grid grid-cols-3 sm:grid-cols-4 gap-2">
|
||||
{FEATURES.map((feature, index) => (
|
||||
<div
|
||||
key={feature.title}
|
||||
className="group relative p-4 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
|
||||
className="group relative p-2.5 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
|
||||
style={{ animationDelay: `${index * 50}ms` }}
|
||||
>
|
||||
<div className="absolute inset-0 bg-gradient-to-b from-zinc-800/0 to-zinc-800/20 opacity-0 group-hover:opacity-100 transition-opacity"></div>
|
||||
<div className="relative">
|
||||
<div className="text-zinc-500 group-hover:text-white transition-colors mb-2">
|
||||
<div className="text-zinc-500 group-hover:text-white transition-colors mb-1">
|
||||
{feature.icon}
|
||||
</div>
|
||||
<h4 className="text-xs font-bold text-white mb-1 font-mono">{feature.title}</h4>
|
||||
<p className="text-zinc-600 text-[10px] leading-relaxed font-mono group-hover:text-zinc-400 transition-colors">
|
||||
<h4 className="text-[11px] font-bold text-white mb-0.5 font-mono">{feature.title}</h4>
|
||||
<p className="text-zinc-600 text-[10px] leading-snug font-mono group-hover:text-zinc-400 transition-colors">
|
||||
{feature.description}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
|
||||
</p>
|
||||
<span className="hidden sm:inline text-zinc-700">•</span>
|
||||
<a
|
||||
href="https://agenstskills.com"
|
||||
href="https://skillkit.sh"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
|
||||
|
||||
@@ -20,16 +20,18 @@ interface TerminalLine {
|
||||
}
|
||||
|
||||
const TERMINAL_LINES: TerminalLine[] = [
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
|
||||
{ type: 'out', text: '→ Installed to 32 agents' },
|
||||
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
|
||||
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
|
||||
{ type: 'out', text: '→ Translated to 44 agent formats' },
|
||||
{ type: 'out', text: '→ Scanned: 0 issues found' },
|
||||
{ type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' },
|
||||
{ type: 'out', text: '→ Installed 12 skills from skills.sh' },
|
||||
{ type: 'cmd', text: 'skillkit translate --all --to cursor' },
|
||||
{ type: 'out', text: '→ 26 skills → .cursor/skills/' },
|
||||
{ type: 'cmd', text: 'skillkit recommend' },
|
||||
{ type: 'out', text: ' 92% vercel-react-best-practices' },
|
||||
{ type: 'out', text: ' 87% typescript-strict-mode' },
|
||||
{ type: 'cmd', text: 'skillkit serve' },
|
||||
{ type: 'out', text: '→ API server on http://0.0.0.0:3737' },
|
||||
{ type: 'out', text: ' GET /search · /trending · /categories' },
|
||||
{ type: 'cmd', text: 'curl localhost:3737/search?q=react' },
|
||||
{ type: 'out', text: ' {"skills":[...],"total":42}' },
|
||||
{ type: 'out', text: ' 92% react-best-practices (vercel)' },
|
||||
{ type: 'out', text: ' 87% strict-typescript (anthropic)' },
|
||||
{ type: 'out', text: ' 85% supabase-auth (supabase)' },
|
||||
];
|
||||
|
||||
const FADE_ANIMATION_STYLES = `
|
||||
@@ -107,10 +109,6 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
}
|
||||
}
|
||||
|
||||
function openGitHub(): void {
|
||||
window.open('https://github.com/rohitg00/skillkit', '_blank', 'noopener,noreferrer');
|
||||
}
|
||||
|
||||
const isTyping = visibleLines < TERMINAL_LINES.length && TERMINAL_LINES[visibleLines].type === 'cmd';
|
||||
const isComplete = visibleLines >= TERMINAL_LINES.length;
|
||||
|
||||
@@ -119,10 +117,22 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
<div className="absolute inset-0 bg-gradient-to-b from-zinc-900/50 to-transparent pointer-events-none"></div>
|
||||
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
|
||||
<div className="hidden lg:block mb-6 overflow-hidden">
|
||||
<pre className="text-zinc-600 text-[10px] leading-none font-mono select-none whitespace-pre" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
|
||||
<div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 mb-4 lg:mb-6">
|
||||
<pre className="hidden sm:block text-zinc-600 text-[6px] sm:text-[8px] lg:text-[10px] leading-none font-mono select-none whitespace-pre overflow-x-auto" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
|
||||
{ASCII_LOGO}
|
||||
</pre>
|
||||
<a
|
||||
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-skillkit-2"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 sm:gap-3 bg-zinc-900/80 border border-zinc-800 hover:border-zinc-600 transition-colors rounded-full px-3 sm:px-4 py-1.5 sm:py-2 group shrink-0 self-start"
|
||||
>
|
||||
<span className="flex items-center justify-center w-6 h-6 sm:w-8 sm:h-8 rounded-full border border-zinc-600 bg-transparent text-white font-bold text-xs sm:text-sm">P</span>
|
||||
<span className="flex flex-col">
|
||||
<span className="text-[8px] sm:text-[10px] font-semibold text-zinc-500 tracking-wider uppercase leading-tight">Product Hunt</span>
|
||||
<span className="text-[11px] sm:text-sm font-bold text-white group-hover:text-zinc-300 transition-colors leading-tight">#3 Product of the Day</span>
|
||||
</span>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
|
||||
@@ -133,14 +143,14 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
</div>
|
||||
|
||||
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
|
||||
One Skill.<br />
|
||||
<span className="text-zinc-500">32 Agents. Zero Rewrites.</span>
|
||||
One CLI. Every Source.<br />
|
||||
<span className="text-zinc-500">Every Agent. Zero Telemetry.</span>
|
||||
</h1>
|
||||
|
||||
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
|
||||
The open source package manager for AI agent skills. Install from 15,000+ skills,
|
||||
auto-translate between formats, persist learnings with Memory.
|
||||
Works with Claude, Cursor, Windsurf, Copilot, and 28 more.
|
||||
The open source package manager that aggregates 34+ skill sources,
|
||||
scans 400K+ skills from registries, auto-translates to 44 agent formats,
|
||||
and adds memory, security scanning, and team workflows. Everything runs locally.
|
||||
</p>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-2 mb-4">
|
||||
@@ -161,15 +171,30 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
)}
|
||||
</span>
|
||||
</button>
|
||||
<button
|
||||
onClick={openGitHub}
|
||||
className="inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-white text-black border border-zinc-300 px-3 py-2 hover:bg-zinc-200 transition-colors font-mono text-sm font-semibold"
|
||||
>
|
||||
<svg className="w-4 h-4" viewBox="0 0 24 24" fill="none">
|
||||
<circle cx="12" cy="12" r="10" fill="#09090b"/>
|
||||
<circle cx="12" cy="12" r="4.5" fill="white"/>
|
||||
<path d="M12 2v5.5M12 16.5V22M2 12h5.5M16.5 12H22" stroke="white" strokeWidth="1.5"/>
|
||||
</svg>
|
||||
Add to Chrome
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="sm:hidden inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
|
||||
>
|
||||
<svg className="w-4 h-4 text-zinc-400 group-hover:text-white transition-colors" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
|
||||
</svg>
|
||||
<span className="font-mono text-sm text-zinc-300 group-hover:text-white transition-colors">Star</span>
|
||||
{typeof stars === 'number' && (
|
||||
{typeof stars === 'number' && stars > 0 && (
|
||||
<>
|
||||
<span className="w-px h-4 bg-zinc-700"></span>
|
||||
<svg className="w-3.5 h-3.5 text-yellow-500" fill="currentColor" viewBox="0 0 24 24">
|
||||
@@ -178,7 +203,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
<span className="font-mono text-sm text-white font-medium">{stars}</span>
|
||||
</>
|
||||
)}
|
||||
</button>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ export function SkillGenerator(): React.ReactElement {
|
||||
<div className="text-center mb-8">
|
||||
<h2 className="text-xl font-bold text-white mb-2 font-mono">Find Skills</h2>
|
||||
<p className="text-zinc-500 font-mono text-xs">
|
||||
Search 15,000+ skills from the marketplace
|
||||
Search 400K+ skills across registries
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -92,7 +92,7 @@ export function TeamEnterprise(): React.ReactElement {
|
||||
</p>
|
||||
</div>
|
||||
<a
|
||||
href="https://agenstskills.com/docs/api-reference"
|
||||
href="https://skillkit.sh/docs/api-reference"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 px-3 sm:px-4 py-2 bg-zinc-800 text-white font-mono text-xs sm:text-sm hover:bg-zinc-700 transition-colors border border-zinc-700 whitespace-nowrap"
|
||||
@@ -108,7 +108,7 @@ export function TeamEnterprise(): React.ReactElement {
|
||||
{/* Bottom CTA */}
|
||||
<div className="mt-6 sm:mt-8 text-center">
|
||||
<a
|
||||
href="https://agenstskills.com/docs"
|
||||
href="https://skillkit.sh/docs"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 px-4 sm:px-6 py-2.5 sm:py-3 bg-white text-black font-mono text-xs sm:text-sm hover:bg-zinc-200 transition-colors cursor-pointer"
|
||||
|
||||
@@ -13,14 +13,14 @@ const CATEGORIES = [
|
||||
] as const;
|
||||
|
||||
const TRENDING_SKILLS = [
|
||||
'anthropics/skills/claude-code-guide',
|
||||
'anthropics/skills/claude-code-setup',
|
||||
'obra/superpowers/tdd',
|
||||
'vercel-labs/agent-skills/nextjs',
|
||||
'trailofbits/skills/security-review',
|
||||
'expo/skills/react-native',
|
||||
'remotion-dev/skills/video',
|
||||
'supabase/agent-skills/database',
|
||||
'anthropics/skills/frontend-design',
|
||||
'anthropics/skills/typescript-best-practices',
|
||||
'obra/superpowers/test-driven-development',
|
||||
'vercel-labs/agent-skills/vercel-react-best-practices',
|
||||
'trailofbits/skills/semgrep',
|
||||
'expo/skills/building-native-ui',
|
||||
'sickn33/antigravity-awesome-skills/senior-architect',
|
||||
'supabase/agent-skills/supabase-postgres-best-practices',
|
||||
];
|
||||
|
||||
function getTrendingSkills(): IndexedSkill[] {
|
||||
|
||||
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
|
||||
{
|
||||
persona: 'Multi-Agent Developer',
|
||||
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
|
||||
solution: 'SkillKit translates skills between all 32 agents. Write once, deploy everywhere.',
|
||||
solution: 'SkillKit translates skills between all 44 agents. Write once, deploy everywhere.',
|
||||
command: 'skillkit translate --to cursor,windsurf',
|
||||
gradient: 'from-violet-500/10 to-purple-500/10',
|
||||
icon: (
|
||||
|
||||
@@ -0,0 +1,159 @@
|
||||
import React from 'react';
|
||||
|
||||
interface Competitor {
|
||||
name: string;
|
||||
type: string;
|
||||
agents: string;
|
||||
translate: boolean;
|
||||
memory: boolean;
|
||||
security: boolean;
|
||||
team: boolean;
|
||||
tui: boolean;
|
||||
api: boolean;
|
||||
}
|
||||
|
||||
const COMPETITORS: Competitor[] = [
|
||||
{ name: 'Vercel skills', type: 'Installer', agents: '~17', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
||||
{ name: 'PRPM', type: 'Registry', agents: '~6', translate: true, memory: false, security: false, team: false, tui: false, api: false },
|
||||
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
|
||||
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
||||
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
|
||||
{ name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true },
|
||||
];
|
||||
|
||||
const SOURCES = [
|
||||
{ name: 'Anthropic', repo: 'anthropics/skills', official: true },
|
||||
{ name: 'Vercel', repo: 'vercel-labs/agent-skills', official: true },
|
||||
{ name: 'Expo', repo: 'expo/skills', official: true },
|
||||
{ name: 'Supabase', repo: 'supabase/agent-skills', official: true },
|
||||
{ name: 'Stripe', repo: 'stripe/ai', official: true },
|
||||
{ name: 'Remotion', repo: 'remotion-dev/skills', official: true },
|
||||
{ name: 'Trail of Bits', repo: 'trailofbits/skills', official: false },
|
||||
{ name: 'Better Auth', repo: 'better-auth/skills', official: false },
|
||||
{ name: 'ElysiaJS', repo: 'elysiajs/skills', official: false },
|
||||
{ name: 'Nuxt', repo: 'onmax/nuxt-skills', official: false },
|
||||
{ name: 'NestJS', repo: 'kadajett/agent-nestjs-skills', official: false },
|
||||
{ name: 'Three.js', repo: 'cloudai-x/threejs-skills', official: false },
|
||||
];
|
||||
|
||||
function Check(): React.ReactElement {
|
||||
return <span className="text-green-400 text-xs font-bold">✓</span>;
|
||||
}
|
||||
|
||||
function Cross(): React.ReactElement {
|
||||
return <span className="text-zinc-700 text-xs">—</span>;
|
||||
}
|
||||
|
||||
export function WhySkillKit(): React.ReactElement {
|
||||
return (
|
||||
<section id="why" className="py-12 sm:py-16 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
|
||||
<div className="text-center mb-8 sm:mb-12">
|
||||
<div className="inline-flex items-center gap-2 border border-zinc-700 bg-zinc-900/80 px-2 sm:px-3 py-1 mb-4 backdrop-blur-sm">
|
||||
<span className="w-1.5 h-1.5 bg-white rounded-full"></span>
|
||||
<span className="text-[10px] sm:text-xs font-mono text-zinc-300 uppercase tracking-wider">Not Another Installer</span>
|
||||
</div>
|
||||
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
|
||||
Others Install. SkillKit Orchestrates.
|
||||
</h2>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto">
|
||||
Most skill tools are simple installers with 3-5 commands.
|
||||
SkillKit is a full platform that aggregates every source, translates to every format,
|
||||
and adds memory, security, and team workflows on top.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="overflow-x-auto -mx-4 px-4 sm:mx-0 sm:px-0 mb-12">
|
||||
<div className="min-w-[640px]">
|
||||
<table className="w-full border-collapse font-mono text-[10px] sm:text-xs">
|
||||
<thead>
|
||||
<tr className="border-b border-zinc-800">
|
||||
<th className="text-left text-zinc-500 uppercase tracking-wider py-2 pr-3">Tool</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Agents</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Translate</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Memory</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Security</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Team</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">TUI</th>
|
||||
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">API</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{COMPETITORS.map((c) => {
|
||||
const isSkillKit = c.name === 'SkillKit';
|
||||
const rowClass = isSkillKit
|
||||
? 'bg-white/[0.03] border-b border-zinc-700'
|
||||
: 'border-b border-zinc-800/50 hover:bg-zinc-900/50';
|
||||
const nameClass = isSkillKit ? 'text-white font-bold' : 'text-zinc-400';
|
||||
return (
|
||||
<tr key={c.name} className={rowClass}>
|
||||
<td className="py-2.5 pr-3">
|
||||
<div className="flex items-center gap-2">
|
||||
<span className={nameClass}>{c.name}</span>
|
||||
<span className="text-zinc-700 text-[9px]">{c.type}</span>
|
||||
</div>
|
||||
</td>
|
||||
<td className={`px-2 py-2.5 text-center ${isSkillKit ? 'text-white font-bold' : 'text-zinc-500'}`}>{c.agents}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.translate ? <Check /> : <Cross />}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.memory ? <Check /> : <Cross />}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.security ? <Check /> : <Cross />}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.team ? <Check /> : <Cross />}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.tui ? <Check /> : <Cross />}</td>
|
||||
<td className="px-2 py-2.5 text-center">{c.api ? <Check /> : <Cross />}</td>
|
||||
</tr>
|
||||
);
|
||||
})}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="mb-8">
|
||||
<h3 className="text-lg font-bold text-white mb-2 font-mono">
|
||||
One CLI. Every Source. Zero Telemetry.
|
||||
</h3>
|
||||
<p className="text-zinc-400 font-mono text-xs sm:text-sm mb-6">
|
||||
SkillKit doesn't compete with skill sources — it aggregates them.
|
||||
Install from 34+ curated repositories, any GitHub/GitLab repo, or local paths.
|
||||
Everything runs locally. No accounts, no tracking, no lock-in.
|
||||
</p>
|
||||
|
||||
<div className="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 gap-2">
|
||||
{SOURCES.map((s) => (
|
||||
<a
|
||||
key={s.repo}
|
||||
href={`https://github.com/${s.repo}`}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="group flex items-center gap-2 px-3 py-2 border border-zinc-800 bg-zinc-900/30 hover:border-zinc-600 hover:bg-zinc-900/80 transition-all"
|
||||
>
|
||||
<span className="text-zinc-400 group-hover:text-white text-xs font-mono transition-colors">{s.name}</span>
|
||||
{s.official && (
|
||||
<span className="text-[8px] text-zinc-600 border border-zinc-800 px-1 py-0.5 uppercase tracking-wider">official</span>
|
||||
)}
|
||||
</a>
|
||||
))}
|
||||
<div className="flex items-center gap-2 px-3 py-2 border border-dashed border-zinc-800 text-zinc-600 text-xs font-mono">
|
||||
+ 22 more community sources
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 sm:grid-cols-3 gap-3">
|
||||
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
|
||||
<div className="text-2xl font-bold text-white font-mono mb-1">0 bytes</div>
|
||||
<div className="text-zinc-500 text-xs font-mono">telemetry collected</div>
|
||||
</div>
|
||||
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
|
||||
<div className="text-2xl font-bold text-white font-mono mb-1">Apache 2.0</div>
|
||||
<div className="text-zinc-500 text-xs font-mono">fully open source</div>
|
||||
</div>
|
||||
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
|
||||
<div className="text-2xl font-bold text-white font-mono mb-1">No account</div>
|
||||
<div className="text-zinc-500 text-xs font-mono">required to use</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -54,9 +54,9 @@ function setCachedStats(data: Omit<Stats, 'loading'>): void {
|
||||
|
||||
export function useStats(): Stats {
|
||||
const [stats, setStats] = useState<Stats>({
|
||||
version: '1.9.0',
|
||||
downloads: '2.4k',
|
||||
stars: 66,
|
||||
version: '',
|
||||
downloads: '',
|
||||
stars: 0,
|
||||
loading: true,
|
||||
});
|
||||
|
||||
@@ -74,9 +74,9 @@ export function useStats(): Stats {
|
||||
fetch('https://api.github.com/repos/rohitg00/skillkit'),
|
||||
]);
|
||||
|
||||
let downloads = '2.4k';
|
||||
let stars = 66;
|
||||
let version = '1.9.0';
|
||||
let downloads = '';
|
||||
let stars = 0;
|
||||
let version = '';
|
||||
|
||||
if (npmResponse.status === 'fulfilled' && npmResponse.value.ok) {
|
||||
const npmData = await npmResponse.value.json();
|
||||
|
||||
@@ -4,24 +4,24 @@
|
||||
<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 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
|
||||
<!-- Open Graph -->
|
||||
<meta property="og:type" content="website">
|
||||
<meta property="og:url" content="https://agenstskills.com/">
|
||||
<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 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta property="og:image" content="https://agenstskills.com/og-image.png">
|
||||
<meta property="og:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta property="og:image" content="https://skillkit.sh/og-image.png">
|
||||
<meta property="og:image:width" content="1200">
|
||||
<meta property="og:image:height" content="630">
|
||||
<meta property="og:site_name" content="SkillKit">
|
||||
|
||||
<!-- Twitter -->
|
||||
<meta name="twitter:card" content="summary_large_image">
|
||||
<meta name="twitter:url" content="https://agenstskills.com/">
|
||||
<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 32 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="twitter:image" content="https://agenstskills.com/og-image.png">
|
||||
<meta name="twitter:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
|
||||
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
|
||||
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
{
|
||||
"name": "SkillKit",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 32 agents.",
|
||||
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.",
|
||||
"requestFramePermissions": []
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.14.0",
|
||||
"version": "1.19.2",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>SkillKit API</title>
|
||||
<meta name="description" content="SkillKit REST API — discover and retrieve 15,000+ AI agent skills on demand">
|
||||
<meta name="description" content="SkillKit REST API — discover and retrieve 400K+ AI agent skills on demand">
|
||||
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
|
||||
<link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css">
|
||||
<style>
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
"info": {
|
||||
"title": "SkillKit",
|
||||
"version": "1.12.0",
|
||||
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\n15,000+ skills across 32 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 44 AI coding agents. Results ranked by a multi-signal scoring system (content 40pts, query match 30pts, popularity 15pts, references 15pts).\n\n## Quick Start\n\n```bash\nnpx skillkit serve\n```\n\nThe API is now running at http://localhost:3737\n\n## MCP Server\n\nFor agent-native discovery (Claude Desktop, Cursor):\n\n```json\n{\n \"mcpServers\": {\n \"skillkit\": { \"command\": \"npx\", \"args\": [\"@skillkit/mcp\"] }\n }\n}\n```\n\n## Python Client\n\n```bash\npip install skillkit-client\n```",
|
||||
"license": {
|
||||
"name": "Apache-2.0",
|
||||
"url": "https://opensource.org/licenses/Apache-2.0"
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Privacy Policy — SkillKit</title>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body { background: #09090b; color: #d4d4d8; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif; line-height: 1.7; }
|
||||
.container { max-width: 640px; margin: 0 auto; padding: 48px 24px; }
|
||||
h1 { color: #fafafa; font-size: 28px; font-weight: 700; margin-bottom: 8px; font-family: 'JetBrains Mono', monospace; }
|
||||
.updated { color: #71717a; font-size: 13px; margin-bottom: 32px; }
|
||||
h2 { color: #fafafa; font-size: 18px; font-weight: 600; margin-top: 32px; margin-bottom: 12px; }
|
||||
p { margin-bottom: 16px; font-size: 15px; }
|
||||
ul { margin-bottom: 16px; padding-left: 24px; }
|
||||
li { margin-bottom: 8px; font-size: 15px; }
|
||||
a { color: #fafafa; text-decoration: underline; text-underline-offset: 2px; }
|
||||
a:hover { color: #a1a1aa; }
|
||||
.back { display: inline-block; margin-bottom: 24px; color: #71717a; font-size: 13px; text-decoration: none; font-family: 'JetBrains Mono', monospace; }
|
||||
.back:hover { color: #fafafa; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<a href="/" class="back">← Back to SkillKit</a>
|
||||
<h1>Privacy Policy</h1>
|
||||
<p class="updated">Last updated: February 14, 2026</p>
|
||||
|
||||
<h2>Overview</h2>
|
||||
<p>SkillKit ("we", "our", "us") is an open-source CLI tool and Chrome extension for managing AI agent skills. We are committed to protecting your privacy. This policy explains what data we collect (or don't) across all SkillKit products.</p>
|
||||
|
||||
<h2>Chrome Extension — "SkillKit - Save as Skill"</h2>
|
||||
<p>The Chrome extension helps you save webpages as AI agent skill files.</p>
|
||||
<ul>
|
||||
<li><strong>What data is sent:</strong> When you click "Save as Skill", the extension sends the URL of the current page to our server at <code>https://skillkit.sh/api/save-skill</code>. This is required to fetch and convert the webpage content into a skill file.</li>
|
||||
<li><strong>What data is NOT sent:</strong> We do not send page content, browsing history, personal information, cookies, authentication tokens, or any data beyond the single URL you choose to save.</li>
|
||||
<li><strong>No data stored on server:</strong> The URL is processed in real time to extract content, generate tags, and build the skill file. No URLs, page content, or user data are stored, logged, or retained on the server after the response is returned.</li>
|
||||
<li><strong>Selection saves are local:</strong> When you save selected text via the right-click menu, the skill file is built entirely in the browser with no network requests.</li>
|
||||
<li><strong>No analytics or tracking:</strong> We do not use any analytics, telemetry, or tracking services.</li>
|
||||
<li><strong>No user accounts:</strong> No login, API key, or account is required.</li>
|
||||
<li><strong>Downloads:</strong> Generated skill files are saved to your local filesystem via the Chrome Downloads API. No files are uploaded anywhere.</li>
|
||||
</ul>
|
||||
|
||||
<h2>Permissions Used</h2>
|
||||
<ul>
|
||||
<li><strong>activeTab:</strong> Read the URL and title of the tab you are viewing when you click the extension. Only accessed when you actively use the extension.</li>
|
||||
<li><strong>contextMenus:</strong> Add "Save page as Skill" and "Save selection as Skill" to the right-click menu.</li>
|
||||
<li><strong>downloads:</strong> Save the generated SKILL.md file to your Downloads folder.</li>
|
||||
</ul>
|
||||
|
||||
<h2>CLI Tool</h2>
|
||||
<p>The SkillKit CLI runs entirely on your local machine. It does not phone home, collect telemetry, or transmit any data to external servers unless you explicitly use network features (e.g., <code>skillkit install</code> fetches public GitHub repositories).</p>
|
||||
|
||||
<h2>MCP Server</h2>
|
||||
<p>The SkillKit MCP server runs locally and provides skill discovery over the Model Context Protocol. It loads skill data from a bundled JSON file and does not make external network requests or collect user data.</p>
|
||||
|
||||
<h2>Website</h2>
|
||||
<p>The SkillKit website is available at <a href="https://skillkit.sh">skillkit.sh</a> and <a href="https://agenstskills.com">agenstskills.com</a>. It is a static site hosted on Vercel. We do not use cookies, analytics trackers, or collect personal information. Vercel may collect standard web server logs (IP address, user agent) as described in their <a href="https://vercel.com/legal/privacy-policy">privacy policy</a>.</p>
|
||||
|
||||
<h2>Third-Party Services</h2>
|
||||
<p>The Chrome extension communicates with <code>skillkit.sh</code> and <code>agenstskills.com</code> (both our own servers, hosted on Vercel) to process webpage URLs. No third-party data processors, advertising networks, or analytics services are used.</p>
|
||||
|
||||
<h2>Data Retention</h2>
|
||||
<p>We do not retain any user data. URLs sent to the API are processed in memory and discarded immediately after the response.</p>
|
||||
|
||||
<h2>Changes to This Policy</h2>
|
||||
<p>We may update this privacy policy from time to time. Changes will be posted on this page with an updated revision date.</p>
|
||||
|
||||
<h2>Contact</h2>
|
||||
<p>If you have questions about this privacy policy, contact us at <a href="mailto:ghumare64@gmail.com">ghumare64@gmail.com</a>.</p>
|
||||
|
||||
<h2>Open Source</h2>
|
||||
<p>SkillKit is open source under the Apache 2.0 license. You can review all source code at <a href="https://github.com/rohitg00/skillkit">github.com/rohitg00/skillkit</a>.</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Binary file not shown.
@@ -23,6 +23,7 @@
|
||||
"./*"
|
||||
]
|
||||
},
|
||||
"resolveJsonModule": true,
|
||||
"allowImportingTsExtensions": true,
|
||||
"noEmit": true
|
||||
}
|
||||
|
||||
@@ -1,4 +1,5 @@
|
||||
{
|
||||
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
|
||||
"buildCommand": "npm run build",
|
||||
"outputDirectory": "dist",
|
||||
"installCommand": "npm install",
|
||||
|
||||
@@ -44,7 +44,7 @@ describe('E2E: Onboarding UI', () => {
|
||||
expect(result.success).toBe(true);
|
||||
});
|
||||
|
||||
it('should display all 32 agents', async () => {
|
||||
it('should display all 44 agents', async () => {
|
||||
const result = await runCli(['init', '--list']);
|
||||
const output = result.stdout + result.stderr;
|
||||
|
||||
@@ -81,6 +81,18 @@ describe('E2E: Onboarding UI', () => {
|
||||
'Qwen',
|
||||
'Vercel',
|
||||
'Zencoder',
|
||||
'Devin',
|
||||
'Aider',
|
||||
'Cody',
|
||||
'Amazon Q',
|
||||
'Augment',
|
||||
'Replit',
|
||||
'Bolt',
|
||||
'Lovable',
|
||||
'Tabby',
|
||||
'Tabnine',
|
||||
'CodeGPT',
|
||||
'PlayCode',
|
||||
];
|
||||
|
||||
for (const agent of agents) {
|
||||
|
||||
@@ -28,7 +28,7 @@ import {
|
||||
type CrossAgentSkill,
|
||||
} from '@skillkit/core';
|
||||
|
||||
// All 32 supported agents
|
||||
// All 44 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -47,6 +47,33 @@ const SUPPORTED_AGENTS = [
|
||||
'trae',
|
||||
'windsurf',
|
||||
'universal',
|
||||
'cline',
|
||||
'codebuddy',
|
||||
'commandcode',
|
||||
'continue',
|
||||
'crush',
|
||||
'factory',
|
||||
'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',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translator - Parsing', () => {
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
* E2E Tests: Skill Translation Commands
|
||||
*
|
||||
* Tests for: translate, context, recommend
|
||||
* Validates translation to all 32 supported agents
|
||||
* Validates translation to all 44 supported agents
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
@@ -16,7 +16,7 @@ import {
|
||||
testFileExists,
|
||||
} from './helpers/cli-runner.js';
|
||||
|
||||
// All 32 supported agents
|
||||
// All 44 supported agents
|
||||
const SUPPORTED_AGENTS = [
|
||||
'claude-code',
|
||||
'cursor',
|
||||
@@ -50,6 +50,18 @@ const SUPPORTED_AGENTS = [
|
||||
'qwen',
|
||||
'vercel',
|
||||
'zencoder',
|
||||
'devin',
|
||||
'aider',
|
||||
'sourcegraph-cody',
|
||||
'amazon-q',
|
||||
'augment-code',
|
||||
'replit-agent',
|
||||
'bolt',
|
||||
'lovable',
|
||||
'tabby',
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
] as const;
|
||||
|
||||
describe('E2E: Skill Translation', () => {
|
||||
|
||||
+845
-175
File diff suppressed because it is too large
Load Diff
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"$schema": "./sources-schema.json",
|
||||
"version": 1,
|
||||
"updatedAt": "2026-01-26",
|
||||
"updatedAt": "2026-02-28",
|
||||
"description": "Curated skill repository sources - THE SINGLE SOURCE OF TRUTH",
|
||||
"sources": [
|
||||
{ "source": "anthropics/skills", "name": "Anthropic Official", "official": true },
|
||||
@@ -34,6 +34,9 @@
|
||||
{ "source": "jimliu/baoyu-skills", "name": "Baoyu Tools" },
|
||||
{ "source": "giuseppe-trisciuoglio/developer-kit", "name": "Shadcn / Radix" },
|
||||
{ "source": "openrouterteam/agent-skills", "name": "OpenRouter SDK" },
|
||||
{ "source": "intellectronica/agent-skills", "name": "Context7" }
|
||||
{ "source": "intellectronica/agent-skills", "name": "Context7" },
|
||||
{ "source": "muratcankoylan/Agent-Skills-for-Context-Engineering", "name": "Context Engineering" },
|
||||
{ "source": "sickn33/antigravity-awesome-skills", "name": "Antigravity Awesome Skills" },
|
||||
{ "source": "skills.sh", "name": "Skills.sh Leaderboard", "official": true, "registry": "skills-sh" }
|
||||
]
|
||||
}
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.16.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.16.0",
|
||||
"license": "Apache-2.0",
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.10.5",
|
||||
|
||||
+2
-2
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.14.0",
|
||||
"version": "1.20.0",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 44 coding agents",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "turbo run build",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.14.0",
|
||||
"version": "1.20.0",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,22 +1,62 @@
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { getAllAdapters, getAdapter, detectAgent } from '../index.js';
|
||||
import { AGENT_CONFIG, AgentType } from '@skillkit/core';
|
||||
|
||||
const GENERIC_AGENTS: AgentType[] = [
|
||||
'cline',
|
||||
'codebuddy',
|
||||
'commandcode',
|
||||
'continue',
|
||||
'crush',
|
||||
'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',
|
||||
];
|
||||
|
||||
const ALL_AGENTS = AgentType.options;
|
||||
|
||||
describe('Agent Adapters', () => {
|
||||
describe('getAllAdapters', () => {
|
||||
it('should return all registered adapters', () => {
|
||||
it('should return all 45 registered adapters', () => {
|
||||
const adapters = getAllAdapters();
|
||||
expect(adapters).toBeInstanceOf(Array);
|
||||
expect(adapters.length).toBeGreaterThan(0);
|
||||
expect(adapters.length).toBe(45);
|
||||
});
|
||||
|
||||
it('should include common agents', () => {
|
||||
const adapters = getAllAdapters();
|
||||
const types = adapters.map(a => a.type);
|
||||
|
||||
// Should include at least some well-known agents
|
||||
expect(types).toContain('claude-code');
|
||||
expect(types).toContain('cursor');
|
||||
});
|
||||
|
||||
it('should have an adapter for every AgentType', () => {
|
||||
const adapters = getAllAdapters();
|
||||
const types = new Set(adapters.map(a => a.type));
|
||||
|
||||
for (const agent of ALL_AGENTS) {
|
||||
expect(types.has(agent)).toBe(true);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('getAdapter', () => {
|
||||
@@ -33,6 +73,67 @@ describe('Agent Adapters', () => {
|
||||
});
|
||||
});
|
||||
|
||||
describe('GenericAgentAdapter correctness', () => {
|
||||
it.each(GENERIC_AGENTS)('%s adapter should have correct type', (agent) => {
|
||||
const adapter = getAdapter(agent);
|
||||
expect(adapter).toBeDefined();
|
||||
expect(adapter.type).toBe(agent);
|
||||
});
|
||||
|
||||
it.each(GENERIC_AGENTS)('%s adapter should use AGENT_CONFIG skillsDir', (agent) => {
|
||||
const adapter = getAdapter(agent);
|
||||
const config = AGENT_CONFIG[agent];
|
||||
expect(adapter.skillsDir).toBe(config.skillsDir);
|
||||
});
|
||||
|
||||
it.each(GENERIC_AGENTS)('%s adapter should use AGENT_CONFIG configFile', (agent) => {
|
||||
const adapter = getAdapter(agent);
|
||||
const config = AGENT_CONFIG[agent];
|
||||
expect(adapter.configFile).toBe(config.configFile);
|
||||
});
|
||||
|
||||
it.each(GENERIC_AGENTS)('%s adapter should not have universal name', (agent) => {
|
||||
const adapter = getAdapter(agent);
|
||||
expect(adapter.name).not.toBe('Universal (Any Agent)');
|
||||
});
|
||||
|
||||
it('devin adapter should have correct skillsDir', () => {
|
||||
const adapter = getAdapter('devin');
|
||||
expect(adapter.skillsDir).toBe('.devin/skills');
|
||||
});
|
||||
|
||||
it('sourcegraph-cody adapter should have correct skillsDir', () => {
|
||||
const adapter = getAdapter('sourcegraph-cody');
|
||||
expect(adapter.skillsDir).toBe('.cody/skills');
|
||||
});
|
||||
|
||||
it('amazon-q adapter should have correct skillsDir', () => {
|
||||
const adapter = getAdapter('amazon-q');
|
||||
expect(adapter.skillsDir).toBe('.amazonq/skills');
|
||||
});
|
||||
});
|
||||
|
||||
describe('AGENT_CONFIG completeness', () => {
|
||||
it('should have config for every AgentType', () => {
|
||||
for (const agent of ALL_AGENTS) {
|
||||
const config = AGENT_CONFIG[agent];
|
||||
expect(config).toBeDefined();
|
||||
expect(config.skillsDir).toBeTruthy();
|
||||
expect(config.configFile).toBeTruthy();
|
||||
expect(config.configFormat).toBeTruthy();
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('universal adapter stays universal', () => {
|
||||
it('should have type universal', () => {
|
||||
const adapter = getAdapter('universal');
|
||||
expect(adapter.type).toBe('universal');
|
||||
expect(adapter.skillsDir).toBe('skills');
|
||||
expect(adapter.name).toBe('Universal (Any Agent)');
|
||||
});
|
||||
});
|
||||
|
||||
describe('detectAgent', () => {
|
||||
it('should return an agent type', async () => {
|
||||
const agent = await detectAgent();
|
||||
|
||||
@@ -236,16 +236,6 @@ describe('ClawdbotAdapter', () => {
|
||||
});
|
||||
|
||||
describe('isDetected', () => {
|
||||
it('should detect Clawdbot from workspace skills directory', async () => {
|
||||
mockExistsSync.mockImplementation((path) => {
|
||||
return path === join(process.cwd(), 'skills');
|
||||
});
|
||||
|
||||
const detected = await adapter.isDetected();
|
||||
|
||||
expect(detected).toBe(true);
|
||||
});
|
||||
|
||||
it('should detect Clawdbot from global directory', async () => {
|
||||
mockExistsSync.mockImplementation((path) => {
|
||||
return path === join(homedir(), '.clawdbot');
|
||||
@@ -287,7 +277,6 @@ describe('ClawdbotAdapter', () => {
|
||||
|
||||
await adapter.isDetected();
|
||||
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'skills'));
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(homedir(), '.clawdbot'));
|
||||
expect(mockExistsSync).toHaveBeenCalledWith(join(process.cwd(), 'clawdbot.json'));
|
||||
});
|
||||
|
||||
@@ -10,9 +10,9 @@ const config = AGENT_CONFIG.clawdbot;
|
||||
|
||||
export class ClawdbotAdapter implements AgentAdapter {
|
||||
readonly type: AgentType = 'clawdbot';
|
||||
readonly name = 'Clawdbot';
|
||||
readonly skillsDir = config.skillsDir;
|
||||
readonly configFile = config.configFile;
|
||||
readonly name: string = 'Clawdbot';
|
||||
readonly skillsDir: string = config.skillsDir;
|
||||
readonly configFile: string = config.configFile;
|
||||
|
||||
generateConfig(skills: Skill[]): string {
|
||||
const enabledSkills = skills.filter(s => s.enabled);
|
||||
@@ -69,10 +69,9 @@ ${skillsXml}
|
||||
}
|
||||
|
||||
async isDetected(): Promise<boolean> {
|
||||
const projectSkills = join(process.cwd(), 'skills');
|
||||
const globalClawdbot = join(homedir(), '.clawdbot');
|
||||
const clawdbotConfig = join(process.cwd(), 'clawdbot.json');
|
||||
|
||||
return existsSync(projectSkills) || existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
||||
return existsSync(globalClawdbot) || existsSync(clawdbotConfig);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,144 @@
|
||||
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 AGENT_DISPLAY_NAMES: Partial<Record<AgentType, string>> = {
|
||||
'cline': 'Cline',
|
||||
'codebuddy': 'CodeBuddy',
|
||||
'commandcode': 'CommandCode',
|
||||
'continue': 'Continue',
|
||||
'crush': 'Crush',
|
||||
'mcpjam': 'MCPJam',
|
||||
'mux': 'Mux',
|
||||
'neovate': 'Neovate',
|
||||
'openhands': 'OpenHands',
|
||||
'pi': 'Pi',
|
||||
'qoder': 'Qoder',
|
||||
'qwen': 'Qwen',
|
||||
'vercel': 'Vercel',
|
||||
'zencoder': 'Zencoder',
|
||||
'devin': 'Devin',
|
||||
'aider': 'Aider',
|
||||
'sourcegraph-cody': 'Sourcegraph Cody',
|
||||
'amazon-q': 'Amazon Q Developer',
|
||||
'augment-code': 'Augment Code',
|
||||
'replit-agent': 'Replit Agent',
|
||||
'bolt': 'Bolt',
|
||||
'lovable': 'Lovable',
|
||||
'tabby': 'Tabby',
|
||||
'tabnine': 'Tabnine',
|
||||
'codegpt': 'CodeGPT',
|
||||
'playcode-agent': 'PlayCode Agent',
|
||||
};
|
||||
|
||||
export class GenericAgentAdapter implements AgentAdapter {
|
||||
readonly type: AgentType;
|
||||
readonly name: string;
|
||||
readonly skillsDir: string;
|
||||
readonly configFile: string;
|
||||
|
||||
constructor(agentType: AgentType) {
|
||||
const config = AGENT_CONFIG[agentType];
|
||||
this.type = agentType;
|
||||
this.name = AGENT_DISPLAY_NAMES[agentType] ?? agentType;
|
||||
this.skillsDir = config.skillsDir;
|
||||
this.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');
|
||||
const skillsList = enabledSkills
|
||||
.map(s => `- **${s.name}**: ${s.description}`)
|
||||
.join('\n');
|
||||
|
||||
return `# Skills System
|
||||
|
||||
<!-- SKILLKIT_SKILLS_START -->
|
||||
|
||||
## Available Skills
|
||||
|
||||
${skillsList}
|
||||
|
||||
## How to Use Skills
|
||||
|
||||
When a task matches one of the available skills, load it to get detailed instructions:
|
||||
|
||||
\`\`\`bash
|
||||
skillkit read <skill-name>
|
||||
\`\`\`
|
||||
|
||||
Or with npx:
|
||||
|
||||
\`\`\`bash
|
||||
npx skillkit read <skill-name>
|
||||
\`\`\`
|
||||
|
||||
## Skills Data
|
||||
|
||||
<skills_system>
|
||||
<usage>
|
||||
Skills provide specialized capabilities and domain knowledge.
|
||||
- Invoke: \`skillkit read <skill-name>\`
|
||||
- Base directory provided in output for resolving resources
|
||||
- Only use skills listed below
|
||||
- Each invocation is stateless
|
||||
</usage>
|
||||
|
||||
<available_skills>
|
||||
|
||||
${skillsXml}
|
||||
|
||||
</available_skills>
|
||||
</skills_system>
|
||||
|
||||
<!-- SKILLKIT_SKILLS_END -->
|
||||
`;
|
||||
}
|
||||
|
||||
parseConfig(content: string): string[] {
|
||||
const skillNames: string[] = [];
|
||||
|
||||
const skillRegex = /<name>([^<]+)<\/name>/g;
|
||||
let match;
|
||||
while ((match = skillRegex.exec(content)) !== null) {
|
||||
skillNames.push(match[1].trim());
|
||||
}
|
||||
|
||||
if (skillNames.length === 0) {
|
||||
const listRegex = /^- \*\*([a-z0-9-]+)\*\*:/gm;
|
||||
while ((match = listRegex.exec(content)) !== null) {
|
||||
skillNames.push(match[1].trim());
|
||||
}
|
||||
}
|
||||
|
||||
return skillNames;
|
||||
}
|
||||
|
||||
getInvokeCommand(skillName: string): string {
|
||||
return `skillkit read ${skillName}`;
|
||||
}
|
||||
|
||||
async isDetected(): Promise<boolean> {
|
||||
const agentDir = this.skillsDir.split('/')[0];
|
||||
const projectDir = join(process.cwd(), agentDir);
|
||||
const config = AGENT_CONFIG[this.type];
|
||||
|
||||
if (existsSync(projectDir)) return true;
|
||||
|
||||
if (config.globalSkillsDir) {
|
||||
const globalDir = config.globalSkillsDir.replace(/^~/, homedir());
|
||||
if (existsSync(globalDir)) return true;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@@ -8,6 +8,7 @@ import { OpenCodeAdapter } from './opencode.js';
|
||||
import { AntigravityAdapter } from './antigravity.js';
|
||||
import { AmpAdapter } from './amp.js';
|
||||
import { ClawdbotAdapter } from './clawdbot.js';
|
||||
import { OpenClawAdapter } from './openclaw.js';
|
||||
import { DroidAdapter } from './droid.js';
|
||||
import { FactoryAdapter } from './factory.js';
|
||||
import { GitHubCopilotAdapter } from './github-copilot.js';
|
||||
@@ -18,6 +19,7 @@ import { RooAdapter } from './roo.js';
|
||||
import { TraeAdapter } from './trae.js';
|
||||
import { WindsurfAdapter } from './windsurf.js';
|
||||
import { UniversalAdapter } from './universal.js';
|
||||
import { GenericAgentAdapter } from './generic.js';
|
||||
|
||||
export * from './base.js';
|
||||
export * from './claude-code.js';
|
||||
@@ -28,6 +30,7 @@ export * from './opencode.js';
|
||||
export * from './antigravity.js';
|
||||
export * from './amp.js';
|
||||
export * from './clawdbot.js';
|
||||
export * from './openclaw.js';
|
||||
export * from './droid.js';
|
||||
export * from './factory.js';
|
||||
export * from './github-copilot.js';
|
||||
@@ -38,6 +41,7 @@ export * from './roo.js';
|
||||
export * from './trae.js';
|
||||
export * from './windsurf.js';
|
||||
export * from './universal.js';
|
||||
export * from './generic.js';
|
||||
|
||||
// Agent features
|
||||
export * from './features/index.js';
|
||||
@@ -51,6 +55,7 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
||||
antigravity: new AntigravityAdapter(),
|
||||
amp: new AmpAdapter(),
|
||||
clawdbot: new ClawdbotAdapter(),
|
||||
openclaw: new OpenClawAdapter(),
|
||||
droid: new DroidAdapter(),
|
||||
'github-copilot': new GitHubCopilotAdapter(),
|
||||
goose: new GooseAdapter(),
|
||||
@@ -60,21 +65,33 @@ const adapters: Record<AgentType, AgentAdapter> = {
|
||||
trae: new TraeAdapter(),
|
||||
windsurf: new WindsurfAdapter(),
|
||||
universal: new UniversalAdapter(),
|
||||
cline: new UniversalAdapter(),
|
||||
codebuddy: new UniversalAdapter(),
|
||||
commandcode: new UniversalAdapter(),
|
||||
continue: new UniversalAdapter(),
|
||||
crush: new UniversalAdapter(),
|
||||
factory: new FactoryAdapter(),
|
||||
mcpjam: new UniversalAdapter(),
|
||||
mux: new UniversalAdapter(),
|
||||
neovate: new UniversalAdapter(),
|
||||
openhands: new UniversalAdapter(),
|
||||
pi: new UniversalAdapter(),
|
||||
qoder: new UniversalAdapter(),
|
||||
qwen: new UniversalAdapter(),
|
||||
vercel: new UniversalAdapter(),
|
||||
zencoder: new UniversalAdapter(),
|
||||
cline: new GenericAgentAdapter('cline'),
|
||||
codebuddy: new GenericAgentAdapter('codebuddy'),
|
||||
commandcode: new GenericAgentAdapter('commandcode'),
|
||||
continue: new GenericAgentAdapter('continue'),
|
||||
crush: new GenericAgentAdapter('crush'),
|
||||
mcpjam: new GenericAgentAdapter('mcpjam'),
|
||||
mux: new GenericAgentAdapter('mux'),
|
||||
neovate: new GenericAgentAdapter('neovate'),
|
||||
openhands: new GenericAgentAdapter('openhands'),
|
||||
pi: new GenericAgentAdapter('pi'),
|
||||
qoder: new GenericAgentAdapter('qoder'),
|
||||
qwen: new GenericAgentAdapter('qwen'),
|
||||
vercel: new GenericAgentAdapter('vercel'),
|
||||
zencoder: new GenericAgentAdapter('zencoder'),
|
||||
devin: new GenericAgentAdapter('devin'),
|
||||
aider: new GenericAgentAdapter('aider'),
|
||||
'sourcegraph-cody': new GenericAgentAdapter('sourcegraph-cody'),
|
||||
'amazon-q': new GenericAgentAdapter('amazon-q'),
|
||||
'augment-code': new GenericAgentAdapter('augment-code'),
|
||||
'replit-agent': new GenericAgentAdapter('replit-agent'),
|
||||
bolt: new GenericAgentAdapter('bolt'),
|
||||
lovable: new GenericAgentAdapter('lovable'),
|
||||
tabby: new GenericAgentAdapter('tabby'),
|
||||
tabnine: new GenericAgentAdapter('tabnine'),
|
||||
codegpt: new GenericAgentAdapter('codegpt'),
|
||||
'playcode-agent': new GenericAgentAdapter('playcode-agent'),
|
||||
};
|
||||
|
||||
export function getAdapter(type: AgentType): AgentAdapter {
|
||||
@@ -93,6 +110,10 @@ export function getAllAdapters(): AgentAdapterWithType[] {
|
||||
}));
|
||||
}
|
||||
|
||||
export function getAdapterCount(): number {
|
||||
return Object.keys(adapters).length;
|
||||
}
|
||||
|
||||
export async function detectAgent(): Promise<AgentType> {
|
||||
const checkOrder: AgentType[] = [
|
||||
'claude-code',
|
||||
@@ -102,6 +123,7 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'opencode',
|
||||
'antigravity',
|
||||
'amp',
|
||||
'openclaw',
|
||||
'clawdbot',
|
||||
'droid',
|
||||
'github-copilot',
|
||||
@@ -126,6 +148,18 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
'qwen',
|
||||
'vercel',
|
||||
'zencoder',
|
||||
'devin',
|
||||
'aider',
|
||||
'sourcegraph-cody',
|
||||
'amazon-q',
|
||||
'augment-code',
|
||||
'replit-agent',
|
||||
'bolt',
|
||||
'lovable',
|
||||
'tabby',
|
||||
'tabnine',
|
||||
'codegpt',
|
||||
'playcode-agent',
|
||||
'universal',
|
||||
];
|
||||
|
||||
@@ -138,6 +172,3 @@ export async function detectAgent(): Promise<AgentType> {
|
||||
|
||||
return 'universal';
|
||||
}
|
||||
|
||||
// getSkillsDir and getConfigFile are now re-exported from @skillkit/core above
|
||||
// This ensures a single source of truth for agent configurations
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
import { existsSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import { ClawdbotAdapter } from './clawdbot.js';
|
||||
import type { AgentType } from '@skillkit/core';
|
||||
import { AGENT_CONFIG } from '@skillkit/core';
|
||||
|
||||
const config = AGENT_CONFIG.openclaw;
|
||||
|
||||
export class OpenClawAdapter extends ClawdbotAdapter {
|
||||
override readonly type: AgentType = 'openclaw';
|
||||
override readonly name = 'OpenClaw';
|
||||
override readonly skillsDir = config.skillsDir;
|
||||
override readonly configFile = config.configFile;
|
||||
|
||||
override async isDetected(): Promise<boolean> {
|
||||
const globalOpenClaw = join(homedir(), '.openclaw');
|
||||
const openclawConfig = join(process.cwd(), 'openclaw.json');
|
||||
|
||||
return existsSync(globalOpenClaw) || existsSync(openclawConfig);
|
||||
}
|
||||
}
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/api",
|
||||
"version": "1.14.0",
|
||||
"version": "1.20.0",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import type { Context, Next } from 'hono';
|
||||
import type { Context, Next } from "hono";
|
||||
|
||||
interface RateLimitEntry {
|
||||
count: number;
|
||||
@@ -18,8 +18,12 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
|
||||
}, windowMs).unref();
|
||||
|
||||
return async (c: Context, next: Next): Promise<Response | void> => {
|
||||
const forwardedFor = c.req.header('x-forwarded-for');
|
||||
const ip = (forwardedFor?.split(',')[0]?.trim()) || c.req.header('x-real-ip') || 'unknown';
|
||||
const xRealIp = c.req.header("x-real-ip");
|
||||
const forwarded = c.req.header("x-forwarded-for");
|
||||
const forwardedIp = forwarded
|
||||
? forwarded.split(",").at(-1)?.trim()
|
||||
: undefined;
|
||||
const ip = xRealIp || forwardedIp || "unknown";
|
||||
const now = Date.now();
|
||||
|
||||
let entry = windows.get(ip);
|
||||
@@ -30,12 +34,21 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
|
||||
|
||||
entry.count++;
|
||||
|
||||
c.header('X-RateLimit-Limit', String(maxRequests));
|
||||
c.header('X-RateLimit-Remaining', String(Math.max(0, maxRequests - entry.count)));
|
||||
c.header('X-RateLimit-Reset', String(Math.ceil(entry.resetAt / 1000)));
|
||||
c.header("X-RateLimit-Limit", String(maxRequests));
|
||||
c.header(
|
||||
"X-RateLimit-Remaining",
|
||||
String(Math.max(0, maxRequests - entry.count)),
|
||||
);
|
||||
c.header("X-RateLimit-Reset", String(Math.ceil(entry.resetAt / 1000)));
|
||||
|
||||
if (entry.count > maxRequests) {
|
||||
return c.json({ error: 'Too many requests', retryAfter: Math.ceil((entry.resetAt - now) / 1000) }, 429);
|
||||
return c.json(
|
||||
{
|
||||
error: "Too many requests",
|
||||
retryAfter: Math.ceil((entry.resetAt - now) / 1000),
|
||||
},
|
||||
429,
|
||||
);
|
||||
}
|
||||
|
||||
await next();
|
||||
|
||||
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
|
||||
info: {
|
||||
title: 'SkillKit',
|
||||
version: '1.12.0',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ skills across 32 agents).',
|
||||
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (400K+ skills across 44 agents).',
|
||||
license: { name: 'Apache-2.0', url: 'https://opensource.org/licenses/Apache-2.0' },
|
||||
contact: { name: 'SkillKit', url: 'https://github.com/rohitg00/skillkit' },
|
||||
},
|
||||
|
||||
@@ -0,0 +1,126 @@
|
||||
import { Hono } from "hono";
|
||||
import { ContentExtractor, SkillGenerator, AutoTagger } from "@skillkit/core";
|
||||
|
||||
interface SaveRequest {
|
||||
url?: string;
|
||||
text?: string;
|
||||
name?: string;
|
||||
global?: boolean;
|
||||
}
|
||||
|
||||
const MAX_TEXT_LENGTH = 500_000;
|
||||
|
||||
const BLOCKED_HOSTS = new Set([
|
||||
"localhost",
|
||||
"127.0.0.1",
|
||||
"[::1]",
|
||||
"::1",
|
||||
"0.0.0.0",
|
||||
]);
|
||||
|
||||
function isAllowedUrl(url: string): boolean {
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
|
||||
return false;
|
||||
|
||||
const hostname = parsed.hostname.toLowerCase();
|
||||
const bare = hostname.replace(/^\[|\]$/g, "");
|
||||
|
||||
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
|
||||
if (bare.startsWith("::ffff:"))
|
||||
return isAllowedUrl(`http://${bare.slice(7)}`);
|
||||
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
|
||||
if (bare.startsWith("10.") || bare.startsWith("192.168.")) return false;
|
||||
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
|
||||
if (bare.startsWith("169.254.")) return false;
|
||||
if (bare.includes(":")) {
|
||||
if (
|
||||
bare.startsWith("fe80:") ||
|
||||
bare.startsWith("fc") ||
|
||||
bare.startsWith("fd")
|
||||
)
|
||||
return false;
|
||||
if (bare.startsWith("ff")) return false;
|
||||
}
|
||||
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function saveRoutes() {
|
||||
const app = new Hono();
|
||||
const extractor = new ContentExtractor();
|
||||
const generator = new SkillGenerator();
|
||||
const tagger = new AutoTagger();
|
||||
|
||||
app.post("/save", async (c) => {
|
||||
let body: SaveRequest;
|
||||
try {
|
||||
body = await c.req.json();
|
||||
} catch {
|
||||
return c.json({ error: "Invalid JSON body" }, 400);
|
||||
}
|
||||
|
||||
if (!body.url && !body.text) {
|
||||
return c.json({ error: 'Either "url" or "text" is required' }, 400);
|
||||
}
|
||||
|
||||
if (body.url && !isAllowedUrl(body.url)) {
|
||||
return c.json({ error: "URL must be a public HTTP(S) address" }, 400);
|
||||
}
|
||||
|
||||
if (body.name && !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(body.name)) {
|
||||
return c.json(
|
||||
{
|
||||
error:
|
||||
"Name must be alphanumeric (hyphens, underscores, dots allowed)",
|
||||
},
|
||||
400,
|
||||
);
|
||||
}
|
||||
|
||||
if (body.text && body.text.length > MAX_TEXT_LENGTH) {
|
||||
return c.json(
|
||||
{
|
||||
error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters`,
|
||||
},
|
||||
400,
|
||||
);
|
||||
}
|
||||
|
||||
try {
|
||||
const content = body.url
|
||||
? await extractor.extractFromUrl(body.url)
|
||||
: extractor.extractFromText(body.text!);
|
||||
|
||||
const result = generator.generate(content, {
|
||||
name: body.name,
|
||||
global: body.global ?? true,
|
||||
});
|
||||
|
||||
return c.json({
|
||||
name: result.name,
|
||||
skillPath: result.skillPath,
|
||||
skillMd: result.skillMd,
|
||||
tags: tagger.detectTags(content),
|
||||
});
|
||||
} catch (err) {
|
||||
console.error("Save extraction failed:", err);
|
||||
const isTimeout =
|
||||
(err instanceof DOMException && err.name === "TimeoutError") ||
|
||||
(err instanceof Error &&
|
||||
(err.name === "TimeoutError" || err.name === "AbortError"));
|
||||
|
||||
if (isTimeout) {
|
||||
return c.json({ error: "Fetch timed out" }, 504);
|
||||
}
|
||||
|
||||
return c.json({ error: "Extraction failed" }, 422);
|
||||
}
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
+33
-21
@@ -1,14 +1,15 @@
|
||||
import { Hono } from 'hono';
|
||||
import { cors } from 'hono/cors';
|
||||
import { MemoryCache } from '@skillkit/core';
|
||||
import { rateLimiter } from './middleware/rate-limit.js';
|
||||
import { healthRoutes } from './routes/health.js';
|
||||
import { searchRoutes } from './routes/search.js';
|
||||
import { skillRoutes } from './routes/skills.js';
|
||||
import { trendingRoutes } from './routes/trending.js';
|
||||
import { categoryRoutes } from './routes/categories.js';
|
||||
import { docsRoutes } from './routes/docs.js';
|
||||
import type { ApiSkill, SearchResponse } from './types.js';
|
||||
import { Hono } from "hono";
|
||||
import { cors } from "hono/cors";
|
||||
import { MemoryCache } from "@skillkit/core";
|
||||
import { rateLimiter } from "./middleware/rate-limit.js";
|
||||
import { healthRoutes } from "./routes/health.js";
|
||||
import { searchRoutes } from "./routes/search.js";
|
||||
import { skillRoutes } from "./routes/skills.js";
|
||||
import { trendingRoutes } from "./routes/trending.js";
|
||||
import { categoryRoutes } from "./routes/categories.js";
|
||||
import { docsRoutes } from "./routes/docs.js";
|
||||
import { saveRoutes } from "./routes/save.js";
|
||||
import type { ApiSkill, SearchResponse } from "./types.js";
|
||||
|
||||
export interface ServerOptions {
|
||||
port?: number;
|
||||
@@ -28,25 +29,36 @@ export function createApp(options: ServerOptions = {}) {
|
||||
|
||||
const app = new Hono();
|
||||
|
||||
app.use('*', cors({ origin: options.corsOrigin || '*' }));
|
||||
app.use('*', rateLimiter(options.rateLimitMax ?? 60));
|
||||
app.use("*", cors({ origin: options.corsOrigin || "*" }));
|
||||
app.use("*", async (c, next) => {
|
||||
await next();
|
||||
c.header("X-Content-Type-Options", "nosniff");
|
||||
c.header("X-Frame-Options", "DENY");
|
||||
c.header(
|
||||
"Content-Security-Policy",
|
||||
"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'",
|
||||
);
|
||||
c.header("Referrer-Policy", "strict-origin-when-cross-origin");
|
||||
});
|
||||
app.use("*", rateLimiter(options.rateLimitMax ?? 60));
|
||||
|
||||
app.route('/', healthRoutes(skills.length, cache));
|
||||
app.route('/', searchRoutes(skills, cache));
|
||||
app.route('/', skillRoutes(skills));
|
||||
app.route('/', trendingRoutes(skills));
|
||||
app.route('/', categoryRoutes(skills));
|
||||
app.route('/', docsRoutes());
|
||||
app.route("/", healthRoutes(skills.length, cache));
|
||||
app.route("/", searchRoutes(skills, cache));
|
||||
app.route("/", skillRoutes(skills));
|
||||
app.route("/", trendingRoutes(skills));
|
||||
app.route("/", categoryRoutes(skills));
|
||||
app.route("/", docsRoutes());
|
||||
app.route("/", saveRoutes());
|
||||
|
||||
return { app, cache };
|
||||
}
|
||||
|
||||
export async function startServer(options: ServerOptions = {}) {
|
||||
const port = options.port ?? 3737;
|
||||
const host = options.host ?? '0.0.0.0';
|
||||
const host = options.host ?? "127.0.0.1";
|
||||
const { app, cache } = createApp(options);
|
||||
|
||||
const { serve } = await import('@hono/node-server');
|
||||
const { serve } = await import("@hono/node-server");
|
||||
|
||||
const server = serve({ fetch: app.fetch, port, hostname: host }, () => {
|
||||
console.log(`SkillKit API server running at http://${host}:${port}`);
|
||||
|
||||
@@ -159,6 +159,20 @@ skillkit command generate <agent> # Generate agent-native commands
|
||||
skillkit command list <agent> # List available commands
|
||||
```
|
||||
|
||||
### Security Scanning
|
||||
|
||||
```bash
|
||||
skillkit scan <path> # Scan skill for vulnerabilities
|
||||
skillkit scan <path> --format json # Output as JSON
|
||||
skillkit scan <path> --format sarif # SARIF for GitHub Code Scanning
|
||||
skillkit scan <path> --fail-on high # Exit code 1 if HIGH+ findings
|
||||
skillkit scan <path> --skip-rules UC001,UC002 # Skip specific rules
|
||||
```
|
||||
|
||||
Detects: prompt injection, command injection, data exfiltration, tool abuse, hardcoded secrets, unicode steganography.
|
||||
|
||||
Skills are automatically scanned during `install` (use `--no-scan` to skip) and `publish`.
|
||||
|
||||
### Utilities
|
||||
|
||||
```bash
|
||||
@@ -184,6 +198,7 @@ skillkit install ./local/path # Local directory
|
||||
--yes # Skip confirmation prompts
|
||||
--global # Install globally
|
||||
--force # Overwrite existing
|
||||
--no-scan # Skip security scan
|
||||
--agent=cursor,windsurf # Install to specific agents
|
||||
```
|
||||
|
||||
@@ -207,6 +222,12 @@ await installCommand('anthropics/skills', {
|
||||
// List installed skills
|
||||
const skills = await listCommand({ json: true });
|
||||
|
||||
// Security scan
|
||||
import { SkillScanner, formatResult } from '@skillkit/core';
|
||||
const scanner = new SkillScanner({ failOnSeverity: 'high' });
|
||||
const result = await scanner.scan('./my-skill');
|
||||
console.log(formatResult(result, 'summary'));
|
||||
|
||||
// Sync to agent
|
||||
await syncCommand({ all: true });
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.14.0",
|
||||
"version": "1.20.0",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -20,6 +20,16 @@ describe('CLI Commands', () => {
|
||||
expect(commands.TranslateCommand).toBeDefined();
|
||||
expect(commands.ContextCommand).toBeDefined();
|
||||
expect(commands.RecommendCommand).toBeDefined();
|
||||
|
||||
expect(commands.ActivityCommand).toBeDefined();
|
||||
expect(commands.DoctorCommand).toBeDefined();
|
||||
expect(commands.IssuePlanCommand).toBeDefined();
|
||||
expect(commands.IssueListCommand).toBeDefined();
|
||||
expect(commands.SessionSnapshotSaveCommand).toBeDefined();
|
||||
expect(commands.SessionSnapshotRestoreCommand).toBeDefined();
|
||||
expect(commands.SessionSnapshotListCommand).toBeDefined();
|
||||
expect(commands.SessionSnapshotDeleteCommand).toBeDefined();
|
||||
expect(commands.SessionExplainCommand).toBeDefined();
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
@@ -0,0 +1,232 @@
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import { execSync } from 'node:child_process';
|
||||
import { mkdirSync, rmSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { stringify } from 'yaml';
|
||||
|
||||
const CLI = join(__dirname, '../../../../apps/skillkit/dist/cli.js');
|
||||
|
||||
function run(args: string, cwd: string): string {
|
||||
try {
|
||||
return execSync(`node ${CLI} ${args}`, {
|
||||
cwd,
|
||||
encoding: 'utf-8',
|
||||
timeout: 15000,
|
||||
env: { ...process.env, NO_COLOR: '1' },
|
||||
});
|
||||
} catch (err: any) {
|
||||
return err.stdout || err.stderr || err.message;
|
||||
}
|
||||
}
|
||||
|
||||
describe('E2E: Session Features', () => {
|
||||
let testDir: string;
|
||||
|
||||
beforeEach(() => {
|
||||
testDir = join(tmpdir(), `skillkit-e2e-${Date.now()}`);
|
||||
mkdirSync(testDir, { recursive: true });
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
rmSync(testDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
describe('skillkit activity', () => {
|
||||
it('should show empty state message', () => {
|
||||
const output = run('activity', testDir);
|
||||
expect(output).toContain('No activity recorded');
|
||||
});
|
||||
|
||||
it('should return empty JSON array', () => {
|
||||
const output = run('activity --json', testDir);
|
||||
const parsed = JSON.parse(output.trim());
|
||||
expect(parsed).toEqual([]);
|
||||
});
|
||||
|
||||
it('should accept --skill filter without error', () => {
|
||||
const output = run('activity --skill code-simplifier', testDir);
|
||||
expect(output).toContain('No activity recorded');
|
||||
});
|
||||
|
||||
it('should accept --limit flag without error', () => {
|
||||
const output = run('activity --limit 5', testDir);
|
||||
expect(output).toContain('No activity recorded');
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit session snapshot', () => {
|
||||
it('should list no snapshots initially', () => {
|
||||
const output = run('session snapshot list', testDir);
|
||||
expect(output).toContain('No snapshots found');
|
||||
});
|
||||
|
||||
it('should return empty JSON for snapshot list', () => {
|
||||
const output = run('session snapshot list --json', testDir);
|
||||
const parsed = JSON.parse(output.trim());
|
||||
expect(parsed).toEqual([]);
|
||||
});
|
||||
|
||||
it('should fail to save without active session', () => {
|
||||
const output = run('session snapshot save test-snap', testDir);
|
||||
expect(output).toContain('No active session');
|
||||
});
|
||||
|
||||
it('should fail to restore nonexistent snapshot', () => {
|
||||
const output = run('session snapshot restore nonexistent', testDir);
|
||||
expect(output).toContain('not found');
|
||||
});
|
||||
|
||||
it('should fail to delete nonexistent snapshot', () => {
|
||||
const output = run('session snapshot delete nonexistent', testDir);
|
||||
expect(output).toContain('not found');
|
||||
});
|
||||
|
||||
it('should save and restore snapshot with active session', () => {
|
||||
const skillkitDir = join(testDir, '.skillkit');
|
||||
mkdirSync(skillkitDir, { recursive: true });
|
||||
|
||||
const sessionState = {
|
||||
version: 1,
|
||||
lastActivity: new Date().toISOString(),
|
||||
projectPath: testDir,
|
||||
currentExecution: {
|
||||
skillName: 'code-simplifier',
|
||||
skillSource: 'local',
|
||||
currentStep: 1,
|
||||
totalSteps: 2,
|
||||
status: 'running',
|
||||
startedAt: new Date().toISOString(),
|
||||
tasks: [
|
||||
{
|
||||
id: 'task-1',
|
||||
name: 'Test task',
|
||||
type: 'auto',
|
||||
status: 'completed',
|
||||
},
|
||||
],
|
||||
},
|
||||
history: [],
|
||||
decisions: [{ key: 'test-key', value: 'test-value', madeAt: new Date().toISOString() }],
|
||||
};
|
||||
|
||||
writeFileSync(
|
||||
join(skillkitDir, 'session.yaml'),
|
||||
stringify(sessionState)
|
||||
);
|
||||
|
||||
const saveOutput = run('session snapshot save my-test-snap --desc "E2E test"', testDir);
|
||||
expect(saveOutput).toContain('Snapshot saved: my-test-snap');
|
||||
|
||||
const snapshotFile = join(skillkitDir, 'snapshots', 'my-test-snap.yaml');
|
||||
expect(existsSync(snapshotFile)).toBe(true);
|
||||
|
||||
const listOutput = run('session snapshot list', testDir);
|
||||
expect(listOutput).toContain('my-test-snap');
|
||||
expect(listOutput).toContain('E2E test');
|
||||
|
||||
const restoreOutput = run('session snapshot restore my-test-snap', testDir);
|
||||
expect(restoreOutput).toContain('Snapshot restored: my-test-snap');
|
||||
|
||||
const deleteOutput = run('session snapshot delete my-test-snap', testDir);
|
||||
expect(deleteOutput).toContain('Snapshot deleted: my-test-snap');
|
||||
|
||||
expect(existsSync(snapshotFile)).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit session explain', () => {
|
||||
it('should show empty session summary', () => {
|
||||
const output = run('session explain --no-git', testDir);
|
||||
expect(output).toContain('Session Summary');
|
||||
expect(output).toContain('Agent:');
|
||||
expect(output).toContain('Files Modified: 0 files');
|
||||
});
|
||||
|
||||
it('should return valid JSON', () => {
|
||||
const output = run('session explain --json --no-git', testDir);
|
||||
const parsed = JSON.parse(output.trim());
|
||||
expect(parsed.date).toBeDefined();
|
||||
expect(parsed.agent).toBe('unknown');
|
||||
expect(parsed.skillsUsed).toEqual([]);
|
||||
expect(parsed.observationCounts).toBeDefined();
|
||||
expect(typeof parsed.observationCounts.errors).toBe('number');
|
||||
expect(typeof parsed.observationCounts.solutions).toBe('number');
|
||||
expect(typeof parsed.observationCounts.patterns).toBe('number');
|
||||
});
|
||||
|
||||
it('should explain session with active execution', () => {
|
||||
const skillkitDir = join(testDir, '.skillkit');
|
||||
mkdirSync(skillkitDir, { recursive: true });
|
||||
|
||||
const sessionState = {
|
||||
version: 1,
|
||||
lastActivity: new Date().toISOString(),
|
||||
projectPath: testDir,
|
||||
currentExecution: {
|
||||
skillName: 'remotion-best-practices',
|
||||
skillSource: 'claude-code',
|
||||
currentStep: 2,
|
||||
totalSteps: 3,
|
||||
status: 'running',
|
||||
startedAt: new Date(Date.now() - 3600000).toISOString(),
|
||||
tasks: [
|
||||
{
|
||||
id: 't1',
|
||||
name: 'Setup video',
|
||||
type: 'auto',
|
||||
status: 'completed',
|
||||
startedAt: new Date(Date.now() - 3600000).toISOString(),
|
||||
completedAt: new Date(Date.now() - 1800000).toISOString(),
|
||||
filesModified: ['src/video.tsx'],
|
||||
},
|
||||
{
|
||||
id: 't2',
|
||||
name: 'Add effects',
|
||||
type: 'auto',
|
||||
status: 'in_progress',
|
||||
startedAt: new Date(Date.now() - 1800000).toISOString(),
|
||||
},
|
||||
],
|
||||
},
|
||||
history: [],
|
||||
decisions: [
|
||||
{ key: 'codec', value: 'h264', madeAt: new Date().toISOString() },
|
||||
],
|
||||
};
|
||||
|
||||
writeFileSync(
|
||||
join(skillkitDir, 'session.yaml'),
|
||||
stringify(sessionState)
|
||||
);
|
||||
|
||||
const output = run('session explain --no-git', testDir);
|
||||
expect(output).toContain('Session Summary');
|
||||
expect(output).toContain('Duration:');
|
||||
expect(output).toContain('claude-code');
|
||||
expect(output).toContain('remotion-best-practices');
|
||||
expect(output).toContain('Setup video');
|
||||
expect(output).toContain('Add effects');
|
||||
expect(output).toContain('codec');
|
||||
|
||||
const jsonOutput = run('session explain --json --no-git', testDir);
|
||||
const parsed = JSON.parse(jsonOutput.trim());
|
||||
expect(parsed.skillsUsed).toHaveLength(1);
|
||||
expect(parsed.skillsUsed[0].name).toBe('remotion-best-practices');
|
||||
expect(parsed.tasks).toHaveLength(2);
|
||||
expect(parsed.decisions).toHaveLength(1);
|
||||
expect(parsed.filesModified).toContain('src/video.tsx');
|
||||
});
|
||||
});
|
||||
|
||||
describe('skillkit session (help)', () => {
|
||||
it('should list all subcommands including new ones', () => {
|
||||
const output = run('session', testDir);
|
||||
expect(output).toContain('session explain');
|
||||
expect(output).toContain('session snapshot save');
|
||||
expect(output).toContain('session snapshot restore');
|
||||
expect(output).toContain('session snapshot list');
|
||||
expect(output).toContain('session snapshot delete');
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -96,11 +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', 32);
|
||||
// Full logo uses block characters (███), not literal text
|
||||
expect(logo).toContain('\u2588'); // █ block character
|
||||
const logo = getFullLogo('1.7.2', 44);
|
||||
expect(logo).toContain('\u2588');
|
||||
expect(logo).toContain('v1.7.2');
|
||||
expect(logo).toContain('32 agents');
|
||||
expect(logo).toContain('44 agents');
|
||||
});
|
||||
|
||||
it('should generate compact logo', async () => {
|
||||
|
||||
@@ -16,8 +16,8 @@ export function generateBadge(skills: string[]): {
|
||||
const url = `https://img.shields.io/badge/SkillKit-No%20Skills-555555?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
|
||||
return {
|
||||
url,
|
||||
markdown: `[](https://agenstskills.com)`,
|
||||
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
|
||||
markdown: `[](https://skillkit.sh)`,
|
||||
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -33,7 +33,7 @@ export function generateBadge(skills: string[]): {
|
||||
|
||||
return {
|
||||
url,
|
||||
markdown: `[](https://agenstskills.com)`,
|
||||
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
|
||||
markdown: `[](https://skillkit.sh)`,
|
||||
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -0,0 +1,94 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { colors, warn } from '../onboarding/index.js';
|
||||
import { ActivityLog } from '@skillkit/core';
|
||||
|
||||
export class ActivityCommand extends Command {
|
||||
static override paths = [['activity']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Show skill activity log for git commits',
|
||||
examples: [
|
||||
['Show recent activity', '$0 activity'],
|
||||
['Filter by skill', '$0 activity --skill code-simplifier'],
|
||||
['JSON output', '$0 activity --json'],
|
||||
],
|
||||
});
|
||||
|
||||
skill = Option.String('--skill,-s', {
|
||||
description: 'Filter by skill name',
|
||||
});
|
||||
|
||||
limit = Option.String('--limit,-l', {
|
||||
description: 'Number of entries to show (default: 10)',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const log = new ActivityLog(projectPath);
|
||||
const parsed = this.limit ? parseInt(this.limit, 10) : 10;
|
||||
const limit = Number.isFinite(parsed) && parsed > 0 ? parsed : 10;
|
||||
|
||||
const activities = this.skill
|
||||
? log.getBySkill(this.skill)
|
||||
: log.getRecent(limit);
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(activities.slice(0, limit), null, 2));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (activities.length === 0) {
|
||||
warn('No activity recorded');
|
||||
console.log(
|
||||
colors.muted(
|
||||
'Activity is recorded when skills are active during git commits.'
|
||||
)
|
||||
);
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(colors.cyan(' Recent Skill Activity\n'));
|
||||
|
||||
const displayed = activities.slice(0, limit);
|
||||
|
||||
for (const activity of displayed) {
|
||||
const shortSha = activity.commitSha.slice(0, 7);
|
||||
const skills = activity.activeSkills.join(', ');
|
||||
const files = activity.filesChanged.join(', ');
|
||||
const ago = formatTimeAgo(activity.committedAt);
|
||||
|
||||
console.log(` ${colors.bold(shortSha)} ${activity.message}`);
|
||||
console.log(` Skills: ${colors.success(skills)}`);
|
||||
console.log(
|
||||
` Files: ${files} ${colors.muted(`(${ago})`)}`
|
||||
);
|
||||
console.log();
|
||||
}
|
||||
|
||||
const topSkills = log.getMostUsedSkills().slice(0, 5);
|
||||
if (topSkills.length > 0) {
|
||||
const formatted = topSkills
|
||||
.map((s) => `${s.skill} (${s.count})`)
|
||||
.join(', ');
|
||||
console.log(` Top Skills: ${formatted}`);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
function formatTimeAgo(isoDate: string): string {
|
||||
const diff = Date.now() - new Date(isoDate).getTime();
|
||||
const minutes = Math.floor(diff / 60000);
|
||||
const hours = Math.floor(minutes / 60);
|
||||
const days = Math.floor(hours / 24);
|
||||
|
||||
if (days > 0) return `${days}d ago`;
|
||||
if (hours > 0) return `${hours}h ago`;
|
||||
if (minutes > 0) return `${minutes}m ago`;
|
||||
return 'just now';
|
||||
}
|
||||
+110
-110
@@ -4,7 +4,7 @@
|
||||
* Manage custom AI sub-agents (e.g., .claude/agents/*.md)
|
||||
*/
|
||||
|
||||
import chalk from 'chalk';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
||||
import { join, basename } from 'node:path';
|
||||
@@ -67,7 +67,7 @@ export class AgentCommand extends Command {
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
console.log(chalk.cyan('Agent management commands:\n'));
|
||||
console.log(colors.cyan('Agent management commands:\n'));
|
||||
console.log(' agent list List all installed agents');
|
||||
console.log(' agent show <name> Show agent details');
|
||||
console.log(' agent create <name> Create a new agent');
|
||||
@@ -76,7 +76,7 @@ export class AgentCommand extends Command {
|
||||
console.log(' agent sync Sync agents to target AI agent');
|
||||
console.log(' agent validate [path] Validate agent definitions');
|
||||
console.log();
|
||||
console.log(chalk.dim('Run `skillkit agent <subcommand> --help` for more info'));
|
||||
console.log(colors.muted('Run `skillkit agent <subcommand> --help` for more info'));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -136,18 +136,18 @@ export class AgentListCommand extends Command {
|
||||
}
|
||||
|
||||
if (agents.length === 0) {
|
||||
console.log(chalk.yellow('No agents found'));
|
||||
console.log(chalk.dim('Create an agent with: skillkit agent create <name>'));
|
||||
console.log(colors.warning('No agents found'));
|
||||
console.log(colors.muted('Create an agent with: skillkit agent create <name>'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Installed agents (${agents.length}):\n`));
|
||||
console.log(colors.cyan(`Installed agents (${agents.length}):\n`));
|
||||
|
||||
const projectAgents = agents.filter((a: CustomAgent) => a.location === 'project');
|
||||
const globalAgents = agents.filter((a: CustomAgent) => a.location === 'global');
|
||||
|
||||
if (projectAgents.length > 0) {
|
||||
console.log(chalk.blue('Project agents:'));
|
||||
console.log(colors.info('Project agents:'));
|
||||
for (const agent of projectAgents) {
|
||||
printAgent(agent);
|
||||
}
|
||||
@@ -155,7 +155,7 @@ export class AgentListCommand extends Command {
|
||||
}
|
||||
|
||||
if (globalAgents.length > 0) {
|
||||
console.log(chalk.dim('Global agents:'));
|
||||
console.log(colors.muted('Global agents:'));
|
||||
for (const agent of globalAgents) {
|
||||
printAgent(agent);
|
||||
}
|
||||
@@ -163,7 +163,7 @@ export class AgentListCommand extends Command {
|
||||
}
|
||||
|
||||
console.log(
|
||||
chalk.dim(`${projectAgents.length} project, ${globalAgents.length} global`)
|
||||
colors.muted(`${projectAgents.length} project, ${globalAgents.length} global`)
|
||||
);
|
||||
|
||||
return 0;
|
||||
@@ -187,47 +187,47 @@ export class AgentShowCommand extends Command {
|
||||
const agent = findAgent(this.name, searchDirs);
|
||||
|
||||
if (!agent) {
|
||||
console.log(chalk.red(`Agent not found: ${this.name}`));
|
||||
console.log(colors.error(`Agent not found: ${this.name}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Agent: ${agent.name}\n`));
|
||||
console.log(`${chalk.dim('Description:')} ${agent.description}`);
|
||||
console.log(`${chalk.dim('Location:')} ${agent.location} (${agent.path})`);
|
||||
console.log(`${chalk.dim('Enabled:')} ${agent.enabled ? chalk.green('yes') : chalk.red('no')}`);
|
||||
console.log(colors.cyan(`Agent: ${agent.name}\n`));
|
||||
console.log(`${colors.muted('Description:')} ${agent.description}`);
|
||||
console.log(`${colors.muted('Location:')} ${agent.location} (${agent.path})`);
|
||||
console.log(`${colors.muted('Enabled:')} ${agent.enabled ? colors.success('yes') : colors.error('no')}`);
|
||||
|
||||
const fm = agent.frontmatter;
|
||||
if (fm.model) {
|
||||
console.log(`${chalk.dim('Model:')} ${fm.model}`);
|
||||
console.log(`${colors.muted('Model:')} ${fm.model}`);
|
||||
}
|
||||
if (fm.permissionMode) {
|
||||
console.log(`${chalk.dim('Permission Mode:')} ${fm.permissionMode}`);
|
||||
console.log(`${colors.muted('Permission Mode:')} ${fm.permissionMode}`);
|
||||
}
|
||||
if (fm.context) {
|
||||
console.log(`${chalk.dim('Context:')} ${fm.context}`);
|
||||
console.log(`${colors.muted('Context:')} ${fm.context}`);
|
||||
}
|
||||
if (fm.disallowedTools && fm.disallowedTools.length > 0) {
|
||||
console.log(`${chalk.dim('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
|
||||
console.log(`${colors.muted('Disallowed Tools:')} ${fm.disallowedTools.join(', ')}`);
|
||||
}
|
||||
if (fm.skills && fm.skills.length > 0) {
|
||||
console.log(`${chalk.dim('Skills:')} ${fm.skills.join(', ')}`);
|
||||
console.log(`${colors.muted('Skills:')} ${fm.skills.join(', ')}`);
|
||||
}
|
||||
if (fm.hooks && fm.hooks.length > 0) {
|
||||
console.log(`${chalk.dim('Hooks:')} ${fm.hooks.length} defined`);
|
||||
console.log(`${colors.muted('Hooks:')} ${fm.hooks.length} defined`);
|
||||
}
|
||||
if (fm.tags && fm.tags.length > 0) {
|
||||
console.log(`${chalk.dim('Tags:')} ${fm.tags.join(', ')}`);
|
||||
console.log(`${colors.muted('Tags:')} ${fm.tags.join(', ')}`);
|
||||
}
|
||||
if (fm.author) {
|
||||
console.log(`${chalk.dim('Author:')} ${fm.author}`);
|
||||
console.log(`${colors.muted('Author:')} ${fm.author}`);
|
||||
}
|
||||
if (fm.version) {
|
||||
console.log(`${chalk.dim('Version:')} ${fm.version}`);
|
||||
console.log(`${colors.muted('Version:')} ${fm.version}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.dim('Content preview:'));
|
||||
console.log(chalk.dim('─'.repeat(40)));
|
||||
console.log(colors.muted('Content preview:'));
|
||||
console.log(colors.muted('─'.repeat(40)));
|
||||
const preview = agent.content.slice(0, 500);
|
||||
console.log(preview + (agent.content.length > 500 ? '\n...' : ''));
|
||||
|
||||
@@ -264,8 +264,8 @@ export class AgentCreateCommand extends Command {
|
||||
async execute(): Promise<number> {
|
||||
const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
||||
if (!namePattern.test(this.name)) {
|
||||
console.log(chalk.red('Invalid agent name: must be lowercase alphanumeric with hyphens'));
|
||||
console.log(chalk.dim('Examples: my-agent, code-reviewer, security-expert'));
|
||||
console.log(colors.error('Invalid agent name: must be lowercase alphanumeric with hyphens'));
|
||||
console.log(colors.muted('Examples: my-agent, code-reviewer, security-expert'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -282,7 +282,7 @@ export class AgentCreateCommand extends Command {
|
||||
|
||||
const agentPath = join(targetDir, `${this.name}.md`);
|
||||
if (existsSync(agentPath)) {
|
||||
console.log(chalk.red(`Agent already exists: ${agentPath}`));
|
||||
console.log(colors.error(`Agent already exists: ${agentPath}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -291,10 +291,10 @@ export class AgentCreateCommand extends Command {
|
||||
|
||||
writeFileSync(agentPath, content);
|
||||
|
||||
console.log(chalk.green(`Created agent: ${agentPath}`));
|
||||
console.log(colors.success(`Created agent: ${agentPath}`));
|
||||
console.log();
|
||||
console.log(chalk.dim('Edit the file to customize the agent system prompt.'));
|
||||
console.log(chalk.dim(`Invoke with: @${this.name}`));
|
||||
console.log(colors.muted('Edit the file to customize the agent system prompt.'));
|
||||
console.log(colors.muted(`Invoke with: @${this.name}`));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -360,23 +360,23 @@ export class AgentTranslateCommand extends Command {
|
||||
: join(process.cwd(), this.source);
|
||||
|
||||
if (!existsSync(sourcePath)) {
|
||||
console.log(chalk.red(`Source path not found: ${sourcePath}`));
|
||||
console.log(colors.error(`Source path not found: ${sourcePath}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
agents = discoverAgentsFromPath(sourcePath, this.recursive);
|
||||
|
||||
if (agents.length === 0) {
|
||||
console.log(chalk.yellow(`No agents found in: ${sourcePath}`));
|
||||
console.log(colors.warning(`No agents found in: ${sourcePath}`));
|
||||
if (!this.recursive) {
|
||||
console.log(chalk.dim('Tip: Use --recursive to scan subdirectories'));
|
||||
console.log(colors.muted('Tip: Use --recursive to scan subdirectories'));
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
} else if (this.name) {
|
||||
const agent = findAgent(this.name, searchDirs);
|
||||
if (!agent) {
|
||||
console.log(chalk.red(`Agent not found: ${this.name}`));
|
||||
console.log(colors.error(`Agent not found: ${this.name}`));
|
||||
return 1;
|
||||
}
|
||||
agents = [agent];
|
||||
@@ -387,13 +387,13 @@ export class AgentTranslateCommand extends Command {
|
||||
}
|
||||
|
||||
if (agents.length === 0) {
|
||||
console.log(chalk.yellow('No agents found to translate'));
|
||||
console.log(colors.warning('No agents found to translate'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const outputDir = this.output || getAgentTargetDirectory(process.cwd(), targetAgent);
|
||||
|
||||
console.log(chalk.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
|
||||
console.log(colors.cyan(`Translating ${agents.length} agent(s) to ${targetAgent} format...\n`));
|
||||
|
||||
let successCount = 0;
|
||||
let errorCount = 0;
|
||||
@@ -403,7 +403,7 @@ export class AgentTranslateCommand extends Command {
|
||||
const result = translateAgent(agent, targetAgent, { addMetadata: true });
|
||||
|
||||
if (!result.success) {
|
||||
console.log(chalk.red(`✗ ${agent.name}: Translation failed`));
|
||||
console.log(colors.error(`✗ ${agent.name}: Translation failed`));
|
||||
errorCount++;
|
||||
continue;
|
||||
}
|
||||
@@ -411,15 +411,15 @@ export class AgentTranslateCommand extends Command {
|
||||
const outputPath = join(outputDir, result.filename);
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.blue(`Would write: ${outputPath}`));
|
||||
console.log(colors.info(`Would write: ${outputPath}`));
|
||||
if (result.warnings.length > 0) {
|
||||
for (const warning of result.warnings) {
|
||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
||||
console.log(colors.warning(` ⚠ ${warning}`));
|
||||
}
|
||||
}
|
||||
if (result.incompatible.length > 0) {
|
||||
for (const incompat of result.incompatible) {
|
||||
console.log(chalk.dim(` ○ ${incompat}`));
|
||||
console.log(colors.muted(` ○ ${incompat}`));
|
||||
}
|
||||
}
|
||||
} else {
|
||||
@@ -427,21 +427,21 @@ export class AgentTranslateCommand extends Command {
|
||||
mkdirSync(outputDir, { recursive: true });
|
||||
}
|
||||
writeFileSync(outputPath, result.content);
|
||||
console.log(chalk.green(`✓ ${agent.name} → ${outputPath}`));
|
||||
console.log(colors.success(`✓ ${agent.name} → ${outputPath}`));
|
||||
}
|
||||
|
||||
successCount++;
|
||||
} catch (error) {
|
||||
console.log(chalk.red(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
|
||||
console.log(colors.error(`✗ ${agent.name}: ${error instanceof Error ? error.message : 'Unknown error'}`));
|
||||
errorCount++;
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.dim(`Would translate ${successCount} agent(s)`));
|
||||
console.log(colors.muted(`Would translate ${successCount} agent(s)`));
|
||||
} else {
|
||||
console.log(chalk.dim(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
|
||||
console.log(colors.muted(`Translated ${successCount} agent(s)${errorCount > 0 ? `, ${errorCount} failed` : ''}`));
|
||||
}
|
||||
|
||||
return errorCount > 0 ? 1 : 0;
|
||||
@@ -468,7 +468,7 @@ export class AgentSyncCommand extends Command {
|
||||
const agents = findAllAgents(searchDirs);
|
||||
|
||||
if (agents.length === 0) {
|
||||
console.log(chalk.yellow('No agents found to sync'));
|
||||
console.log(colors.warning('No agents found to sync'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -476,12 +476,12 @@ export class AgentSyncCommand extends Command {
|
||||
? this.agent.split(',').map(a => a.trim() as AgentType)
|
||||
: ['claude-code' as AgentType];
|
||||
|
||||
console.log(chalk.cyan(`Syncing ${agents.length} agent(s)...\n`));
|
||||
console.log(colors.cyan(`Syncing ${agents.length} agent(s)...\n`));
|
||||
|
||||
for (const targetAgent of targetAgents) {
|
||||
const outputDir = getAgentTargetDirectory(process.cwd(), targetAgent);
|
||||
|
||||
console.log(chalk.blue(`→ ${targetAgent} (${outputDir})`));
|
||||
console.log(colors.info(`→ ${targetAgent} (${outputDir})`));
|
||||
|
||||
if (!existsSync(outputDir)) {
|
||||
mkdirSync(outputDir, { recursive: true });
|
||||
@@ -492,15 +492,15 @@ export class AgentSyncCommand extends Command {
|
||||
if (result.success) {
|
||||
const outputPath = join(outputDir, result.filename);
|
||||
writeFileSync(outputPath, result.content);
|
||||
console.log(chalk.green(` ✓ ${agent.name}`));
|
||||
console.log(colors.success(` ✓ ${agent.name}`));
|
||||
} else {
|
||||
console.log(chalk.red(` ✗ ${agent.name}`));
|
||||
console.log(colors.error(` ✗ ${agent.name}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.dim('Sync complete'));
|
||||
console.log(colors.muted('Sync complete'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -535,11 +535,11 @@ export class AgentValidateCommand extends Command {
|
||||
const agents = findAllAgents(searchDirs);
|
||||
|
||||
if (agents.length === 0) {
|
||||
console.log(chalk.yellow('No agents found'));
|
||||
console.log(colors.warning('No agents found'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Validating ${agents.length} agent(s)...\n`));
|
||||
console.log(colors.cyan(`Validating ${agents.length} agent(s)...\n`));
|
||||
|
||||
for (const agent of agents) {
|
||||
const result = validateAgent(agent.path);
|
||||
@@ -547,7 +547,7 @@ export class AgentValidateCommand extends Command {
|
||||
if (!result.valid) hasErrors = true;
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.yellow('Specify a path or use --all to validate all agents'));
|
||||
console.log(colors.warning('Specify a path or use --all to validate all agents'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -556,10 +556,10 @@ export class AgentValidateCommand extends Command {
|
||||
}
|
||||
|
||||
function printAgent(agent: CustomAgent): void {
|
||||
const status = agent.enabled ? chalk.green('✓') : chalk.red('○');
|
||||
const name = agent.enabled ? agent.name : chalk.dim(agent.name);
|
||||
const model = agent.frontmatter.model ? chalk.blue(`[${agent.frontmatter.model}]`) : '';
|
||||
const desc = chalk.dim(truncate(agent.description, 40));
|
||||
const status = agent.enabled ? colors.success('✓') : colors.error('○');
|
||||
const name = agent.enabled ? agent.name : colors.muted(agent.name);
|
||||
const model = agent.frontmatter.model ? colors.info(`[${agent.frontmatter.model}]`) : '';
|
||||
const desc = colors.muted(truncate(agent.description, 40));
|
||||
|
||||
console.log(` ${status} ${name} ${model}`);
|
||||
if (agent.description) {
|
||||
@@ -572,17 +572,17 @@ function printValidationResult(
|
||||
result: { valid: boolean; errors: string[]; warnings: string[] }
|
||||
): void {
|
||||
if (result.valid) {
|
||||
console.log(chalk.green(`✓ ${name}`));
|
||||
console.log(colors.success(`✓ ${name}`));
|
||||
for (const warning of result.warnings) {
|
||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
||||
console.log(colors.warning(` ⚠ ${warning}`));
|
||||
}
|
||||
} else {
|
||||
console.log(chalk.red(`✗ ${name}`));
|
||||
for (const error of result.errors) {
|
||||
console.log(chalk.red(` • ${error}`));
|
||||
console.log(colors.error(`✗ ${name}`));
|
||||
for (const err of result.errors) {
|
||||
console.log(colors.error(` • ${err}`));
|
||||
}
|
||||
for (const warning of result.warnings) {
|
||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
||||
console.log(colors.warning(` ⚠ ${warning}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -671,15 +671,15 @@ export class AgentInstallCommand extends Command {
|
||||
}
|
||||
|
||||
if (!this.name) {
|
||||
console.log(chalk.yellow('Please specify an agent name or use --all'));
|
||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
||||
console.log(colors.warning('Please specify an agent name or use --all'));
|
||||
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const agent = getBundledAgent(this.name);
|
||||
if (!agent) {
|
||||
console.log(chalk.red(`Bundled agent not found: ${this.name}`));
|
||||
console.log(chalk.dim('Run `skillkit agent available` to see available agents'));
|
||||
console.log(colors.error(`Bundled agent not found: ${this.name}`));
|
||||
console.log(colors.muted('Run `skillkit agent available` to see available agents'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -689,11 +689,11 @@ export class AgentInstallCommand extends Command {
|
||||
});
|
||||
|
||||
if (result.success) {
|
||||
console.log(chalk.green(`✓ Installed: ${agent.name}`));
|
||||
console.log(chalk.dim(` Path: ${result.path}`));
|
||||
console.log(chalk.dim(` Invoke with: @${agent.id}`));
|
||||
console.log(colors.success(`✓ Installed: ${agent.name}`));
|
||||
console.log(colors.muted(` Path: ${result.path}`));
|
||||
console.log(colors.muted(` Invoke with: @${agent.id}`));
|
||||
} else {
|
||||
console.log(chalk.red(`✗ Failed: ${result.message}`));
|
||||
console.log(colors.error(`✗ Failed: ${result.message}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -702,7 +702,7 @@ export class AgentInstallCommand extends Command {
|
||||
|
||||
private async installAll(): Promise<number> {
|
||||
const agents = getBundledAgents();
|
||||
console.log(chalk.cyan(`Installing ${agents.length} bundled agents...\n`));
|
||||
console.log(colors.cyan(`Installing ${agents.length} bundled agents...\n`));
|
||||
|
||||
let successCount = 0;
|
||||
let skipCount = 0;
|
||||
@@ -715,20 +715,20 @@ export class AgentInstallCommand extends Command {
|
||||
});
|
||||
|
||||
if (result.success) {
|
||||
console.log(chalk.green(` ✓ ${agent.name}`));
|
||||
console.log(colors.success(` ✓ ${agent.name}`));
|
||||
successCount++;
|
||||
} else if (result.message.includes('already exists')) {
|
||||
console.log(chalk.yellow(` ○ ${agent.name} (already installed)`));
|
||||
console.log(colors.warning(` ○ ${agent.name} (already installed)`));
|
||||
skipCount++;
|
||||
} else {
|
||||
console.log(chalk.red(` ✗ ${agent.name}: ${result.message}`));
|
||||
console.log(colors.error(` ✗ ${agent.name}: ${result.message}`));
|
||||
errorCount++;
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(
|
||||
chalk.dim(
|
||||
colors.muted(
|
||||
`Installed: ${successCount}, Skipped: ${skipCount}, Errors: ${errorCount}`
|
||||
)
|
||||
);
|
||||
@@ -781,10 +781,10 @@ export class AgentAvailableCommand extends Command {
|
||||
|
||||
if (agents.length === 0) {
|
||||
if (this.installed) {
|
||||
console.log(chalk.yellow('No bundled agents installed'));
|
||||
console.log(chalk.dim('Run `skillkit agent install <name>` to install'));
|
||||
console.log(colors.warning('No bundled agents installed'));
|
||||
console.log(colors.muted('Run `skillkit agent install <name>` to install'));
|
||||
} else {
|
||||
console.log(chalk.green('All bundled agents are already installed!'));
|
||||
console.log(colors.success('All bundled agents are already installed!'));
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
@@ -793,7 +793,7 @@ export class AgentAvailableCommand extends Command {
|
||||
? 'Installed Bundled Agents'
|
||||
: 'Available Bundled Agents';
|
||||
|
||||
console.log(chalk.cyan(`${title} (${agents.length}):\n`));
|
||||
console.log(colors.cyan(`${title} (${agents.length}):\n`));
|
||||
|
||||
const categories = new Map<string, BundledAgent[]>();
|
||||
for (const agent of agents) {
|
||||
@@ -805,20 +805,20 @@ export class AgentAvailableCommand extends Command {
|
||||
}
|
||||
|
||||
for (const [category, catAgents] of categories) {
|
||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
||||
console.log(colors.info(` ${formatCategoryName(category)}`));
|
||||
for (const agent of catAgents) {
|
||||
const installed = isAgentInstalled(agent.id);
|
||||
const status = installed ? chalk.green('✓') : chalk.dim('○');
|
||||
const model = agent.model ? chalk.blue(`[${agent.model}]`) : '';
|
||||
console.log(` ${status} ${chalk.bold(agent.id)} ${model}`);
|
||||
console.log(` ${chalk.dim(agent.description)}`);
|
||||
const status = installed ? colors.success('✓') : colors.muted('○');
|
||||
const model = agent.model ? colors.info(`[${agent.model}]`) : '';
|
||||
console.log(` ${status} ${colors.bold(agent.id)} ${model}`);
|
||||
console.log(` ${colors.muted(agent.description)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (!this.installed) {
|
||||
console.log(chalk.dim('Install with: skillkit agent install <name>'));
|
||||
console.log(chalk.dim('Install all: skillkit agent install --all'));
|
||||
console.log(colors.muted('Install with: skillkit agent install <name>'));
|
||||
console.log(colors.muted('Install all: skillkit agent install --all'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
@@ -877,20 +877,20 @@ export class AgentFromSkillCommand extends Command {
|
||||
const skill = skills.find((s: Skill) => s.name === this.skillName);
|
||||
|
||||
if (!skill) {
|
||||
console.log(chalk.red(`Skill not found: ${this.skillName}`));
|
||||
console.log(chalk.dim('Available skills:'));
|
||||
console.log(colors.error(`Skill not found: ${this.skillName}`));
|
||||
console.log(colors.muted('Available skills:'));
|
||||
for (const s of skills.slice(0, 10)) {
|
||||
console.log(chalk.dim(` - ${s.name}`));
|
||||
console.log(colors.muted(` - ${s.name}`));
|
||||
}
|
||||
if (skills.length > 10) {
|
||||
console.log(chalk.dim(` ... and ${skills.length - 10} more`));
|
||||
console.log(colors.muted(` ... and ${skills.length - 10} more`));
|
||||
}
|
||||
return 1;
|
||||
}
|
||||
|
||||
const skillContent = readSkillContent(skill.path);
|
||||
if (!skillContent) {
|
||||
console.log(chalk.red(`Could not read skill content: ${skill.path}`));
|
||||
console.log(colors.error(`Could not read skill content: ${skill.path}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -901,8 +901,8 @@ export class AgentFromSkillCommand extends Command {
|
||||
if (this.model) {
|
||||
const validModels = ['sonnet', 'opus', 'haiku', 'inherit'];
|
||||
if (!validModels.includes(this.model)) {
|
||||
console.log(chalk.red(`Invalid model: ${this.model}`));
|
||||
console.log(chalk.dim(`Valid options: ${validModels.join(', ')}`));
|
||||
console.log(colors.error(`Invalid model: ${this.model}`));
|
||||
console.log(colors.muted(`Valid options: ${validModels.join(', ')}`));
|
||||
return 1;
|
||||
}
|
||||
options.model = this.model as 'sonnet' | 'opus' | 'haiku' | 'inherit';
|
||||
@@ -911,8 +911,8 @@ export class AgentFromSkillCommand extends Command {
|
||||
if (this.permission) {
|
||||
const validModes = ['default', 'plan', 'auto-edit', 'full-auto', 'bypassPermissions'];
|
||||
if (!validModes.includes(this.permission)) {
|
||||
console.log(chalk.red(`Invalid permission mode: ${this.permission}`));
|
||||
console.log(chalk.dim(`Valid options: ${validModes.join(', ')}`));
|
||||
console.log(colors.error(`Invalid permission mode: ${this.permission}`));
|
||||
console.log(colors.muted(`Valid options: ${validModes.join(', ')}`));
|
||||
return 1;
|
||||
}
|
||||
options.permissionMode = this.permission as AgentPermissionMode;
|
||||
@@ -928,16 +928,16 @@ export class AgentFromSkillCommand extends Command {
|
||||
if (this.output) {
|
||||
const sanitized = sanitizeFilename(this.output);
|
||||
if (!sanitized) {
|
||||
console.log(chalk.red(`Invalid output filename: ${this.output}`));
|
||||
console.log(chalk.dim('Filename must contain only alphanumeric characters, hyphens, and underscores'));
|
||||
console.log(colors.error(`Invalid output filename: ${this.output}`));
|
||||
console.log(colors.muted('Filename must contain only alphanumeric characters, hyphens, and underscores'));
|
||||
return 1;
|
||||
}
|
||||
filename = `${sanitized}.md`;
|
||||
} else {
|
||||
const sanitized = sanitizeFilename(skill.name);
|
||||
if (!sanitized) {
|
||||
console.log(chalk.red(`Invalid skill name for filename: ${skill.name}`));
|
||||
console.log(chalk.dim('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
|
||||
console.log(colors.error(`Invalid skill name for filename: ${skill.name}`));
|
||||
console.log(colors.muted('Skill name must contain only alphanumeric characters, hyphens, and underscores'));
|
||||
return 1;
|
||||
}
|
||||
filename = `${sanitized}.md`;
|
||||
@@ -946,11 +946,11 @@ export class AgentFromSkillCommand extends Command {
|
||||
const outputPath = join(targetDir, filename);
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.cyan('Preview (dry run):\n'));
|
||||
console.log(chalk.dim(`Would write to: ${outputPath}`));
|
||||
console.log(chalk.dim('─'.repeat(50)));
|
||||
console.log(colors.cyan('Preview (dry run):\n'));
|
||||
console.log(colors.muted(`Would write to: ${outputPath}`));
|
||||
console.log(colors.muted('─'.repeat(50)));
|
||||
console.log(content);
|
||||
console.log(chalk.dim('─'.repeat(50)));
|
||||
console.log(colors.muted('─'.repeat(50)));
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -959,18 +959,18 @@ export class AgentFromSkillCommand extends Command {
|
||||
}
|
||||
|
||||
if (existsSync(outputPath)) {
|
||||
console.log(chalk.yellow(`Overwriting existing file: ${outputPath}`));
|
||||
console.log(colors.warning(`Overwriting existing file: ${outputPath}`));
|
||||
}
|
||||
|
||||
writeFileSync(outputPath, content);
|
||||
|
||||
console.log(chalk.green(`Created subagent: ${outputPath}`));
|
||||
console.log(colors.success(`Created subagent: ${outputPath}`));
|
||||
console.log();
|
||||
console.log(chalk.dim(`Invoke with: @${skill.name}`));
|
||||
console.log(colors.muted(`Invoke with: @${skill.name}`));
|
||||
if (!this.inline) {
|
||||
console.log(chalk.dim(`Skills referenced: ${skill.name}`));
|
||||
console.log(colors.muted(`Skills referenced: ${skill.name}`));
|
||||
} else {
|
||||
console.log(chalk.dim('Skill content embedded inline'));
|
||||
console.log(colors.muted('Skill content embedded inline'));
|
||||
}
|
||||
|
||||
return 0;
|
||||
|
||||
@@ -0,0 +1,123 @@
|
||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { colors, warn, success, error } from '../onboarding/index.js';
|
||||
import { Command } from 'clipanion';
|
||||
import { AgentsMdGenerator, AgentsMdParser } from '@skillkit/core';
|
||||
|
||||
export class AgentsMdCommand extends Command {
|
||||
static override paths = [['agents']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage AGENTS.md for project-specific agent context',
|
||||
details: `
|
||||
Sub-commands:
|
||||
agents init - Generate initial AGENTS.md
|
||||
agents sync - Update managed sections in existing AGENTS.md
|
||||
agents show - Display current AGENTS.md content
|
||||
`,
|
||||
examples: [
|
||||
['Generate AGENTS.md', '$0 agents init'],
|
||||
['Update skills section', '$0 agents sync'],
|
||||
['Show AGENTS.md', '$0 agents show'],
|
||||
],
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
this.context.stdout.write(this.cli.usage(AgentsMdCommand, { detailed: true }));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdInitCommand extends Command {
|
||||
static override paths = [['agents', 'init']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Generate initial AGENTS.md in current directory',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||
|
||||
if (existsSync(agentsPath)) {
|
||||
warn('AGENTS.md already exists. Use `skillkit agents sync` to update.');
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const generator = new AgentsMdGenerator({ projectPath });
|
||||
const result = generator.generate();
|
||||
|
||||
console.log(colors.muted('Preview:'));
|
||||
console.log('');
|
||||
console.log(result.content);
|
||||
|
||||
writeFileSync(agentsPath, result.content, 'utf-8');
|
||||
success(`Created ${agentsPath}`);
|
||||
return 0;
|
||||
} catch (err) {
|
||||
error(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdSyncCommand extends Command {
|
||||
static override paths = [['agents', 'sync']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Update managed sections in existing AGENTS.md',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||
|
||||
if (!existsSync(agentsPath)) {
|
||||
warn('No AGENTS.md found. Run `skillkit agents init` first.');
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const existing = readFileSync(agentsPath, 'utf-8');
|
||||
const parser = new AgentsMdParser();
|
||||
|
||||
if (!parser.hasManagedSections(existing)) {
|
||||
warn('No managed sections found in AGENTS.md. Nothing to update.');
|
||||
return 0;
|
||||
}
|
||||
|
||||
const generator = new AgentsMdGenerator({ projectPath });
|
||||
const result = generator.generate();
|
||||
const managedSections = result.sections.filter(s => s.managed);
|
||||
const updated = parser.updateManagedSections(existing, managedSections);
|
||||
|
||||
writeFileSync(agentsPath, updated, 'utf-8');
|
||||
success(`Updated ${managedSections.length} managed section(s) in AGENTS.md`);
|
||||
return 0;
|
||||
} catch (err) {
|
||||
error(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdShowCommand extends Command {
|
||||
static override paths = [['agents', 'show']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Display current AGENTS.md content',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const agentsPath = join(process.cwd(), 'AGENTS.md');
|
||||
|
||||
if (!existsSync(agentsPath)) {
|
||||
warn('No AGENTS.md found. Run `skillkit agents init` to create one.');
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(readFileSync(agentsPath, 'utf-8'));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -1,8 +1,7 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import { promises as fs } from 'fs';
|
||||
import chalk from 'chalk';
|
||||
import ora from 'ora';
|
||||
import { colors, spinner } from '../onboarding/index.js';
|
||||
import {
|
||||
type SearchableSkill,
|
||||
type SkillExample,
|
||||
@@ -88,7 +87,7 @@ export class AICommand extends Command {
|
||||
const providerName = manager.getProviderName();
|
||||
if (providerName === 'mock') {
|
||||
console.log(
|
||||
chalk.yellow(
|
||||
colors.warning(
|
||||
'⚠ Using mock AI provider (limited functionality)\n' +
|
||||
' Set ANTHROPIC_API_KEY or OPENAI_API_KEY for real AI features\n'
|
||||
)
|
||||
@@ -110,7 +109,7 @@ export class AICommand extends Command {
|
||||
return this.handleProviders();
|
||||
default:
|
||||
console.error(
|
||||
chalk.red(`Unknown subcommand: ${this.subcommand}\n`)
|
||||
colors.error(`Unknown subcommand: ${this.subcommand}\n`)
|
||||
);
|
||||
console.log('Valid subcommands: search, generate, similar, wizard, providers');
|
||||
return 1;
|
||||
@@ -120,19 +119,20 @@ export class AICommand extends Command {
|
||||
private async handleSearch(manager: AIManager): Promise<number> {
|
||||
const query = this.query || this.skillName;
|
||||
if (!query) {
|
||||
console.error(chalk.red('Search query required (--query or positional argument)'));
|
||||
console.error(colors.error('Search query required (--query or positional argument)'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const skills = await this.loadSkills();
|
||||
if (skills.length === 0) {
|
||||
console.log(
|
||||
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
|
||||
colors.warning('No skills found. Run "skillkit recommend --update" first.')
|
||||
);
|
||||
return 0;
|
||||
}
|
||||
|
||||
const spinner = ora('Searching with AI...').start();
|
||||
const s = spinner();
|
||||
s.start('Searching with AI...');
|
||||
|
||||
try {
|
||||
const results = await manager.searchSkills(query, skills, {
|
||||
@@ -143,7 +143,7 @@ export class AICommand extends Command {
|
||||
includeReasoning: !this.json,
|
||||
});
|
||||
|
||||
spinner.stop();
|
||||
s.stop();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(results, null, 2));
|
||||
@@ -151,37 +151,37 @@ export class AICommand extends Command {
|
||||
}
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(chalk.yellow(`No skills found matching "${query}"`));
|
||||
console.log(colors.warning(`No skills found matching "${query}"`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`\nAI Search Results (${results.length} found):\n`));
|
||||
console.log(colors.cyan(`\nAI Search Results (${results.length} found):\n`));
|
||||
|
||||
for (const result of results) {
|
||||
const score = Math.round(result.relevance * 100);
|
||||
const scoreColor =
|
||||
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
|
||||
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
|
||||
|
||||
console.log(
|
||||
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
|
||||
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
|
||||
);
|
||||
|
||||
if (result.skill.description) {
|
||||
console.log(` ${chalk.dim(result.skill.description)}`);
|
||||
console.log(` ${colors.muted(result.skill.description)}`);
|
||||
}
|
||||
|
||||
if (result.reasoning) {
|
||||
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
|
||||
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Search failed');
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Search failed'));
|
||||
console.error(
|
||||
chalk.red(error instanceof Error ? error.message : String(error))
|
||||
colors.error(err instanceof Error ? err.message : String(err))
|
||||
);
|
||||
return 1;
|
||||
}
|
||||
@@ -190,7 +190,7 @@ export class AICommand extends Command {
|
||||
private async handleGenerate(manager: AIManager): Promise<number> {
|
||||
const description = this.description;
|
||||
if (!description) {
|
||||
console.error(chalk.red('Description required (--description)'));
|
||||
console.error(colors.error('Description required (--description)'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -201,7 +201,7 @@ export class AICommand extends Command {
|
||||
const code = await fs.readFile(codePath, 'utf-8');
|
||||
codeExamples = [code];
|
||||
} catch {
|
||||
console.error(chalk.red(`Failed to read code file: ${codePath}`));
|
||||
console.error(colors.error(`Failed to read code file: ${codePath}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
@@ -213,7 +213,8 @@ export class AICommand extends Command {
|
||||
targetAgent: this.targetAgent,
|
||||
};
|
||||
|
||||
const spinner = ora('Generating skill with AI...').start();
|
||||
const s = spinner();
|
||||
s.start('Generating skill with AI...');
|
||||
|
||||
try {
|
||||
const generated = await manager.generateSkill(example, {
|
||||
@@ -222,13 +223,13 @@ export class AICommand extends Command {
|
||||
includeDocumentation: true,
|
||||
});
|
||||
|
||||
spinner.stop();
|
||||
s.stop();
|
||||
|
||||
const validation = manager.validateGenerated(generated);
|
||||
if (!validation.valid) {
|
||||
console.log(chalk.yellow('\n⚠ Generated skill has validation warnings:'));
|
||||
for (const error of validation.errors) {
|
||||
console.log(chalk.dim(` • ${error}`));
|
||||
console.log(colors.warning('\n⚠ Generated skill has validation warnings:'));
|
||||
for (const err of validation.errors) {
|
||||
console.log(colors.muted(` • ${err}`));
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
@@ -238,41 +239,41 @@ export class AICommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.green('\n✓ Generated skill successfully\n'));
|
||||
console.log(chalk.cyan('Name:') + ` ${generated.name}`);
|
||||
console.log(chalk.cyan('Description:') + ` ${generated.description}`);
|
||||
console.log(colors.success('\n✓ Generated skill successfully\n'));
|
||||
console.log(colors.cyan('Name:') + ` ${generated.name}`);
|
||||
console.log(colors.cyan('Description:') + ` ${generated.description}`);
|
||||
console.log(
|
||||
chalk.cyan('Tags:') + ` ${generated.tags.join(', ')}`
|
||||
colors.cyan('Tags:') + ` ${generated.tags.join(', ')}`
|
||||
);
|
||||
console.log(
|
||||
chalk.cyan('Confidence:') +
|
||||
colors.cyan('Confidence:') +
|
||||
` ${Math.round(generated.confidence * 100)}%`
|
||||
);
|
||||
|
||||
if (generated.reasoning) {
|
||||
console.log(chalk.cyan('Reasoning:') + ` ${generated.reasoning}`);
|
||||
console.log(colors.cyan('Reasoning:') + ` ${generated.reasoning}`);
|
||||
}
|
||||
|
||||
console.log('\n' + chalk.dim('Content:'));
|
||||
console.log(chalk.dim('─'.repeat(60)));
|
||||
console.log('\n' + colors.muted('Content:'));
|
||||
console.log(colors.muted('─'.repeat(60)));
|
||||
console.log(generated.content);
|
||||
console.log(chalk.dim('─'.repeat(60)));
|
||||
console.log(colors.muted('─'.repeat(60)));
|
||||
|
||||
if (this.output) {
|
||||
const outputPath = resolve(this.output);
|
||||
await fs.writeFile(outputPath, generated.content, 'utf-8');
|
||||
console.log(chalk.green(`\n✓ Saved to: ${outputPath}`));
|
||||
console.log(colors.success(`\n✓ Saved to: ${outputPath}`));
|
||||
} else {
|
||||
console.log(
|
||||
chalk.dim('\nSave with: --output <filename>')
|
||||
colors.muted('\nSave with: --output <filename>')
|
||||
);
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Generation failed');
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Generation failed'));
|
||||
console.error(
|
||||
chalk.red(error instanceof Error ? error.message : String(error))
|
||||
colors.error(err instanceof Error ? err.message : String(err))
|
||||
);
|
||||
return 1;
|
||||
}
|
||||
@@ -281,14 +282,14 @@ export class AICommand extends Command {
|
||||
private async handleSimilar(manager: AIManager): Promise<number> {
|
||||
const skillName = this.skillName;
|
||||
if (!skillName) {
|
||||
console.error(chalk.red('Skill name required'));
|
||||
console.error(colors.error('Skill name required'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const skills = await this.loadSkills();
|
||||
if (skills.length === 0) {
|
||||
console.log(
|
||||
chalk.yellow('No skills found. Run "skillkit recommend --update" first.')
|
||||
colors.warning('No skills found. Run "skillkit recommend --update" first.')
|
||||
);
|
||||
return 0;
|
||||
}
|
||||
@@ -298,11 +299,12 @@ export class AICommand extends Command {
|
||||
);
|
||||
|
||||
if (!targetSkill) {
|
||||
console.error(chalk.red(`Skill not found: ${skillName}`));
|
||||
console.error(colors.error(`Skill not found: ${skillName}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const spinner = ora('Finding similar skills...').start();
|
||||
const s = spinner();
|
||||
s.start('Finding similar skills...');
|
||||
|
||||
try {
|
||||
const results = await manager.findSimilar(targetSkill, skills, {
|
||||
@@ -313,7 +315,7 @@ export class AICommand extends Command {
|
||||
includeReasoning: !this.json,
|
||||
});
|
||||
|
||||
spinner.stop();
|
||||
s.stop();
|
||||
|
||||
if (this.json) {
|
||||
console.log(JSON.stringify(results, null, 2));
|
||||
@@ -322,40 +324,40 @@ export class AICommand extends Command {
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(
|
||||
chalk.yellow(`No similar skills found for "${skillName}"`)
|
||||
colors.warning(`No similar skills found for "${skillName}"`)
|
||||
);
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(
|
||||
chalk.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
|
||||
colors.cyan(`\nSkills similar to "${skillName}" (${results.length} found):\n`)
|
||||
);
|
||||
|
||||
for (const result of results) {
|
||||
const score = Math.round(result.relevance * 100);
|
||||
const scoreColor =
|
||||
score >= 70 ? chalk.green : score >= 50 ? chalk.yellow : chalk.dim;
|
||||
score >= 70 ? colors.success : score >= 50 ? colors.warning : colors.muted;
|
||||
|
||||
console.log(
|
||||
` ${scoreColor(`${score}%`)} ${chalk.bold(result.skill.name)}`
|
||||
` ${scoreColor(`${score}%`)} ${colors.bold(result.skill.name)}`
|
||||
);
|
||||
|
||||
if (result.skill.description) {
|
||||
console.log(` ${chalk.dim(result.skill.description)}`);
|
||||
console.log(` ${colors.muted(result.skill.description)}`);
|
||||
}
|
||||
|
||||
if (result.reasoning) {
|
||||
console.log(` ${chalk.dim('→ ' + result.reasoning)}`);
|
||||
console.log(` ${colors.muted('→ ' + result.reasoning)}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
}
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
spinner.fail('Search failed');
|
||||
} catch (err) {
|
||||
s.stop(colors.error('Search failed'));
|
||||
console.error(
|
||||
chalk.red(error instanceof Error ? error.message : String(error))
|
||||
colors.error(err instanceof Error ? err.message : String(err))
|
||||
);
|
||||
return 1;
|
||||
}
|
||||
@@ -377,8 +379,8 @@ export class AICommand extends Command {
|
||||
}
|
||||
|
||||
private async handleWizard(): Promise<number> {
|
||||
console.log(chalk.cyan('\nLaunching Smart Generate Wizard...\n'));
|
||||
console.log(chalk.dim('For the full wizard experience, use: skillkit generate\n'));
|
||||
console.log(colors.cyan('\nLaunching Smart Generate Wizard...\n'));
|
||||
console.log(colors.muted('For the full wizard experience, use: skillkit generate\n'));
|
||||
|
||||
const { GenerateCommand } = await import('./generate.js');
|
||||
const generateCmd = new GenerateCommand();
|
||||
@@ -389,31 +391,31 @@ export class AICommand extends Command {
|
||||
const detected = detectProviders();
|
||||
const defaultProvider = getDefaultProvider();
|
||||
|
||||
console.log(chalk.cyan('\nAvailable LLM Providers:\n'));
|
||||
console.log(colors.cyan('\nAvailable LLM Providers:\n'));
|
||||
|
||||
for (const provider of detected) {
|
||||
const isDefault = provider.provider === defaultProvider;
|
||||
const status = provider.configured
|
||||
? chalk.green('✓ Configured')
|
||||
: chalk.dim('○ Not configured');
|
||||
const defaultBadge = isDefault ? chalk.yellow(' (default)') : '';
|
||||
? colors.success('✓ Configured')
|
||||
: colors.muted('○ Not configured');
|
||||
const defaultBadge = isDefault ? colors.warning(' (default)') : '';
|
||||
|
||||
console.log(` ${provider.displayName}${defaultBadge}`);
|
||||
console.log(` ${status}`);
|
||||
if (provider.envVar) {
|
||||
console.log(` ${chalk.dim(`Set ${provider.envVar} to configure`)}`);
|
||||
console.log(` ${colors.muted(`Set ${provider.envVar} to configure`)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (defaultProvider === 'mock') {
|
||||
console.log(` Mock Provider${chalk.yellow(' (default)')}`);
|
||||
console.log(` ${chalk.green('✓ Always available')}`);
|
||||
console.log(` ${chalk.dim('Basic functionality without API keys')}`);
|
||||
console.log(` Mock Provider${colors.warning(' (default)')}`);
|
||||
console.log(` ${colors.success('✓ Always available')}`);
|
||||
console.log(` ${colors.muted('Basic functionality without API keys')}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Use "skillkit generate --provider <name>" to use a specific provider\n'));
|
||||
console.log(colors.muted('Use "skillkit generate --provider <name>" to use a specific provider\n'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -2,7 +2,7 @@ import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import { promises as fs } from 'fs';
|
||||
import path from 'path';
|
||||
import chalk from 'chalk';
|
||||
import { colors, warn, success } from '../onboarding/index.js';
|
||||
import { AuditLogger, type AuditQuery, type AuditEventType } from '@skillkit/core';
|
||||
|
||||
export class AuditCommand extends Command {
|
||||
@@ -104,7 +104,7 @@ export class AuditCommand extends Command {
|
||||
case 'clear':
|
||||
return await this.handleClear(logger);
|
||||
default:
|
||||
console.error(chalk.red(`Unknown subcommand: ${this.subcommand}\n`));
|
||||
console.error(colors.error(`Unknown subcommand: ${this.subcommand}\n`));
|
||||
console.log('Valid subcommands: log, export, stats, clear');
|
||||
return 1;
|
||||
}
|
||||
@@ -123,37 +123,37 @@ export class AuditCommand extends Command {
|
||||
}
|
||||
|
||||
if (events.length === 0) {
|
||||
console.log(chalk.yellow('No audit events found'));
|
||||
warn('No audit events found');
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`\nAudit Log (${events.length} entries):\n`));
|
||||
console.log(colors.cyan(`\nAudit Log (${events.length} entries):\n`));
|
||||
|
||||
for (const event of events) {
|
||||
const statusIcon = event.success ? chalk.green('✓') : chalk.red('✗');
|
||||
const statusIcon = event.success ? colors.success('✓') : colors.error('✗');
|
||||
const timestamp = event.timestamp.toLocaleString();
|
||||
|
||||
console.log(
|
||||
`${statusIcon} ${chalk.dim(timestamp)} ${chalk.bold(event.type)}`
|
||||
`${statusIcon} ${colors.muted(timestamp)} ${colors.bold(event.type)}`
|
||||
);
|
||||
console.log(
|
||||
` ${event.action} on ${chalk.cyan(event.resource)}`
|
||||
` ${event.action} on ${colors.cyan(event.resource)}`
|
||||
);
|
||||
|
||||
if (event.user) {
|
||||
console.log(` ${chalk.dim('User:')} ${event.user}`);
|
||||
console.log(` ${colors.muted('User:')} ${event.user}`);
|
||||
}
|
||||
|
||||
if (event.duration) {
|
||||
console.log(` ${chalk.dim('Duration:')} ${event.duration}ms`);
|
||||
console.log(` ${colors.muted('Duration:')} ${event.duration}ms`);
|
||||
}
|
||||
|
||||
if (event.error) {
|
||||
console.log(` ${chalk.red('Error:')} ${event.error}`);
|
||||
console.log(` ${colors.error('Error:')} ${event.error}`);
|
||||
}
|
||||
|
||||
if (event.details && Object.keys(event.details).length > 0) {
|
||||
console.log(` ${chalk.dim('Details:')} ${JSON.stringify(event.details)}`);
|
||||
console.log(` ${colors.muted('Details:')} ${JSON.stringify(event.details)}`);
|
||||
}
|
||||
|
||||
console.log();
|
||||
@@ -171,7 +171,7 @@ export class AuditCommand extends Command {
|
||||
if (this.output) {
|
||||
const outputPath = resolve(this.output);
|
||||
await fs.writeFile(outputPath, content, 'utf-8');
|
||||
console.log(chalk.green(`✓ Exported audit log to: ${outputPath}`));
|
||||
success(`✓ Exported audit log to: ${outputPath}`);
|
||||
} else {
|
||||
console.log(content);
|
||||
}
|
||||
@@ -187,14 +187,14 @@ export class AuditCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('\nAudit Statistics:\n'));
|
||||
console.log(`Total Events: ${chalk.bold(stats.totalEvents.toString())}`);
|
||||
console.log(colors.cyan('\nAudit Statistics:\n'));
|
||||
console.log(`Total Events: ${colors.bold(stats.totalEvents.toString())}`);
|
||||
console.log(
|
||||
`Success Rate: ${chalk.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
|
||||
`Success Rate: ${colors.bold(`${(stats.successRate * 100).toFixed(1)}%`)}`
|
||||
);
|
||||
|
||||
if (Object.keys(stats.eventsByType).length > 0) {
|
||||
console.log(chalk.cyan('\nEvents by Type:'));
|
||||
console.log(colors.cyan('\nEvents by Type:'));
|
||||
const sorted = Object.entries(stats.eventsByType).sort(
|
||||
([, a], [, b]) => b - a
|
||||
);
|
||||
@@ -204,21 +204,21 @@ export class AuditCommand extends Command {
|
||||
}
|
||||
|
||||
if (stats.topResources.length > 0) {
|
||||
console.log(chalk.cyan('\nTop Resources:'));
|
||||
console.log(colors.cyan('\nTop Resources:'));
|
||||
for (const { resource, count } of stats.topResources) {
|
||||
console.log(` ${resource.padEnd(40)} ${count}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (stats.recentErrors.length > 0) {
|
||||
console.log(chalk.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
|
||||
for (const error of stats.recentErrors.slice(0, 5)) {
|
||||
const timestamp = error.timestamp.toLocaleString();
|
||||
console.log(colors.cyan(`\nRecent Errors (${stats.recentErrors.length}):`));
|
||||
for (const err of stats.recentErrors.slice(0, 5)) {
|
||||
const timestamp = err.timestamp.toLocaleString();
|
||||
console.log(
|
||||
` ${chalk.red('✗')} ${chalk.dim(timestamp)} ${error.type}`
|
||||
` ${colors.error('✗')} ${colors.muted(timestamp)} ${err.type}`
|
||||
);
|
||||
if (error.error) {
|
||||
console.log(` ${chalk.dim(error.error)}`);
|
||||
if (err.error) {
|
||||
console.log(` ${colors.muted(err.error)}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -229,7 +229,7 @@ export class AuditCommand extends Command {
|
||||
|
||||
private async handleClear(logger: AuditLogger): Promise<number> {
|
||||
if (!this.days) {
|
||||
console.error(chalk.red('--days option required'));
|
||||
console.error(colors.error('--days option required'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -239,11 +239,7 @@ export class AuditCommand extends Command {
|
||||
|
||||
const cleared = await logger.clear(cutoffDate);
|
||||
|
||||
console.log(
|
||||
chalk.green(
|
||||
`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`
|
||||
)
|
||||
);
|
||||
success(`✓ Cleared ${cleared} audit entries older than ${daysAgo} days`);
|
||||
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
|
||||
@@ -247,7 +247,7 @@ export class CICDCommand extends Command {
|
||||
? ['github', 'gitlab', 'circleci']
|
||||
: [this.provider as CICDProvider];
|
||||
|
||||
console.log(chalk.cyan('Initializing CI/CD workflows...'));
|
||||
console.log(colors.cyan('Initializing CI/CD workflows...'));
|
||||
console.log();
|
||||
|
||||
let success = true;
|
||||
@@ -256,29 +256,29 @@ export class CICDCommand extends Command {
|
||||
for (const provider of providers) {
|
||||
const result = this.createWorkflow(projectPath, provider);
|
||||
if (result.skipped) {
|
||||
console.log(chalk.yellow(` ${result.message}`));
|
||||
console.log(colors.warning(` ${result.message}`));
|
||||
continue;
|
||||
}
|
||||
if (!result.success) {
|
||||
success = false;
|
||||
console.error(chalk.red(` ${result.message}`));
|
||||
console.error(colors.error(` ${result.message}`));
|
||||
continue;
|
||||
}
|
||||
created = true;
|
||||
console.log(chalk.green(` ✓ ${result.message}`));
|
||||
console.log(colors.success(` ✓ ${result.message}`));
|
||||
}
|
||||
|
||||
if (success) {
|
||||
console.log();
|
||||
console.log(
|
||||
created
|
||||
? chalk.green('CI/CD workflows initialized successfully!')
|
||||
: chalk.yellow('CI/CD workflows already exist; nothing to do.')
|
||||
? colors.success('CI/CD workflows initialized successfully!')
|
||||
: colors.warning('CI/CD workflows already exist; nothing to do.')
|
||||
);
|
||||
console.log();
|
||||
if (created) {
|
||||
console.log(chalk.dim('The workflows will run on push/PR to validate your skills.'));
|
||||
console.log(chalk.dim('Commit the generated files to enable CI/CD.'));
|
||||
console.log(colors.muted('The workflows will run on push/PR to validate your skills.'));
|
||||
console.log(colors.muted('Commit the generated files to enable CI/CD.'));
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { resolve } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import {
|
||||
type AgentType,
|
||||
type ProjectContext,
|
||||
@@ -103,8 +103,8 @@ export class ContextCommand extends Command {
|
||||
case 'agents':
|
||||
return this.listAgents();
|
||||
default:
|
||||
console.error(chalk.red(`Unknown action: ${action}`));
|
||||
console.log(chalk.gray('Available actions: init, show, export, import, sync, detect, agents'));
|
||||
console.error(colors.error(`Unknown action: ${action}`));
|
||||
console.log(colors.muted('Available actions: init, show, export, import, sync, detect, agents'));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
@@ -116,16 +116,16 @@ export class ContextCommand extends Command {
|
||||
const manager = new ContextManager(process.cwd());
|
||||
|
||||
if (manager.exists() && !this.force) {
|
||||
console.log(chalk.yellow('Context already exists. Use --force to reinitialize.'));
|
||||
console.log(colors.warning('Context already exists. Use --force to reinitialize.'));
|
||||
return this.showContext();
|
||||
}
|
||||
|
||||
console.log(chalk.cyan('Initializing project context...\n'));
|
||||
console.log(colors.cyan('Initializing project context...\n'));
|
||||
|
||||
const context = manager.init({ force: this.force });
|
||||
|
||||
console.log(chalk.green('✓ Context initialized\n'));
|
||||
console.log(chalk.gray(` Location: .skillkit/context.yaml\n`));
|
||||
console.log(colors.success('✓ Context initialized\n'));
|
||||
console.log(colors.muted(` Location: .skillkit/context.yaml\n`));
|
||||
|
||||
// Show summary
|
||||
this.printContextSummary(context);
|
||||
@@ -134,9 +134,9 @@ export class ContextCommand extends Command {
|
||||
const sync = createContextSync(process.cwd());
|
||||
const detected = sync.detectAgents();
|
||||
if (detected.length > 0) {
|
||||
console.log(chalk.cyan('\nDetected agents:'));
|
||||
console.log(colors.cyan('\nDetected agents:'));
|
||||
for (const agent of detected) {
|
||||
console.log(` ${chalk.green('•')} ${agent}`);
|
||||
console.log(` ${colors.success('•')} ${agent}`);
|
||||
}
|
||||
|
||||
// Update context with detected agents
|
||||
@@ -146,7 +146,7 @@ export class ContextCommand extends Command {
|
||||
});
|
||||
}
|
||||
|
||||
console.log(chalk.gray('\nRun `skillkit context sync` to sync skills to all agents.'));
|
||||
console.log(colors.muted('\nRun `skillkit context sync` to sync skills to all agents.'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -159,7 +159,7 @@ export class ContextCommand extends Command {
|
||||
const context = manager.load();
|
||||
|
||||
if (!context) {
|
||||
console.log(chalk.yellow('No context found. Run `skillkit context init` first.'));
|
||||
console.log(colors.warning('No context found. Run `skillkit context init` first.'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -171,8 +171,8 @@ export class ContextCommand extends Command {
|
||||
this.printContextSummary(context);
|
||||
|
||||
if (this.verbose) {
|
||||
console.log(chalk.gray('\nFull context:'));
|
||||
console.log(chalk.gray(JSON.stringify(context, null, 2)));
|
||||
console.log(colors.muted('\nFull context:'));
|
||||
console.log(colors.muted(JSON.stringify(context, null, 2)));
|
||||
}
|
||||
|
||||
return 0;
|
||||
@@ -186,7 +186,7 @@ export class ContextCommand extends Command {
|
||||
const context = manager.get();
|
||||
|
||||
if (!context) {
|
||||
console.error(chalk.red('No context found. Run `skillkit context init` first.'));
|
||||
console.error(colors.error('No context found. Run `skillkit context init` first.'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -200,12 +200,12 @@ export class ContextCommand extends Command {
|
||||
if (this.output) {
|
||||
const outputPath = resolve(this.output);
|
||||
if (existsSync(outputPath) && !this.force) {
|
||||
console.error(chalk.red(`File exists: ${outputPath}. Use --force to overwrite.`));
|
||||
console.error(colors.error(`File exists: ${outputPath}. Use --force to overwrite.`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
writeFileSync(outputPath, content, 'utf-8');
|
||||
console.log(chalk.green(`✓ Context exported to ${outputPath}`));
|
||||
console.log(colors.success(`✓ Context exported to ${outputPath}`));
|
||||
} else {
|
||||
// Print to stdout
|
||||
console.log(content);
|
||||
@@ -219,13 +219,13 @@ export class ContextCommand extends Command {
|
||||
*/
|
||||
private async importContext(): Promise<number> {
|
||||
if (!this.input) {
|
||||
console.error(chalk.red('Error: --input/-i file path is required'));
|
||||
console.error(colors.error('Error: --input/-i file path is required'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const inputPath = resolve(this.input);
|
||||
if (!existsSync(inputPath)) {
|
||||
console.error(chalk.red(`File not found: ${inputPath}`));
|
||||
console.error(colors.error(`File not found: ${inputPath}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -238,11 +238,11 @@ export class ContextCommand extends Command {
|
||||
overwrite: this.force,
|
||||
});
|
||||
|
||||
console.log(chalk.green('✓ Context imported successfully'));
|
||||
console.log(colors.success('✓ Context imported successfully'));
|
||||
this.printContextSummary(context);
|
||||
return 0;
|
||||
} catch (error) {
|
||||
console.error(chalk.red(`Import failed: ${error}`));
|
||||
console.error(colors.error(`Import failed: ${error}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
@@ -255,13 +255,13 @@ export class ContextCommand extends Command {
|
||||
const context = manager.get();
|
||||
|
||||
if (!context) {
|
||||
console.log(chalk.yellow('No context found. Initializing...'));
|
||||
console.log(colors.warning('No context found. Initializing...'));
|
||||
manager.init();
|
||||
}
|
||||
|
||||
const sync = createContextSync(process.cwd());
|
||||
|
||||
console.log(chalk.cyan('Syncing skills across agents...\n'));
|
||||
console.log(colors.cyan('Syncing skills across agents...\n'));
|
||||
|
||||
// Determine target agents
|
||||
const agents = this.agent ? [this.agent as AgentType] : undefined;
|
||||
@@ -274,33 +274,33 @@ export class ContextCommand extends Command {
|
||||
|
||||
// Print results
|
||||
for (const result of report.results) {
|
||||
const status = result.success ? chalk.green('✓') : chalk.red('✗');
|
||||
const status = result.success ? colors.success('✓') : colors.error('✗');
|
||||
console.log(`${status} ${result.agent}: ${result.skillsSynced} synced, ${result.skillsSkipped} skipped`);
|
||||
|
||||
if (this.verbose && result.files.length > 0) {
|
||||
for (const file of result.files) {
|
||||
console.log(chalk.gray(` → ${file}`));
|
||||
console.log(colors.muted(` → ${file}`));
|
||||
}
|
||||
}
|
||||
|
||||
if (result.warnings.length > 0) {
|
||||
for (const warning of result.warnings) {
|
||||
console.log(chalk.yellow(` ⚠ ${warning}`));
|
||||
console.log(colors.warning(` ⚠ ${warning}`));
|
||||
}
|
||||
}
|
||||
|
||||
if (result.errors.length > 0) {
|
||||
for (const error of result.errors) {
|
||||
console.log(chalk.red(` ✗ ${error}`));
|
||||
console.log(colors.error(` ✗ ${error}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
|
||||
console.log(colors.bold(`Summary: ${report.successfulAgents}/${report.totalAgents} agents, ${report.totalSkills} skills`));
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.gray('\n(Dry run - no files were written)'));
|
||||
console.log(colors.muted('\n(Dry run - no files were written)'));
|
||||
}
|
||||
|
||||
return report.successfulAgents === report.totalAgents ? 0 : 1;
|
||||
@@ -310,86 +310,86 @@ export class ContextCommand extends Command {
|
||||
* Detect project stack
|
||||
*/
|
||||
private async detectProject(): Promise<number> {
|
||||
console.log(chalk.cyan('Analyzing project...\n'));
|
||||
console.log(colors.cyan('Analyzing project...\n'));
|
||||
|
||||
const stack = analyzeProject(process.cwd());
|
||||
const tags = getStackTags(stack);
|
||||
|
||||
// Languages
|
||||
if (stack.languages.length > 0) {
|
||||
console.log(chalk.bold('Languages:'));
|
||||
console.log(colors.bold('Languages:'));
|
||||
for (const lang of stack.languages) {
|
||||
const version = lang.version ? ` (${lang.version})` : '';
|
||||
console.log(` ${chalk.green('•')} ${lang.name}${version}`);
|
||||
console.log(` ${colors.success('•')} ${lang.name}${version}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Frameworks
|
||||
if (stack.frameworks.length > 0) {
|
||||
console.log(chalk.bold('Frameworks:'));
|
||||
console.log(colors.bold('Frameworks:'));
|
||||
for (const fw of stack.frameworks) {
|
||||
const version = fw.version ? ` (${fw.version})` : '';
|
||||
console.log(` ${chalk.green('•')} ${fw.name}${version}`);
|
||||
console.log(` ${colors.success('•')} ${fw.name}${version}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Libraries
|
||||
if (stack.libraries.length > 0) {
|
||||
console.log(chalk.bold('Libraries:'));
|
||||
console.log(colors.bold('Libraries:'));
|
||||
for (const lib of stack.libraries) {
|
||||
const version = lib.version ? ` (${lib.version})` : '';
|
||||
console.log(` ${chalk.green('•')} ${lib.name}${version}`);
|
||||
console.log(` ${colors.success('•')} ${lib.name}${version}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Styling
|
||||
if (stack.styling.length > 0) {
|
||||
console.log(chalk.bold('Styling:'));
|
||||
console.log(colors.bold('Styling:'));
|
||||
for (const style of stack.styling) {
|
||||
console.log(` ${chalk.green('•')} ${style.name}`);
|
||||
console.log(` ${colors.success('•')} ${style.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Testing
|
||||
if (stack.testing.length > 0) {
|
||||
console.log(chalk.bold('Testing:'));
|
||||
console.log(colors.bold('Testing:'));
|
||||
for (const test of stack.testing) {
|
||||
console.log(` ${chalk.green('•')} ${test.name}`);
|
||||
console.log(` ${colors.success('•')} ${test.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Databases
|
||||
if (stack.databases.length > 0) {
|
||||
console.log(chalk.bold('Databases:'));
|
||||
console.log(colors.bold('Databases:'));
|
||||
for (const db of stack.databases) {
|
||||
console.log(` ${chalk.green('•')} ${db.name}`);
|
||||
console.log(` ${colors.success('•')} ${db.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Tools
|
||||
if (stack.tools.length > 0) {
|
||||
console.log(chalk.bold('Tools:'));
|
||||
console.log(colors.bold('Tools:'));
|
||||
for (const tool of stack.tools) {
|
||||
console.log(` ${chalk.green('•')} ${tool.name}`);
|
||||
console.log(` ${colors.success('•')} ${tool.name}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
// Tags
|
||||
if (tags.length > 0) {
|
||||
console.log(chalk.bold('Recommended skill tags:'));
|
||||
console.log(` ${chalk.cyan(tags.join(', '))}`);
|
||||
console.log(colors.bold('Recommended skill tags:'));
|
||||
console.log(` ${colors.cyan(tags.join(', '))}`);
|
||||
console.log();
|
||||
}
|
||||
|
||||
if (this.json) {
|
||||
console.log(chalk.gray('\nJSON:'));
|
||||
console.log(colors.muted('\nJSON:'));
|
||||
console.log(JSON.stringify(stack, null, 2));
|
||||
}
|
||||
|
||||
@@ -405,27 +405,27 @@ export class ContextCommand extends Command {
|
||||
const status = sync.checkStatus();
|
||||
const adapters = getAllAdapters();
|
||||
|
||||
console.log(chalk.bold('\nAgent Status:\n'));
|
||||
console.log(colors.bold('\nAgent Status:\n'));
|
||||
|
||||
for (const [agent, info] of Object.entries(status)) {
|
||||
const adapter = adapters.find(a => a.type === agent);
|
||||
const name = adapter?.name || agent;
|
||||
const isDetected = detected.includes(agent as AgentType);
|
||||
|
||||
const statusIcon = info.hasSkills ? chalk.green('●') : isDetected ? chalk.yellow('○') : chalk.gray('○');
|
||||
const skillInfo = info.skillCount > 0 ? chalk.gray(` (${info.skillCount} skills)`) : '';
|
||||
const statusIcon = info.hasSkills ? colors.success('●') : isDetected ? colors.warning('○') : colors.muted('○');
|
||||
const skillInfo = info.skillCount > 0 ? colors.muted(` (${info.skillCount} skills)`) : '';
|
||||
|
||||
console.log(` ${statusIcon} ${name.padEnd(20)} ${chalk.gray(agent)}${skillInfo}`);
|
||||
console.log(` ${statusIcon} ${name.padEnd(20)} ${colors.muted(agent)}${skillInfo}`);
|
||||
|
||||
if (this.verbose && info.skills.length > 0) {
|
||||
for (const skill of info.skills) {
|
||||
console.log(chalk.gray(` └─ ${skill}`));
|
||||
console.log(colors.muted(` └─ ${skill}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log();
|
||||
console.log(chalk.gray('Legend: ● has skills, ○ detected/configured, ○ not detected'));
|
||||
console.log(colors.muted('Legend: ● has skills, ○ detected/configured, ○ not detected'));
|
||||
console.log();
|
||||
|
||||
return 0;
|
||||
@@ -435,8 +435,8 @@ export class ContextCommand extends Command {
|
||||
* Print context summary
|
||||
*/
|
||||
private printContextSummary(context: ProjectContext): void {
|
||||
console.log(chalk.bold('Project:'));
|
||||
console.log(` Name: ${chalk.cyan(context.project.name)}`);
|
||||
console.log(colors.bold('Project:'));
|
||||
console.log(` Name: ${colors.cyan(context.project.name)}`);
|
||||
if (context.project.type) {
|
||||
console.log(` Type: ${context.project.type}`);
|
||||
}
|
||||
@@ -460,32 +460,30 @@ export class ContextCommand extends Command {
|
||||
}
|
||||
|
||||
if (stackItems.length > 0) {
|
||||
console.log(`\n${chalk.bold('Stack:')} ${stackItems.join(', ')}`);
|
||||
console.log(`\n${colors.bold('Stack:')} ${stackItems.join(', ')}`);
|
||||
|
||||
// Show top items
|
||||
const topFrameworks = context.stack.frameworks.slice(0, 3).map(f => f.name);
|
||||
if (topFrameworks.length > 0) {
|
||||
console.log(` Frameworks: ${chalk.cyan(topFrameworks.join(', '))}`);
|
||||
console.log(` Frameworks: ${colors.cyan(topFrameworks.join(', '))}`);
|
||||
}
|
||||
|
||||
const topLibs = context.stack.libraries.slice(0, 3).map(l => l.name);
|
||||
if (topLibs.length > 0) {
|
||||
console.log(` Libraries: ${chalk.cyan(topLibs.join(', '))}`);
|
||||
console.log(` Libraries: ${colors.cyan(topLibs.join(', '))}`);
|
||||
}
|
||||
}
|
||||
|
||||
// Skills summary
|
||||
if (context.skills) {
|
||||
console.log(`\n${chalk.bold('Skills:')}`);
|
||||
console.log(`\n${colors.bold('Skills:')}`);
|
||||
console.log(` Installed: ${context.skills.installed?.length || 0}`);
|
||||
console.log(` Auto-sync: ${context.skills.autoSync ? 'enabled' : 'disabled'}`);
|
||||
}
|
||||
|
||||
// Agents summary
|
||||
if (context.agents) {
|
||||
console.log(`\n${chalk.bold('Agents:')}`);
|
||||
console.log(`\n${colors.bold('Agents:')}`);
|
||||
if (context.agents.primary) {
|
||||
console.log(` Primary: ${chalk.cyan(context.agents.primary)}`);
|
||||
console.log(` Primary: ${colors.cyan(context.agents.primary)}`);
|
||||
}
|
||||
if (context.agents.synced?.length) {
|
||||
console.log(` Synced: ${context.agents.synced.join(', ')}`);
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { colors, success, error, step } from '../onboarding/index.js';
|
||||
import { Command, Option } from 'clipanion';
|
||||
|
||||
export class CreateCommand extends Command {
|
||||
@@ -41,8 +41,8 @@ export class CreateCommand extends Command {
|
||||
const skillName = this.name.toLowerCase();
|
||||
|
||||
if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
|
||||
console.error(chalk.red('Invalid skill name'));
|
||||
console.error(chalk.dim('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
|
||||
error('Invalid skill name');
|
||||
console.log(colors.muted('Must be lowercase alphanumeric with hyphens (e.g., my-skill)'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -50,7 +50,7 @@ export class CreateCommand extends Command {
|
||||
const skillDir = join(parentDir, skillName);
|
||||
|
||||
if (existsSync(skillDir)) {
|
||||
console.error(chalk.red(`Directory already exists: ${skillDir}`));
|
||||
error(`Directory already exists: ${skillDir}`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -78,24 +78,24 @@ export class CreateCommand extends Command {
|
||||
writeFileSync(join(assetsDir, '.gitkeep'), '');
|
||||
}
|
||||
|
||||
console.log(chalk.green(`Created skill: ${skillName}`));
|
||||
success(`Created skill: ${skillName}`);
|
||||
console.log();
|
||||
console.log(chalk.dim('Structure:'));
|
||||
console.log(chalk.dim(` ${skillDir}/`));
|
||||
console.log(chalk.dim(' ├── SKILL.md'));
|
||||
if (this.full || this.references) console.log(chalk.dim(' ├── references/'));
|
||||
if (this.full || this.scripts) console.log(chalk.dim(' ├── scripts/'));
|
||||
if (this.full || this.assets) console.log(chalk.dim(' └── assets/'));
|
||||
console.log(colors.muted('Structure:'));
|
||||
console.log(colors.muted(` ${skillDir}/`));
|
||||
console.log(colors.muted(' ├── SKILL.md'));
|
||||
if (this.full || this.references) console.log(colors.muted(' ├── references/'));
|
||||
if (this.full || this.scripts) console.log(colors.muted(' ├── scripts/'));
|
||||
if (this.full || this.assets) console.log(colors.muted(' └── assets/'));
|
||||
console.log();
|
||||
console.log(chalk.cyan('Next steps:'));
|
||||
console.log(chalk.dim(' 1. Edit SKILL.md with your instructions'));
|
||||
console.log(chalk.dim(' 2. Validate: skillkit validate ' + skillDir));
|
||||
console.log(chalk.dim(' 3. Test: skillkit read ' + skillName));
|
||||
step('Next steps:');
|
||||
console.log(colors.muted(' 1. Edit SKILL.md with your instructions'));
|
||||
console.log(colors.muted(' 2. Validate: skillkit validate ' + skillDir));
|
||||
console.log(colors.muted(' 3. Test: skillkit read ' + skillName));
|
||||
|
||||
return 0;
|
||||
} catch (error) {
|
||||
console.error(chalk.red('Failed to create skill'));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
} catch (err) {
|
||||
error('Failed to create skill');
|
||||
console.log(colors.muted(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,297 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { execFileSync } from 'node:child_process';
|
||||
import { existsSync, lstatSync, readlinkSync, readdirSync, mkdirSync, unlinkSync } from 'node:fs';
|
||||
import { resolve, join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import { detectAgent, getAdapter } from '@skillkit/agents';
|
||||
import { AgentType, findAllSkills, validateSkill, loadConfig, getProjectConfigPath, getGlobalSkillsDir } from '@skillkit/core';
|
||||
import type { AgentType as AgentTypeT } from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
import { colors, symbols } from '../onboarding/index.js';
|
||||
|
||||
interface CheckResult {
|
||||
name: string;
|
||||
status: 'pass' | 'warn' | 'fail';
|
||||
message: string;
|
||||
fix?: string;
|
||||
}
|
||||
|
||||
export class DoctorCommand extends Command {
|
||||
static override paths = [['doctor']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Diagnose setup issues and check environment health',
|
||||
details: `
|
||||
Runs a series of checks to verify your SkillKit setup is correct,
|
||||
including environment, agent detection, skills health, and configuration.
|
||||
`,
|
||||
examples: [
|
||||
['Run health checks', '$0 doctor'],
|
||||
['JSON output', '$0 doctor --json'],
|
||||
['Auto-fix issues', '$0 doctor --fix'],
|
||||
],
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output in JSON format',
|
||||
});
|
||||
|
||||
fix = Option.Boolean('--fix', false, {
|
||||
description: 'Auto-fix issues where possible',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const results: CheckResult[] = [];
|
||||
|
||||
// --- Environment ---
|
||||
const nodeVersion = process.version;
|
||||
const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0], 10);
|
||||
if (nodeMajor >= 18) {
|
||||
results.push({ name: 'Node.js version', status: 'pass', message: `Node.js ${nodeVersion}` });
|
||||
} else {
|
||||
results.push({ name: 'Node.js version', status: 'fail', message: `Node.js ${nodeVersion} — upgrade to >=18 required` });
|
||||
}
|
||||
|
||||
const npmVersion = this.whichVersion('npm');
|
||||
if (npmVersion) {
|
||||
results.push({ name: 'npm available', status: 'pass', message: `npm v${npmVersion}` });
|
||||
} else {
|
||||
results.push({ name: 'npm available', status: 'warn', message: 'npm not found' });
|
||||
}
|
||||
|
||||
const pnpmVersion = this.whichVersion('pnpm');
|
||||
if (pnpmVersion) {
|
||||
results.push({ name: 'pnpm available', status: 'pass', message: `pnpm v${pnpmVersion}` });
|
||||
}
|
||||
|
||||
const skillkitVersion = this.cli.binaryVersion ?? 'unknown';
|
||||
results.push({ name: 'SkillKit version', status: 'pass', message: `skillkit v${skillkitVersion}` });
|
||||
|
||||
// --- Configuration ---
|
||||
const configPath = getProjectConfigPath();
|
||||
const hasConfig = existsSync(configPath);
|
||||
if (hasConfig) {
|
||||
try {
|
||||
const agent = loadConfig().agent;
|
||||
results.push({ name: 'Config file', status: 'pass', message: `skillkit.yaml (agent: ${agent})` });
|
||||
} catch {
|
||||
results.push({ name: 'Config file', status: 'warn', message: 'skillkit.yaml found but has parse errors' });
|
||||
}
|
||||
} else {
|
||||
results.push({ name: 'Config file', status: 'warn', message: 'No config file (using defaults)' });
|
||||
}
|
||||
|
||||
// --- Agent Detection ---
|
||||
let detectedAgent: AgentTypeT = 'universal';
|
||||
try {
|
||||
detectedAgent = await detectAgent();
|
||||
results.push({ name: 'Detected agent', status: 'pass', message: `Detected: ${detectedAgent}` });
|
||||
} catch {
|
||||
results.push({ name: 'Detected agent', status: 'warn', message: 'No agent detected (using universal)' });
|
||||
}
|
||||
|
||||
const otherDetected: string[] = [];
|
||||
try {
|
||||
for (const agentType of AgentType.options) {
|
||||
if (agentType === detectedAgent || agentType === 'universal') continue;
|
||||
try {
|
||||
const agentAdapter = getAdapter(agentType);
|
||||
if (await agentAdapter.isDetected()) {
|
||||
otherDetected.push(agentType);
|
||||
}
|
||||
} catch {
|
||||
// skip
|
||||
}
|
||||
}
|
||||
if (otherDetected.length > 0) {
|
||||
results.push({ name: 'Other agents', status: 'warn', message: `Also detected: ${otherDetected.join(', ')}` });
|
||||
}
|
||||
} catch {
|
||||
// skip
|
||||
}
|
||||
|
||||
// --- Skills ---
|
||||
const adapter = getAdapter(detectedAgent);
|
||||
const skillsDir = resolve(adapter.skillsDir);
|
||||
const skillsDirExists = existsSync(skillsDir);
|
||||
|
||||
if (skillsDirExists) {
|
||||
const entries = readdirSync(skillsDir).filter(e => !e.startsWith('.'));
|
||||
results.push({ name: 'Project skills dir', status: 'pass', message: `${adapter.skillsDir} (${entries.length} entries)` });
|
||||
} else {
|
||||
if (this.fix) {
|
||||
mkdirSync(skillsDir, { recursive: true });
|
||||
results.push({ name: 'Project skills dir', status: 'pass', message: `${adapter.skillsDir} (created)` });
|
||||
} else {
|
||||
results.push({
|
||||
name: 'Project skills dir',
|
||||
status: 'warn',
|
||||
message: `${adapter.skillsDir} missing`,
|
||||
fix: 'Run with --fix to create it',
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
const globalSkillsDirRaw = getGlobalSkillsDir(detectedAgent);
|
||||
const globalSkillsDir = globalSkillsDirRaw ? globalSkillsDirRaw.replace(/^~/, homedir()) : null;
|
||||
if (globalSkillsDir && existsSync(globalSkillsDir)) {
|
||||
const entries = readdirSync(globalSkillsDir).filter(e => !e.startsWith('.'));
|
||||
results.push({ name: 'Global skills dir', status: 'pass', message: `${globalSkillsDir} (${entries.length} entries)` });
|
||||
} else {
|
||||
results.push({ name: 'Global skills dir', status: 'pass', message: 'No global skills directory' });
|
||||
}
|
||||
|
||||
// Skill validation
|
||||
let searchDirs: string[] = [];
|
||||
try {
|
||||
searchDirs = getSearchDirs(detectedAgent);
|
||||
} catch {
|
||||
searchDirs = skillsDirExists ? [skillsDir] : [];
|
||||
}
|
||||
|
||||
const allSkills = findAllSkills(searchDirs);
|
||||
const invalidSkills: string[] = [];
|
||||
|
||||
for (const skill of allSkills) {
|
||||
const validation = validateSkill(skill.path);
|
||||
if (!validation.valid) {
|
||||
invalidSkills.push(`${skill.name}: ${validation.errors.join(', ')}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (allSkills.length === 0) {
|
||||
results.push({ name: 'Installed skills', status: 'pass', message: 'No skills installed' });
|
||||
} else if (invalidSkills.length === 0) {
|
||||
results.push({ name: 'Installed skills', status: 'pass', message: `${allSkills.length} skills, all valid` });
|
||||
} else {
|
||||
results.push({
|
||||
name: 'Installed skills',
|
||||
status: 'fail',
|
||||
message: `${invalidSkills.length} of ${allSkills.length} skills have errors`,
|
||||
fix: invalidSkills.join('; '),
|
||||
});
|
||||
}
|
||||
|
||||
// Broken symlinks
|
||||
const brokenSymlinks: string[] = [];
|
||||
for (const dir of searchDirs) {
|
||||
if (!existsSync(dir)) continue;
|
||||
try {
|
||||
const entries = readdirSync(dir);
|
||||
for (const entry of entries) {
|
||||
const fullPath = join(dir, entry);
|
||||
try {
|
||||
const stat = lstatSync(fullPath);
|
||||
if (stat.isSymbolicLink()) {
|
||||
const target = readlinkSync(fullPath);
|
||||
const resolvedTarget = resolve(dir, target);
|
||||
if (!existsSync(resolvedTarget)) {
|
||||
brokenSymlinks.push(fullPath);
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// skip
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// skip
|
||||
}
|
||||
}
|
||||
|
||||
if (brokenSymlinks.length > 0) {
|
||||
if (this.fix) {
|
||||
let removed = 0;
|
||||
const failed: string[] = [];
|
||||
for (const link of brokenSymlinks) {
|
||||
try {
|
||||
unlinkSync(link);
|
||||
removed++;
|
||||
} catch {
|
||||
failed.push(link);
|
||||
}
|
||||
}
|
||||
if (failed.length > 0) {
|
||||
results.push({ name: 'Broken symlinks', status: 'warn', message: `Removed ${removed}, failed to remove ${failed.length}` });
|
||||
} else {
|
||||
results.push({ name: 'Broken symlinks', status: 'pass', message: `Removed ${brokenSymlinks.length} broken symlink(s)` });
|
||||
}
|
||||
} else {
|
||||
results.push({
|
||||
name: 'Broken symlinks',
|
||||
status: 'fail',
|
||||
message: `${brokenSymlinks.length} broken symlink(s) found`,
|
||||
fix: brokenSymlinks.map(l => ` ${l}`).join('\n'),
|
||||
});
|
||||
}
|
||||
} else {
|
||||
results.push({ name: 'Broken symlinks', status: 'pass', message: 'No broken symlinks' });
|
||||
}
|
||||
|
||||
// --- Output ---
|
||||
if (this.json) {
|
||||
const summary = {
|
||||
checks: results,
|
||||
passed: results.filter(r => r.status === 'pass').length,
|
||||
warnings: results.filter(r => r.status === 'warn').length,
|
||||
errors: results.filter(r => r.status === 'fail').length,
|
||||
};
|
||||
console.log(JSON.stringify(summary, null, 2));
|
||||
return summary.errors > 0 ? 1 : 0;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.primary('skillkit doctor'));
|
||||
console.log('');
|
||||
|
||||
const sections: Record<string, string[]> = {
|
||||
Environment: ['Node.js version', 'npm available', 'pnpm available', 'SkillKit version'],
|
||||
Configuration: ['Config file', 'Detected agent', 'Other agents'],
|
||||
Skills: ['Project skills dir', 'Global skills dir', 'Installed skills', 'Broken symlinks'],
|
||||
};
|
||||
|
||||
for (const [section, checkNames] of Object.entries(sections)) {
|
||||
const sectionResults = results.filter(r => checkNames.includes(r.name));
|
||||
if (sectionResults.length === 0) continue;
|
||||
|
||||
console.log(` ${colors.primary(section)}`);
|
||||
for (const result of sectionResults) {
|
||||
const icon = this.statusIcon(result.status);
|
||||
console.log(` ${icon} ${result.message}`);
|
||||
if (result.fix && result.status !== 'pass') {
|
||||
console.log(` ${colors.muted(result.fix)}`);
|
||||
}
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
|
||||
const passed = results.filter(r => r.status === 'pass').length;
|
||||
const warnings = results.filter(r => r.status === 'warn').length;
|
||||
const errors = results.filter(r => r.status === 'fail').length;
|
||||
|
||||
const parts = [`${passed} passed`];
|
||||
if (warnings > 0) parts.push(`${warnings} warning(s)`);
|
||||
if (errors > 0) parts.push(`${errors} error(s)`);
|
||||
console.log(` ${colors.muted('Summary:')} ${parts.join(', ')}`);
|
||||
console.log('');
|
||||
|
||||
return errors > 0 ? 1 : 0;
|
||||
}
|
||||
|
||||
private statusIcon(status: CheckResult['status']): string {
|
||||
switch (status) {
|
||||
case 'pass': return colors.success(symbols.success);
|
||||
case 'warn': return colors.warning(symbols.warning);
|
||||
case 'fail': return colors.error(symbols.error);
|
||||
}
|
||||
}
|
||||
|
||||
private whichVersion(cmd: string): string | null {
|
||||
try {
|
||||
return execFileSync(cmd, ['--version'], { encoding: 'utf-8', timeout: 5000 })
|
||||
.trim()
|
||||
.replace(/^v/, '');
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,4 +1,4 @@
|
||||
import chalk from 'chalk';
|
||||
import { colors, warn, success, error } from '../onboarding/index.js';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { setSkillEnabled, findSkill } from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
@@ -18,36 +18,36 @@ export class EnableCommand extends Command {
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
let success = 0;
|
||||
let successCount = 0;
|
||||
let failed = 0;
|
||||
|
||||
for (const skillName of this.skills) {
|
||||
const skill = findSkill(skillName, searchDirs);
|
||||
|
||||
if (!skill) {
|
||||
console.log(chalk.red(`Skill not found: ${skillName}`));
|
||||
error(`Skill not found: ${skillName}`);
|
||||
failed++;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (skill.enabled) {
|
||||
console.log(chalk.dim(`Already enabled: ${skillName}`));
|
||||
console.log(colors.muted(`Already enabled: ${skillName}`));
|
||||
continue;
|
||||
}
|
||||
|
||||
const result = setSkillEnabled(skill.path, true);
|
||||
|
||||
if (result) {
|
||||
console.log(chalk.green(`Enabled: ${skillName}`));
|
||||
success++;
|
||||
success(`Enabled: ${skillName}`);
|
||||
successCount++;
|
||||
} else {
|
||||
console.log(chalk.red(`Failed to enable: ${skillName}`));
|
||||
error(`Failed to enable: ${skillName}`);
|
||||
failed++;
|
||||
}
|
||||
}
|
||||
|
||||
if (success > 0) {
|
||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
||||
if (successCount > 0) {
|
||||
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
|
||||
}
|
||||
|
||||
return failed > 0 ? 1 : 0;
|
||||
@@ -69,36 +69,36 @@ export class DisableCommand extends Command {
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const searchDirs = getSearchDirs();
|
||||
let success = 0;
|
||||
let successCount = 0;
|
||||
let failed = 0;
|
||||
|
||||
for (const skillName of this.skills) {
|
||||
const skill = findSkill(skillName, searchDirs);
|
||||
|
||||
if (!skill) {
|
||||
console.log(chalk.red(`Skill not found: ${skillName}`));
|
||||
error(`Skill not found: ${skillName}`);
|
||||
failed++;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (!skill.enabled) {
|
||||
console.log(chalk.dim(`Already disabled: ${skillName}`));
|
||||
console.log(colors.muted(`Already disabled: ${skillName}`));
|
||||
continue;
|
||||
}
|
||||
|
||||
const result = setSkillEnabled(skill.path, false);
|
||||
|
||||
if (result) {
|
||||
console.log(chalk.yellow(`Disabled: ${skillName}`));
|
||||
success++;
|
||||
warn(`Disabled: ${skillName}`);
|
||||
successCount++;
|
||||
} else {
|
||||
console.log(chalk.red(`Failed to disable: ${skillName}`));
|
||||
error(`Failed to disable: ${skillName}`);
|
||||
failed++;
|
||||
}
|
||||
}
|
||||
|
||||
if (success > 0) {
|
||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
||||
if (successCount > 0) {
|
||||
console.log(colors.muted('\nRun `skillkit sync` to update your agent config'));
|
||||
}
|
||||
|
||||
return failed > 0 ? 1 : 0;
|
||||
|
||||
@@ -0,0 +1,149 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { resolve } from 'node:path';
|
||||
import { existsSync } from 'node:fs';
|
||||
import {
|
||||
createEvalEngine,
|
||||
formatEvalResult,
|
||||
LLMQualityEvaluator,
|
||||
ContradictionEvaluator,
|
||||
BehavioralSecurityEvaluator,
|
||||
SandboxEvaluator,
|
||||
DynamicBenchmarkEvaluator,
|
||||
CommunitySignalsEvaluator,
|
||||
} from '@skillkit/core';
|
||||
import type { EvalTier, EvalOptions } from '@skillkit/core';
|
||||
|
||||
export class EvalCommand extends Command {
|
||||
static override paths = [['eval']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Evaluate a skill with multi-tier analysis (LLM quality, contradictions, security, benchmarks)',
|
||||
details: `
|
||||
Runs a comprehensive evaluation engine across up to 6 tiers:
|
||||
Tier 1: LLM-based quality scoring (G-Eval pattern)
|
||||
Tier 2: Contradiction detection (formal + semantic)
|
||||
Tier 3: Behavioral security analysis (AST + taint + LLM)
|
||||
Tier 4: Sandbox execution testing (Docker)
|
||||
Tier 5: Dynamic marketplace benchmarks
|
||||
Tier 6: Community signals (GitHub, installs, freshness)
|
||||
|
||||
Works without API keys (heuristic fallback for Tier 1, Tiers 5-6 always available).
|
||||
Configure a provider for full LLM-powered evaluation.
|
||||
`,
|
||||
examples: [
|
||||
['Evaluate a skill', '$0 eval ./my-skill'],
|
||||
['Run specific tiers', '$0 eval ./my-skill --tier 1,2,3'],
|
||||
['Use Anthropic provider', '$0 eval ./my-skill --provider anthropic'],
|
||||
['JSON output', '$0 eval ./my-skill --format json'],
|
||||
['Set minimum score', '$0 eval ./my-skill --min-score 70'],
|
||||
['Verbose output', '$0 eval ./my-skill --verbose'],
|
||||
],
|
||||
});
|
||||
|
||||
skillPath = Option.String({ required: true, name: 'path' });
|
||||
|
||||
tier = Option.String('--tier,-t', {
|
||||
description: 'Comma-separated tier numbers to run (1-6). Default: 1,2,3,5,6',
|
||||
});
|
||||
|
||||
provider = Option.String('--provider,-p', {
|
||||
description: 'LLM provider: anthropic, openai, google, ollama, openrouter',
|
||||
});
|
||||
|
||||
model = Option.String('--model,-m', {
|
||||
description: 'Model name to use with the provider',
|
||||
});
|
||||
|
||||
format = Option.String('--format,-f', 'summary', {
|
||||
description: 'Output format: summary, json, table',
|
||||
});
|
||||
|
||||
verbose = Option.Boolean('--verbose,-v', false, {
|
||||
description: 'Show detailed output for each tier',
|
||||
});
|
||||
|
||||
minScore = Option.String('--min-score', {
|
||||
description: 'Exit with code 1 if overall score is below this threshold',
|
||||
});
|
||||
|
||||
sandboxImage = Option.String('--sandbox-image', {
|
||||
description: 'Docker image for sandbox testing (Tier 4)',
|
||||
});
|
||||
|
||||
timeout = Option.String('--timeout', {
|
||||
description: 'Timeout in seconds for each tier',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const targetPath = resolve(this.skillPath);
|
||||
|
||||
if (!existsSync(targetPath)) {
|
||||
this.context.stderr.write(`Path not found: ${targetPath}\n`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
const validFormats = ['summary', 'json', 'table'];
|
||||
if (!validFormats.includes(this.format)) {
|
||||
this.context.stderr.write(`Invalid format: "${this.format}". Must be one of: ${validFormats.join(', ')}\n`);
|
||||
return 1;
|
||||
}
|
||||
|
||||
let tiers: EvalTier[] | undefined;
|
||||
if (this.tier) {
|
||||
tiers = this.tier.split(',').map((s) => {
|
||||
const n = parseInt(s.trim(), 10);
|
||||
if (isNaN(n) || n < 1 || n > 6) {
|
||||
return null;
|
||||
}
|
||||
return n as EvalTier;
|
||||
}).filter((n): n is EvalTier => n !== null);
|
||||
if (tiers.length === 0) {
|
||||
this.context.stderr.write(`Invalid --tier value: "${this.tier}". Must be comma-separated numbers 1-6.\n`);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
if (this.minScore) {
|
||||
const threshold = parseInt(this.minScore, 10);
|
||||
if (isNaN(threshold)) {
|
||||
this.context.stderr.write(`Invalid --min-score value: "${this.minScore}". Must be a number.\n`);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
const parsedTimeout = this.timeout ? parseInt(this.timeout, 10) : NaN;
|
||||
|
||||
const options: EvalOptions = {
|
||||
tiers,
|
||||
provider: this.provider,
|
||||
model: this.model,
|
||||
format: this.format as 'summary' | 'json' | 'table',
|
||||
verbose: this.verbose,
|
||||
sandboxImage: this.sandboxImage,
|
||||
timeout: !isNaN(parsedTimeout) ? parsedTimeout : undefined,
|
||||
};
|
||||
|
||||
const engine = createEvalEngine();
|
||||
|
||||
engine.registerEvaluator(new LLMQualityEvaluator());
|
||||
engine.registerEvaluator(new ContradictionEvaluator());
|
||||
engine.registerEvaluator(new BehavioralSecurityEvaluator());
|
||||
engine.registerEvaluator(new SandboxEvaluator());
|
||||
engine.registerEvaluator(new DynamicBenchmarkEvaluator());
|
||||
engine.registerEvaluator(new CommunitySignalsEvaluator());
|
||||
|
||||
const result = await engine.evaluate(targetPath, options);
|
||||
|
||||
this.context.stdout.write(formatEvalResult(result, this.format) + '\n');
|
||||
|
||||
if (this.minScore) {
|
||||
const threshold = parseInt(this.minScore, 10);
|
||||
if (result.overallScore < threshold) {
|
||||
this.context.stderr.write(`Score ${result.overallScore} is below minimum ${threshold}\n`);
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -1,4 +1,4 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { Command, Option } from "clipanion";
|
||||
import {
|
||||
colors,
|
||||
symbols,
|
||||
@@ -7,8 +7,13 @@ import {
|
||||
isCancel,
|
||||
select,
|
||||
header,
|
||||
} from '../onboarding/index.js';
|
||||
import { FederatedSearch, GitHubSkillRegistry, RateLimitError } from '@skillkit/core';
|
||||
} from "../onboarding/index.js";
|
||||
import {
|
||||
FederatedSearch,
|
||||
GitHubSkillRegistry,
|
||||
SkillsShRegistry,
|
||||
} from "@skillkit/core";
|
||||
import { formatCount } from "../helpers.js";
|
||||
|
||||
interface SkillResult {
|
||||
name: string;
|
||||
@@ -17,46 +22,46 @@ interface SkillResult {
|
||||
repoName: string;
|
||||
}
|
||||
|
||||
import skillsData from '../../../../marketplace/skills.json' with { type: 'json' };
|
||||
import sourcesData from '../../../../marketplace/sources.json' with { type: 'json' };
|
||||
import skillsData from "../../../../marketplace/skills.json" with { type: "json" };
|
||||
import sourcesData from "../../../../marketplace/sources.json" with { type: "json" };
|
||||
|
||||
export class FindCommand extends Command {
|
||||
static override paths = [['find'], ['search']];
|
||||
static override paths = [["find"], ["search"]];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Search for skills in the marketplace',
|
||||
description: "Search for skills in the marketplace",
|
||||
details: `
|
||||
Quickly find and install skills from the marketplace.
|
||||
Interactive mode lets you browse and install in one step.
|
||||
`,
|
||||
examples: [
|
||||
['Interactive search', '$0 find'],
|
||||
['Search for specific skill', '$0 find pdf'],
|
||||
['Search with keyword', '$0 find "nextjs"'],
|
||||
['List top skills', '$0 find --top'],
|
||||
["Interactive search", "$0 find"],
|
||||
["Search for specific skill", "$0 find pdf"],
|
||||
["Search with keyword", '$0 find "nextjs"'],
|
||||
["List top skills", "$0 find --top"],
|
||||
],
|
||||
});
|
||||
|
||||
query = Option.String({ required: false });
|
||||
|
||||
top = Option.Boolean('--top,-t', false, {
|
||||
description: 'Show top/featured skills',
|
||||
top = Option.Boolean("--top,-t", false, {
|
||||
description: "Show top/featured skills",
|
||||
});
|
||||
|
||||
limit = Option.String('--limit,-l', '10', {
|
||||
description: 'Maximum results to show',
|
||||
limit = Option.String("--limit,-l", "10", {
|
||||
description: "Maximum results to show",
|
||||
});
|
||||
|
||||
install = Option.Boolean('--install,-i', false, {
|
||||
description: 'Prompt to install after finding',
|
||||
install = Option.Boolean("--install,-i", false, {
|
||||
description: "Prompt to install after finding",
|
||||
});
|
||||
|
||||
quiet = Option.Boolean('--quiet,-q', false, {
|
||||
description: 'Minimal output (just list skills)',
|
||||
quiet = Option.Boolean("--quiet,-q", false, {
|
||||
description: "Minimal output (just list skills)",
|
||||
});
|
||||
|
||||
federated = Option.Boolean('--federated,-f', false, {
|
||||
description: 'Search external registries (GitHub SKILL.md files)',
|
||||
federated = Option.Boolean("--federated,-f", false, {
|
||||
description: "Search external registries (GitHub SKILL.md files)",
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
@@ -64,17 +69,25 @@ export class FindCommand extends Command {
|
||||
const limit = parseInt(this.limit, 10) || 10;
|
||||
|
||||
if (!this.quiet) {
|
||||
header('Find Skills');
|
||||
header("Find Skills");
|
||||
}
|
||||
|
||||
const allSkills: SkillResult[] = (skillsData.skills || []).map((skill: { name: string; description?: string; source?: string; repo?: string }) => ({
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
source: skill.source || '',
|
||||
repoName: skill.repo || skill.source?.split('/').pop() || '',
|
||||
}));
|
||||
const allSkills: SkillResult[] = (skillsData.skills || []).map(
|
||||
(skill: {
|
||||
name: string;
|
||||
description?: string;
|
||||
source?: string;
|
||||
repo?: string;
|
||||
}) => ({
|
||||
name: skill.name,
|
||||
description: skill.description,
|
||||
source: skill.source || "",
|
||||
repoName: skill.repo || skill.source?.split("/").pop() || "",
|
||||
}),
|
||||
);
|
||||
|
||||
let results: SkillResult[];
|
||||
let searchTerm: string | undefined;
|
||||
|
||||
if (this.top) {
|
||||
const featured = sourcesData.sources
|
||||
@@ -82,35 +95,43 @@ export class FindCommand extends Command {
|
||||
.slice(0, 5);
|
||||
|
||||
results = allSkills
|
||||
.filter(skill => featured.some((f: { source: string }) => skill.source.includes(f.source)))
|
||||
.filter((skill) =>
|
||||
featured.some((f: { source: string }) =>
|
||||
skill.source.includes(f.source),
|
||||
),
|
||||
)
|
||||
.slice(0, limit);
|
||||
|
||||
if (!this.quiet) {
|
||||
step('Showing featured skills');
|
||||
step("Showing featured skills");
|
||||
}
|
||||
} else if (this.query) {
|
||||
const query = this.query.toLowerCase();
|
||||
searchTerm = this.query;
|
||||
|
||||
s.start('Searching...');
|
||||
s.start("Searching...");
|
||||
|
||||
results = allSkills.filter(skill =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query)
|
||||
).slice(0, limit);
|
||||
results = allSkills
|
||||
.filter(
|
||||
(skill) =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query),
|
||||
)
|
||||
.slice(0, limit);
|
||||
|
||||
s.stop(`Found ${results.length} skill(s)`);
|
||||
} else {
|
||||
if (!this.quiet) {
|
||||
step('Enter a search term or browse featured skills');
|
||||
step("Enter a search term or browse featured skills");
|
||||
}
|
||||
|
||||
const { text } = await import('../onboarding/prompts.js');
|
||||
const { text } = await import("../onboarding/prompts.js");
|
||||
|
||||
const searchResult = await text({
|
||||
message: 'Search skills',
|
||||
placeholder: 'e.g., pdf, nextjs, testing',
|
||||
message: "Search skills",
|
||||
placeholder: "e.g., pdf, nextjs, testing",
|
||||
});
|
||||
|
||||
if (isCancel(searchResult)) {
|
||||
@@ -118,101 +139,163 @@ export class FindCommand extends Command {
|
||||
}
|
||||
|
||||
const query = (searchResult as string).toLowerCase();
|
||||
searchTerm = searchResult as string;
|
||||
|
||||
if (query) {
|
||||
s.start('Searching...');
|
||||
results = allSkills.filter(skill =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query)
|
||||
).slice(0, limit);
|
||||
s.start("Searching...");
|
||||
results = allSkills
|
||||
.filter(
|
||||
(skill) =>
|
||||
skill.name.toLowerCase().includes(query) ||
|
||||
skill.description?.toLowerCase().includes(query) ||
|
||||
skill.source.toLowerCase().includes(query) ||
|
||||
skill.repoName.toLowerCase().includes(query),
|
||||
)
|
||||
.slice(0, limit);
|
||||
s.stop(`Found ${results.length} skill(s)`);
|
||||
} else {
|
||||
results = allSkills.slice(0, limit);
|
||||
}
|
||||
}
|
||||
|
||||
if (this.federated && this.query) {
|
||||
s.start('Searching external registries...');
|
||||
if (searchTerm) {
|
||||
s.start("Searching skills.sh + external registries...");
|
||||
const fedSearch = new FederatedSearch();
|
||||
fedSearch.addRegistry(new GitHubSkillRegistry());
|
||||
fedSearch.addRegistry(new SkillsShRegistry());
|
||||
if (this.federated) {
|
||||
fedSearch.addRegistry(new GitHubSkillRegistry());
|
||||
}
|
||||
try {
|
||||
const fedResult = await fedSearch.search(this.query, { limit: parseInt(this.limit, 10) || 10 });
|
||||
s.stop(`Found ${fedResult.total} external skill(s) from ${fedResult.registries.join(', ') || 'none'}`);
|
||||
const fedResult = await fedSearch.search(searchTerm, {
|
||||
limit: parseInt(this.limit, 10) || 10,
|
||||
});
|
||||
const sourceLabel = fedResult.registries.join(", ") || "none";
|
||||
s.stop(`Found ${fedResult.total} skill(s) from ${sourceLabel}`);
|
||||
|
||||
if (fedResult.skills.length > 0) {
|
||||
console.log('');
|
||||
console.log(colors.bold('External Skills (SKILL.md):'));
|
||||
for (const skill of fedResult.skills) {
|
||||
const stars = typeof skill.stars === 'number' ? colors.muted(` ★${skill.stars}`) : '';
|
||||
const desc = skill.description
|
||||
? colors.muted(` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? '...' : ''}`)
|
||||
: '';
|
||||
console.log(` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${stars}${desc}`);
|
||||
if (!this.quiet) {
|
||||
console.log(` ${colors.muted(skill.source)}`);
|
||||
const skillsShResults = fedResult.skills.filter(
|
||||
(sk) => sk.registry === "skills.sh",
|
||||
);
|
||||
const githubResults = fedResult.skills.filter(
|
||||
(sk) => sk.registry !== "skills.sh",
|
||||
);
|
||||
|
||||
if (skillsShResults.length > 0) {
|
||||
console.log("");
|
||||
console.log(colors.bold("Skills.sh Registry:"));
|
||||
for (const skill of skillsShResults) {
|
||||
const installs =
|
||||
typeof skill.stars === "number" && skill.stars > 0
|
||||
? colors.muted(` ${formatCount(skill.stars)} installs`)
|
||||
: "";
|
||||
const desc = skill.description
|
||||
? colors.muted(
|
||||
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
|
||||
)
|
||||
: "";
|
||||
console.log(
|
||||
` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${installs}${desc}`,
|
||||
);
|
||||
if (!this.quiet) {
|
||||
const installSource = skill.source.replace(
|
||||
"https://github.com/",
|
||||
"",
|
||||
);
|
||||
console.log(
|
||||
` ${colors.muted(`skillkit install skills.sh/${installSource}/${skill.name}`)}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
console.log('');
|
||||
}
|
||||
} catch (err) {
|
||||
if (err instanceof RateLimitError) {
|
||||
s.stop(colors.warning('Rate limited by GitHub API'));
|
||||
console.log(colors.muted('Set GITHUB_TOKEN env var or wait before retrying.'));
|
||||
} else {
|
||||
s.stop(colors.warning('Federated search failed'));
|
||||
|
||||
if (githubResults.length > 0) {
|
||||
console.log("");
|
||||
console.log(colors.bold("GitHub (SKILL.md):"));
|
||||
for (const skill of githubResults) {
|
||||
const stars =
|
||||
typeof skill.stars === "number"
|
||||
? colors.muted(` ★${skill.stars}`)
|
||||
: "";
|
||||
const desc = skill.description
|
||||
? colors.muted(
|
||||
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
|
||||
)
|
||||
: "";
|
||||
console.log(
|
||||
` ${colors.cyan(symbols.bullet)} ${colors.primary(skill.name)}${stars}${desc}`,
|
||||
);
|
||||
if (!this.quiet) {
|
||||
console.log(` ${colors.muted(skill.source)}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log("");
|
||||
}
|
||||
} catch {
|
||||
s.stop(colors.warning("External search unavailable"));
|
||||
}
|
||||
}
|
||||
|
||||
if (results.length === 0) {
|
||||
console.log(colors.muted('No skills found matching your search'));
|
||||
console.log('');
|
||||
console.log(colors.muted('Try:'));
|
||||
console.log(colors.muted(' skillkit find --top # Show featured skills'));
|
||||
console.log(colors.muted(' skillkit find -f <query> # Search external registries'));
|
||||
console.log(colors.muted(' skillkit ui # Browse in TUI'));
|
||||
console.log(colors.muted("No skills found matching your search"));
|
||||
console.log("");
|
||||
console.log(colors.muted("Try:"));
|
||||
console.log(
|
||||
colors.muted(" skillkit find --top # Show featured skills"),
|
||||
);
|
||||
console.log(
|
||||
colors.muted(
|
||||
" skillkit find -f <query> # Also search GitHub SKILL.md files",
|
||||
),
|
||||
);
|
||||
console.log(colors.muted(" skillkit ui # Browse in TUI"));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log("");
|
||||
|
||||
for (const skill of results) {
|
||||
const desc = skill.description
|
||||
? colors.muted(` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? '...' : ''}`)
|
||||
: '';
|
||||
console.log(` ${colors.success(symbols.bullet)} ${colors.primary(skill.name)}${desc}`);
|
||||
? colors.muted(
|
||||
` - ${skill.description.slice(0, 50)}${skill.description.length > 50 ? "..." : ""}`,
|
||||
)
|
||||
: "";
|
||||
console.log(
|
||||
` ${colors.success(symbols.bullet)} ${colors.primary(skill.name)}${desc}`,
|
||||
);
|
||||
if (!this.quiet && skill.source) {
|
||||
console.log(` ${colors.muted(skill.source)}`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
console.log(colors.muted(`Showing ${results.length} of ${allSkills.length} skills`));
|
||||
console.log('');
|
||||
console.log("");
|
||||
console.log(
|
||||
colors.muted(`Showing ${results.length} of ${allSkills.length} skills`),
|
||||
);
|
||||
console.log("");
|
||||
|
||||
if (this.install || (!this.query && !this.top && process.stdin.isTTY)) {
|
||||
const installResult = await select({
|
||||
message: 'Install a skill?',
|
||||
message: "Install a skill?",
|
||||
options: [
|
||||
{ value: 'none', label: 'No, just browsing' },
|
||||
...results.slice(0, 5).map(skill => ({
|
||||
{ value: "none", label: "No, just browsing" },
|
||||
...results.slice(0, 5).map((skill) => ({
|
||||
value: skill.source,
|
||||
label: skill.name,
|
||||
hint: skill.repoName,
|
||||
})),
|
||||
],
|
||||
initialValue: 'none',
|
||||
initialValue: "none",
|
||||
});
|
||||
|
||||
if (!isCancel(installResult) && installResult !== 'none') {
|
||||
console.log('');
|
||||
console.log(colors.cyan('To install, run:'));
|
||||
if (!isCancel(installResult) && installResult !== "none") {
|
||||
console.log("");
|
||||
console.log(colors.cyan("To install, run:"));
|
||||
console.log(` ${colors.bold(`skillkit install ${installResult}`)}`);
|
||||
}
|
||||
} else {
|
||||
console.log(colors.muted('To install: skillkit install <source>'));
|
||||
console.log(colors.muted("To install: skillkit install <source>"));
|
||||
}
|
||||
|
||||
return 0;
|
||||
|
||||
@@ -24,7 +24,7 @@ export class GenerateCommand extends Command {
|
||||
|
||||
- Documentation (Context7)
|
||||
- Local codebase patterns
|
||||
- Marketplace skills (15,000+)
|
||||
- Marketplace skills (400K+)
|
||||
- Memory observations and learnings
|
||||
|
||||
Supports multiple LLM providers: Claude, GPT-4, Gemini, Ollama, OpenRouter
|
||||
@@ -33,7 +33,7 @@ export class GenerateCommand extends Command {
|
||||
['Interactive wizard', '$0 generate'],
|
||||
['Use specific provider', '$0 generate --provider openai'],
|
||||
['Compose from existing skills', '$0 generate --compose "testing patterns for vitest"'],
|
||||
['Target specific agents', '$0 generate --agents claude-code,cursor'],
|
||||
['Target specific agents', '$0 generate --agent claude-code,cursor'],
|
||||
['Skip memory context', '$0 generate --no-memory'],
|
||||
],
|
||||
});
|
||||
@@ -50,7 +50,7 @@ export class GenerateCommand extends Command {
|
||||
description: 'Natural language search to find skills to compose',
|
||||
});
|
||||
|
||||
agents = Option.String('--agents,-a', {
|
||||
agents = Option.String('--agent,--agents,-a', {
|
||||
description: 'Target agents (comma-separated)',
|
||||
});
|
||||
|
||||
@@ -243,7 +243,7 @@ Or use Ollama for local models (no API key needed)`,
|
||||
const sourceOptions = [
|
||||
{ value: 'docs', label: 'Documentation (Context7)', hint: 'Library docs & guides' },
|
||||
{ value: 'codebase', label: 'Codebase (local)', hint: 'Project patterns & configs' },
|
||||
{ value: 'skills', label: 'Marketplace Skills', hint: '15,000+ skills' },
|
||||
{ value: 'skills', label: 'Marketplace Skills', hint: '400K+ skills' },
|
||||
{ value: 'memory', label: 'Memory & Learnings', hint: 'Your corrections & patterns' },
|
||||
];
|
||||
|
||||
@@ -536,6 +536,9 @@ ${trustScore.warnings.length > 0 ? `\nWarnings:\n${trustScore.warnings.map((w) =
|
||||
let targetAgents: string[];
|
||||
|
||||
if (this.agents) {
|
||||
if (process.argv.includes('--agents')) {
|
||||
console.warn('Warning: --agents is deprecated, use --agent instead (--agents will be removed in v2.0)');
|
||||
}
|
||||
targetAgents = this.agents.split(',').map((a) => a.trim());
|
||||
} else {
|
||||
const agentOptions = [
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import {
|
||||
getAllGuidelines,
|
||||
getEnabledGuidelines,
|
||||
@@ -31,7 +31,7 @@ export class GuidelineCommand extends Command {
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
console.log(chalk.cyan('Guideline commands:\n'));
|
||||
console.log(colors.cyan('Guideline commands:\n'));
|
||||
console.log(' guideline list List all guidelines');
|
||||
console.log(' guideline show <id> Show guideline content');
|
||||
console.log(' guideline enable Enable a guideline');
|
||||
@@ -70,7 +70,7 @@ export class GuidelineListCommand extends Command {
|
||||
}
|
||||
|
||||
const title = this.enabled ? 'Enabled Guidelines' : 'All Guidelines';
|
||||
console.log(chalk.cyan(`${title} (${guidelines.length}):\n`));
|
||||
console.log(colors.cyan(`${title} (${guidelines.length}):\n`));
|
||||
|
||||
const byCategory = new Map<GuidelineCategory, Guideline[]>();
|
||||
for (const guideline of guidelines) {
|
||||
@@ -81,22 +81,22 @@ export class GuidelineListCommand extends Command {
|
||||
}
|
||||
|
||||
for (const [category, catGuidelines] of byCategory) {
|
||||
console.log(chalk.blue(` ${formatCategoryName(category)}`));
|
||||
console.log(colors.info(` ${formatCategoryName(category)}`));
|
||||
|
||||
for (const guideline of catGuidelines) {
|
||||
const enabled = isGuidelineEnabled(guideline.id);
|
||||
const status = enabled ? chalk.green('●') : chalk.dim('○');
|
||||
const custom = isBuiltinGuideline(guideline.id) ? '' : chalk.dim(' (custom)');
|
||||
const priority = chalk.dim(`[${guideline.priority}]`);
|
||||
const status = enabled ? colors.success('●') : colors.muted('○');
|
||||
const custom = isBuiltinGuideline(guideline.id) ? '' : colors.muted(' (custom)');
|
||||
const priority = colors.muted(`[${guideline.priority}]`);
|
||||
|
||||
console.log(` ${status} ${chalk.bold(guideline.id)} ${priority}${custom}`);
|
||||
console.log(` ${chalk.dim(guideline.description)}`);
|
||||
console.log(` ${status} ${colors.bold(guideline.id)} ${priority}${custom}`);
|
||||
console.log(` ${colors.muted(guideline.description)}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Enable with: skillkit guideline enable <id>'));
|
||||
console.log(chalk.dim('Show content: skillkit guideline show <id>'));
|
||||
console.log(colors.muted('Enable with: skillkit guideline enable <id>'));
|
||||
console.log(colors.muted('Show content: skillkit guideline show <id>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -116,20 +116,20 @@ export class GuidelineShowCommand extends Command {
|
||||
const guideline = getGuideline(this.id);
|
||||
|
||||
if (!guideline) {
|
||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
||||
console.log(colors.error(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const enabled = isGuidelineEnabled(this.id);
|
||||
const status = enabled ? chalk.green('enabled') : chalk.dim('disabled');
|
||||
const status = enabled ? colors.success('enabled') : colors.muted('disabled');
|
||||
|
||||
console.log(chalk.cyan(`Guideline: ${guideline.name}\n`));
|
||||
console.log(colors.cyan(`Guideline: ${guideline.name}\n`));
|
||||
console.log(`ID: ${guideline.id}`);
|
||||
console.log(`Category: ${guideline.category}`);
|
||||
console.log(`Priority: ${guideline.priority}`);
|
||||
console.log(`Status: ${status}`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Content:'));
|
||||
console.log(colors.bold('Content:'));
|
||||
console.log(guideline.content);
|
||||
|
||||
return 0;
|
||||
@@ -150,11 +150,11 @@ export class GuidelineEnableCommand extends Command {
|
||||
const success = enableGuideline(this.id);
|
||||
|
||||
if (!success) {
|
||||
console.log(chalk.red(`Guideline not found: ${this.id}`));
|
||||
console.log(colors.error(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Enabled guideline: ${this.id}`));
|
||||
console.log(colors.success(`✓ Enabled guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -173,11 +173,11 @@ export class GuidelineDisableCommand extends Command {
|
||||
const success = disableGuideline(this.id);
|
||||
|
||||
if (!success) {
|
||||
console.log(chalk.yellow(`Guideline not found or already disabled: ${this.id}`));
|
||||
console.log(colors.warning(`Guideline not found or already disabled: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Disabled guideline: ${this.id}`));
|
||||
console.log(colors.success(`✓ Disabled guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -216,7 +216,7 @@ export class GuidelineCreateCommand extends Command {
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinGuideline(this.id)) {
|
||||
console.log(chalk.red(`Cannot create: ${this.id} is a built-in guideline`));
|
||||
console.log(colors.error(`Cannot create: ${this.id} is a built-in guideline`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -234,8 +234,8 @@ export class GuidelineCreateCommand extends Command {
|
||||
addCustomGuideline(guideline);
|
||||
enableGuideline(this.id);
|
||||
|
||||
console.log(chalk.green(`✓ Created guideline: ${this.id}`));
|
||||
console.log(chalk.dim('Edit ~/.skillkit/guidelines.yaml to customize content'));
|
||||
console.log(colors.success(`✓ Created guideline: ${this.id}`));
|
||||
console.log(colors.muted('Edit ~/.skillkit/guidelines.yaml to customize content'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -253,18 +253,18 @@ export class GuidelineRemoveCommand extends Command {
|
||||
|
||||
async execute(): Promise<number> {
|
||||
if (isBuiltinGuideline(this.id)) {
|
||||
console.log(chalk.red(`Cannot remove built-in guideline: ${this.id}`));
|
||||
console.log(colors.error(`Cannot remove built-in guideline: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const removed = removeCustomGuideline(this.id);
|
||||
|
||||
if (!removed) {
|
||||
console.log(chalk.yellow(`Guideline not found: ${this.id}`));
|
||||
console.log(colors.warning(`Guideline not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.green(`✓ Removed guideline: ${this.id}`));
|
||||
console.log(colors.success(`✓ Removed guideline: ${this.id}`));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { writeFileSync } from 'node:fs';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import { SessionHandoff } from '@skillkit/core';
|
||||
|
||||
export class SessionHandoffCommand extends Command {
|
||||
static override paths = [['session', 'handoff']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Generate agent-to-agent session handoff document',
|
||||
examples: [
|
||||
['Print handoff to stdout', '$0 session handoff'],
|
||||
['Target agent recommendations', '$0 session handoff --to cursor'],
|
||||
['Save to file', '$0 session handoff --out handoff.md'],
|
||||
['JSON output', '$0 session handoff --json'],
|
||||
],
|
||||
});
|
||||
|
||||
to = Option.String('--to', {
|
||||
description: 'Target agent for recommendations',
|
||||
});
|
||||
|
||||
out = Option.String('--out,-o', {
|
||||
description: 'Save handoff to file',
|
||||
});
|
||||
|
||||
json = Option.Boolean('--json,-j', false, {
|
||||
description: 'Output as JSON',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const handoff = new SessionHandoff(projectPath);
|
||||
|
||||
const doc = handoff.generate({
|
||||
targetAgent: this.to,
|
||||
});
|
||||
|
||||
const output = this.json ? handoff.toJson(doc) : handoff.toMarkdown(doc);
|
||||
|
||||
if (this.out) {
|
||||
try {
|
||||
writeFileSync(this.out, output, 'utf-8');
|
||||
console.log(colors.success(`Handoff saved to ${this.out}`));
|
||||
} catch (error) {
|
||||
console.error(colors.error(`Failed to write file: ${(error as Error).message}`));
|
||||
return 1;
|
||||
}
|
||||
} else {
|
||||
console.log(output);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -5,7 +5,7 @@
|
||||
*/
|
||||
|
||||
import { Command, Option } from 'clipanion';
|
||||
import chalk from 'chalk';
|
||||
import { colors } from '../onboarding/index.js';
|
||||
import { createHookManager, type HookEvent, type InjectionMode } from '@skillkit/core';
|
||||
import {
|
||||
getHookTemplates,
|
||||
@@ -60,12 +60,12 @@ export class HookCommand extends Command {
|
||||
case 'info':
|
||||
return await this.showHookInfo(projectPath);
|
||||
default:
|
||||
this.context.stderr.write(chalk.red(`Unknown action: ${this.action}\n`));
|
||||
this.context.stderr.write(colors.error(`Unknown action: ${this.action}\n`));
|
||||
this.context.stderr.write('Available actions: list, add, remove, enable, disable, generate, info\n');
|
||||
return 1;
|
||||
}
|
||||
} catch (err) {
|
||||
this.context.stderr.write(chalk.red(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
|
||||
this.context.stderr.write(colors.error(`✗ ${err instanceof Error ? err.message : 'Unknown error'}\n`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
@@ -76,11 +76,11 @@ export class HookCommand extends Command {
|
||||
|
||||
if (hooks.length === 0) {
|
||||
this.context.stdout.write('No hooks configured.\n');
|
||||
this.context.stdout.write(chalk.gray('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
|
||||
this.context.stdout.write(colors.muted('Run `skillkit hook add <event> <skill>` to add a hook.\n'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
this.context.stdout.write(chalk.cyan('Configured Hooks:\n\n'));
|
||||
this.context.stdout.write(colors.cyan('Configured Hooks:\n\n'));
|
||||
|
||||
// Group by event
|
||||
const eventGroups = new Map<string, typeof hooks>();
|
||||
@@ -91,15 +91,15 @@ export class HookCommand extends Command {
|
||||
}
|
||||
|
||||
for (const [event, eventHooks] of eventGroups) {
|
||||
this.context.stdout.write(chalk.yellow(`${event}:\n`));
|
||||
this.context.stdout.write(colors.warning(`${event}:\n`));
|
||||
for (const hook of eventHooks) {
|
||||
const status = hook.enabled ? chalk.green('●') : chalk.gray('○');
|
||||
this.context.stdout.write(` ${status} ${chalk.white(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
|
||||
const status = hook.enabled ? colors.success('●') : colors.muted('○');
|
||||
this.context.stdout.write(` ${status} ${colors.primary(hook.id.slice(0, 8))} → ${hook.skills.join(', ')}\n`);
|
||||
if (hook.matcher) {
|
||||
this.context.stdout.write(chalk.gray(` Pattern: ${hook.matcher}\n`));
|
||||
this.context.stdout.write(colors.muted(` Pattern: ${hook.matcher}\n`));
|
||||
}
|
||||
if (this.verbose) {
|
||||
this.context.stdout.write(chalk.gray(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
|
||||
this.context.stdout.write(colors.muted(` Inject: ${hook.inject}, Priority: ${hook.priority || 0}\n`));
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -110,14 +110,14 @@ export class HookCommand extends Command {
|
||||
|
||||
private async addHook(projectPath: string): Promise<number> {
|
||||
if (!this.target) {
|
||||
this.context.stderr.write(chalk.red('Event type required.\n'));
|
||||
this.context.stderr.write(colors.error('Event type required.\n'));
|
||||
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
||||
this.context.stderr.write('Events: session:start, session:end, file:save, file:open, task:start, commit:pre, commit:post, error:occur, test:fail, build:fail\n');
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (!this.skill) {
|
||||
this.context.stderr.write(chalk.red('Skill name required.\n'));
|
||||
this.context.stderr.write(colors.error('Skill name required.\n'));
|
||||
this.context.stderr.write('Usage: skillkit hook add <event> <skill>\n');
|
||||
return 1;
|
||||
}
|
||||
@@ -133,7 +133,7 @@ export class HookCommand extends Command {
|
||||
];
|
||||
|
||||
if (!validEvents.includes(event)) {
|
||||
this.context.stderr.write(chalk.red(`Invalid event: ${this.target}\n`));
|
||||
this.context.stderr.write(colors.error(`Invalid event: ${this.target}\n`));
|
||||
this.context.stderr.write(`Valid events: ${validEvents.join(', ')}\n`);
|
||||
return 1;
|
||||
}
|
||||
@@ -151,7 +151,7 @@ export class HookCommand extends Command {
|
||||
|
||||
manager.save();
|
||||
|
||||
this.context.stdout.write(chalk.green(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
|
||||
this.context.stdout.write(colors.success(`✓ Hook added: ${hook.id.slice(0, 8)}\n`));
|
||||
this.context.stdout.write(` Event: ${event}\n`);
|
||||
this.context.stdout.write(` Skill: ${this.skill}\n`);
|
||||
if (this.pattern) {
|
||||
@@ -163,7 +163,7 @@ export class HookCommand extends Command {
|
||||
|
||||
private async removeHook(projectPath: string): Promise<number> {
|
||||
if (!this.target) {
|
||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
||||
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||
this.context.stderr.write('Usage: skillkit hook remove <hook-id>\n');
|
||||
return 1;
|
||||
}
|
||||
@@ -174,20 +174,20 @@ export class HookCommand extends Command {
|
||||
// Find hook by ID prefix
|
||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||
if (!hook) {
|
||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
||||
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
manager.unregisterHook(hook.id);
|
||||
manager.save();
|
||||
|
||||
this.context.stdout.write(chalk.green(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
|
||||
this.context.stdout.write(colors.success(`✓ Hook removed: ${hook.id.slice(0, 8)}\n`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async enableHook(projectPath: string): Promise<number> {
|
||||
if (!this.target) {
|
||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
||||
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -196,20 +196,20 @@ export class HookCommand extends Command {
|
||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||
|
||||
if (!hook) {
|
||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
||||
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
manager.enableHook(hook.id);
|
||||
manager.save();
|
||||
|
||||
this.context.stdout.write(chalk.green(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
|
||||
this.context.stdout.write(colors.success(`✓ Hook enabled: ${hook.id.slice(0, 8)}\n`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
private async disableHook(projectPath: string): Promise<number> {
|
||||
if (!this.target) {
|
||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
||||
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -218,14 +218,14 @@ export class HookCommand extends Command {
|
||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||
|
||||
if (!hook) {
|
||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
||||
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
manager.disableHook(hook.id);
|
||||
manager.save();
|
||||
|
||||
this.context.stdout.write(chalk.yellow(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
|
||||
this.context.stdout.write(colors.warning(`○ Hook disabled: ${hook.id.slice(0, 8)}\n`));
|
||||
return 0;
|
||||
}
|
||||
|
||||
@@ -241,7 +241,7 @@ export class HookCommand extends Command {
|
||||
const agent = this.agent || 'claude-code';
|
||||
const generated = manager.generateAgentHooks(agent as any);
|
||||
|
||||
this.context.stdout.write(chalk.cyan(`Generated hooks for ${agent}:\n\n`));
|
||||
this.context.stdout.write(colors.cyan(`Generated hooks for ${agent}:\n\n`));
|
||||
|
||||
if (typeof generated === 'string') {
|
||||
this.context.stdout.write(generated);
|
||||
@@ -255,7 +255,7 @@ export class HookCommand extends Command {
|
||||
|
||||
private async showHookInfo(projectPath: string): Promise<number> {
|
||||
if (!this.target) {
|
||||
this.context.stderr.write(chalk.red('Hook ID required.\n'));
|
||||
this.context.stderr.write(colors.error('Hook ID required.\n'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -264,11 +264,11 @@ export class HookCommand extends Command {
|
||||
const hook = hooks.find((h) => h.id.startsWith(this.target!));
|
||||
|
||||
if (!hook) {
|
||||
this.context.stderr.write(chalk.red(`Hook not found: ${this.target}\n`));
|
||||
this.context.stderr.write(colors.error(`Hook not found: ${this.target}\n`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
this.context.stdout.write(chalk.cyan(`\nHook: ${hook.id}\n`));
|
||||
this.context.stdout.write(colors.cyan(`\nHook: ${hook.id}\n`));
|
||||
this.context.stdout.write(`Event: ${hook.event}\n`);
|
||||
this.context.stdout.write(`Skills: ${hook.skills.join(', ')}\n`);
|
||||
this.context.stdout.write(`Enabled: ${hook.enabled ? 'Yes' : 'No'}\n`);
|
||||
@@ -317,7 +317,7 @@ export class HookTemplateListCommand extends Command {
|
||||
return 0;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Hook Templates (${templates.length}):\n`));
|
||||
console.log(colors.cyan(`Hook Templates (${templates.length}):\n`));
|
||||
|
||||
const byCategory = new Map<HookTemplateCategory, HookTemplate[]>();
|
||||
for (const template of templates) {
|
||||
@@ -328,17 +328,17 @@ export class HookTemplateListCommand extends Command {
|
||||
}
|
||||
|
||||
for (const [category, catTemplates] of byCategory) {
|
||||
console.log(chalk.blue(` ${formatCategory(category)}`));
|
||||
console.log(colors.info(` ${formatCategory(category)}`));
|
||||
for (const template of catTemplates) {
|
||||
const blocking = template.blocking ? chalk.yellow(' [blocking]') : '';
|
||||
console.log(` ${chalk.bold(template.id)}${blocking}`);
|
||||
console.log(` ${chalk.dim(template.description)}`);
|
||||
const blocking = template.blocking ? colors.warning(' [blocking]') : '';
|
||||
console.log(` ${colors.bold(template.id)}${blocking}`);
|
||||
console.log(` ${colors.muted(template.description)}`);
|
||||
console.log(` Event: ${template.event}`);
|
||||
}
|
||||
console.log();
|
||||
}
|
||||
|
||||
console.log(chalk.dim('Apply with: skillkit hook template apply <id>'));
|
||||
console.log(colors.muted('Apply with: skillkit hook template apply <id>'));
|
||||
|
||||
return 0;
|
||||
}
|
||||
@@ -361,8 +361,8 @@ export class HookTemplateApplyCommand extends Command {
|
||||
const template = getHookTemplate(this.id);
|
||||
|
||||
if (!template) {
|
||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
||||
console.log(chalk.dim('Run `skillkit hook template list` to see available templates'));
|
||||
console.log(colors.error(`Template not found: ${this.id}`));
|
||||
console.log(colors.muted('Run `skillkit hook template list` to see available templates'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
@@ -385,12 +385,12 @@ export class HookTemplateApplyCommand extends Command {
|
||||
|
||||
manager.save();
|
||||
|
||||
console.log(chalk.green(`✓ Applied template: ${template.name}`));
|
||||
console.log(colors.success(`✓ Applied template: ${template.name}`));
|
||||
console.log(` Hook ID: ${hook.id.slice(0, 8)}`);
|
||||
console.log(` Event: ${template.event}`);
|
||||
console.log(` Command: ${chalk.dim(template.command)}`);
|
||||
console.log(` Command: ${colors.muted(template.command)}`);
|
||||
if (template.blocking) {
|
||||
console.log(chalk.yellow(` Blocking: yes`));
|
||||
console.log(colors.warning(` Blocking: yes`));
|
||||
}
|
||||
|
||||
return 0;
|
||||
@@ -411,11 +411,11 @@ export class HookTemplateShowCommand extends Command {
|
||||
const template = getHookTemplate(this.id);
|
||||
|
||||
if (!template) {
|
||||
console.log(chalk.red(`Template not found: ${this.id}`));
|
||||
console.log(colors.error(`Template not found: ${this.id}`));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(chalk.cyan(`Template: ${template.name}\n`));
|
||||
console.log(colors.cyan(`Template: ${template.name}\n`));
|
||||
console.log(`ID: ${template.id}`);
|
||||
console.log(`Category: ${template.category}`);
|
||||
console.log(`Description: ${template.description}`);
|
||||
@@ -426,7 +426,7 @@ export class HookTemplateShowCommand extends Command {
|
||||
console.log(`Blocking: ${template.blocking ? 'yes' : 'no'}`);
|
||||
console.log(`Timeout: ${template.timeout || 30000}ms`);
|
||||
console.log();
|
||||
console.log(chalk.bold('Command:'));
|
||||
console.log(colors.bold('Command:'));
|
||||
console.log(` ${template.command}`);
|
||||
|
||||
return 0;
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user