Codex Skill Manager(Codex スキルマネージャー)
概要
Codex Skill Managerは、Codexの「スキル(skills)」を手元で管理・閲覧するためのmacOSアプリです。SwiftUIを用いたモダンなUIで、ローカルに配置されたスキル群(デフォルトは ~/.codex/skills/public)をサイドバーで一覧し、選択したスキルのSKILL.mdをMarkdownとしてレンダリングします。Markdown内の参照に対してインラインプレビューを表示することで、ドキュメントの確認がスムーズになります。Clawdhubと連携してリモートスキルの検索や最新公開物の閲覧・ダウンロードも可能で、フォルダやZIPからのインポート、サイドバーからの削除などローカル運用に必要な機能をひと通り備えています。(約300字)
リポジトリの統計情報
- スター数: 42
- フォーク数: 0
- ウォッチャー数: 42
- コミット数: 14
- ファイル数: 14
- メインの言語: Swift
主な特徴
- ローカルスキル(~/.codex/skills/public)を一覧して管理
- SKILL.mdをMarkdownでレンダリング、インライン参照プレビューを表示
- フォルダ/ZIPからスキルをインポート、サイドバーから削除可能
- Clawdhubのリモートスキル検索と最新ドロップの参照・ダウンロード
技術的なポイント
Codex Skill ManagerはSwiftUIで構築されたmacOSアプリで、特徴的なのは「SwiftPMのみでビルドされる」点(Xcodeプロジェクトを持たない)です。Package.swiftで製品や依存を定義し、リソースの管理もSwiftPMの仕組みで行う設計が想定されます。UIはSwiftUIのList/Sidebarパターンを使い、ユーザーのスキル一覧と詳細(Markdown)を分かりやすく二分割表示しているでしょう。ローカルスキルの検出にはFileManagerで ~/.codex/skills/public を監視・列挙し、更新や削除操作を反映します。SKILL.mdのレンダリングにはMarkdownパーサ(組み込みのAttributedStringのMarkdown、もしくは外部ライブラリ)を用い、リンク・参照のインラインプレビューはHTMLレンダリングやカスタムビューで実装されていることが推測されます。Clawdhub連携はHTTP APIを叩くことで実現され、検索や最新項目のフェッチ、ZIPダウンロード後の展開とインポート処理を行います。セキュリティ面では、ローカルファイル操作とネットワーク通信の両方があるため、ファイルの上書き確認やダウンロード時の検証、ユーザー許可(サンドボックス外でのアクセスを提供する場合の対処)が重要です。また、SwiftPMのみの構成はCIやビルド自動化に向いており、Homebrewやアーカイブ配布のパッケージングに柔軟性を与えます。(約700字)
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- .vscode: dir
- AGENTS.md: file
- Icon.icns: file
- Icon.iconset: dir
- Package.swift: file
- README.md: file
- Sources: dir
- Resources: dir
- LICENSE: file …他 4 ファイル
(上記は代表的な構成。SwiftPMで管理されたSources配下にアプリのSwiftUIコード、Resourcesに画像やアセット、Package.swiftでターゲット/依存が定義されている想定です。)
使い方(簡易)
- リポジトリをクローンして Swift Package Manager でビルド(swift build / swift run、あるいは Xcode でパッケージを開く)
- アプリ起動後、サイドバーにローカルスキルが表示される
- SKILL.mdを選択するとMarkdownがレンダリングされ、参照のプレビューが表示される
- Clawdhubタブからリモート検索、ダウンロード、ローカルへのインポートが可能
まとめ
Codexのスキル運用を簡潔に管理できる、SwiftUI×SwiftPMの軽量なmacOSアプリです。(約50字)
リポジトリ情報:
- 名前: CodexSkillManager
- 説明: macOS app to manage your Codex skills
- スター数: 42
- 言語: Swift
- URL: https://github.com/Dimillian/CodexSkillManager
- オーナー: Dimillian
- アバター: https://avatars.githubusercontent.com/u/535509?v=4
READMEの抜粋:
Codex Skill Manager
image
Codex Skill Manager is a macOS SwiftUI app built with SwiftPM (no Xcode project). It lists your local Codex skills, renders each SKILL.md, and lets you browse remote skills from Clawdhub.
Features
- Browse local skills from
~/.codex/skills/public - Render
SKILL.mdwith Markdown, plus inline reference previews - Import skills from a folder or zip
- Delete skills from the sidebar
- Browse Clawdhub skills with search + latest drops
- Download re…