simple-skill-cli
sametcelikbicak/simple-skill-cli
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.
Instalação
npx convez-ai sametcelikbicak/simple-skill-cli1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
RoleCraft — Simple Skill Installer for AI
Zero-dependency CLI to install AI agent skills as roles & behaviors 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.
Why rolecraft?
| Feature | rolecraft | npx add-skill | @agentskill.sh/cli |
|---|---|---|---|
| Zero dependencies | ✅ | ✅ | ❌ (2) |
| Local path install | ✅ 1st class | ❌ GitHub only | ❌ marketplace only |
| GitHub repo install | ✅ | ✅ | ❌ |
| Offline capable | ✅ | ❌ | ❌ |
| agentskill.sh lockfile compatible | ✅ | ✅ | ✅ |
| Project-level install | ✅ | ✅ | ✅ |
| File size | ~3 KB | ~500 KB+ | ~84 KB |
Install
npm install -g rolecraft
# or
npx rolecraft install <source>
Usage
rolecraft install ./path/to/my-skill # install from local folder
rolecraft install sametcelikbicak/task-decomposer # install from GitHub
rolecraft list # list installed skills
rolecraft remove <slug> # remove a skill
Install scope
When you run rolecraft install <source> without flags, it asks where to install:
Where do you want to install this skill?
1) Global (~/.agents/skills/) [default]
2) Project (./.agents/skills/)
3) Both
Use flags to skip the prompt:
rolecraft install ./my-skill --global # ~/.agents/skills/
rolecraft install ./my-skill --project # ./.agents/skills/
rolecraft install ./my-skill --claude # also ~/.claude/skills/
rolecraft install ./my-skill --all # all locations
Source types
Local path — any directory containing SKILL.md:
rolecraft install ./my-skill
rolecraft install ~/projects/my-skill
rolecraft install /absolute/path/to/skill
GitHub repo — shorthand owner/repo:
rolecraft install sametcelikbicak/task-decomposer
rolecraft install sametcelikbicak/coverage-guard
The CLI clones with --depth 1, finds SKILL.md recursively, installs it, and cleans up.
What it does
- Reads
SKILL.mdfrom the source and parses metadata (slug, name, owner) - Copies all files alongside
SKILL.md(references, configs, assets) to the target directory - Updates
~/.agents/.skill-lock.jsonso agents can discover the skill - Compatible with skills installed by
@agentskill.sh/cli,add-skill, or manual installs
How agents discover skills
| Agent | Directory |
|---|---|
| opencode | ~/.agents/skills/ or ./.agents/skills/ |
| claude-code | ~/.claude/skills/ or ./.claude/skills/ |
| cursor | ~/.cursor/skills/ or ./.cursor/skills/ |
Commands
| Command | Description |
|---|---|
rolecraft install <source> | Install a skill (local or GitHub) |
rolecraft list | Show all installed skills |
rolecraft remove <slug> | Uninstall a skill |
rolecraft help | Show this help |
Project structure
rolecraft/
├── bin/rolecraft.js # CLI entry point
├── src/
│ ├── commands/
│ │ ├── install.js # install logic + interactive scope
│ │ ├── list.js # list installed skills
│ │ └── remove.js # remove skill + lockfile cleanup
│ └── utils/
│ ├── resolver.js # source resolver (local / GitHub)
│ ├── installer.js # copy files to target dirs
│ └── lockfile.js # read/write .skill-lock.json
├── package.json
└── README.md
License
MIT