mcpField
S
skill-personalizer

skill-personalizer

github.com/hqhq1025エージェントワークフロー185240 回インストール24 週間前に更新
リポジトリ

skill-personalizer について

skill-personalizerは、スキルをユーザー固有の環境に合わせて監査・調整するためのワークフローガイドです。ローカルのツールやパス、実際のセッション情報を基にトリガーや既定値を調整し、上流の有用な動作を保ちながら現実的なプロンプトで変更を検証します。

主な機能

  1. 01スキルとローカル環境やメモリの確認
  2. 02実際の依頼に基づくトリガー条件の評価
  3. 03ローカルの既定値と安全境界の追加
  4. 04対象スキルと必要なリソースのみ編集
  5. 05現実的なプロンプトとレイアウト確認による検証

活用シーン

  1. 01新しく導入したスキルをローカルのツールやパスに適合
  2. 02スキルの起動頻度が低すぎる、または高すぎる状態の修正
  3. 03不要な質問を減らし、既存のワークフローに適合
  4. 04既存スキルの過剰な起動、競合、保持価値を評価

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hqhq1025/skill-optimizer --skill skill-personalizer

インストール後、Claude Code で/skill-personalizerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
audit-rubric.md
personalization-rubric.md

詳細

スキルのパーソナライズ

概要

あるユーザーの実際の環境に合わせて、スキルを監査し、調整します。目的は幅広いユーザーに向けた汎用性ではなく、スキルが適切に起動し、摩擦が減り、ユーザーが実際に使うツール、パス、スタイル、繰り返し行うタスクによりよく適合することです。

使用するタイミング

  • ユーザーが GitHub からスキルをインストールするか、ゼロから作成し、自分の環境に合わせたい場合。
  • スキルの起動が少なすぎる、または多すぎる、不要な質問をする、あるいはユーザーが希望するワークフローに合わない場合。
  • 既存のスキルについて、適切か、壊れていないか、ノイズが多くないか、長すぎないか、競合していないか、残しておく価値があるかをユーザーが尋ねる場合。
  • ローカルのパス、エイリアス、メモリ、CLI、MCP ツール、またはリポジトリの規約をスキルに反映する必要がある場合。

スキルを一般公開する準備には使用しないでください。その場合は skill-generalizer を使用してください。

ワークフロー

  1. 対象のスキル、インストール済みのコピー、ローカルのメモリ、利用可能な場合は実際のセッションの証拠を確認します。
  2. 品質、トリガーの適合性、または保持の判断が不明確な場合は、audit-rubric.md に記載された監査チェックを実施します。
  3. ユーザーが繰り返し使う表現、期待する自律性のレベル、ツール、ディレクトリ、検証の習慣を特定します。
  4. スキルのトリガー条件を、スキルを読み込むべき実際のユーザーリクエストと、読み込むべきでないリクエストに照らして確認します。
  5. パーソナライズに必要な対象スキルと同梱リソースのみを編集します。
  6. 具体的なローカルの既定値、推奨コマンド、安全上の境界、検証手順を追加します。
  7. 有用な上流の動作を維持し、意図的にローカルで変更した点は記録します。
  8. 現実的なプロンプトと、フロントマターおよびレイアウトのチェックで検証します。

パーソナライズのルール

  • 個人的な情報を追加できるのは、それによってこのユーザーの今後の実行が改善される場合に限ります。
  • 壊れたローカル環境を隠すような、壊れやすいフォールバックを追加しないでください。
  • 一般的なベストプラクティスより、実際のローカル環境の証拠を優先します。
  • ユーザーが自然に使う表現を捉えられるよう、トリガーの説明は幅広く保ちます。
  • インストール済みのサードパーティ製スキルを編集する場合、上流の帰属表示やライセンス文は変更しないでください。

参考資料

元のオプティマイザーから引き継いだ診断手順については、audit-rubric.md を読んでください。

ローカルの既定値、セッションの証拠、検証シナリオについては、personalization-rubric.md を読んでください。

コメント