mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
Add `skillkit scan <path>` command with 46+ detection rules across 6 threat categories: prompt injection, command injection, data exfiltration, tool abuse, hardcoded secrets, and unicode steganography. - 3 analyzers: static pattern matching, SKILL.md manifest validation, secrets detection - 4 output formats: summary (colored terminal), json, table, sarif (GitHub Code Scanning) - Auto-scan on `skillkit install` (--no-scan to skip, --force to override) - Auto-scan on `skillkit publish` (blocks on HIGH+ findings) - Threat taxonomy with 10 categories and severity levels - False-positive filtering for placeholders, test files, safe patterns - Updated README, CLI docs, website commands, features, and fumadocs
339 lines
11 KiB
Markdown
339 lines
11 KiB
Markdown
<div align="center">
|
|
|
|
<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%">
|
|
</picture>
|
|
|
|
<br/>
|
|
|
|
[](https://www.npmjs.com/package/skillkit)
|
|
[](https://www.npmjs.com/package/skillkit)
|
|
[](https://github.com/rohitg00/skillkit/stargazers)
|
|
[](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
|
|
[](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.**
|
|
|
|
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit)
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
Skills make AI coding agents smarter. But every agent uses a different format:
|
|
|
|
| Agent | Format | Directory |
|
|
|-------|--------|-----------|
|
|
| Claude Code | `SKILL.md` | `.claude/skills/` |
|
|
| Cursor | `.mdc` | `.cursor/skills/` |
|
|
| Copilot | Markdown | `.github/skills/` |
|
|
| Windsurf | Markdown | `.windsurf/skills/` |
|
|
|
|
You end up rewriting the same skill for each agent, or locking into one platform.
|
|
|
|
**SkillKit fixes this.** Install from 15,000+ skills, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 28 more.
|
|
|
|
```bash
|
|
npx skillkit@latest
|
|
```
|
|
|
|
## See It In Action
|
|
|
|
<div align="center">
|
|
|
|
[](https://raw.githubusercontent.com/rohitg00/skillkit/main/docs/video/skillkit.mp4)
|
|
|
|
*Click the image above to watch the full demo*
|
|
|
|
</div>
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
npx skillkit@latest init # Detect agents, create dirs
|
|
skillkit recommend # Get smart suggestions
|
|
skillkit install anthropics/skills # Install from marketplace
|
|
skillkit sync # Deploy to your agents
|
|
```
|
|
|
|
Four commands. Your agents now have skills for PDF processing, code review, and more.
|
|
|
|
## What Can You Do?
|
|
|
|
### Install skills from anywhere
|
|
|
|
```bash
|
|
skillkit install anthropics/skills # GitHub
|
|
skillkit install gitlab:team/skills # GitLab
|
|
skillkit install ./my-local-skills # Local path
|
|
```
|
|
|
|
### Translate between agents
|
|
|
|
Write for Claude, deploy to Cursor:
|
|
|
|
```bash
|
|
skillkit translate my-skill --to cursor
|
|
skillkit translate --all --to windsurf
|
|
```
|
|
|
|
### Get smart recommendations
|
|
|
|
SkillKit reads your project, detects your stack, and suggests relevant skills:
|
|
|
|
```bash
|
|
skillkit recommend
|
|
# 92% vercel-react-best-practices
|
|
# 87% tailwind-v4-patterns
|
|
# 85% nextjs-app-router
|
|
```
|
|
|
|
### Discover skills at runtime
|
|
|
|
Start an API server and let agents find skills on demand:
|
|
|
|
```bash
|
|
skillkit serve
|
|
# Server running at http://localhost:3737
|
|
|
|
curl "http://localhost:3737/search?q=react+performance"
|
|
```
|
|
|
|
Or use MCP for native agent integration:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
|
|
}
|
|
}
|
|
```
|
|
|
|
Or use Python:
|
|
|
|
```bash
|
|
pip install skillkit-client
|
|
```
|
|
|
|
```python
|
|
from skillkit import SkillKitClient
|
|
|
|
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)
|
|
|
|
### Auto-generate agent instructions
|
|
|
|
Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:
|
|
|
|
```bash
|
|
skillkit primer --all-agents
|
|
```
|
|
|
|
### Session memory
|
|
|
|
Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:
|
|
|
|
```bash
|
|
skillkit memory compress
|
|
skillkit memory search "auth patterns"
|
|
skillkit memory export auth-patterns
|
|
```
|
|
|
|
### AI skill generation
|
|
|
|
Generate skills from natural language with multi-source context:
|
|
|
|
```bash
|
|
skillkit generate
|
|
# Interactive wizard with 4 context sources:
|
|
# - Documentation (via Context7)
|
|
# - Your codebase patterns
|
|
# - 15,000+ marketplace skills
|
|
# - Memory (your corrections)
|
|
```
|
|
|
|
Works with any LLM: Claude, GPT-4, Gemini, Ollama (local), or OpenRouter (100+ models). Generates agent-optimized variants with trust scores.
|
|
|
|
### Mesh network
|
|
|
|
Distribute agents across machines with encrypted P2P:
|
|
|
|
```bash
|
|
skillkit mesh init
|
|
skillkit mesh discover
|
|
```
|
|
|
|
### Team collaboration
|
|
|
|
Share skills via a Git-committable `.skills` manifest:
|
|
|
|
```bash
|
|
skillkit manifest init
|
|
skillkit manifest add anthropics/skills
|
|
git commit -m "add team skills"
|
|
```
|
|
|
|
Team members run `skillkit manifest install` and they're in sync.
|
|
|
|
### Interactive TUI
|
|
|
|
```bash
|
|
skillkit ui
|
|
```
|
|
|
|
`h` Home · `m` Marketplace · `r` Recommend · `t` Translate · `i` Installed · `s` Sync · `q` Quit
|
|
|
|

|
|
|
|
## Supported Agents (32)
|
|
|
|
| Agent | Format | Directory |
|
|
|-------|--------|-----------|
|
|
| **Claude Code** | SKILL.md | `.claude/skills/` |
|
|
| **Cursor** | .mdc | `.cursor/skills/` |
|
|
| **Codex** | SKILL.md | `.codex/skills/` |
|
|
| **Gemini CLI** | SKILL.md | `.gemini/skills/` |
|
|
| **OpenCode** | SKILL.md | `.opencode/skills/` |
|
|
| **GitHub Copilot** | Markdown | `.github/skills/` |
|
|
| **Windsurf** | Markdown | `.windsurf/skills/` |
|
|
|
|
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
|
|
|
|
[Full agent details](https://agenstskills.com/docs/agents)
|
|
|
|
## Commands
|
|
|
|
### Core
|
|
|
|
```bash
|
|
skillkit install <source> # Install skills
|
|
skillkit remove <skills> # Remove skills
|
|
skillkit translate <skill> --to # Translate between agents
|
|
skillkit sync # Deploy to agent config
|
|
skillkit recommend # Smart recommendations
|
|
skillkit generate # AI skill generation wizard
|
|
skillkit serve # Start REST API server
|
|
```
|
|
|
|
### Discovery & Security
|
|
|
|
```bash
|
|
skillkit marketplace # Browse skills
|
|
skillkit tree # Hierarchical taxonomy
|
|
skillkit find <query> # Quick search
|
|
skillkit scan <path> # Security scan for skills
|
|
```
|
|
|
|
### Advanced
|
|
|
|
```bash
|
|
skillkit primer --all-agents # Generate agent instructions
|
|
skillkit memory compress # Capture session learnings
|
|
skillkit mesh init # Multi-machine distribution
|
|
skillkit message send # Inter-agent messaging
|
|
skillkit workflow run <name> # Run workflows
|
|
skillkit test # Test skills
|
|
skillkit cicd init # CI/CD templates
|
|
```
|
|
|
|
[Full command reference](https://agenstskills.com/docs/commands)
|
|
|
|
## Creating Skills
|
|
|
|
```bash
|
|
skillkit create my-skill
|
|
```
|
|
|
|
Or manually create a `SKILL.md`:
|
|
|
|
```markdown
|
|
---
|
|
name: my-skill
|
|
description: What this skill does
|
|
license: MIT
|
|
---
|
|
|
|
# My Skill
|
|
|
|
Instructions for the AI agent.
|
|
|
|
## When to Use
|
|
- Scenario 1
|
|
- Scenario 2
|
|
|
|
## Steps
|
|
1. First step
|
|
2. Second step
|
|
```
|
|
|
|
## Programmatic API
|
|
|
|
```typescript
|
|
import { translateSkill, analyzeProject, RecommendationEngine } from 'skillkit';
|
|
|
|
const skill = await translateSkill(content, 'cursor');
|
|
|
|
const profile = await analyzeProject('./my-project');
|
|
const engine = new RecommendationEngine();
|
|
const recs = await engine.recommend(profile);
|
|
```
|
|
|
|
```typescript
|
|
import { startServer } from '@skillkit/api';
|
|
await startServer({ port: 3737, skills: [...] });
|
|
```
|
|
|
|
```typescript
|
|
import { MemoryCache, RelevanceRanker } from '@skillkit/core';
|
|
const cache = new MemoryCache({ maxSize: 500, ttlMs: 86_400_000 });
|
|
const ranker = new RelevanceRanker();
|
|
const results = ranker.rank(skills, 'react performance');
|
|
```
|
|
|
|
## Skill Sources
|
|
|
|
SkillKit aggregates skills from trusted sources. All original creators are credited with their licenses preserved.
|
|
|
|
### Official Partners
|
|
|
|
| Repository | Description |
|
|
|------------|-------------|
|
|
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Code skills |
|
|
| [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Next.js and React skills |
|
|
| [expo/skills](https://github.com/expo/skills) | Mobile development with Expo |
|
|
| [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation |
|
|
| [supabase/agent-skills](https://github.com/supabase/agent-skills) | Database and auth skills |
|
|
| [stripe/ai](https://github.com/stripe/ai) | Payment integration patterns |
|
|
|
|
### Community
|
|
|
|
[trailofbits/skills](https://github.com/trailofbits/skills) · [obra/superpowers](https://github.com/obra/superpowers) · [wshobson/agents](https://github.com/wshobson/agents) · [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) · [travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills) · [langgenius/dify](https://github.com/langgenius/dify) · [better-auth/skills](https://github.com/better-auth/skills) · [onmax/nuxt-skills](https://github.com/onmax/nuxt-skills) · [elysiajs/skills](https://github.com/elysiajs/skills) · [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) · [cloudai-x/threejs-skills](https://github.com/cloudai-x/threejs-skills) · [dimillian/skills](https://github.com/dimillian/skills) · [waynesutton/convexskills](https://github.com/waynesutton/convexskills) · [kepano/obsidian-skills](https://github.com/kepano/obsidian-skills) · [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) · [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills)
|
|
|
|
**Want to add your skills?** [Submit your repository](https://github.com/rohitg00/skillkit/issues/new?template=add-source.md)
|
|
|
|
## Install
|
|
|
|
```bash
|
|
npm install -g skillkit # npm
|
|
pnpm add -g skillkit # pnpm
|
|
yarn global add skillkit # yarn
|
|
bun add -g skillkit # bun
|
|
npx skillkit <command> # no install
|
|
```
|
|
|
|
## License
|
|
|
|
Apache 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)
|