Skillget

rolecraft

agent
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 21 GitHub stars
Code Fail
  • fs module — File system access in .github/scripts/release-prep.sh
  • execSync — Synchronous shell command execution in bin/rolecraft.test.js
  • process.env — Environment variable access in bin/rolecraft.test.js
  • process.env — Environment variable access in src/commands/bundle.js
  • process.env — Environment variable access in src/commands/bundle.test.js
  • process.env — Environment variable access in src/commands/ci.test.js
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Zero-dependency CLI to install AI agent skills directly from any source. No marketplace, no registry, no signup — just point it at a local folder or a GitHub repo and it works. Works with opencode, claude-code, cursor, and all spec-compliant agents.

README.md

RoleCraft

RoleCraft

Install AI agent skills as roles & behaviors — from any source.
Zero-dependency CLI. No marketplace. No signup.

Awesome npm npm downloads Tests Stars Changelog Contributing MIT

Works with 30+ AI agents: opencode · claude-code · cursor · windsurf · devin · codex · copilot · aider · cline · gemini-cli · cody · continue · warp · codeium · fabric · goose · tabnine · supermaven · pr-pilot · loom · roo · trae · hermes · kiro · augment · kilo · openhands · junie · factory · and more

Quick Start · Why RoleCraft? · Commands · Install Guide · Contribute

RoleCraft demo

Quick start

# try without installing
npx rolecraft --help

# or install globally
npm install -g rolecraft

# create a skill
rolecraft init my-skill

# install it
rolecraft install ./my-skill           # local folder
rolecraft install user/repo            # GitHub repo
rolecraft install ./my-skill --cursor  # specific agent only

# manage
rolecraft list
rolecraft search code-review
rolecraft remove my-skill

Requirements: Node.js >= 20 · No other dependencies · Full install guide →

Features

  • Zero dependencies — ~4 KB, no bloat
  • Any source — local folder, GitHub repo, any URL
  • 30+ agents — opencode, claude-code, cursor, copilot, aider, devin, gemini-cli, and more
  • No registry required — no signup, no marketplace, no vendor lock-in
  • Content hash verification — detect tampered or outdated skills
  • CI-ready — lockfile-based re-install for pipelines
  • Dry-run mode — preview before installing

Commands overview

Command Description Details
rolecraft init [<name>] Scaffold a new SKILL.md docs
rolecraft install <source> Install a skill (local path or GitHub owner/repo) docs
rolecraft bundle <sources> Install multiple skills from inline sources or file docs
rolecraft bundle create Create a new bundle file docs
rolecraft search <query> Search for skills on GitHub docs
rolecraft use <source> Preview a skill's files without installing docs
rolecraft setup [<source>] Detect agents, optionally install a skill to all docs
rolecraft list Show all installed skills docs
rolecraft verify Check installed skill integrity via content hash docs
rolecraft ci Re-install all skills from lockfile (CI mode) docs
rolecraft remove <slug> Uninstall a skill docs
rolecraft update <slug> Re-install a skill to latest docs
rolecraft --version Show version

Why rolecraft?

→ Full feature comparison

Feature rolecraft skills (Vercel) @agentskill.sh/cli
Zero dependencies ✅ ✅ (1 dep) ❌ (2)
Local path install ✅ 1st class ✅ ❌ marketplace only
GitHub repo install ✅ ✅ ❌
Bundle install + create ✅ ❌ ✅ (skillset only)
Interactive search + install ✅ ❌ ❌
Dry-run preview (--dry-run) ✅ ❌ ❌
Interactive scope prompt ✅ ❌ ❌
Content hash verification (verify) ✅ ✅ ❌
CI-mode re-install (ci) ✅ ✅ ❌
File size ~4 KB ~465 KB ~84 KB

See full table →

How agents discover skills

rolecraft knows where each AI agent looks for skills. Use flags like --claude, --cursor, --devin to target specific agents, or --all for every supported agent.

→ Full agent path table

# Install to multiple agents at once
rolecraft install ./my-skill --cursor --devin --copilot --gemini --cody

Architecture

  1. Reads SKILL.md from the source and parses metadata (slug, name, owner)
  2. Copies (or symlinks with --symlink) all files alongside SKILL.md to the target directory
  3. Computes a SHA256 content hash and stores it in the lockfile
  4. Updates ~/.agents/.skill-lock.json so agents can discover the skill
  5. Compatible with skills installed by @agentskill.sh/cli, add-skill, or manual installs

→ Full architecture & project structure

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT

Reviews (0)

No results found