convez.ai
Skill
sametcelikbicak

simple-skill-cli

sametcelikbicak/simple-skill-cli

Ver no GitHub
InicialPluginScore · de 0 a 100

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-cli

1 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

Estrelas
99
Forks
43
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v2.6.2
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

RoleCraft — Simple Skill Installer for AI

Awesome npm GitHub Stars

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?

Featurerolecraftnpx 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

  1. Reads SKILL.md from the source and parses metadata (slug, name, owner)
  2. Copies all files alongside SKILL.md (references, configs, assets) to the target directory
  3. Updates ~/.agents/.skill-lock.json so agents can discover the skill
  4. Compatible with skills installed by @agentskill.sh/cli, add-skill, or manual installs

How agents discover skills

AgentDirectory
opencode~/.agents/skills/ or ./.agents/skills/
claude-code~/.claude/skills/ or ./.claude/skills/
cursor~/.cursor/skills/ or ./.cursor/skills/

Commands

CommandDescription
rolecraft install <source>Install a skill (local or GitHub)
rolecraft listShow all installed skills
rolecraft remove <slug>Uninstall a skill
rolecraft helpShow 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

Ver o original no GitHub

Bom para

Relacionados