skill-generalizer

スキル汎用化

概要

動作するローカルスキルを、公開に適したクリーンな成果物に変換します。再利用可能な手法を維持しながら、個人的なコンテキスト、個人固有の前提、マシン固有の設定を取り除くことが目的です。

使用するタイミング

• ユーザーがローカルスキルを公開、共有、宣伝、オープンソース化、またはパッケージ化したい場合。
• スキルが個人的なワークフロー、非公開リポジトリ、ローカルパス、トランスクリプト、リモートホスト、またはチームの慣習をもとに作られている場合。
• 作者の環境情報を漏らすことなく、初めて使う人にも役立つ成果物が必要な場合。

ユーザー自身のマシン向けにスキルを調整するだけの場合は使用せず、代わりに skill-personalizer を使用してください。

ワークフロー

1. 判断する前に、実際のソーススキルと近くにあるリポジトリのファイルを確認します。
2. ソーススキルの品質が不明な場合は、まず skill-personalizer の監査チェックを実行します。
3. 再利用可能な機能と、個人的な実装の詳細を切り分けます。
4. 非公開の名前、パス、ホスト、認証情報、アカウント ID、トランスクリプト、一度限りのプロジェクト情報を削除するか、置き換えます。
5. 汎用的な発動条件、移植可能なワークフロー、範囲を限定した前提に基づいてスキルを書き直します。
6. SKILL.md は簡潔に保ち、長い評価基準、例、スクリプトは同梱リソースに移します。
7. インストール手順やサポートの主張を記載する前に、対象エージェントとの互換性を確認します。
8. 依頼があった場合に限り、公開可能なパッケージと誠実な宣伝文を作成します。
9. フロントマター、ファイル構成、インストール先、少なくとも 1 つの現実的な使用プロンプトを確認します。

公開リリースのルール

• フロントマターの description には、ワークフローの要約ではなく、そのスキルを使用するタイミングを記載します。
• 公開する例は汎用的なものにするか、明示的に匿名化します。
• README やマーケットプレイスの説明に記載する主張は、実際に存在するファイルと一致させます。
• 作者のホームディレクトリや非公開エイリアスではなく、移植可能なコマンドやパスのプレースホルダーを優先します。
• 個人的な情報が不可欠な場合は、設定可能な変数に置き換え、設定方法を案内します。

参考資料

完全なリリース確認、匿名化レビュー、README の書き直し、または宣伝用パッケージの作成時は、publication-rubric.md をお読みください。

Codex、Claude Code、Cursor、OpenCode、Gemini CLI、その他のコーディングエージェントのサポートを主張する前に、platform-compatibility.md をお読みください。