Compare commits

...
Author SHA1 Message Date
Rohit Ghumare eeddd2a8cf style: add Product Hunt #3 badge to banner SVG 2026-02-09 21:32:51 +00:00
Rohit Ghumare 6362be2cb9 fix: update website from 32 to 44 agents across all components 2026-02-09 21:28:39 +00:00
Rohit Ghumare 7e23c3a5d7 fix: bump apps/skillkit version to 1.16.0 2026-02-09 21:21:55 +00:00
Rohit Ghumare 91c81ba1fa fix: bump all package versions to 1.16.0 2026-02-09 21:18:05 +00:00
Rohit Ghumare 684ea48f58 chore: release v1.16.0 2026-02-09 21:00:18 +00:00
Rohit Ghumare 19c9f6bdc4 feat: add 12 missing AI agents, expand to 44 total (#57)
* feat: add 12 missing AI coding agents (Devin, Aider, Cody, Amazon Q, Augment, Replit, Bolt, Lovable, Tabby, Tabnine, CodeGPT, PlayCode)

Expands agent support from 32 to 44 agents across all packages:
- Core types, configs, discovery paths, format maps, command generator
- Agent adapters (UniversalAdapter for all new agents)
- CLI onboarding icons/names, TUI symbols/logos
- Updated all docs, tests, and e2e references from 32 to 44

* test: add comprehensive tests for new agents, update docs and e2e

- Add it.each tests for all 12 new agent adapters and configs
- Add completeness test ensuring every AgentType has adapter + config
- Update agents.mdx doc table with all 12 new agents
- Update e2e onboarding test with new agent display names

* fix: add all 44 agents to translateSkillToAll and fix e2e test

- translateSkillToAll had hardcoded 17-agent list, now includes all 44
- e2e/skill-translator test was missing cline-zencoder batch in SUPPORTED_AGENTS

* fix: replace UniversalAdapter with GenericAgentAdapter for all non-universal agents

UniversalAdapter hardcoded type='universal', skillsDir='skills', and
name='Universal (Any Agent)' for all 26 agents that used it. This caused
skills to install to wrong directories and agents to be undetectable.

GenericAgentAdapter reads type, skillsDir, configFile from AGENT_CONFIG
and checks agent-specific directories in isDetected(). Fixes both the
12 new agents and the 14 pre-existing ones (cline through zencoder).

115 adapter tests now verify correct type, skillsDir, configFile, and
name for every GenericAgentAdapter instance.

* style: update README banner and header for 44 agents

* style: add rotating 3D model banner GIF for README

* style: revert to monochromatic SVG banner, update to 44 agents
2026-02-09 20:51:17 +00:00
Rohit Ghumare f11de2ac63 feat: add 12 missing AI coding agents (32 to 44) (#56)
* feat: add 12 missing AI coding agents (Devin, Aider, Cody, Amazon Q, Augment, Replit, Bolt, Lovable, Tabby, Tabnine, CodeGPT, PlayCode)

Expands agent support from 32 to 44 agents across all packages:
- Core types, configs, discovery paths, format maps, command generator
- Agent adapters (UniversalAdapter for all new agents)
- CLI onboarding icons/names, TUI symbols/logos
- Updated all docs, tests, and e2e references from 32 to 44

* test: add comprehensive tests for new agents, update docs and e2e

- Add it.each tests for all 12 new agent adapters and configs
- Add completeness test ensuring every AgentType has adapter + config
- Update agents.mdx doc table with all 12 new agents
- Update e2e onboarding test with new agent display names

* fix: add all 44 agents to translateSkillToAll and fix e2e test

- translateSkillToAll had hardcoded 17-agent list, now includes all 44
- e2e/skill-translator test was missing cline-zencoder batch in SUPPORTED_AGENTS

* fix: replace UniversalAdapter with GenericAgentAdapter for all non-universal agents

UniversalAdapter hardcoded type='universal', skillsDir='skills', and
name='Universal (Any Agent)' for all 26 agents that used it. This caused
skills to install to wrong directories and agents to be undetectable.

GenericAgentAdapter reads type, skillsDir, configFile from AGENT_CONFIG
and checks agent-specific directories in isDetected(). Fixes both the
12 new agents and the 14 pre-existing ones (cline through zencoder).

115 adapter tests now verify correct type, skillsDir, configFile, and
name for every GenericAgentAdapter instance.
2026-02-09 20:21:54 +00:00
Rohit Ghumare 3e92215231 fix: remove unnecessary VERSIONING.md from repo root (#55) 2026-02-09 19:44:08 +00:00
Rohit Ghumare 2f29632f17 fix: bump docs package versions to 1.15.0 2026-02-08 21:03:09 +00:00
Rohit Ghumare 596fc0aa7b chore: release v1.15.0 2026-02-08 20:57:48 +00:00
Rohit Ghumare 2bf8c7499c docs: add security scanner documentation, TUI screen, and README updates (#53)
- Add dedicated security.mdx docs page with full rule reference (46+ rules),
  threat categories, SARIF/CI integration guide, and programmatic usage
- Add TUI Scan screen (z key) with live scan results, severity colors,
  finding navigation, and rescan support
- Add scan to TUI sidebar nav, help shortcuts, and bottom status bar
- Add security scanner section to docs index page with link
- Add programmatic scan usage example to CLI README
- Remove stale --quiet option from commands.mdx
- Add security page to docs sidebar navigation
2026-02-08 20:50:45 +00:00
Rohit Ghumare d7861f96a7 feat: update Product Hunt badge to top post daily badge (#54)
Replace featured badge with top-post-badge showing daily ranking.
2026-02-08 20:50:29 +00:00
Rohit Ghumare c89d3130d1 fix: rewrite compatibility matrix with accurate agent capability data (#52)
Replace fabricated compatibility data with ratings based on actual
SkillKit translator capabilities, agent constraints, and compatibility
scoring from the codebase.

Key changes:
- Categories now reflect real SkillKit features (Translation, Hooks,
  MCP & Tools, Context Window) alongside skill categories
- Cline promoted to Tier 1 (full MCP/tools/hooks support)
- Only Claude, Cline, Roo show full MCP & Tools support (accurate)
- Codex/Copilot show partial for most categories (8K context limit)
- No agent claims 100% - scores reflect real translation capabilities
- Removed language-specific categories (Go, Python, TypeScript) that
  don't meaningfully differ across agents since skills are text-based
2026-02-08 20:35:08 +00:00
Rohit Ghumare d8168044b3 fix: remove hardcoded initial stars count from website loader (#51)
Replace stale hardcoded fallback values (66 stars, 2.4k downloads, v1.9.0)
with empty/zero defaults that show a dash placeholder while loading. Real
values populate once the API responds.
2026-02-08 20:30:10 +00:00
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
89 changed files with 3221 additions and 310 deletions
+15 -12
View File
@@ -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/>
[![npm version](https://img.shields.io/npm/v/skillkit.svg?style=flat-square)](https://www.npmjs.com/package/skillkit)
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/skillkit.svg?style=flat-square&color=3b82f6)](https://www.npmjs.com/package/skillkit)
[![npm downloads](https://img.shields.io/npm/dm/skillkit.svg?style=flat-square)](https://www.npmjs.com/package/skillkit)
[![GitHub stars](https://img.shields.io/github/stars/rohitg00/skillkit?style=flat-square)](https://github.com/rohitg00/skillkit/stargazers)
[![CI](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rohitg00/skillkit/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
[![Website](https://img.shields.io/badge/agenstskills.com-black?style=flat-square&logo=vercel)](https://agenstskills.com)
[![Docs](https://img.shields.io/badge/Docs-blue?style=flat-square&logo=readthedocs&logoColor=white)](https://agenstskills.com/docs)
[![API](https://img.shields.io/badge/API-green?style=flat-square&logo=swagger&logoColor=white)](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. 15,000+ skills in the marketplace.
[Website](https://agenstskills.com) &middot; [Docs](https://agenstskills.com/docs) &middot; [API](https://agenstskills.com/api) &middot; [npm](https://www.npmjs.com/package/skillkit)
[Website](https://agenstskills.com) &middot; [Docs](https://agenstskills.com/docs) &middot; [API Explorer](https://agenstskills.com/api) &middot; [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 15,000+ skills, auto-translate between formats, persist learnings with Memory. Works with Claude, Cursor, Windsurf, Copilot, and 40 more.
```bash
npx skillkit@latest
@@ -193,7 +191,7 @@ skillkit ui
![SkillKit Interactive CLI](docs/img/inital-command.png)
## Supported Agents (32)
## Supported Agents (44)
| Agent | Format | Directory |
|-------|--------|-----------|
@@ -204,8 +202,12 @@ 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)
@@ -223,12 +225,13 @@ 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
```
### Advanced
-93
View File
@@ -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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.14.0",
"version": "1.16.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": {
+2
View File
@@ -103,6 +103,7 @@ import {
SkillMdInitCommand,
SkillMdCheckCommand,
ServeCommand,
ScanCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -231,5 +232,6 @@ cli.register(SkillMdInitCommand);
cli.register(SkillMdCheckCommand);
cli.register(ServeCommand);
cli.register(ScanCommand);
cli.runExit(process.argv.slice(2));
+14 -2
View File
@@ -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
+33
View File
@@ -362,6 +362,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
+15 -2
View File
@@ -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
@@ -94,12 +94,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
@@ -145,6 +157,7 @@ Team members run `skillkit manifest install` and they're in sync.
- [Installation](/docs/installation) — Install and configure
- [Quick Start](/docs/quickstart) — First project setup
- [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
+1 -1
View File
@@ -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)
```
+1
View File
@@ -16,6 +16,7 @@
"mesh",
"messaging",
"workflows",
"security",
"testing",
"commands",
"configuration",
+1 -1
View File
@@ -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
+259
View File
@@ -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
```
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.14.0",
"version": "1.16.0",
"private": true,
"scripts": {
"build": "next build",
@@ -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: [
+35 -22
View File
@@ -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="#da552f"/>
<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

+10 -9
View File
@@ -123,7 +123,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 +131,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 +143,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 +155,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,19 +167,20 @@ 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>
<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"
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="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"
src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1071813&theme=dark&period=daily"
alt="Skillkit - The package manager for AI agent skills | Product Hunt"
width="250"
height="54"
style={{ height: '28px', width: 'auto' }}
/>
</a>
@@ -51,8 +51,8 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
id: 'primer',
title: 'Primer',
subtitle: 'Zero-Config AI Instructions',
description: 'Automatically generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase. Detects your tech stack, coding patterns, and project structure—then creates optimized instructions for all 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 +60,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' },
],
+1 -1
View File
@@ -312,7 +312,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>
+11
View File
@@ -82,6 +82,17 @@ 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: 'Advanced',
commands: [
@@ -16,111 +16,106 @@ 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: '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: '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' },
];
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 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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': 'full',
},
'hooks': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'partial',
'opencode': 'partial', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'none', 'continue': 'none',
},
'mcp-tools': {
'claude-code': 'full', 'cursor': 'none', 'codex': 'none', 'gemini-cli': 'none',
'opencode': 'none', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
'trae': 'none', 'amp': 'none', 'antigravity': 'none', 'continue': 'none',
},
'context': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'partial', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
},
'security': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': '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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': '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',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': '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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': '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',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'partial', 'continue': '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',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': 'full',
},
};
@@ -202,7 +197,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 {AGENTS.length} agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
+6 -6
View File
@@ -42,13 +42,13 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 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">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 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">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,7 +206,7 @@ skillkit cicd init # Setup CI/CD integration`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">AI Instruction Generation (Primer)</h3>
<CodeBlock>{`skillkit primer # Analyze codebase, generate for detected agents
skillkit primer --all-agents # Generate for all 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
+13 -3
View File
@@ -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" />
@@ -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,12 +109,13 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agent Support', '1 agent', '32 agents'],
['Agent Support', '1 agent', '44 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'],
['Security', 'Manual review', 'Auto-scan on install'],
['API Access', 'None', 'REST + MCP + Python'],
] as const;
+4 -4
View File
@@ -21,7 +21,7 @@ interface TerminalLine {
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
{ type: 'out', text: '→ Installed to 32 agents' },
{ type: 'out', text: '→ Installed to 44 agents' },
{ type: 'cmd', text: 'skillkit recommend' },
{ type: 'out', text: ' 92% vercel-react-best-practices' },
{ type: 'out', text: ' 87% typescript-strict-mode' },
@@ -134,13 +134,13 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
<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>
<span className="text-zinc-500">44 Agents. Zero Rewrites.</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.
Works with Claude, Cursor, Windsurf, Copilot, Devin, Codex, and 38 more.
</p>
<div className="flex flex-wrap items-center gap-2 mb-4">
@@ -169,7 +169,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
<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">
+1 -1
View File
@@ -13,7 +13,7 @@ const USE_CASES: UseCase[] = [
{
persona: 'Multi-Agent Developer',
problem: 'You\'ve built skills for Claude Code. Now your team wants Cursor, and you want to try Windsurf.',
solution: 'SkillKit translates skills between all 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: (
+6 -6
View File
@@ -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();
+3 -3
View File
@@ -4,13 +4,13 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>SkillKit - Universal Skills for AI Coding Agents</title>
<meta name="description" content="Write once, deploy to 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: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: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://agenstskills.com/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
@@ -20,7 +20,7 @@
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://agenstskills.com/">
<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: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://agenstskills.com/og-image.png">
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+1 -1
View File
@@ -1,5 +1,5 @@
{
"name": "SkillKit",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 32 agents.",
"description": "Supercharge Every AI Coding Agent. Translate, manage, and sync skills across Claude, Cursor, Windsurf, and 44 agents.",
"requestFramePermissions": []
}
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.14.0",
"version": "1.16.0",
"type": "module",
"scripts": {
"dev": "vite",
+1 -1
View File
@@ -3,7 +3,7 @@
"info": {
"title": "SkillKit",
"version": "1.12.0",
"description": "Skills shouldn't require pre-installation. This API lets any agent, framework, or tool discover and retrieve skills on demand.\n\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\n15,000+ 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"
+13 -1
View File
@@ -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 -1
View File
@@ -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', () => {
+14 -2
View File
@@ -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', () => {
+2 -2
View File
@@ -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",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.14.0",
"version": "1.16.0",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.14.0",
"version": "1.16.0",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"type": "module",
"main": "./dist/index.js",
+104 -3
View File
@@ -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 44 registered adapters', () => {
const adapters = getAllAdapters();
expect(adapters).toBeInstanceOf(Array);
expect(adapters.length).toBeGreaterThan(0);
expect(adapters.length).toBe(44);
});
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();
+144
View File
@@ -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;
}
}
+40 -17
View File
@@ -18,6 +18,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';
@@ -38,6 +39,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';
@@ -60,21 +62,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 {
@@ -126,6 +140,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 +164,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
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.14.0",
"version": "1.16.0",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -5,7 +5,7 @@ const OPENAPI_SPEC = {
info: {
title: 'SkillKit',
version: '1.12.0',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ skills across 32 agents).',
description: 'Skill Discovery API for AI coding agents. Search, browse, and retrieve skills from the SkillKit marketplace (15,000+ 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' },
},
+21
View File
@@ -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 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.14.0",
"version": "1.16.0",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
@@ -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 () => {
+1
View File
@@ -118,3 +118,4 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
// API server
export { ServeCommand } from './serve.js';
export { ScanCommand } from './scan.js';
+28 -1
View File
@@ -5,7 +5,7 @@ import { promisify } from 'node:util';
const execFileAsync = promisify(execFile);
import { Command, Option } from 'clipanion';
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory } from '@skillkit/core';
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory, SkillScanner, formatSummary, Severity } from '@skillkit/core';
import type { SkillMetadata, GitProvider, AgentType } from '@skillkit/core';
import { isPathInside } from '@skillkit/core';
import { getAdapter, detectAgent, getAllAdapters } from '@skillkit/agents';
@@ -94,6 +94,10 @@ export class InstallCommand extends Command {
description: 'Minimal output (no logo)',
});
scan = Option.Boolean('--scan', true, {
description: 'Run security scan before installing (default: true)',
});
async execute(): Promise<number> {
const isInteractive = process.stdin.isTTY && !this.skills && !this.all && !this.yes;
const s = spinner();
@@ -259,6 +263,29 @@ export class InstallCommand extends Command {
}
}
if (this.scan) {
const scanner = new SkillScanner({ failOnSeverity: Severity.HIGH });
for (const skill of skillsToInstall) {
const scanResult = await scanner.scan(skill.path);
if (scanResult.verdict === 'fail' && !this.force) {
error(`Security scan FAILED for "${skill.name}"`);
console.log(formatSummary(scanResult));
console.log(colors.muted('Use --force to install anyway, or --no-scan to skip scanning'));
const cleanupPath = result.tempRoot || result.path;
if (!isLocalPath(this.source) && cleanupPath && existsSync(cleanupPath)) {
rmSync(cleanupPath, { recursive: true, force: true });
}
return 1;
}
if (scanResult.verdict === 'warn' && !this.quiet) {
warn(`Security warnings for "${skill.name}" (${scanResult.stats.medium} medium, ${scanResult.stats.low} low)`);
}
}
}
// Confirm installation
if (isInteractive && !this.yes) {
console.log('');
+3 -3
View File
@@ -22,13 +22,13 @@ export class PrimerCommand extends Command {
for AI coding agents.
By default, it generates instructions for detected agents in your project.
Use --all-agents to generate for all 32 supported agents.
Use --all-agents to generate for all 44 supported agents.
Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
`,
examples: [
['Generate for detected agents', '$0 primer'],
['Generate for all 32 agents', '$0 primer --all-agents'],
['Generate for all 44 agents', '$0 primer --all-agents'],
['Generate for specific agents', '$0 primer --agent claude-code,cursor,github-copilot'],
['Custom output directory', '$0 primer --output ./instructions'],
['Preview without writing files', '$0 primer --dry-run'],
@@ -42,7 +42,7 @@ export class PrimerCommand extends Command {
});
allAgents = Option.Boolean('--all-agents,-A', false, {
description: 'Generate for all 32 supported agents',
description: 'Generate for all 44 supported agents',
});
output = Option.String('--output,-o', {
+15 -2
View File
@@ -2,7 +2,7 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, statSy
import { join, basename, dirname, resolve } from 'node:path';
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import { generateWellKnownIndex, type WellKnownSkill } from '@skillkit/core';
import { generateWellKnownIndex, type WellKnownSkill, SkillScanner, formatSummary, Severity } from '@skillkit/core';
function sanitizeSkillName(name: string): string | null {
if (!name || typeof name !== 'string') return null;
@@ -72,7 +72,6 @@ export class PublishCommand extends Command {
console.log(chalk.white(`Found ${discoveredSkills.length} skill(s):\n`));
const wellKnownSkills: WellKnownSkill[] = [];
const validSkills: Array<{ name: string; safeName: string; description?: string; path: string }> = [];
for (const skill of discoveredSkills) {
@@ -95,6 +94,20 @@ export class PublishCommand extends Command {
});
}
const scanner = new SkillScanner({ failOnSeverity: Severity.HIGH });
for (const skill of validSkills) {
const scanResult = await scanner.scan(skill.path);
if (scanResult.verdict === 'fail') {
console.error(chalk.red(`\nSecurity scan FAILED for "${skill.safeName}"`));
console.error(formatSummary(scanResult));
console.error(chalk.dim('Fix security issues before publishing.'));
return 1;
}
if (scanResult.verdict === 'warn') {
console.log(chalk.yellow(` Security warnings for "${skill.safeName}" (${scanResult.findings.length} findings)`));
}
}
if (validSkills.length === 0) {
console.error(chalk.red('\nNo valid skills to publish'));
return 1;
+85
View File
@@ -0,0 +1,85 @@
import { Command, Option } from 'clipanion';
import { resolve } from 'node:path';
import { existsSync } from 'node:fs';
import { SkillScanner, formatResult, Severity } from '@skillkit/core';
const SEVERITY_MAP: Record<string, Severity> = {
critical: Severity.CRITICAL,
high: Severity.HIGH,
medium: Severity.MEDIUM,
low: Severity.LOW,
info: Severity.INFO,
};
export class ScanCommand extends Command {
static override paths = [['scan']];
static override usage = Command.Usage({
description: 'Scan a skill directory for security vulnerabilities',
details: `
Analyzes skill files for prompt injection, command injection, data exfiltration,
tool abuse, hardcoded secrets, and unicode steganography.
Outputs findings in various formats including SARIF for GitHub Code Scanning.
`,
examples: [
['Scan current directory', '$0 scan .'],
['Scan a specific skill', '$0 scan ./my-skill'],
['Output as JSON', '$0 scan ./my-skill --format json'],
['Output as SARIF', '$0 scan ./my-skill --format sarif'],
['Fail on high severity', '$0 scan ./my-skill --fail-on high'],
['Skip unicode rules', '$0 scan ./my-skill --skip-rules UC001,UC002'],
],
});
skillPath = Option.String({ required: true, name: 'path' });
format = Option.String('--format,-f', 'summary', {
description: 'Output format: summary, json, table, sarif',
});
failOn = Option.String('--fail-on', {
description: 'Exit with code 1 if findings at this severity or above (critical, high, medium, low)',
});
skipRules = Option.String('--skip-rules', {
description: 'Comma-separated rule IDs or categories to skip',
});
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', 'sarif'];
if (!validFormats.includes(this.format)) {
this.context.stderr.write(`Invalid format: "${this.format}". Must be one of: ${validFormats.join(', ')}\n`);
return 1;
}
const skipRules = this.skipRules?.split(',').map((s) => s.trim()) ?? [];
let failOnSeverity: Severity | undefined;
if (this.failOn) {
failOnSeverity = SEVERITY_MAP[this.failOn.toLowerCase()];
if (!failOnSeverity) {
this.context.stderr.write(`Invalid --fail-on value: "${this.failOn}". Must be one of: ${Object.keys(SEVERITY_MAP).join(', ')}\n`);
return 1;
}
}
const scanner = new SkillScanner({
failOnSeverity,
skipRules,
});
const result = await scanner.scan(targetPath);
this.context.stdout.write(formatResult(result, this.format) + '\n');
return result.verdict === 'fail' ? 1 : 0;
}
}
+1 -1
View File
@@ -88,7 +88,7 @@ import {
} from './preferences.js';
let VERSION = '1.7.6';
let AGENT_COUNT = 32;
let AGENT_COUNT = 44;
export function setVersion(version: string): void {
VERSION = version;
+24
View File
@@ -17,6 +17,18 @@ export const AGENT_ICONS: Record<string, string> = {
'trae': '\u25c6',
'antigravity': '\u229b',
'clawdbot': '\u27d0',
'devin': '\u25a7',
'aider': '\u25a8',
'sourcegraph-cody': '\u25a9',
'amazon-q': '\u25aa',
'augment-code': '\u25ab',
'replit-agent': '\u25b4',
'bolt': '\u26a1',
'lovable': '\u2665',
'tabby': '\u25b9',
'tabnine': '\u25ba',
'codegpt': '\u25bb',
'playcode-agent': '\u25bd',
'universal': '\u25cf',
};
@@ -37,6 +49,18 @@ export const AGENT_NAMES: Record<string, string> = {
'trae': 'Trae',
'antigravity': 'Antigravity',
'clawdbot': 'Clawdbot',
'devin': 'Devin',
'aider': 'Aider',
'sourcegraph-cody': 'Cody',
'amazon-q': 'Amazon Q',
'augment-code': 'Augment',
'replit-agent': 'Replit',
'bolt': 'Bolt',
'lovable': 'Lovable',
'tabby': 'Tabby',
'tabnine': 'Tabnine',
'codegpt': 'CodeGPT',
'playcode-agent': 'PlayCode',
'universal': 'Universal',
};
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.14.0",
"version": "1.16.0",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
+113
View File
@@ -348,6 +348,119 @@ export const AGENT_CONFIG: Record<AgentType, AgentDirectoryConfig> = {
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Devin (Cognition Labs)
devin: {
skillsDir: '.devin/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Aider
aider: {
skillsDir: '.aider/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.aider/skills',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Sourcegraph Cody
'sourcegraph-cody': {
skillsDir: '.cody/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.cody/skills',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Amazon Q Developer
'amazon-q': {
skillsDir: '.amazonq/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.amazonq/skills',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Augment Code
'augment-code': {
skillsDir: '.augment/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Replit Agent
'replit-agent': {
skillsDir: '.replit/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Bolt (Vercel)
bolt: {
skillsDir: '.bolt/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Lovable
lovable: {
skillsDir: '.lovable/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Tabby
tabby: {
skillsDir: '.tabby/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.tabby/skills',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// Tabnine
tabnine: {
skillsDir: '.tabnine/skills',
configFile: 'AGENTS.md',
globalSkillsDir: '~/.tabnine/skills',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// CodeGPT
codegpt: {
skillsDir: '.codegpt/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
// PlayCode Agent
'playcode-agent': {
skillsDir: '.playcode/skills',
configFile: 'AGENTS.md',
configFormat: 'markdown',
usesFrontmatter: true,
supportsAutoDiscovery: true,
},
};
/**
+36
View File
@@ -251,6 +251,18 @@ export const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]> = {
'qwen': ['.qwen/agents'],
'vercel': ['.vercel/agents'],
'zencoder': ['.zencoder/agents'],
'devin': ['.devin/agents'],
'aider': ['.aider/agents'],
'sourcegraph-cody': ['.cody/agents'],
'amazon-q': ['.amazonq/agents'],
'augment-code': ['.augment/agents'],
'replit-agent': ['.replit/agents'],
'bolt': ['.bolt/agents'],
'lovable': ['.lovable/agents'],
'tabby': ['.tabby/agents'],
'tabnine': ['.tabnine/agents'],
'codegpt': ['.codegpt/agents'],
'playcode-agent': ['.playcode/agents'],
};
/**
@@ -298,6 +310,18 @@ export const ALL_AGENT_DISCOVERY_PATHS = [
'.windsurf/agents',
'.windsurf/workflows',
'.zencoder/agents',
'.devin/agents',
'.aider/agents',
'.cody/agents',
'.amazonq/agents',
'.augment/agents',
'.replit/agents',
'.bolt/agents',
'.lovable/agents',
'.tabby/agents',
'.tabnine/agents',
'.codegpt/agents',
'.playcode/agents',
];
/**
@@ -336,4 +360,16 @@ export const CUSTOM_AGENT_FORMAT_MAP: Record<AgentType, AgentFormatCategory> = {
'qwen': 'claude-agent',
'vercel': 'claude-agent',
'zencoder': 'claude-agent',
'devin': 'universal',
'aider': 'universal',
'sourcegraph-cody': 'universal',
'amazon-q': 'universal',
'augment-code': 'universal',
'replit-agent': 'universal',
'bolt': 'universal',
'lovable': 'universal',
'tabby': 'universal',
'tabnine': 'universal',
'codegpt': 'universal',
'playcode-agent': 'universal',
};
+84
View File
@@ -241,6 +241,90 @@ const AGENT_FORMATS: Record<AgentType, AgentCommandFormat> = {
supportsSlashCommands: true,
supportsCommandFiles: true,
},
devin: {
agent: 'devin',
extension: '.md',
directory: '.devin/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
aider: {
agent: 'aider',
extension: '.md',
directory: '.aider/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
'sourcegraph-cody': {
agent: 'sourcegraph-cody',
extension: '.md',
directory: '.cody/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
'amazon-q': {
agent: 'amazon-q',
extension: '.md',
directory: '.amazonq/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
'augment-code': {
agent: 'augment-code',
extension: '.md',
directory: '.augment/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
'replit-agent': {
agent: 'replit-agent',
extension: '.md',
directory: '.replit/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
bolt: {
agent: 'bolt',
extension: '.md',
directory: '.bolt/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
lovable: {
agent: 'lovable',
extension: '.md',
directory: '.lovable/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
tabby: {
agent: 'tabby',
extension: '.md',
directory: '.tabby/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
tabnine: {
agent: 'tabnine',
extension: '.md',
directory: '.tabnine/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
codegpt: {
agent: 'codegpt',
extension: '.md',
directory: '.codegpt/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
'playcode-agent': {
agent: 'playcode-agent',
extension: '.md',
directory: '.playcode/commands',
supportsSlashCommands: false,
supportsCommandFiles: true,
},
};
/**
+3
View File
@@ -120,3 +120,6 @@ export type { SkillReference, ParsedSkillContent } from './parser/index.js';
// Runtime Skill Injection
export * from './runtime/index.js';
// Security Scanner
export * from './scanner/index.js';
@@ -0,0 +1,6 @@
import type { Finding } from '../types.js';
export interface Analyzer {
name: string;
analyze(skillPath: string, files: string[]): Promise<Finding[]>;
}
@@ -0,0 +1,212 @@
import { readFile } from 'node:fs/promises';
import { extname } from 'node:path';
import type { Analyzer } from './base.js';
import type { Finding } from '../types.js';
import { Severity, ThreatCategory } from '../types.js';
const DANGEROUS_TOOLS = new Set(['Bash', 'bash', 'shell', 'terminal', 'exec', 'system']);
const IMPERSONATION_PATTERNS = [
/official\s+(?:anthropic|openai|google|microsoft|meta)\s+(?:tool|skill|plugin)/i,
/(?:anthropic|openai|google|microsoft|meta)\s+certified/i,
/endorsed\s+by\s+(?:anthropic|openai|google|microsoft|meta)/i,
];
const BINARY_EXTENSIONS = new Set([
'.exe', '.dll', '.so', '.dylib', '.bin', '.dat',
'.zip', '.tar', '.gz', '.rar', '.7z',
'.wasm', '.pyc', '.pyo', '.class',
]);
export class ManifestAnalyzer implements Analyzer {
name = 'manifest';
private findingCounter = 0;
private skipRules: Set<string>;
constructor(skipRules?: string[]) {
this.skipRules = new Set(skipRules ?? []);
}
async analyze(_skillPath: string, files: string[]): Promise<Finding[]> {
this.findingCounter = 0;
const findings: Finding[] = [];
const skillMdFiles = files.filter((f) => f.toLowerCase().endsWith('skill.md'));
for (const skillMd of skillMdFiles) {
let content: string;
try {
content = await readFile(skillMd, 'utf-8');
} catch {
continue;
}
this.validateFrontmatter(content, skillMd, findings);
this.checkImpersonation(content, skillMd, findings);
}
this.checkBinaryFiles(files, findings);
return findings;
}
private shouldSkip(ruleId: string): boolean {
return this.skipRules.has(ruleId);
}
private validateFrontmatter(content: string, filePath: string, findings: Finding[]): void {
const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!fmMatch) {
if (!this.shouldSkip('MF001')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF001',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.LOW,
title: 'Missing SKILL.md frontmatter',
description: 'SKILL.md should have YAML frontmatter with name, description, and allowed-tools',
filePath,
analyzer: this.name,
remediation: 'Add YAML frontmatter with name, description, and allowed-tools fields.',
});
}
return;
}
const fm = fmMatch[1];
if (!/^name:/m.test(fm) && !this.shouldSkip('MF002')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF002',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.LOW,
title: 'Missing skill name in frontmatter',
description: 'SKILL.md frontmatter should include a name field',
filePath,
analyzer: this.name,
remediation: 'Add a name field to the YAML frontmatter.',
});
}
const nameMatch = fm.match(/^name:\s*(.+)$/m);
if (nameMatch) {
const name = nameMatch[1].trim().replace(/^["']|["']$/g, '');
if (!/^[a-z0-9][a-z0-9._-]*$/i.test(name) && !this.shouldSkip('MF003')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF003',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.LOW,
title: 'Invalid skill name format',
description: `Skill name "${name}" should use alphanumeric characters, dots, hyphens, or underscores`,
filePath,
analyzer: this.name,
remediation: 'Use a name matching [a-z0-9][a-z0-9._-]* pattern.',
});
}
}
const descMatch = fm.match(/^description:\s*(.+)$/m);
if (!descMatch) {
if (!this.shouldSkip('MF004')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF004',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.INFO,
title: 'Missing skill description',
description: 'SKILL.md should include a description for discoverability',
filePath,
analyzer: this.name,
remediation: 'Add a description field to the YAML frontmatter.',
});
}
} else {
const desc = descMatch[1].trim().replace(/^["']|["']$/g, '');
if (desc.length < 20 && !this.shouldSkip('MF005')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF005',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.INFO,
title: 'Short skill description',
description: `Description "${desc}" is too short (${desc.length} chars). Aim for at least 20 characters.`,
filePath,
analyzer: this.name,
remediation: 'Provide a more detailed description.',
});
}
}
const inlineToolsMatch = fm.match(/^allowed-tools:\s*\[([^\]]*)\]/m);
const multiLineToolsMatch = fm.match(/^allowed-tools:\s*\n((?:\s+-\s+.+\n?)+)/m);
let tools: string[] = [];
if (inlineToolsMatch) {
tools = inlineToolsMatch[1].split(',').map((t) => t.trim().replace(/^["']|["']$/g, ''));
} else if (multiLineToolsMatch) {
tools = multiLineToolsMatch[1]
.split('\n')
.map((line) => line.replace(/^\s*-\s*/, '').trim().replace(/^["']|["']$/g, ''))
.filter((t) => t.length > 0);
}
for (const tool of tools) {
if (DANGEROUS_TOOLS.has(tool) && !this.shouldSkip('MF006')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF006',
category: ThreatCategory.TOOL_ABUSE,
severity: Severity.HIGH,
title: `Dangerous tool in allowed-tools: ${tool}`,
description: `The tool "${tool}" grants shell access. This is a significant security risk.`,
filePath,
analyzer: this.name,
remediation: 'Restrict allowed-tools to the minimum needed. Avoid shell/exec tools.',
});
}
}
}
private checkImpersonation(content: string, filePath: string, findings: Finding[]): void {
for (const pattern of IMPERSONATION_PATTERNS) {
const match = content.match(pattern);
if (match && !this.shouldSkip('MF007')) {
const lineNumber = content.substring(0, match.index).split('\n').length;
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF007',
category: ThreatCategory.SOCIAL_ENGINEERING,
severity: Severity.HIGH,
title: 'Impersonation detected',
description: `Skill claims official affiliation: "${match[0]}"`,
filePath,
lineNumber,
snippet: match[0],
analyzer: this.name,
remediation: 'Remove false claims of official endorsement or certification.',
});
}
}
}
private checkBinaryFiles(files: string[], findings: Finding[]): void {
for (const file of files) {
const ext = extname(file).toLowerCase();
if (BINARY_EXTENSIONS.has(ext) && !this.shouldSkip('MF008')) {
findings.push({
id: `MF${++this.findingCounter}`,
ruleId: 'MF008',
category: ThreatCategory.POLICY_VIOLATION,
severity: Severity.MEDIUM,
title: `Binary file detected: ${ext}`,
description: `Binary file found in skill directory. Skills should contain only text files.`,
filePath: file,
analyzer: this.name,
remediation: 'Remove binary files from skill directory. Use package managers for dependencies.',
});
}
}
}
}
@@ -0,0 +1,188 @@
import { readFile } from 'node:fs/promises';
import { basename } from 'node:path';
import type { Analyzer } from './base.js';
import type { Finding } from '../types.js';
import { Severity, ThreatCategory } from '../types.js';
interface SecretPattern {
id: string;
name: string;
pattern: RegExp;
severity: Severity;
}
const SECRET_PATTERNS: SecretPattern[] = [
{
id: 'SK001',
name: 'OpenAI API key',
pattern: /sk-(?!ant-)(?:proj-|admin-)?[A-Za-z0-9-]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK002',
name: 'Stripe live key',
pattern: /pk_live_[a-zA-Z0-9]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK003',
name: 'Stripe secret key',
pattern: /sk_live_[a-zA-Z0-9]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK004',
name: 'GitHub personal access token',
pattern: /ghp_[a-zA-Z0-9]{36}/,
severity: Severity.CRITICAL,
},
{
id: 'SK005',
name: 'GitHub OAuth token',
pattern: /gho_[a-zA-Z0-9]{36}/,
severity: Severity.CRITICAL,
},
{
id: 'SK006',
name: 'AWS access key',
pattern: /AKIA[0-9A-Z]{16}/,
severity: Severity.CRITICAL,
},
{
id: 'SK007',
name: 'Slack bot token',
pattern: /xoxb-[0-9]{10,}-[a-zA-Z0-9]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK008',
name: 'Slack user token',
pattern: /xoxp-[0-9]{10,}-[a-zA-Z0-9]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK009',
name: 'Private key block',
pattern: /-----BEGIN\s+(?:RSA\s+|EC\s+|DSA\s+|OPENSSH\s+)?PRIVATE\s+KEY-----/,
severity: Severity.CRITICAL,
},
{
id: 'SK010',
name: 'Google API key',
pattern: /AIza[0-9A-Za-z_-]{35}/,
severity: Severity.HIGH,
},
{
id: 'SK011',
name: 'Anthropic API key',
pattern: /sk-ant-[a-zA-Z0-9]{20,}/,
severity: Severity.CRITICAL,
},
{
id: 'SK012',
name: 'npm token',
pattern: /npm_[a-zA-Z0-9]{36}/,
severity: Severity.HIGH,
},
{
id: 'SK013',
name: 'Heroku API key',
pattern: /[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/,
severity: Severity.LOW,
},
];
const PLACEHOLDER_INDICATORS = [
/your[-_]?api[-_]?key/i,
/example/i,
/sample/i,
/dummy/i,
/placeholder/i,
/xxx+/i,
/test[-_]?key/i,
/fake/i,
/replace[-_]?with/i,
/\<.*key.*\>/i,
];
const ENV_FILE_PATTERN = /^\.env/;
function isPlaceholder(line: string): boolean {
return PLACEHOLDER_INDICATORS.some((p) => p.test(line));
}
export class SecretsAnalyzer implements Analyzer {
name = 'secrets';
private findingCounter = 0;
private skipRules: Set<string>;
constructor(skipRules?: string[]) {
this.skipRules = new Set(skipRules ?? []);
}
async analyze(_skillPath: string, files: string[]): Promise<Finding[]> {
this.findingCounter = 0;
const findings: Finding[] = [];
for (const file of files) {
const name = basename(file);
if (ENV_FILE_PATTERN.test(name) && !this.skipRules.has('SK-ENV')) {
findings.push({
id: `SK${++this.findingCounter}`,
ruleId: 'SK-ENV',
category: ThreatCategory.HARDCODED_SECRETS,
severity: Severity.HIGH,
title: `Environment file included: ${name}`,
description: 'Environment files should not be included in skill distributions',
filePath: file,
analyzer: this.name,
remediation: 'Remove .env files from skill directory. Add to .gitignore.',
});
continue;
}
let content: string;
try {
content = await readFile(file, 'utf-8');
} catch {
continue;
}
if (content.length > 1_000_000) continue;
const lines = content.split('\n');
for (let i = 0; i < lines.length; i++) {
const line = lines[i];
if (isPlaceholder(line)) continue;
for (const secret of SECRET_PATTERNS) {
if (this.skipRules.has(secret.id)) continue;
if (secret.pattern.test(line)) {
if (secret.id === 'SK013') {
if (!/(?:key|token|secret|password|credential|api)/i.test(line)) continue;
}
findings.push({
id: `SK${++this.findingCounter}`,
ruleId: secret.id,
category: ThreatCategory.HARDCODED_SECRETS,
severity: secret.severity,
title: `${secret.name} detected`,
description: `Potential ${secret.name} found in skill file`,
filePath: file,
lineNumber: i + 1,
snippet: line.trim().replace(secret.pattern, '[REDACTED]').substring(0, 100),
analyzer: this.name,
remediation: 'Remove hardcoded secrets. Use environment variables or secret managers.',
});
break;
}
}
}
}
return findings;
}
}
@@ -0,0 +1,166 @@
import { readFile } from 'node:fs/promises';
import { extname } from 'node:path';
import type { Analyzer } from './base.js';
import type { Finding, SecurityRule } from '../types.js';
import { getAllRules } from '../rules/index.js';
const EXT_TO_FILETYPE: Record<string, string> = {
'.ts': 'typescript',
'.tsx': 'typescript',
'.js': 'javascript',
'.jsx': 'javascript',
'.mjs': 'javascript',
'.cjs': 'javascript',
'.py': 'python',
'.sh': 'bash',
'.bash': 'bash',
'.zsh': 'bash',
'.md': 'markdown',
'.mdx': 'markdown',
};
const PLACEHOLDER_PATTERNS = [
/your[-_]?api[-_]?key/i,
/example[-_]?token/i,
/sample[-_]?secret/i,
/dummy[-_]?password/i,
/placeholder/i,
/xxx+/i,
/\.\.\./,
/TODO/,
/FIXME/,
];
const TEST_FILE_PATTERNS = [
/\.test\.[jt]sx?$/,
/\.spec\.[jt]sx?$/,
/__tests__\//,
/test\//,
/tests\//,
/\.stories\.[jt]sx?$/,
];
function isTestFile(filePath: string): boolean {
return TEST_FILE_PATTERNS.some((p) => p.test(filePath));
}
function isPlaceholderLine(line: string): boolean {
return PLACEHOLDER_PATTERNS.some((p) => p.test(line));
}
function getFileType(filePath: string): string | undefined {
return EXT_TO_FILETYPE[extname(filePath)];
}
function ruleMatchesFileType(rule: SecurityRule, fileType: string | undefined): boolean {
if (!rule.fileTypes || rule.fileTypes.length === 0) return true;
if (!fileType) return true;
return rule.fileTypes.includes(fileType);
}
function matchesExcludePatterns(line: string, rule: SecurityRule): boolean {
if (!rule.excludePatterns) return false;
return rule.excludePatterns.some((p) => p.test(line));
}
export class StaticAnalyzer implements Analyzer {
name = 'static';
private rules: SecurityRule[];
private skipRules: Set<string>;
private findingCounter = 0;
constructor(skipRules?: string[]) {
this.rules = getAllRules();
this.skipRules = new Set(skipRules ?? []);
}
async analyze(_skillPath: string, files: string[]): Promise<Finding[]> {
this.findingCounter = 0;
const findings: Finding[] = [];
for (const file of files) {
if (isTestFile(file)) continue;
const fileType = getFileType(file);
const applicableRules = this.rules.filter(
(r) => !this.skipRules.has(r.id) && ruleMatchesFileType(r, fileType)
);
if (applicableRules.length === 0) continue;
let content: string;
try {
content = await readFile(file, 'utf-8');
} catch {
continue;
}
const lines = content.split('\n');
for (const rule of applicableRules) {
if (rule.multiline) {
for (const pattern of rule.patterns) {
pattern.lastIndex = 0;
let match: RegExpExecArray | null;
while ((match = pattern.exec(content)) !== null) {
const lineNumber = content.substring(0, match.index).split('\n').length;
const snippetStart = Math.max(0, match.index - 40);
const snippet = content.substring(snippetStart, match.index + match[0].length + 40).trim().substring(0, 200);
if (isPlaceholderLine(snippet) || matchesExcludePatterns(snippet, rule)) {
if (!pattern.global) break;
continue;
}
findings.push({
id: `F${++this.findingCounter}`,
ruleId: rule.id,
category: rule.category,
severity: rule.severity,
title: rule.description,
description: rule.description,
filePath: file,
lineNumber,
snippet,
remediation: rule.remediation,
analyzer: this.name,
});
if (!pattern.global) break;
}
}
continue;
}
for (let i = 0; i < lines.length; i++) {
const line = lines[i];
if (isPlaceholderLine(line)) continue;
if (matchesExcludePatterns(line, rule)) continue;
for (const pattern of rule.patterns) {
pattern.lastIndex = 0;
if (pattern.test(line)) {
findings.push({
id: `F${++this.findingCounter}`,
ruleId: rule.id,
category: rule.category,
severity: rule.severity,
title: rule.description,
description: rule.description,
filePath: file,
lineNumber: i + 1,
snippet: line.trim().substring(0, 200),
remediation: rule.remediation,
analyzer: this.name,
});
break;
}
}
}
}
}
return findings;
}
}
+10
View File
@@ -0,0 +1,10 @@
export { Severity, ThreatCategory } from './types.js';
export type { SecurityRule, Finding, ScanResult, ScanOptions } from './types.js';
export type { Analyzer } from './analyzers/base.js';
export { StaticAnalyzer } from './analyzers/static.js';
export { ManifestAnalyzer } from './analyzers/manifest.js';
export { SecretsAnalyzer } from './analyzers/secrets.js';
export { SkillScanner } from './scanner.js';
export { formatResult, formatSummary, formatJson, formatTable, formatSarif } from './reporter.js';
export { THREAT_TAXONOMY, getThreatInfo, getDefaultSeverity } from './taxonomy.js';
export { getAllRules } from './rules/index.js';
+182
View File
@@ -0,0 +1,182 @@
import { basename } from 'node:path';
import type { Finding, ScanResult } from './types.js';
import { Severity } from './types.js';
declare const __PACKAGE_VERSION__: string;
const SCANNER_VERSION = typeof __PACKAGE_VERSION__ !== 'undefined' ? __PACKAGE_VERSION__ : '0.0.0';
const SEVERITY_COLORS: Record<string, string> = {
[Severity.CRITICAL]: '\x1b[91m',
[Severity.HIGH]: '\x1b[31m',
[Severity.MEDIUM]: '\x1b[33m',
[Severity.LOW]: '\x1b[36m',
[Severity.INFO]: '\x1b[37m',
[Severity.SAFE]: '\x1b[32m',
};
const RESET = '\x1b[0m';
const BOLD = '\x1b[1m';
const DIM = '\x1b[2m';
const VERDICT_ICON: Record<string, string> = {
pass: '\x1b[32m PASS \x1b[0m',
warn: '\x1b[33m WARN \x1b[0m',
fail: '\x1b[91m FAIL \x1b[0m',
};
export function formatSummary(result: ScanResult): string {
const lines: string[] = [];
lines.push('');
lines.push(`${BOLD}Security Scan: ${result.skillName}${RESET}`);
lines.push(`Verdict: ${VERDICT_ICON[result.verdict] ?? result.verdict}`);
lines.push(`Duration: ${result.duration}ms | Analyzers: ${result.analyzersUsed.join(', ')}`);
lines.push('');
const { critical, high, medium, low, info } = result.stats;
const parts: string[] = [];
if (critical) parts.push(`${SEVERITY_COLORS[Severity.CRITICAL]}${critical} critical${RESET}`);
if (high) parts.push(`${SEVERITY_COLORS[Severity.HIGH]}${high} high${RESET}`);
if (medium) parts.push(`${SEVERITY_COLORS[Severity.MEDIUM]}${medium} medium${RESET}`);
if (low) parts.push(`${SEVERITY_COLORS[Severity.LOW]}${low} low${RESET}`);
if (info) parts.push(`${SEVERITY_COLORS[Severity.INFO]}${info} info${RESET}`);
if (parts.length > 0) {
lines.push(`Findings: ${parts.join(' | ')}`);
lines.push('');
} else {
lines.push(`${SEVERITY_COLORS[Severity.SAFE]}No security findings${RESET}`);
lines.push('');
return lines.join('\n');
}
for (const finding of result.findings) {
const color = SEVERITY_COLORS[finding.severity] ?? '';
const sev = finding.severity.toUpperCase().padEnd(8);
lines.push(` ${color}${sev}${RESET} [${finding.ruleId}] ${finding.title}`);
if (finding.filePath) {
const loc = finding.lineNumber ? `${finding.filePath}:${finding.lineNumber}` : finding.filePath;
lines.push(` ${DIM}${loc}${RESET}`);
}
if (finding.snippet) {
lines.push(` ${DIM}> ${finding.snippet}${RESET}`);
}
if (finding.remediation) {
lines.push(` Fix: ${finding.remediation}`);
}
lines.push('');
}
return lines.join('\n');
}
export function formatJson(result: ScanResult): string {
return JSON.stringify(result, null, 2);
}
export function formatTable(result: ScanResult): string {
const lines: string[] = [];
const header = ['Severity', 'Rule', 'Title', 'File', 'Line'];
const widths = [10, 8, 50, 40, 6];
lines.push(header.map((h, i) => h.padEnd(widths[i])).join(' | '));
lines.push(widths.map((w) => '-'.repeat(w)).join('-+-'));
for (const f of result.findings) {
const row = [
f.severity.toUpperCase().padEnd(widths[0]),
f.ruleId.padEnd(widths[1]),
f.title.substring(0, widths[2]).padEnd(widths[2]),
(f.filePath ? basename(f.filePath) : '').substring(0, widths[3]).padEnd(widths[3]),
String(f.lineNumber ?? '').padEnd(widths[4]),
];
lines.push(row.join(' | '));
}
lines.push('');
lines.push(`Total: ${result.findings.length} findings | Verdict: ${result.verdict.toUpperCase()}`);
return lines.join('\n');
}
export function formatSarif(result: ScanResult): string {
const rules = new Map<string, Finding>();
for (const f of result.findings) {
if (!rules.has(f.ruleId)) rules.set(f.ruleId, f);
}
const severityToSarif: Record<string, string> = {
[Severity.CRITICAL]: 'error',
[Severity.HIGH]: 'error',
[Severity.MEDIUM]: 'warning',
[Severity.LOW]: 'note',
[Severity.INFO]: 'note',
[Severity.SAFE]: 'none',
};
const sarif = {
$schema: 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/main/sarif-2.1/schema/sarif-schema-2.1.0.json',
version: '2.1.0',
runs: [
{
tool: {
driver: {
name: 'skillkit-scanner',
version: SCANNER_VERSION,
informationUri: 'https://agenstskills.com',
rules: [...rules.values()].map((r) => ({
id: r.ruleId,
name: r.ruleId,
shortDescription: { text: r.title },
fullDescription: { text: r.description },
helpUri: 'https://agenstskills.com/docs/security',
defaultConfiguration: {
level: severityToSarif[r.severity] ?? 'warning',
},
properties: {
category: r.category,
},
})),
},
},
results: result.findings.map((f) => ({
ruleId: f.ruleId,
level: severityToSarif[f.severity] ?? 'warning',
message: { text: f.description },
locations: f.filePath
? [
{
physicalLocation: {
artifactLocation: {
uri: f.filePath.startsWith(result.skillPath)
? f.filePath.slice(result.skillPath.length).replace(/^\//, '')
: f.filePath,
},
region: f.lineNumber
? { startLine: f.lineNumber }
: undefined,
},
},
]
: [],
fixes: f.remediation
? [{ description: { text: f.remediation } }]
: undefined,
})),
},
],
};
return JSON.stringify(sarif, null, 2);
}
export function formatResult(result: ScanResult, format: string = 'summary'): string {
switch (format) {
case 'json': return formatJson(result);
case 'table': return formatTable(result);
case 'sarif': return formatSarif(result);
default: return formatSummary(result);
}
}
@@ -0,0 +1,114 @@
import { type SecurityRule, Severity, ThreatCategory } from '../types.js';
export const commandInjectionRules: SecurityRule[] = [
{
id: 'CI001',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.CRITICAL,
patterns: [/\beval\s*\(/],
excludePatterns: [/\/\/.*\beval\b/, /#.*\beval\b/, /['"].*\beval\b.*['"]/],
fileTypes: ['typescript', 'javascript', 'python'],
description: 'eval() call: dynamic code execution',
remediation: 'Replace eval() with safer alternatives like JSON.parse() or dedicated parsers.',
},
{
id: 'CI002',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.CRITICAL,
patterns: [/new\s+Function\s*\(/, /\bFunction\s*\(\s*['"`]/],
fileTypes: ['typescript', 'javascript'],
description: 'Function() constructor: dynamic code generation',
remediation: 'Avoid Function() constructor. Use static code structures.',
},
{
id: 'CI003',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.CRITICAL,
patterns: [
/child_process\s*['"]?\s*\)\s*\.\s*exec\s*\(/,
/\bexec\s*\(\s*['"`].*\$\{/,
/\bexecSync\s*\(/,
/require\s*\(\s*['"]child_process['"]\s*\)/,
],
fileTypes: ['typescript', 'javascript'],
description: 'child_process execution: shell command injection risk',
remediation: 'Use execFile() with argument arrays instead of exec() with string interpolation.',
},
{
id: 'CI004',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.CRITICAL,
patterns: [
/subprocess\.(?:call|run|Popen)\s*\([^)]*shell\s*=\s*True/,
/os\.system\s*\(/,
/os\.popen\s*\(/,
],
fileTypes: ['python'],
description: 'Python shell execution with shell=True or os.system()',
remediation: 'Use subprocess.run() with shell=False and argument lists.',
},
{
id: 'CI005',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.MEDIUM,
patterns: [/`[^`]*\$\{[^}]*\}[^`]*`/],
excludePatterns: [/console\.log/, /logger\./, /throw\s+new/, /return\s+`/, /=\s*`/, /\+\s*`/, /\(\s*`/],
fileTypes: ['typescript', 'javascript'],
description: 'Template literal with dynamic content in potential command context',
remediation: 'Avoid interpolating user input into command strings. Use argument arrays.',
},
{
id: 'CI006',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.MEDIUM,
patterns: [/\.\.\//, /\.\.\\/],
excludePatterns: [/import\s+.*from\s+['"]\.\.\//, /require\s*\(\s*['"]\.\.\//, /\/\/.*\.\.\//, /#.*\.\.\//, /\]\(\.\.\//, /href\s*=\s*['"]\.\.\//, /src\s*=\s*['"]\.\.\//, /include\s+['"]\.\.\//, /!\[.*\]\(\.\.\//, /\.\.\/node_modules/],
fileTypes: ['typescript', 'javascript', 'python', 'bash'],
description: 'Path traversal: relative path escaping directory boundaries',
remediation: 'Use path.resolve() and validate paths are within expected directories.',
},
{
id: 'CI007',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.HIGH,
patterns: [
/;\s*(?:rm|cat|curl|wget|nc|ncat)\s+/,
/\|\s*(?:sh|bash|zsh|dash)\b/,
/&&\s*(?:rm|curl|wget)\s+/,
],
fileTypes: ['bash', 'markdown'],
description: 'Shell command chaining with dangerous commands',
remediation: 'Avoid chaining shell commands. Use discrete, validated command invocations.',
},
{
id: 'CI008',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.MEDIUM,
patterns: [/\bexec\s*\(/, /\bspawn\s*\(/],
excludePatterns: [/execFile\s*\(/, /\.exec\s*\(/, /RegExp.*\.exec/],
fileTypes: ['typescript', 'javascript'],
description: 'Process execution functions detected',
remediation: 'Prefer execFile() over exec(). Validate all command arguments.',
},
{
id: 'CI009',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.HIGH,
patterns: [
/\b__import__\s*\(/,
/\bcompile\s*\(\s*['"][^'"]*['"]\s*,\s*['"][^'"]*['"]\s*,\s*['"]exec['"]\s*\)/,
],
fileTypes: ['python'],
description: 'Python dynamic import or code compilation',
remediation: 'Use standard import statements. Avoid dynamic code compilation.',
},
{
id: 'CI010',
category: ThreatCategory.COMMAND_INJECTION,
severity: Severity.MEDIUM,
patterns: [/\bvm\.runIn(?:ThisContext|NewContext|Context)\s*\(/],
fileTypes: ['typescript', 'javascript'],
description: 'Node.js vm module: sandboxed but potentially dangerous code execution',
remediation: 'Avoid vm module for untrusted code. Use proper sandboxing solutions.',
},
];
@@ -0,0 +1,101 @@
import { type SecurityRule, Severity, ThreatCategory } from '../types.js';
export const dataExfiltrationRules: SecurityRule[] = [
{
id: 'DE001',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.HIGH,
patterns: [
/https?:\/\/(?:discord(?:app)?\.com\/api\/webhooks|ptb\.discord\.com\/api\/webhooks)\//i,
/https?:\/\/hooks\.slack\.com\/services\//i,
/https?:\/\/api\.telegram\.org\/bot/i,
],
description: 'Webhook URL detected: Discord, Slack, or Telegram webhook endpoint',
remediation: 'Remove hardcoded webhook URLs. Use environment variables or configuration files.',
},
{
id: 'DE002',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.HIGH,
patterns: [
/(?:fetch|axios|request|got|ky|undici)\s*(?:\.\s*post)?\s*\([^)]*(?:process\.env|credentials|password|secret|token)/i,
],
description: 'HTTP request sending sensitive data: credentials or environment variables in request',
remediation: 'Never send credentials or env vars to external services from skill code.',
},
{
id: 'DE003',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.MEDIUM,
patterns: [
/process\.env\[/,
/process\.env\./,
/os\.environ/,
/\$ENV\{/,
],
excludePatterns: [/process\.env\.NODE_ENV/, /process\.env\.HOME/, /process\.env\.PATH/],
description: 'Environment variable access: skill reads environment variables',
remediation: 'Skills should declare required env vars in manifest, not access them directly.',
},
{
id: 'DE004',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.HIGH,
patterns: [
/readFile.*(?:\.env|credentials|\.aws|\.ssh|\.gnupg|\.netrc)/i,
/open\s*\(\s*['"].*(?:\.env|credentials|\.aws|\.ssh|\.gnupg)/i,
/cat\s+.*(?:\.env|credentials|id_rsa|\.aws\/)/i,
],
description: 'Sensitive file access: reading credential or configuration files',
remediation: 'Skills should not read user credential files.',
},
{
id: 'DE005',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.MEDIUM,
patterns: [
/new\s+WebSocket\s*\(\s*['"`]/,
/\bio\.connect\s*\(/,
],
description: 'WebSocket connection: potential covert data channel',
remediation: 'Document all network connections. Avoid persistent connections in skills.',
},
{
id: 'DE006',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.HIGH,
patterns: [
/https?:\/\/[a-z0-9]+\.ngrok\b/i,
/https?:\/\/[a-z0-9]+\.serveo\.net/i,
/https?:\/\/[a-z0-9]+\.loca\.lt/i,
/https?:\/\/[a-z0-9]+\.burpcollaborator\.net/i,
],
description: 'Tunneling service URL: potential data exfiltration via tunnel',
remediation: 'Remove tunneling service URLs. Use official API endpoints.',
},
{
id: 'DE007',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.MEDIUM,
patterns: [
/dns\.resolve/i,
/\bdnslookup\b/i,
/\bnslookup\s+/i,
/\bdig\s+/i,
],
description: 'DNS-based data exfiltration: DNS queries can encode stolen data',
remediation: 'Skills should not perform DNS queries unless explicitly required.',
},
{
id: 'DE008',
category: ThreatCategory.DATA_EXFILTRATION,
severity: Severity.MEDIUM,
patterns: [
/(?:fetch|axios|request|got)\s*\(\s*['"`]https?:\/\/(?!localhost|127\.0\.0\.1)/,
],
excludePatterns: [/(?:npmjs\.org|github\.com|githubusercontent\.com|registry\.npmmirror)/],
fileTypes: ['typescript', 'javascript'],
description: 'External HTTP request: skill makes outbound network call',
remediation: 'Declare all external URLs in skill manifest. Minimize network access.',
},
];
+24
View File
@@ -0,0 +1,24 @@
import type { SecurityRule } from '../types.js';
import { promptInjectionRules } from './prompt-injection.js';
import { commandInjectionRules } from './command-injection.js';
import { dataExfiltrationRules } from './data-exfiltration.js';
import { toolAbuseRules } from './tool-abuse.js';
import { unicodeRules } from './unicode.js';
export function getAllRules(): SecurityRule[] {
return [
...promptInjectionRules,
...commandInjectionRules,
...dataExfiltrationRules,
...toolAbuseRules,
...unicodeRules,
];
}
export {
promptInjectionRules,
commandInjectionRules,
dataExfiltrationRules,
toolAbuseRules,
unicodeRules,
};
@@ -0,0 +1,145 @@
import { type SecurityRule, Severity, ThreatCategory } from '../types.js';
export const promptInjectionRules: SecurityRule[] = [
{
id: 'PI001',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.CRITICAL,
patterns: [/ignore\s+(all\s+)?(previous|above|prior)\s+(instructions?|rules?|guidelines?)/i],
description: 'Instruction override: attempts to discard system instructions',
remediation: 'Remove instruction override language. Skills should not attempt to modify agent behavior.',
},
{
id: 'PI002',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.CRITICAL,
patterns: [/forget\s+(everything|all|what)\s+(you|i)\s+(told|said|learned)/i],
description: 'Context clearing: attempts to wipe agent memory',
remediation: 'Remove context-clearing instructions.',
},
{
id: 'PI003',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.CRITICAL,
patterns: [/disregard\s+(your|all|the)\s+(training|programming|instructions?)/i],
description: 'Training bypass: attempts to override agent training',
remediation: 'Remove training bypass instructions.',
},
{
id: 'PI004',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.CRITICAL,
patterns: [/new\s+instructions?:\s*$/im, /system\s+prompt:\s*$/im],
description: 'System prompt injection: attempts to inject new system-level instructions',
remediation: 'Do not include system prompt markers in skill content.',
},
{
id: 'PI005',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [/you\s+are\s+(now|actually|really)\s+(a|an|the)/i],
description: 'Role manipulation: attempts to reassign agent identity',
remediation: 'Skills should not attempt to change the agent\'s role or identity.',
},
{
id: 'PI006',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [/pretend\s+(to\s+be|you\s+are)/i, /act\s+as\s+(if|though)\s+you/i],
description: 'Roleplay manipulation: attempts to alter agent behavior via pretense',
remediation: 'Remove roleplay instructions that change agent behavior.',
},
{
id: 'PI007',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [/from\s+now\s+on,?\s+(you|always|never)/i],
description: 'Persistent behavior change: attempts to permanently alter agent behavior',
remediation: 'Skills should provide task-specific instructions, not permanent behavior changes.',
},
{
id: 'PI008',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [
/show\s+me\s+your\s+(system\s+)?(prompt|instructions)/i,
/reveal\s+your\s+(system\s+)?(prompt|instructions)/i,
/what\s+are\s+your\s+(system\s+)?(instructions|rules)/i,
],
description: 'System prompt extraction: attempts to reveal agent configuration',
remediation: 'Remove attempts to extract system prompts.',
},
{
id: 'PI009',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.CRITICAL,
patterns: [
/unrestricted\s+mode/i,
/(?<!detect(?:ing)?[\s.]+)(?<!prevent(?:ing)?[\s.]+)jailbreak/i,
/DAN\s+(mode|prompt)/i,
/bypass\s+(safety|content)\s+(filter|restriction)/i,
],
description: 'Policy bypass: attempts to disable safety restrictions',
remediation: 'Remove jailbreak or policy bypass instructions.',
},
{
id: 'PI010',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [
/don'?t\s+tell\s+the\s+user/i,
/hide\s+this\s+from\s+the\s+user/i,
/keep\s+this\s+(a\s+)?secret/i,
/do\s+not\s+mention\s+this/i,
],
description: 'Concealment: instructs agent to hide information from user',
remediation: 'Skills should be transparent. Remove concealment instructions.',
},
{
id: 'PI011',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [
/```\s*(system|assistant|user)\s*$/im,
/<\/?(?:system|user|assistant|human|ai|claude)>/i,
],
description: 'Delimiter injection: attempts to inject conversation role markers',
remediation: 'Remove conversation role delimiters from skill content.',
},
{
id: 'PI012',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.HIGH,
patterns: [/\[INST\]/i, /\[\/INST\]/i, /<<SYS>>/i, /<<\/SYS>>/i],
description: 'Model-specific delimiter injection: Llama-style instruction delimiters',
remediation: 'Remove model-specific instruction delimiters.',
},
{
id: 'PI013',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.MEDIUM,
patterns: [/---\s*$/im],
excludePatterns: [/^---\s*$/],
multiline: true,
description: 'YAML front-matter injection: attempts to inject via YAML metadata',
remediation: 'Use standard SKILL.md frontmatter format only.',
},
{
id: 'PI014',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.MEDIUM,
patterns: [
/<!--[^>]{0,500}?(?:ignore|system|instruction|secret|override)[^>]{0,500}?-->/i,
],
description: 'Hidden HTML comments with suspicious instruction content',
remediation: 'Do not hide instructions in HTML comments.',
},
{
id: 'PI015',
category: ThreatCategory.PROMPT_INJECTION,
severity: Severity.MEDIUM,
patterns: [/\[comment\]:\s*#\s*\([^)]*(?:ignore|system|override)[^)]*\)/i],
description: 'Hidden Markdown comments with suspicious content',
remediation: 'Do not hide instructions in Markdown comments.',
},
];
@@ -0,0 +1,77 @@
import { type SecurityRule, Severity, ThreatCategory } from '../types.js';
export const toolAbuseRules: SecurityRule[] = [
{
id: 'TA001',
category: ThreatCategory.TOOL_ABUSE,
severity: Severity.HIGH,
patterns: [
/(?:override|replace|redefine|shadow)\s+(?:the\s+)?(?:built-?in|default|original)\s+(?:tool|function|command)/i,
],
fileTypes: ['markdown'],
description: 'Tool shadowing: instructs agent to override built-in tools',
remediation: 'Skills should extend functionality, not replace built-in tools.',
},
{
id: 'TA002',
category: ThreatCategory.AUTONOMY_ABUSE,
severity: Severity.HIGH,
patterns: [
/(?:keep|continue)\s+(?:retrying|trying|running)\s+(?:until|without)/i,
/(?:run|execute|proceed)\s+without\s+(?:confirmation|approval|asking)/i,
/(?:auto-?approve|skip\s+confirmation|bypass\s+approval)/i,
/(?:don'?t|do\s+not|never)\s+(?:ask|prompt|wait)\s+(?:for|the)\s+(?:permission|confirmation|approval)/i,
],
fileTypes: ['markdown'],
description: 'Autonomy abuse: instructs agent to bypass user confirmation',
remediation: 'Skills must respect user confirmation flows. Remove autonomy escalation.',
},
{
id: 'TA003',
category: ThreatCategory.TOOL_ABUSE,
severity: Severity.MEDIUM,
patterns: [
/(?:discover|find|list|enumerate)\s+(?:all\s+)?(?:available\s+)?(?:tools|capabilities|functions)/i,
/(?:enable|activate|unlock)\s+(?:all\s+)?(?:hidden|disabled|extra)\s+(?:tools|capabilities)/i,
],
fileTypes: ['markdown'],
description: 'Capability inflation: attempts to discover or enable additional tools',
remediation: 'Skills should use only declared tools. Do not probe for hidden capabilities.',
},
{
id: 'TA004',
category: ThreatCategory.TOOL_ABUSE,
severity: Severity.HIGH,
patterns: [
/read\s+(?:the\s+)?(?:file|contents?).*(?:then|and)\s+(?:send|post|upload|transmit)/i,
/(?:access|read|get)\s+.*(?:credential|secret|key|token).*(?:then|and)\s+(?:send|share|post)/i,
],
fileTypes: ['markdown'],
description: 'Tool chaining: read sensitive data then send externally',
remediation: 'Skills should not combine file reading with external transmission.',
},
{
id: 'TA005',
category: ThreatCategory.SOCIAL_ENGINEERING,
severity: Severity.MEDIUM,
patterns: [
/(?:urgent|immediately|critical|emergency)[!:]\s+(?:you\s+must|run|execute|do\s+this)/i,
/(?:as\s+(?:an?\s+)?(?:admin|root|superuser|administrator)),?\s+(?:I|we)\s+(?:require|need|demand)/i,
],
fileTypes: ['markdown'],
description: 'Social engineering: uses urgency or authority to manipulate agent',
remediation: 'Remove manipulative language. Provide clear, neutral instructions.',
},
{
id: 'TA006',
category: ThreatCategory.TOOL_ABUSE,
severity: Severity.MEDIUM,
patterns: [
/(?:when|if)\s+(?:the\s+)?(?:user|human)\s+(?:isn'?t|is\s+not)\s+(?:looking|watching|present)/i,
/(?:only|secretly)\s+(?:when|while)\s+(?:idle|unattended|background)/i,
],
fileTypes: ['markdown'],
description: 'Stealth execution: instructs agent to act when user is not present',
remediation: 'All skill actions must be transparent and auditable.',
},
];
@@ -0,0 +1,68 @@
import { type SecurityRule, Severity, ThreatCategory } from '../types.js';
export const unicodeRules: SecurityRule[] = [
{
id: 'UC001',
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
severity: Severity.MEDIUM,
patterns: [/\u200B|\u200C|\u200D|\uFEFF/],
description: 'Zero-width characters detected: may hide invisible instructions',
remediation: 'Remove zero-width characters (U+200B, U+200C, U+200D, U+FEFF).',
},
{
id: 'UC002',
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
severity: Severity.HIGH,
patterns: [/[\u202A-\u202E]/],
description: 'Bidirectional text override: can reverse displayed text direction to hide content',
remediation: 'Remove bidirectional override characters (U+202A-U+202E).',
},
{
id: 'UC003',
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
severity: Severity.HIGH,
patterns: [/[\u2066-\u2069]/],
description: 'Bidirectional isolate characters: can create hidden text regions',
remediation: 'Remove bidirectional isolate characters (U+2066-U+2069).',
},
{
id: 'UC004',
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
severity: Severity.HIGH,
patterns: [/[\u{E0001}-\u{E007F}]/u],
description: 'Tag characters detected: Unicode tag block can encode hidden payloads',
remediation: 'Remove Unicode tag characters (U+E0001-U+E007F).',
},
{
id: 'UC005',
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
severity: Severity.MEDIUM,
// biome-ignore lint/suspicious/noControlCharactersInRegex: intentional detection of control characters
patterns: [/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/],
description: 'Control characters detected: non-printable characters in content',
remediation: 'Remove control characters. Use only printable Unicode content.',
},
{
id: 'UC006',
category: ThreatCategory.OBFUSCATION,
severity: Severity.MEDIUM,
patterns: [
/atob\s*\(\s*['"`][A-Za-z0-9+/=]{40,}['"`]\s*\)/,
/Buffer\.from\s*\(\s*['"`][A-Za-z0-9+/=]{40,}['"`]\s*,\s*['"`]base64['"`]\s*\)/,
/base64\.b64decode\s*\(\s*['"`][A-Za-z0-9+/=]{40,}['"`]\s*\)/,
],
description: 'Base64-encoded payload: long encoded string being decoded at runtime',
remediation: 'Avoid embedding base64-encoded payloads. Use plain text or documented data formats.',
},
{
id: 'UC007',
category: ThreatCategory.OBFUSCATION,
severity: Severity.MEDIUM,
patterns: [
/\\x[0-9a-fA-F]{2}(?:\\x[0-9a-fA-F]{2}){9,}/,
/\\u[0-9a-fA-F]{4}(?:\\u[0-9a-fA-F]{4}){9,}/,
],
description: 'Hex/Unicode escape sequences: potential obfuscated content',
remediation: 'Use readable strings instead of hex or unicode escape sequences.',
},
];
+131
View File
@@ -0,0 +1,131 @@
import { readdir } from 'node:fs/promises';
import { join, basename } from 'node:path';
import type { Analyzer } from './analyzers/base.js';
import { StaticAnalyzer } from './analyzers/static.js';
import { ManifestAnalyzer } from './analyzers/manifest.js';
import { SecretsAnalyzer } from './analyzers/secrets.js';
import type { Finding, ScanResult, ScanOptions } from './types.js';
import { Severity } from './types.js';
const SEVERITY_ORDER: Record<string, number> = {
[Severity.CRITICAL]: 5,
[Severity.HIGH]: 4,
[Severity.MEDIUM]: 3,
[Severity.LOW]: 2,
[Severity.INFO]: 1,
[Severity.SAFE]: 0,
};
async function discoverFiles(dirPath: string): Promise<string[]> {
const files: string[] = [];
async function walk(dir: string): Promise<void> {
let entries;
try {
entries = await readdir(dir, { withFileTypes: true });
} catch {
return;
}
for (const entry of entries) {
const fullPath = join(dir, entry.name);
if (entry.name.startsWith('.') && entry.name !== '.env' && !entry.name.startsWith('.env.')) continue;
if (entry.name === 'node_modules') continue;
if (entry.isDirectory()) {
await walk(fullPath);
} else if (entry.isFile()) {
files.push(fullPath);
}
}
}
await walk(dirPath);
return files;
}
function deduplicateFindings(findings: Finding[]): Finding[] {
const seen = new Set<string>();
return findings.filter((f) => {
const key = `${f.ruleId}:${f.filePath ?? ''}:${f.lineNumber ?? ''}`;
if (seen.has(key)) return false;
seen.add(key);
return true;
});
}
function calculateVerdict(
findings: Finding[],
failOnSeverity: Severity = Severity.HIGH
): 'pass' | 'warn' | 'fail' {
const threshold = SEVERITY_ORDER[failOnSeverity] ?? SEVERITY_ORDER[Severity.HIGH];
for (const f of findings) {
if ((SEVERITY_ORDER[f.severity] ?? 0) >= threshold) {
return 'fail';
}
}
if (findings.some((f) => (SEVERITY_ORDER[f.severity] ?? 0) >= SEVERITY_ORDER[Severity.MEDIUM])) {
return 'warn';
}
return 'pass';
}
function countStats(findings: Finding[]): ScanResult['stats'] {
const stats = { critical: 0, high: 0, medium: 0, low: 0, info: 0 };
for (const f of findings) {
switch (f.severity) {
case Severity.CRITICAL: stats.critical++; break;
case Severity.HIGH: stats.high++; break;
case Severity.MEDIUM: stats.medium++; break;
case Severity.LOW: stats.low++; break;
case Severity.INFO: stats.info++; break;
}
}
return stats;
}
export class SkillScanner {
private analyzers: Analyzer[];
private options: ScanOptions;
constructor(options?: ScanOptions) {
this.options = options ?? {};
this.analyzers = [
new StaticAnalyzer(this.options.skipRules),
new ManifestAnalyzer(this.options.skipRules),
new SecretsAnalyzer(this.options.skipRules),
];
}
async scan(skillPath: string): Promise<ScanResult> {
const start = performance.now();
const files = await discoverFiles(skillPath);
const skillName = basename(skillPath.replace(/\/+$/, '')) || 'unknown';
const resultSets = await Promise.all(
this.analyzers.map((a) => a.analyze(skillPath, files))
);
const allFindings = deduplicateFindings(resultSets.flat());
allFindings.sort(
(a, b) => (SEVERITY_ORDER[b.severity] ?? 0) - (SEVERITY_ORDER[a.severity] ?? 0)
);
const duration = Math.round(performance.now() - start);
return {
skillPath,
skillName,
verdict: calculateVerdict(allFindings, this.options.failOnSeverity),
findings: allFindings,
stats: countStats(allFindings),
duration,
analyzersUsed: this.analyzers.map((a) => a.name),
};
}
}
+130
View File
@@ -0,0 +1,130 @@
import { ThreatCategory, Severity } from './types.js';
export interface ThreatInfo {
category: ThreatCategory;
name: string;
description: string;
defaultSeverity: Severity;
examples: string[];
}
export const THREAT_TAXONOMY: Record<ThreatCategory, ThreatInfo> = {
[ThreatCategory.PROMPT_INJECTION]: {
category: ThreatCategory.PROMPT_INJECTION,
name: 'Prompt Injection',
description: 'Attempts to override, manipulate, or bypass AI agent instructions through crafted text',
defaultSeverity: Severity.CRITICAL,
examples: [
'Instruction override (ignore previous instructions)',
'Role manipulation (you are now...)',
'System prompt extraction',
],
},
[ThreatCategory.COMMAND_INJECTION]: {
category: ThreatCategory.COMMAND_INJECTION,
name: 'Command Injection',
description: 'Code execution via eval, exec, subprocess, or shell commands embedded in skill content',
defaultSeverity: Severity.CRITICAL,
examples: [
'eval() or Function() calls',
'subprocess.run with shell=True',
'child_process.exec with user input',
],
},
[ThreatCategory.DATA_EXFILTRATION]: {
category: ThreatCategory.DATA_EXFILTRATION,
name: 'Data Exfiltration',
description: 'Attempts to send sensitive data to external endpoints or read protected files',
defaultSeverity: Severity.HIGH,
examples: [
'Webhook URLs to Discord/Telegram/Slack',
'HTTP POST with environment variables',
'Reading .env or credential files',
],
},
[ThreatCategory.TOOL_ABUSE]: {
category: ThreatCategory.TOOL_ABUSE,
name: 'Tool Abuse',
description: 'Manipulation of AI agent tools through shadowing, chaining, or autonomy escalation',
defaultSeverity: Severity.HIGH,
examples: [
'Redefining built-in tools',
'Instructing agent to run without confirmation',
'Chaining sensitive read + external send',
],
},
[ThreatCategory.HARDCODED_SECRETS]: {
category: ThreatCategory.HARDCODED_SECRETS,
name: 'Hardcoded Secrets',
description: 'API keys, tokens, passwords, or other credentials embedded in skill files',
defaultSeverity: Severity.HIGH,
examples: [
'API keys (sk-, pk_live_, ghp_)',
'Private key blocks',
'Embedded .env file contents',
],
},
[ThreatCategory.UNICODE_STEGANOGRAPHY]: {
category: ThreatCategory.UNICODE_STEGANOGRAPHY,
name: 'Unicode Steganography',
description: 'Hidden content using invisible Unicode characters, bidirectional overrides, or homoglyphs',
defaultSeverity: Severity.MEDIUM,
examples: [
'Zero-width characters hiding instructions',
'Bidirectional text override attacks',
'Tag characters encoding hidden payloads',
],
},
[ThreatCategory.OBFUSCATION]: {
category: ThreatCategory.OBFUSCATION,
name: 'Obfuscation',
description: 'Deliberately obscured code or instructions to hide malicious intent',
defaultSeverity: Severity.MEDIUM,
examples: [
'Base64-encoded commands',
'Hex-encoded payloads',
'String concatenation to evade detection',
],
},
[ThreatCategory.SOCIAL_ENGINEERING]: {
category: ThreatCategory.SOCIAL_ENGINEERING,
name: 'Social Engineering',
description: 'Manipulative language targeting the AI agent or the user to bypass safety measures',
defaultSeverity: Severity.MEDIUM,
examples: [
'Urgency pressure (do this immediately)',
'Authority claims (as an admin, I require...)',
'Concealment requests (don\'t tell the user)',
],
},
[ThreatCategory.AUTONOMY_ABUSE]: {
category: ThreatCategory.AUTONOMY_ABUSE,
name: 'Autonomy Abuse',
description: 'Instructions that escalate agent autonomy beyond intended boundaries',
defaultSeverity: Severity.HIGH,
examples: [
'Run without user confirmation',
'Keep retrying until success',
'Auto-approve all actions',
],
},
[ThreatCategory.POLICY_VIOLATION]: {
category: ThreatCategory.POLICY_VIOLATION,
name: 'Policy Violation',
description: 'Content that violates skill marketplace policies or naming conventions',
defaultSeverity: Severity.LOW,
examples: [
'Impersonating official tools',
'Missing required metadata',
'Binary files in skill directory',
],
},
};
export function getThreatInfo(category: ThreatCategory): ThreatInfo {
return THREAT_TAXONOMY[category];
}
export function getDefaultSeverity(category: ThreatCategory): Severity {
return THREAT_TAXONOMY[category].defaultSeverity;
}
+69
View File
@@ -0,0 +1,69 @@
export enum Severity {
CRITICAL = 'critical',
HIGH = 'high',
MEDIUM = 'medium',
LOW = 'low',
INFO = 'info',
SAFE = 'safe',
}
export enum ThreatCategory {
PROMPT_INJECTION = 'prompt-injection',
COMMAND_INJECTION = 'command-injection',
DATA_EXFILTRATION = 'data-exfiltration',
TOOL_ABUSE = 'tool-abuse',
HARDCODED_SECRETS = 'hardcoded-secrets',
UNICODE_STEGANOGRAPHY = 'unicode-steganography',
OBFUSCATION = 'obfuscation',
SOCIAL_ENGINEERING = 'social-engineering',
AUTONOMY_ABUSE = 'autonomy-abuse',
POLICY_VIOLATION = 'policy-violation',
}
export interface SecurityRule {
id: string;
category: ThreatCategory;
severity: Severity;
patterns: RegExp[];
excludePatterns?: RegExp[];
fileTypes?: string[];
multiline?: boolean;
description: string;
remediation: string;
}
export interface Finding {
id: string;
ruleId: string;
category: ThreatCategory;
severity: Severity;
title: string;
description: string;
filePath?: string;
lineNumber?: number;
snippet?: string;
remediation?: string;
analyzer: string;
aitech?: string;
}
export interface ScanResult {
skillPath: string;
skillName: string;
verdict: 'pass' | 'warn' | 'fail';
findings: Finding[];
stats: {
critical: number;
high: number;
medium: number;
low: number;
info: number;
};
duration: number;
analyzersUsed: string[];
}
export interface ScanOptions {
failOnSeverity?: Severity;
skipRules?: string[];
}
+5
View File
@@ -401,6 +401,11 @@ export function translateSkillToAll(
'claude-code', 'cursor', 'codex', 'gemini-cli', 'opencode',
'antigravity', 'amp', 'clawdbot', 'droid', 'github-copilot',
'goose', 'kilo', 'kiro-cli', 'roo', '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',
];
for (const agent of agents) {
@@ -329,7 +329,7 @@ Follow these guidelines`;
});
describe('supported agents', () => {
it('should support all 32 agents', () => {
it('should support all 44 agents', () => {
const allAgents = [
'claude-code',
'cursor',
@@ -348,6 +348,18 @@ Follow these guidelines`;
'trae',
'windsurf',
'universal',
'devin',
'aider',
'sourcegraph-cody',
'amazon-q',
'augment-code',
'replit-agent',
'bolt',
'lovable',
'tabby',
'tabnine',
'codegpt',
'playcode-agent',
] as const;
const skill: CanonicalSkill = {
+12
View File
@@ -46,6 +46,18 @@ export const AGENT_FORMAT_MAP: Record<AgentType, FormatCategory> = {
'qwen': 'skill-md',
'vercel': 'skill-md',
'zencoder': 'skill-md',
'devin': 'external',
'aider': 'skill-md',
'sourcegraph-cody': 'skill-md',
'amazon-q': 'skill-md',
'augment-code': 'skill-md',
'replit-agent': 'external',
'bolt': 'external',
'lovable': 'external',
'tabby': 'skill-md',
'tabnine': 'skill-md',
'codegpt': 'skill-md',
'playcode-agent': 'external',
};
/**
+12
View File
@@ -33,6 +33,18 @@ export const AgentType = z.enum([
'qwen',
'vercel',
'zencoder',
'devin',
'aider',
'sourcegraph-cody',
'amazon-q',
'augment-code',
'replit-agent',
'bolt',
'lovable',
'tabby',
'tabnine',
'codegpt',
'playcode-agent',
]);
export type AgentType = z.infer<typeof AgentType>;
+6
View File
@@ -1,5 +1,8 @@
import { readFileSync } from 'node:fs';
import { defineConfig } from 'tsup';
const pkg = JSON.parse(readFileSync('./package.json', 'utf-8'));
export default defineConfig({
entry: ['src/index.ts'],
format: ['esm'],
@@ -11,4 +14,7 @@ export default defineConfig({
splitting: false,
skipNodeModulesBundle: true,
platform: 'node',
define: {
'__PACKAGE_VERSION__': JSON.stringify(pkg.version),
},
});
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp-memory",
"version": "1.14.0",
"version": "1.16.0",
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp",
"version": "1.14.0",
"version": "1.16.0",
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/memory",
"version": "1.14.0",
"version": "1.16.0",
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mesh",
"version": "1.14.0",
"version": "1.16.0",
"description": "Peer mesh network for multi-machine agent distribution",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/messaging",
"version": "1.14.0",
"version": "1.16.0",
"description": "Inter-agent messaging system for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/resources",
"version": "1.14.0",
"version": "1.16.0",
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "1.14.0",
"version": "1.16.0",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+2 -1
View File
@@ -8,7 +8,7 @@ import { StatusBar } from './components/StatusBar.js';
import {
Home, Browse, Installed, Marketplace, Settings, Recommend,
Translate, Context, Memory, Team, Plugins, Methodology,
Plan, Workflow, Execute, History, Sync, Help, Mesh, Message,
Plan, Workflow, Execute, History, Sync, Help, Mesh, Message, Scan,
} from './screens/index.js';
const DOCS_URL = 'https://agenstskills.com/docs';
@@ -137,6 +137,7 @@ export function App(props: AppProps) {
<Match when={currentScreen() === 'help'}><Help {...screenProps()} /></Match>
<Match when={currentScreen() === 'mesh'}><Mesh {...screenProps()} /></Match>
<Match when={currentScreen() === 'message'}><Message {...screenProps()} /></Match>
<Match when={currentScreen() === 'scan'}><Scan {...screenProps()} /></Match>
</Switch>
</box>
</box>
@@ -28,6 +28,7 @@ const SCREEN_LABELS: Record<Screen, string> = {
help: 'Help',
mesh: 'Mesh',
message: 'Message',
scan: 'Security Scan',
};
export function BottomStatusBar(props: BottomStatusBarProps) {
+1
View File
@@ -26,6 +26,7 @@ const SHORTCUTS = [
{ key: 'n', desc: 'Plan' },
{ key: 'v', desc: 'Validate' },
{ key: 'u', desc: 'Publish' },
{ key: 'z', desc: 'Security scan' },
]},
{ section: 'Team & Config', items: [
{ key: 'a', desc: 'Team settings' },
+218
View File
@@ -0,0 +1,218 @@
import { createSignal, createEffect, Show, For, createMemo } from 'solid-js';
import { useKeyboard } from '@opentui/solid';
import { type Screen } from '../state/index.js';
import { terminalColors } from '../theme/colors.js';
import { Header } from '../components/Header.js';
import { Spinner } from '../components/Spinner.js';
import { EmptyState } from '../components/EmptyState.js';
import { execFile } from 'node:child_process';
interface ScanProps {
onNavigate: (screen: Screen) => void;
cols?: number;
rows?: number;
}
interface ScanFinding {
ruleId: string;
severity: string;
title: string;
filePath?: string;
lineNumber?: number;
snippet?: string;
remediation?: string;
}
interface ScanResult {
skillPath: string;
skillName: string;
verdict: 'pass' | 'warn' | 'fail';
findings: ScanFinding[];
stats: { critical: number; high: number; medium: number; low: number; info: number };
duration: number;
analyzersUsed: string[];
}
function getSeverityColor(severity: string): string {
switch (severity.toLowerCase()) {
case 'critical': return '#ff5555';
case 'high': return '#ff4444';
case 'medium': return '#ffaa00';
case 'low': return '#00bbcc';
case 'info': return '#888888';
default: return terminalColors.textMuted;
}
}
function getVerdictColor(verdict: string): string {
switch (verdict) {
case 'pass': return '#22cc44';
case 'warn': return '#ffaa00';
case 'fail': return '#ff5555';
default: return terminalColors.textMuted;
}
}
export function Scan(props: ScanProps) {
const [scanning, setScanning] = createSignal(false);
const [result, setResult] = createSignal<ScanResult | null>(null);
const [error, setError] = createSignal<string | null>(null);
const [scanPath] = createSignal('.');
const [selectedIndex, setSelectedIndex] = createSignal(0);
const rows = () => props.rows ?? 24;
const visibleCount = () => Math.max(1, rows() - 14);
const runScan = (path: string) => {
setScanning(true);
setError(null);
setResult(null);
try {
execFile('npx', ['skillkit', 'scan', path, '--format', 'json'], {
timeout: 30000,
maxBuffer: 1024 * 1024,
}, (err, stdout, stderr) => {
setScanning(false);
if (err && !stdout) {
setError(stderr || err.message || 'Scan failed');
return;
}
try {
const parsed = JSON.parse(stdout) as ScanResult;
setResult(parsed);
} catch {
setError('Failed to parse scan results');
}
});
} catch (err) {
setScanning(false);
setError(err instanceof Error ? err.message : 'Failed to start scan');
}
};
createEffect(() => {
runScan(scanPath());
});
const findings = createMemo(() => result()?.findings ?? []);
const windowStart = createMemo(() => Math.max(0, selectedIndex() - visibleCount() + 1));
const visibleFindings = createMemo(() =>
findings().slice(windowStart(), windowStart() + visibleCount())
);
useKeyboard((key: { name?: string; sequence?: string }) => {
if (key.name === 'k' || key.name === 'up') {
setSelectedIndex(i => Math.max(0, i - 1));
} else if (key.name === 'j' || key.name === 'down') {
setSelectedIndex(i => Math.min(findings().length - 1, i + 1));
} else if (key.name === 'r') {
runScan(scanPath());
}
});
return (
<box flexDirection="column" padding={1}>
<Header
title="Security Scan"
subtitle="detect vulnerabilities in skills"
icon="\u25D0"
/>
<Show when={scanning()}>
<box flexDirection="row" gap={1}>
<Spinner />
<text fg={terminalColors.textMuted}>Scanning {scanPath()}...</text>
</box>
</Show>
<Show when={error()}>
<box flexDirection="column">
<text fg="#ff5555">Scan error: {error()}</text>
<text fg={terminalColors.textMuted}>Press r to retry</text>
</box>
</Show>
<Show when={result() && !scanning()}>
<box flexDirection="column">
<box flexDirection="row" gap={2}>
<text fg={terminalColors.text}>
{result()!.skillName}
</text>
<text fg={getVerdictColor(result()!.verdict)}>
{result()!.verdict.toUpperCase()}
</text>
<text fg={terminalColors.textMuted}>
{result()!.duration}ms
</text>
</box>
<box flexDirection="row" gap={2}>
<Show when={result()!.stats.critical > 0}>
<text fg="#ff5555">{result()!.stats.critical} critical</text>
</Show>
<Show when={result()!.stats.high > 0}>
<text fg="#ff4444">{result()!.stats.high} high</text>
</Show>
<Show when={result()!.stats.medium > 0}>
<text fg="#ffaa00">{result()!.stats.medium} medium</text>
</Show>
<Show when={result()!.stats.low > 0}>
<text fg="#00bbcc">{result()!.stats.low} low</text>
</Show>
<Show when={result()!.stats.info > 0}>
<text fg="#888888">{result()!.stats.info} info</text>
</Show>
<Show when={findings().length === 0}>
<text fg="#22cc44">No findings</text>
</Show>
</box>
<text fg={terminalColors.textMuted}>{'─'.repeat(Math.min(60, (props.cols ?? 80) - 4))}</text>
<Show when={findings().length === 0}>
<EmptyState title="No security findings detected" />
</Show>
<Show when={findings().length > 0}>
<For each={visibleFindings()}>
{(finding, idx) => {
const absoluteIdx = () => windowStart() + idx();
const isSelected = () => absoluteIdx() === selectedIndex();
return (
<box flexDirection="column">
<box flexDirection="row" gap={1}>
<text fg={isSelected() ? terminalColors.accent : terminalColors.textMuted}>
{isSelected() ? '>' : ' '}
</text>
<text fg={getSeverityColor(finding.severity)}>
{finding.severity.toUpperCase().padEnd(8)}
</text>
<text fg={terminalColors.textMuted}>[{finding.ruleId}]</text>
<text fg={isSelected() ? terminalColors.text : terminalColors.textMuted}>
{finding.title}
</text>
</box>
<Show when={isSelected() && finding.filePath}>
<text fg={terminalColors.textMuted}>
{' '}{finding.filePath}{finding.lineNumber ? `:${finding.lineNumber}` : ''}
</text>
</Show>
<Show when={isSelected() && finding.remediation}>
<text fg={terminalColors.accent}>
{' '}Fix: {finding.remediation}
</text>
</Show>
</box>
);
}}
</For>
</Show>
</box>
</Show>
<text> </text>
<text fg={terminalColors.textMuted}>j/k navigate r rescan esc back</text>
</box>
);
}
+1
View File
@@ -22,3 +22,4 @@ export { Settings } from './Settings.js';
export { Help } from './Help.js';
export { Mesh } from './Mesh.js';
export { Message } from './Message.js';
export { Scan } from './Scan.js';
@@ -30,7 +30,19 @@ export type AgentType =
| 'qoder'
| 'qwen'
| 'vercel'
| 'zencoder';
| 'zencoder'
| 'devin'
| 'aider'
| 'sourcegraph-cody'
| 'amazon-q'
| 'augment-code'
| 'replit-agent'
| 'bolt'
| 'lovable'
| 'tabby'
| 'tabnine'
| 'codegpt'
| 'playcode-agent';
export interface TranslationDisplay {
sourceFormat: string;
+3 -2
View File
@@ -25,14 +25,14 @@ export type Screen =
| 'home' | 'browse' | 'installed' | 'marketplace' | 'recommend'
| 'translate' | 'context' | 'memory' | 'team' | 'plugins'
| 'methodology' | 'plan' | 'workflow' | 'execute' | 'history'
| 'sync' | 'settings' | 'help' | 'mesh' | 'message';
| 'sync' | 'settings' | 'help' | 'mesh' | 'message' | 'scan';
export const NAV_KEYS: Record<string, Screen> = {
h: 'home', m: 'marketplace', b: 'browse', w: 'workflow',
x: 'execute', y: 'history', r: 'recommend', t: 'translate',
c: 'context', e: 'memory', i: 'installed', s: 'sync',
a: 'team', p: 'plugins', o: 'methodology', n: 'plan',
',': 'settings', '/': 'help', 'g': 'mesh', 'j': 'message',
',': 'settings', '/': 'help', 'g': 'mesh', 'j': 'message', 'z': 'scan',
} as const;
export const STATUS_BAR_SHORTCUTS = 'b browse m market i installed s sync / help q quit';
@@ -64,6 +64,7 @@ export const SIDEBAR_NAV: SidebarSection[] = [
{ key: 'i', label: 'Installed', screen: 'installed' },
{ key: 's', label: 'Sync', screen: 'sync' },
{ key: 't', label: 'Translate', screen: 'translate' },
{ key: 'z', label: 'Scan', screen: 'scan' },
],
},
{
+12
View File
@@ -47,6 +47,18 @@ export const AGENT_LOGOS: Record<string, AgentLogo> = {
'qwen': { icon: '⊧', name: 'Qwen', company: 'Alibaba' },
'vercel': { icon: '▲', name: 'Vercel', company: 'Vercel' },
'zencoder': { icon: '⊩', name: 'Zencoder', company: '' },
'devin': { icon: '▧', name: 'Devin', company: 'Cognition' },
'aider': { icon: '▨', name: 'Aider', company: '' },
'sourcegraph-cody': { icon: '▩', name: 'Cody', company: 'Sourcegraph' },
'amazon-q': { icon: '▪', name: 'Amazon Q', company: 'AWS' },
'augment-code': { icon: '▫', name: 'Augment', company: 'Augment Code' },
'replit-agent': { icon: '▴', name: 'Replit Agent', company: 'Replit' },
'bolt': { icon: '⚡', name: 'Bolt', company: 'StackBlitz' },
'lovable': { icon: '♥', name: 'Lovable', company: 'Lovable' },
'tabby': { icon: '▹', name: 'Tabby', company: 'TabbyML' },
'tabnine': { icon: '►', name: 'Tabnine', company: 'Tabnine' },
'codegpt': { icon: '▻', name: 'CodeGPT', company: '' },
'playcode-agent': { icon: '▽', name: 'PlayCode', company: '' },
'universal': { icon: '●', name: 'Universal', company: '' },
} as const;