Codex Skill Manager(Codex スキルマネージャー)

Tool

概要

Codex Skill Managerは、Codexの「スキル(skills)」を手元で管理・閲覧するためのmacOSアプリです。SwiftUIを用いたモダンなUIで、ローカルに配置されたスキル群(デフォルトは ~/.codex/skills/public)をサイドバーで一覧し、選択したスキルのSKILL.mdをMarkdownとしてレンダリングします。Markdown内の参照に対してインラインプレビューを表示することで、ドキュメントの確認がスムーズになります。Clawdhubと連携してリモートスキルの検索や最新公開物の閲覧・ダウンロードも可能で、フォルダやZIPからのインポート、サイドバーからの削除などローカル運用に必要な機能をひと通り備えています。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 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字)

リポジトリ情報:

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.md with 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…