distilly について
distillyは、人や関係性を題材にしたスキルの作成、更新、管理を行うエージェントスキルです。対応ホストで手順に沿って作業し、生成ファイルをユーザーのワークスペースに保存します。
主な機能
- 01依頼に応じて作成・更新・管理フローを選択
- 02生成スキルをワークスペース内に保存
- 03専用の書き込みツールでスキルファイルを操作
- 04認証情報を会話に含めない運用
- 05複数の指定エージェントホストに対応
活用シーン
- 01人物や資料をもとにスキルを作成
- 02新しいファイルや訂正内容でスキルを更新
- 03生成スキルの確認、ロールバック、削除
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ titanwings/ distilly --skill distillyインストール後、Claude Code で/distillyを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignoreCITATION.cff.npmrcCONTRIBUTING.mdLICENSEROADMAP.mdINSTALL_EN.mdINSTALL.mdREADME.mdpackage.json.github/PULL_REQUEST_TEMPLATE.md.github/ISSUE_TEMPLATE/config.ymlbug_report.mdfeature_request.mdquestion.md.github/workflows/publish-package.ymlci.ymlbin/distilly.mjsdocs/assets/hosts/README.mddocs/assets/sources/README.mddocs/lang/README_DE.mdREADME_ES.mdREADME_KO.mdREADME_RU.mdREADME_PT.mdREADME_JA.mdREADME_ZH.mdprompts/celebrity/budget_unfriendly/audit.mdpersona_builder.mdpersona_analyzer.md詳細
言語:この手順は英語で書かれています。ユーザーの最初のメッセージからユーザーの言語を判定し、以降はその言語でユーザーに返信してください。
スキルのルート:同梱のプロンプトを読む前、または同梱のスクリプトを実行する前に、ホストが実際に読み込んだ
SKILL.mdの絶対パスを解決してください。以下の手順における{distilly_skill_root}は、その正確なディレクトリを指します。Claude Code では${CLAUDE_SKILL_DIR}として公開されます。それ以外のホストでは、そのホストの検出コンテキストから提供される読み込み済みスキルのパスを使用してください。シェルの現在の作業ディレクトリがスキルのルートだと決めつけたり、インストール先のパスを推測したり、ハードコードしたりしないでください。ホストが読み込み済みのパスを公開していない場合、または Distilly のインストール先が複数あり、どれが有効か判断できない場合は、コードを実行する前にユーザーに有効なインストール先を確認してください。シェルはユーザーの現在のワークスペースに置いたままにしてください。これにより、
./skills/...などの相対出力パスをプロジェクト内に保てます。すべてのtools/...およびprompts/...リソースは{distilly_skill_root}を基準に解決してください。たとえば、tools/owner_profile.pyはpython3 "{distilly_skill_root}/tools/owner_profile.py"として実行します。実際のツール呼び出しでは、プレースホルダーを解決済みの絶対パスに置き換えてください。
Distilly Creator
Distilly は以前 Colleague Skill / colleague-skill という名称でした。現在の Skill フロントマター名とクリエイターのエントリーポイントは、どちらも
distillyです。
リクエストの振り分け
リクエストに必要なフローファイルだけを読み、その手順に従ってください。
| ユーザーの発言 | フロー |
|---|---|
| 「プロフィールを設定して」/「私のことを知って」/「あなたにとって私は誰?」、「自分を蒸留して」、またはオーナープロフィールがまだない状態でホストを初めて実行する場合 | prompts/flows/owner.md |
/distilly、「スキルの作成を手伝って」、「新しいスキルを作成して」、「誰かを蒸留したい」、「XX のスキルを作って」 | prompts/flows/create.md(ステップ 0 で owner の場合はオーナーフローに戻ります) |
「新しいファイルがある」/「追加して」、「それは違う」/「彼ならそんなことはしない」/「彼はこうあるべきだ」、/update-skill {character} {slug}、またはエイリアスの /update-colleague {slug} | prompts/flows/evolve.md |
| 「自分のスキルを表示して」、生成したスキルをロールバックまたは削除する | prompts/flows/manage.md |
create フローでは、素材をインポートするために prompts/flows/sources.md が読み込まれ、celebrity の場合は prompts/flows/celebrity_research.md も読み込まれます。各フローには必要なプロンプトが記載されています。先にすべて読むのではなく、フローで必要になったときに読み込んでください。
すべてのフローに適用されるルール
- 保存先:生成したスキルは、ユーザーのワークスペース内の
./skills/colleague/{slug}/、./skills/relationship/{slug}/、または./skills/celebrity/{slug}/に保存します。グローバルパスを使う場合は、その種別の保存先ルートを--base-dirで指定してください。 - 書き込み:生成したスキルの作成と更新には、必ず
tools/skill_writer.pyを使用してください。ファイルを手作業で作成または編集してはいけません。 - 認証情報:アプリシークレット、アクセストークンやリフレッシュトークン、Bot トークン、OAuth コードを会話に含めてはいけません。ユーザーに尋ねないでください。ユーザー自身のターミナルで、コレクターの
--setup/--loginを実行してもらってください。詳細はprompts/flows/sources.mdを参照してください。
対応ホスト
Claude Code、OpenClaw、Hermes、Codex、DeepSeek Harness、Pi coding agent、Grok Build、OpenCode に対応しています。Claude Code、Hermes、DeepSeek Harness、Grok Build では /distilly で呼び出します。OpenClaw では /distilly または /skill distilly、Codex では $distilly または /skills、Pi では /skill:distilly で呼び出します。OpenCode はスキルをネイティブに読み込むため、専用コマンドはありません。Grok Bot はこのディレクトリを直接インポートできません。このリポジトリを Grok Bot のインストール方法として案内しないでください。