Make the desktop app visible in the homepage, navigation, and README before CLI installation. Add localized installation guides and promotion copy across all five documentation languages, with Homebrew as the recommended macOS path.
16 KiB
skillshare
English · 日本語 · 한국어 · 简体中文 · 繁體中文
AI CLI の skills、agents、rules、commands などを、ひとつのソースで管理。デスクトップアプリで操作するか、コマンドひとつですべてのツールに同期でき、個人から組織全体まで使えます。
Codex、Claude Code、OpenClaw、OpenCode など 60 以上のツールに対応。
公式サイト • インストール • クイックスタート • 主な機能 • スクリーンショット • デスクトップアプリ • ドキュメント
Note
最新バージョン:v0.23.0 — global と project の両スコープでネイティブ hooks を管理・同期し、
tools.allowとtools.denyでモデルが使える MCP tools を選択できます。dashboard に追加された Hooks ページと MCP ツール選択画面からも設定できます。新機能と修正の一覧は Releases と変更履歴をご覧ください。
skillshare を使う理由
AI CLI はそれぞれ独自の skills ディレクトリを持っています。 ひとつを編集して別のツールへのコピーを忘れ、どれが最新か分からなくなります。
skillshare はこの問題を解決します。
- ひとつのソースをすべての agent へ —
skillshare syncで Claude、Cursor、Codex など 60 以上のツールに同期 - Agent 管理 — カスタム agent を skills と一緒に、agent 対応の target へ同期
- skills だけではない — extras で rules、commands、prompts などファイルベースのリソースを管理
- MCP 接続 — サーバーの定義は一度だけ。
sync mcpが各 Agent 固有の設定形式に書き込みます - plugin 一式 — plugin の skills、hooks、MCP 設定をまとめたまま、
pluginでインストール先のツールを選択 - ネイティブ hooks — Agent ごとの event 設定や extension コードを管理。プレビュー、有効/無効、復元に対応。 hooks
- どこからでもインストール — GitHub、GitLab、Bitbucket、Azure DevOps、Gitea、CNB、またはセルフホストの Git
- セキュリティ機能を内蔵 — 使う前に、prompt injection やデータ流出につながる内容がないか skills を監査
- チームで使える — プロジェクトの skills は
.skillshare/に、組織共通の skills は tracked repo で配布 - ローカルで軽量 — 単一バイナリ。registry もテレメトリもなく、完全にオフラインで動作
- きめ細かなフィルタリング —
.skillignore、SKILL.md のtargets、target ごとの include/exclude で、どの skills をどの target に届けるかを制御
仕組み
- macOS / Linux:
~/.config/skillshare/ - Windows:
%AppData%\skillshare\
┌─────────────────────────────────────────────────────────────┐
│ Source Directory │
│ ~/.config/skillshare/skills/ ← skills (SKILL.md) │
│ ~/.config/skillshare/agents/ ← agents │
│ ~/.config/skillshare/extras/ ← rules, commands, etc. │
└─────────────────────────────────────────────────────────────┘
│ sync
┌───────────────┼───────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ OpenCode │ │ OpenClaw │ ...
└───────────┘ └───────────┘ └───────────┘
| プラットフォーム | Skills のソース | Agents のソース | Extras のソース | リンク方式 |
|---|---|---|---|---|
| macOS/Linux | ~/.config/skillshare/skills/ |
~/.config/skillshare/agents/ |
~/.config/skillshare/extras/ |
Symlinks |
| Windows | %AppData%\skillshare\skills\ |
%AppData%\skillshare\agents\ |
%AppData%\skillshare\extras\ |
フォルダーは NTFS Junction(管理者権限は不要)。ファイルのシンボリックリンクには Developer Mode が必要で、ない場合はコピー |
| 命令型(コマンドごとにインストール) | 宣言型(skillshare) | |
|---|---|---|
| 単一のソース | skills を個別にコピー | ひとつのソースから symlink(またはコピー)で配布 |
| 新しいマシンのセットアップ | すべてのインストールを手作業でやり直す | 設定を git clone して sync |
| セキュリティ監査 | なし | audit を内蔵。install と update の際に自動スキャン |
| Web ダッシュボード | なし | skillshare ui |
| 実行時の依存 | Node.js + npm | なし(単一の Go バイナリ) |
CLI と UI のプレビュー
| Skill の詳細 | セキュリティ監査 |
|---|---|
![]() |
![]() |
| Web ダッシュボード | Web の Skills ページ |
|---|---|
![]() |
![]() |
インストール
Tip
デスクトップで skillshare を管理。 macOS(Apple Silicon)、Windows、Linux 向けの Skillshare App をダウンロード。初回起動では CLI のインストールまたは既存の CLI の選択、AI ツールの選択、初回の同期を案内します。インストールガイド。
デスクトップアプリ — 画面で設定・管理
Skillshare App はスキル、エージェント、MCP、hooks をデスクトップのウィンドウで管理できます。アプリをインストールして開き、初回起動の案内に沿って設定してください。
macOS(Apple Silicon)では Homebrew を使用:
brew tap runkids/tap
brew install --cask skillshare-app
Windows/Linux、または macOS に手動でインストールする場合:最新版のアプリインストーラーをダウンロード。各プラットフォームの詳細はデスクトップアプリのガイドをご覧ください。
CLI:macOS / Linux
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
スクリプトはデフォルトで ~/.local/bin にインストールするため、通常のインストールと更新に sudo は不要です。インストーラーが PATH 設定の案内を表示した場合のみ、その案内に従ってから skillshare を実行してください。今後のターミナルでも使えるよう、案内された行を shell 設定ファイル(~/.zshrc や ~/.bashrc など)に追加できます。別の場所には INSTALL_DIR を指定できます。
Windows PowerShell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
CLI:Homebrew
brew install skillshare
ヒント:
skillshare upgradeで最新版に更新できます。インストール方法を自動で判別し、残りの作業も行います。
GitHub Actions
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
すべてのオプション(audit、project モード、バージョン固定)は setup-skillshare を参照してください。
短縮コマンド(任意)
シェルの設定ファイル(~/.zshrc または ~/.bashrc)に alias を追加します。
alias ss='skillshare'
クイックスタート
skillshare init # 設定、ソース、検出された target を作成
skillshare sync # skills をすべての target に同期
主な機能
skills のインストールと更新 — GitHub、GitLab、その他の Git ホストから
skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy # symlink が使えない場合
symlink で問題が起きたら — target ごとに copy モードへ切り替え
skillshare target <name> --mode copy
skillshare sync
セキュリティ監査 — skills が agent に届く前にスキャン
skillshare audit
プロジェクトの skills — リポジトリごとに管理し、コードと一緒に commit
skillshare init -p && skillshare sync
Agents — カスタム agent を agent 対応の target に同期
skillshare sync agents # agents だけを同期
skillshare sync --all # skills、agents、extras、MCP、hooks をまとめて同期
Extras — rules、commands、prompts などを管理
skillshare extras init rules # "rules" という extra を作成
skillshare sync --all # skills、agents、extras、MCP、hooks をまとめて同期
skillshare extras collect rules # ローカルのファイルをソースに取り込む
MCP 接続 — 一度の設定で Claude Code、Codex、Cursor、VS Code、OpenCode などに反映
skillshare mcp add # ガイド付き設定。URL を入力するか JSON を貼り付け
skillshare sync mcp --dry-run # 各ツールの設定ファイルへの変更をプレビュー
skillshare sync mcp # 接続設定を適用
定義は config.yaml に書くか、別の mcp.yaml を参照できます。
設定例、環境変数の参照、既存の接続のインポートは MCP の設定を参照してください。
hook を実行せずにネイティブ hooks を管理:
skillshare hooks add check --file ./check.yaml
skillshare hooks sync --dry-run
skillshare hooks sync
Plugins — plugin 一式をインストールし、インストール先のツールを選択
skillshare plugin add # ガイド付き:ソース、plugin、target、確認
skillshare plugin add owner/repo --target claude --target codex --no-tui
skillshare sync plugins --dry-run # plugin の同期は sync --all とは別
ツールにインストール済みの plugin は plugin import で管理下に置けます。
ツールをまたいだ plugin の管理を参照してください。
シェル補完 — コマンド、フラグ、サブコマンドを Tab で補完
skillshare completion bash --install # zsh、fish、powershell、nushell にも対応
ローカルチェックポイント — ソースの変更を push せずに commit
skillshare commit -m "Update review skill"
skillshare commit --dry-run
Web ダッシュボード — 視覚的なコントロールパネル
skillshare ui
コントリビュート
コントリビュートを歓迎します。まず issue を立て、テスト付きの draft PR を送ってください。 セットアップの詳細は CONTRIBUTING.md を参照してください。
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
Tip
どこから始めればよいか分からない場合は、open issues を見るか、セットアップ不要の開発環境 Playground を試してください。
コントリビューター
skillshare を支えてくださったすべての方に感謝します。一覧は英語版 README にあります。
skillshare が役に立ったら、⭐ をお願いします
Star History
ライセンス
MIT





