yibie/skills-manager

A native macOS app to manage skills across coding agents — Claude Code, Cursor, Copilot CLI, Codex, Gemini CLI

Skills Manager – macOS UI for organising LLM‑coding‑agent skills

What it is

macOS (Sonoma +) のネイティブアプリで、SwiftUI/Swift 6 で作成。Claude Code、Cursor、Gemini CLI、OpenHands など、多数のコード生成エージェント向けの skills（プロンプト指向の拡張機能）の検索、インストール、テスト、整理を一元化します。
ローカルファイルシステムを唯一の信頼できるソースとして扱います：Library には元のスキルパッケージが保存され、Collections でプロジェクトやワークフロー用にグループ化され、Mounts がエージェントのスキルディレクトリにシンボリックリンクを動的に作成します。

Key concepts

Layer	Role
Library	すべてのダウンロード済みスキルパッケージを保存する中央の読み取り専用ストア。
Collection	Library のスキルを再利用可能な名前付きグループ（例：Web‑dev, Data‑Science）にまとめます。
Mount	コレクションを1つ以上のエージェント内にシンボリックリンクで公開するセット。ファイルのコピーは不要です。

Main features

Discover – 公開されている skills.sh カタログからスキル一覧を取得し、ローカルにキャッシュ。オンライン時、サイト全体の検索をサポート。
Try – インストール前に、ローカルに設定された LLM（Claude、OpenAI、OpenRouter、Ollama、LM Studio）でスキルを実行してテスト可能。
Install / Uninstall – サポートされているエージェントの任意のサブセットにワンクリックでインストール。アンマウントはシンボリックリンクのみ削除し、Library はそのまま残ります。
Conflict & state view – エージェント間で欠落、共有、部分適用、差分のあるコピーを表示し、手動で解決可能。
Translation – スキル説明のための組み込み8言語カタログと、新規エントリ用のオンデマンド LLM フォールバック。
Terminal UI – tui/ に実装された bless-style TUI。macOS アプリの機能を完全に再現し、ロールバック用にローカル Git ログを保持。
Automatic monitoring – エージェントのスキルフォルダを監視し、ディスク上のファイル変更を検知して UI を自動更新。

Supported agents (internal AgentRegistry で検出). README には40以上がリストアップされており、Install target とマークされたものはマルチインストールピッカーで選択可能。残りはコンフリクト検出用にスキャンされます。

Installation

GitHub リリースページから署名済み zip をダウンロードし、Applications にドラッグ（macOS 14+ 必須）。
Xcode でソースからビルド（open SkillsManager.xcodeproj）。
TUI 用には cd tui && npm exec skills-manager（またはグローバル skills-manager コマンド用に npm link）。

Architecture & offline stance

完全にローカルファースト：リモートバックエンドなし。カタログの更新、説明の翻訳、Try 時の LLM 呼び出しを除き、データは機械から出ません。
アプリはエージェントの設定ファイルに直接書き込み、インストール履歴をローカル Git ログで管理し、差分比較やロールバックを可能にします。
検索データは ~/.skills-manager/cache/discover-directory.json にキャッシュ。ネットワークはカタログ更新、サイト全体検索、翻訳フォールバック、LLM Try 呼び出し時のみ使用。

Roadmap (as of the README)

License – MIT。

Skills Manager は、複数の LLM ベースのコーディングアシスタントを扱う開発者にとって、エージェント固有のプロンプト拡張機能の成長するエコシステムを統一的に管理する本格的で生産性重視のツールです。