The Security-First Skill Manager for AI Agents
Every install runs a security scan ยท Skills & MCP Servers across 87 Agents (27 Verified)
Zero-dependency CLI ยท No signup ยท Offline-first
Works with 87 AI agents. See the full agent table โ
Quick Start ยท Features ยท Commands ยท Comparison ยท FAQ ยท Security ยท Contribute
โก Zero dependencies ยท ๐ฆ 432.8 kB ยท ๐ค 26 verified agents ยท ๐ Skills + MCP ยท ๐ Security scoring ยท ๐ Skill testing ยท ๐ง Init templates ยท ๐ Offline-first
Full benchmark results โ
ย ย
Full feature comparison โ
ย ย
Migrate from Vercel skills โ
```yaml
# .github/workflows/skills.yml
- uses: rolecraft-sh/rolecraft-action@v1
with:
command: ci --yes
```
See the [CI guide](docs/guides/ci.md) for more examples.
---
## Node.js API
rolecraft exposes a programmatic API for use in your own Node.js scripts and tools:
```js
import {
install,
list,
search,
check,
doctor,
verify,
ci,
mcpInstall,
profileSave,
} from "rolecraft";
// install a skill
const result = await install("./my-skill", { global: true });
console.log(result);
// search GitHub for skills
const results = await search("code-review");
console.log(results.results);
// system health check
const health = await doctor();
console.log(health.summary);
// full API reference โ [docs/reference.md](docs/reference.md)
```
All API functions return plain objects (no side-effects). Available exports:
| Function | Description |
| --------------- | ------------------------------------ |
| `install` | Install a skill with security scan |
| `list` | List installed skills |
| `search` | Search GitHub or skills.sh |
| `resolve` | Resolve a source string |
| `remove` | Uninstall a skill |
| `update` | Re-install a skill |
| `check` | Check for updates |
| `verify` | Verify skill integrity |
| `ci` | Re-install from lockfile |
| `doctor` | System health check |
| `use` | Preview a skill |
| `mcpInstall` | Install an MCP server |
| `mcpList` | List MCP servers |
| `mcpUpdate` | Update an MCP server |
| `mcpRemove` | Remove an MCP server |
| `mcpCheck` | Check MCP server status |
| `mcpSearch` | Search MCP servers |
| `profileSave` | Save current config |
| `profileApply` | Apply a saved profile |
| `profileDiff` | Diff current vs saved |
| `profileList` | List profiles |
| `profileShow` | Show profile details |
| `profileDelete` | Delete a profile |
| `profileImport` | Import a profile |
| `test` | Test a skill quality with assertions |
---
## Commands overview
| Command | Description | Details |
| ------------------------------------------ | --------------------------------------------------------------------------- | ------------------------------------ |
| `rolecraft init [
|
yukidev630: Contributing was straightforward, and it was easy to understand where to make the change. I had a great experience contributing to RoleCraft. |
|
BenjaminAyivoh1: Contributing to RoleCraft was a great experience, especially as one of my first open-source contributions. The issue was clearly defined, and the maintainers were responsive throughout the process, which made it easy to understand the project and contribute confidently |