RoleCraft：AI agent skills と MCP の install を local CLI にする
AI coding agent が増えるほど、team はかなり素朴な問題にぶつかる。instructions、skills、MCP servers、agent config をどう配るのか。
一人は Claude Code を使い、別の人は Cursor を使い、CI には独自の agent runner がいる。project convention は AGENTS.md にあり、code review の癖は skill にあり、database tool は MCP server として必要になる。file copy でしばらくは耐えられるが、machine、agent、team をまたいで reuse し始めると、それ自体が configuration sync problem になる。
今日メモしておきたい sametcelikbicak/rolecraft は、この問題を local CLI として扱う project だ。任意の source から AI agent skills を install し、それらが宣言する MCP servers も管理する。marketplace-first ではなく、signup も前提にしない。README が前面に出しているのは、local folder、GitHub/GitLab/Bitbucket、SSH git URL、npm package といった、developer がすでに使っている配布経路だ。
2026-07-16 時点で GitHub repository API、repository page、README、Tags、CHANGELOG、package.json、security docs、LICENSE から確認できる公開情報では、sametcelikbicak/rolecraft は 71 stars、9 forks。主言語は JavaScript、license は MIT。repository 作成日は 2026-06-12 15:31:13 UTC、最近の public push は 2026-07-15 15:55:53 UTC。default branch main の最新 commit は f169206、commit time は 2026-07-15 15:55:51 UTC。GitHub Releases には current latest release がない。Tags page の最新 tag は v1.5.0、tag commit は 3b5e9f1。package.json 上の npm package name は rolecraft、version は 1.5.0、required Node.js は >= 20、runtime dependencies は空だ。
プロジェクト概要
| 項目 | 内容 |
|---|---|
| リポジトリ | sametcelikbicak/rolecraft |
| 位置づけ | AI agent skills と MCP servers の local install / management CLI |
| Stars | 71 |
| Forks | 9 |
| 主言語 | JavaScript |
| ライセンス | MIT |
| リポジトリ作成日 | 2026-06-12 15:31:13 UTC |
| 最近 push | 2026-07-15 15:55:53 UTC |
| 最新 main commit | f169206、2026-07-15 15:55:51 UTC |
| Latest GitHub release | current latest release なし |
| 最新 tag | v1.5.0、tag commit 3b5e9f1 |
| npm package | rolecraft 1.5.0、Node.js >= 20 |
| runtime dependencies | third-party dependencies なし |
| キーワード | AI agent skills、MCP、CLI、local-first、agent configuration |
model の問題ではなく、配布の問題を扱う
AI agent ecosystem では最近、「agent のための knowledge package」が増えている。skills、commands、rules、hooks、MCP server config、project convention、review checklist。これらは結局、team が再利用したい behavior だ。
問題は、その behavior が特定 client の directory に閉じ込められやすいことだ。Claude Code には Claude Code の場所があり、Cursor には rules file があり、OpenCode、Goose、Copilot、Aider、Gemini CLI もそれぞれ作法が違う。同じ skill を全 tool に手で copy すれば短期的には動く。しかし長期的には、version が同じか分からない、誰が変更したか分からない、CI や新しい member の machine で再現しづらい、という問題になる。
RoleCraft の切り口は現実的だ。新しい agent platform を作るのではなく、CLI で install、update、check、remove、lockfile-based reinstall を扱う。README にある command には install、setup、list、check、verify、doctor、ci、profile、mcp install/remove/list が含まれる。雰囲気としては chat UI ではなく、npm、brew、mise に近い local tool manager だ。
Skills と MCP を一緒に扱う
RoleCraft でいちばん見たい点は、skill と MCP server を完全に別 workflow にしていないところだ。
README の例では、SKILL.md frontmatter が MCP servers を宣言している場合、rolecraft install ./postgres-rules --cursor で skill と対応する MCP server を一緒に install できる。MCP server だけを扱いたい場合は、rolecraft mcp install npm:@modelcontextprotocol/github --cursor のような command もある。
これは実際の team では重要だ。多くの agent skill は数段落の instruction だけでは完結しない。database review skill には Postgres MCP server が必要かもしれない。issue triage skill には GitHub MCP server が必要かもしれない。internal docs skill には search や knowledge base tool が必要になる。prompt だけ配って tool config を配らなければ、agent は結局、必要な手足を持たない。
RoleCraft はこの二つを一つの install action に近づけようとしている。skill の中身が良いことを保証するわけではないが、「instructions と tool entry を一緒に agent へ渡す」という engineering problem を扱っている。
Zero dependencies という取捨選択
package.json では RoleCraft に runtime third-party dependencies がない。README でも zero dependencies を強調している。CLI tool として、この選択には意味がある。
一方では、agent skill installer は local config、project files、agent directories、場合によっては MCP server config に触れる。dependency が少ないほど supply-chain surface は小さくなり、audit cost も少し下がる。もう一方で、zero dependencies は download、path handling、verification、interaction、platform difference を自前で抱えるということでもある。機能が増えるほど maintenance pressure は上がる。
だから、zero dependencies を絶対的な強みとしてではなく、conservative design signal として見るのがよさそうだ。作者はこの installer を軽く、audit しやすく、developer machine と CI に置きやすい tool にしたいのだと思う。installer 系の tool として、この方向は理解できる。
Security scan は必要だが、万能ではない
RoleCraft の security docs には、install 時の 0-100 static score がある。skill files に対して regex pattern を使い、prompt injection、command injection、obfuscated code、sensitive file access、credential harvesting、data exfiltration、network requests などを見る。90-100 はそのまま install、70-89 は confirmation、0-69 は default block、ただし user が明示的に --yes を使えば進められる。
方向性は正しい。skill は agent への instruction そのものなので、source が信頼できなければ、malicious prompt、dangerous shell command、credential read logic を持ち込む可能性がある。install action を security checkpoint にする方が、SKILL.md を手で copy するよりずっとよい。
ただし境界もある。README と security docs が示している通り、これは zero-dependency static analysis で、rule は主に pattern matching だ。明らかな危険文言や common risk signal は拾えるが、skill が完全に安全だと証明するものではない。team で使うなら、source trust、code review、version pinning、lockfile、そして --yes の扱いをきちんと決める必要がある。
向いている場面
第一の場面は、複数の AI coding agent を行き来する個人 developer だ。同じ code review、test、migration、documentation habit を複数 client に同期したいが、各 tool に手で設定したくない場合に合う。
第二の場面は small team だ。project convention、review checklist、deployment notes、internal tool guide を skills にして、ひとつの Git repository から member の agent environment に install できる。
第三の場面は、MCP server config と skill を一緒に届けたい workflow だ。agent に instruction だけ渡しても足りず、どの tool を呼べるかまでセットにしたい場合がある。
第四の場面は CI や standardized dev environment だ。rolecraft ci、lockfile、verify、doctor といった command は、一回だけ試す tool ではなく、repeatable install と health check も意識していることを示している。
注意したいところ
第一に、project はかなり若い。repository 作成日は 2026-06-12。stars と forks はまだ小さく、latest tag は v1.5.0 だが、GitHub Releases の latest release はまだない。導入するなら、まず personal environment や non-critical project で試したい。
第二に、README にある supported agents の数は大きく、scope も広い。実際に使うときは、総数ではなく、自分たちが使う agent の path が安定しているかを見るべきだ。
第三に、skills の品質は installer だけでは保証できない。RoleCraft は install、scan、verify、update を扱えるが、その skill が team の workflow に合っているかは人間が保守する必要がある。
第四に、security score は audit の代わりではない。知らない repository や npm package から来る skill は、score が高くても team default config に直接入れない方がよい。
まとめ
RoleCraft が面白いのは、AI agent ecosystem の中で地味だがすぐ面倒になる問題を扱っているところだ。skills、rules、MCP servers、agent config を、普通の development dependency のように distribute、update、reproduce できるか。
AI coding tool を一つだけたまに使うなら、まだ必須ではないかもしれない。しかし複数 agent を切り替えたり、team convention を installable skills として残したいなら、sametcelikbicak/rolecraft は観察する価値がある。これは「model が良い code を書けるか」ではなく、「agent に渡す behavior と tools を、各 environment へ確実に届けられるか」を解く tool だ。