🔓 unclaimed — this page was auto-generated from GitHub. Are you the creator?
Claim this page →
rolecraft
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…
git clone https://github.com/sametcelikbicak/rolecraft
RoleCraft
Install AI agent skills as roles & behaviors — from any source.
Zero-dependency CLI. No marketplace. No signup.
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
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?
| 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 |
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.
# Install to multiple agents at once
rolecraft install ./my-skill --cursor --devin --copilot --gemini --cody
Architecture
- Reads
SKILL.mdfrom the source and parses metadata (slug, name, owner) - Copies (or symlinks with
--symlink) all files alongsideSKILL.mdto the target directory - Computes a SHA256 content hash and stores it in the lockfile
- Updates
~/.agents/.skill-lock.jsonso agents can discover the skill - 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
// compatibility
| Platforms | cli |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | JavaScript |
// faq
What is rolecraft?
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.. It is open-source on GitHub.
Is rolecraft free to use?
rolecraft is open-source under the MIT license, so it is free to use.
What category does rolecraft belong to?
rolecraft is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/rolecraft)
// retro hit counter
[](https://claudeers.com/rolecraft)
// reviews
// guestbook
// related in Claude Skills
🔓An agentic skills framework & software development methodology that works.
🔓💫 Toolkit to help you get started with Spec-Driven Development
🔓
🔓AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…