Files
skillkit/README.md
Rohit Ghumare b28a2801b2 feat: add security scanner for detecting malicious patterns in skills (#50)
* feat: add security scanner for detecting malicious patterns in skills

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

* fix: address Devin and CodeRabbit review suggestions for security scanner

- Fix .env variant files (.env.local, .env.production) being skipped by scanner
- Add multiline rule support in StaticAnalyzer for cross-line pattern matching
- Fix PI004/PI013 patterns that contained literal \n (never matched per-line)
- Fix /g flag on CI006 path traversal regex causing intermittent misses
- Fix frontmatter regex to handle Windows CRLF line endings
- Fix allowed-tools parsing to detect multi-line YAML arrays
- Fix snippet redaction order: redact before truncate to prevent secret leaks
- Reset findingCounter per analyze() call for deterministic finding IDs
- Make SARIF artifactLocation.uri relative to skillPath for GitHub Code Scanning
- Use basename() instead of split('/').pop() for cross-platform paths
- Inject package version at build time via tsup define (replaces hardcoded 1.0.0)
- Validate --fail-on and --format CLI options with clear error messages
- Remove unused format/quiet from ScanOptions interface
- Move publish scan after name validation to avoid blocking on invalid skills
- Add excludePatterns for jailbreak detection to reduce false positives
- Add biome suppression for intentional control character regex in UC005
- Use alternation instead of character class for ZWJ in UC001

* fix: address CodeRabbit round 2 review suggestions

- Remove unused --quiet option from scan command
- Update OpenAI API key pattern to detect sk-proj- and sk-admin- prefixes

* fix: address deep review issues in security scanner

- SK001: add negative lookahead to prevent matching Anthropic keys
- static.ts: fix multiline loop hang for non-global regex with filtered matches
- CI005: reduce severity to MEDIUM, expand excludePatterns for template literals
- CI006: reduce severity to MEDIUM, add fileTypes whitelist, exclude markdown/YAML patterns
- PI011: fix literal \n in regex, use $/im for end-of-line matching
- UC004: use \u{...} notation for supplementary codepoint range
- scanner.ts: propagate skipRules to ManifestAnalyzer and SecretsAnalyzer
2026-02-08 12:56:45 +00:00

11 KiB

SkillKit - One Skill. 32 Agents.

npm version npm downloads GitHub stars CI License Website Docs API

Write a skill once, deploy it to all 32 agents. No rewrites.

Website · Docs · API · npm


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.

npx skillkit@latest

See It In Action

Watch the demo

Click the image above to watch the full demo

Quick Start

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

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:

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:

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:

skillkit serve
# Server running at http://localhost:3737

curl "http://localhost:3737/search?q=react+performance"

Or use MCP for native agent integration:

{
  "mcpServers": {
    "skillkit": { "command": "npx", "args": ["@skillkit/mcp"] }
  }
}

Or use Python:

pip install skillkit-client
from skillkit import SkillKitClient

async with SkillKitClient() as client:
    results = await client.search("react performance", limit=5)

REST API docs · MCP Server docs · Python Client docs · Interactive API explorer

Auto-generate agent instructions

Let SkillKit analyze your codebase and create CLAUDE.md, .cursorrules, etc.:

skillkit primer --all-agents

Session memory

Your AI agents learn patterns during sessions, then forget everything. SkillKit captures those learnings:

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:

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:

skillkit mesh init
skillkit mesh discover

Team collaboration

Share skills via a Git-committable .skills manifest:

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

skillkit ui

h Home · m Marketplace · r Recommend · t Translate · i Installed · s Sync · q Quit

SkillKit Interactive CLI

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

Commands

Core

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

skillkit marketplace             # Browse skills
skillkit tree                    # Hierarchical taxonomy
skillkit find <query>            # Quick search
skillkit scan <path>             # Security scan for skills

Advanced

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

Creating Skills

skillkit create my-skill

Or manually create a SKILL.md:

---
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

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);
import { startServer } from '@skillkit/api';
await startServer({ port: 3737, skills: [...] });
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 Official Claude Code skills
vercel-labs/agent-skills Next.js and React skills
expo/skills Mobile development with Expo
remotion-dev/skills Programmatic video creation
supabase/agent-skills Database and auth skills
stripe/ai Payment integration patterns

Community

trailofbits/skills · obra/superpowers · wshobson/agents · ComposioHQ/awesome-claude-skills · travisvn/awesome-claude-skills · 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

Want to add your skills? Submit your repository

Install

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.

Documentation · Website · API Explorer · npm · GitHub