printing-press-library

Printing Press ライブラリ

ユーザーから、Printing Press ライブラリに存在する可能性のある CLI、エージェントスキル、API ラッパー、スクレイパー、自動化ツール、データソースを尋ねられた場合に、このスキルを使用します。

このライブラリは、mvanhorn/cli-printing-press から生成された、特定の用途に特化した CLI と対応するエージェントスキルのオープンソースカタログです。このスキルはカタログへの入り口です。存在するというだけで、無作為にニッチなスキルをインストールしないでください。まず適切なツールを特定し、そのタスクに役立つ場合に限って、特化したスキルまたは CLI をインストールします。

デフォルトのワークフロー

1. 必要な場合にのみ、ユーザーの目的を確認します。

   • リクエストでサービスまたはウェブサイトが指定されている場合は、それを直接検索します。
   • サービスではなく作業内容が説明されている場合は、機能とドメインで検索します。
   • ユーザーのエージェントに、その作業を解決できる安全な組み込みツールがすでにある場合は、別の CLI をインストールするよりもそちらを優先します。

2. まずライブラリ CLI でカタログを検索します。

   • 人が読みやすい検索結果カードには、npx -y @mvanhorn/printing-press-library search <keyword> を使用します。
   • エージェントが解析しやすい形式には、npx -y @mvanhorn/printing-press-library search <keyword> --json を使用します。
   • カテゴリがわかっている場合は、npx -y @mvanhorn/printing-press-library list --category <category> --json を使用します。
   • 各検索結果には、そのツールの正規のインストールコマンドが含まれています。
   • npx が利用できない場合、またはさらに詳しく調べる必要がある場合に限り、GitHub リポジトリまたはローカルクローンを使用します。

3. 慎重に選定します。

   • ウェブサイト名が同じというだけでなく、README／SKILL の例がユーザーの実際の作業に合致する候補を優先します。
   • インストール前に、認証、Cookie、有料 API、OS 固有のバイナリ、ブラウザー自動化が必要かどうかを確認します。
   • 役立つ範囲で最も用途を絞ったツールをインストールします。検索結果に表示されたからといって、関連ツール群をまとめてインストールしないでください。

4. 選んだツールが役立つ場合は、ライブラリのインストーラーを使ってインストールします。

   • デフォルトのコマンドは npx -y @mvanhorn/printing-press-library install <slug> です。
   • OpenClaw では、特化したスキルが OpenClaw の管理対象スキルルートに配置されるよう、npx -y @mvanhorn/printing-press-library install <slug> --agent openclaw を使用します。インストーラーは Go バイナリをユーザーごとの bin ディレクトリに配置するのがデフォルトです。
   • インストールコマンドは、CLI と対応する特化型エージェントスキルの両方をインストールします。
   • install <slug> は冪等です。すでにインストール済みのツールに対して再実行すると、Go バイナリを更新し、特化したスキルをその場で上書きまたは再追加します。
   • 内部では、インストーラーは CLI に go install <module>@latest を使用し、このリポジトリから特化した pp-* スキルをグローバルにインストールするために、Vercel Agent Skills 互換の skills CLI を使用します。
   • Go バイナリのインストールに成功しても、現在のプロセスの PATH に含まれていない場合は、スキルのインストール失敗ではなく警告として扱います。インストーラーは特化したスキルを引き続きインストールし、プラットフォーム固有の PATH 設定手順を表示する必要があります。
   • エージェント／ゲートウェイ環境では、シェルの起動ファイルを変更しても、すでに実行中のプロセスには反映されない場合があります。PATH の変更後はセッション／ゲートウェイを再起動し、デフォルトのユーザー bin ディレクトリがハーネスから見えることを確認します。
   • OpenClaw ゲートウェイ／サービス環境では、ゲートウェイプロセスの PATH から <slug>-pp-cli を解決できることを確認します。対話型シェルでの which だけでは不十分です。
   • ユーザーが片方だけを明示的に希望している場合に限り、--cli-only または --skill-only を渡します。

5. 新しくインストールしたスキルを、実行中のエージェントから利用できるようにします。

   • ほとんどのエージェント実行環境では、セッション開始時に利用可能なスキルのスナップショットを取得します。特定のスキルをインストールまたは更新した後、呼び出す前に新しいセッションを開始するか、スキルを再読み込みしてください。
   • Hermes CLI のセッションでは、利用可能な場合は /reload-skills を使用するか、終了して新しい hermes セッションを開始してください。
   • Hermes gateway のセッションでは、gateway のチャットから /restart を使用するか、シェルから hermes gateway restart を実行して、gateway プロセスにインストール済みのスキルを再読み込みさせてください。
   • OpenClaw では、OpenClaw のセッションまたは gateway を再起動するまで、現在のエージェントセッションから新しくインストールしたスキルを利用できない場合があることを前提にしてください。

6. 成功したと伝える前に、動作を確認します。

   • CLI をインストールした場合は、--help または同等の無害なコマンドを実行してください。
   • スキルをインストールした場合は、セッションを再読み込みまたは再起動した後、確認用コマンドがあるときは、対象の実行環境からスキルを確認できることを確かめてください。
   • 認証情報を必要とする CLI を使用する場合は、秘密情報を表示せずに、必要な環境変数が設定されていることを確認してください。

7. インストールまたは更新が成功した後、効率的な定期更新スケジュールを提案します。

   • インストールや更新は冪等であるため、インストール済みの Printing Press CLI と特定のスキルを、スケジュールに従って最新の状態に保っても問題ありません。
   • ユーザーの明示的な承認なしに cron／スケジュールジョブを作成しないでください。定期実行ジョブは永続的な副作用を伴います。
   • 既定では、CLI ごとにスケジュールジョブを作成するのは避けてください。ユーザーが多数の Printing Press ツールをインストールする場合があり、ツールごとにジョブを作成すると煩雑になり、管理が難しくなります。
   • 代わりに、npx -y @mvanhorn/printing-press-library update を実行する単一の統合された定期ジョブを優先してください。このコマンドは、現在 PATH 上にあるインストール済みの Printing Press CLI と、それに対応する特定のスキルをすべて更新します。
   • ユーザーがそのツールだけ異なる頻度や方針を明示的に希望する場合に限り、npx -y @mvanhorn/printing-press-library update <slug> を使うツール別のジョブを提案してください。
   • ユーザーから別の指定がない限り、毎週など、実行頻度が低く通知を抑えたスケジュールを優先してください。

このスキルの用途

このスキルを使用すると、公開されている Printing Press Library の CLI とエージェントスキルを見つけられます。ユーザーの目的に合うライブラリエントリを選び、ライブラリ CLI を使って正式なインストールコマンドを確認し、タスクに役立つ場合にのみ、選択したツールをインストールします。

適している用途：

• 特定のサービス向けに作られた CLI を見つける
• 一度限りの調査や自動化タスクに使えるスクレイパーやデータソースツールを見つける
• 今後のエージェントが特定の CLI の使い方を把握できるよう、専用の pp-* スキルをインストールする
• インストール済みの Printing Press CLI とスキルを更新する

適していない用途：

• タスクをすでに解決できる安全な組み込みエージェントツールを置き換える
• 幅広いツールのバンドルを、必要性が不確かなままインストールする
• ユーザーが外部への副作用を承認していない状態で、認証情報を使ってアカウントを操作する
• 明示的な承認なしに、公開、投稿、予約、購入、メール送信、またはサードパーティの状態を変更する

インストールの基本コマンド

Printing Press Library CLI は、カタログ内のツールをインストールするための正式なインターフェースです。

npx -y @mvanhorn/printing-press-library install <slug>

OpenClaw では、OpenClaw エージェントの対象を明示的に指定してください。インストーラーは、既定のユーザー別 bin ディレクトリ（macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin）にバイナリを配置します。

npx -y @mvanhorn/printing-press-library install <slug> --agent openclaw

このコマンドは、カタログエントリの両方をインストールします。

• Go CLI バイナリ
• 対応する専用の pp-* エージェントスキル

スキルのインストールには、インストーラーから Vercel Agent Skills 互換のインストーラーを呼び出します。概念的には、次のコマンドを実行します。

npx -y skills@latest add mvanhorn/printing-press-library/cli-skills/pp-<slug> -g -y

そのため、カタログインストーラーが引き続き適切な最上位コマンドです。CLI をインストールした後、別個のスキルインストール手順をエージェントに手作業で用意させるのではなく、同じ agent-skills の仕組みを使って専用スキルをグローバルにインストールします。

インストール操作は冪等で、単一ツールの再インストールとして機能します。install <slug> を再実行すると、バイナリには go install <module>@latest が使用され、専用スキルは既存のインストールをその場で上書きして、対話なしで再追加されます。先にアンインストールする必要はありません。 インストール時に、バイナリディレクトリが PATH に含まれていないという警告が表示されても、バイナリと該当するスキルのインストールは正常に完了している場合があります。表示されたプラットフォーム固有の PATH 設定手順に従ってください。固定された環境を引き継いでいる場合は、実行中のエージェントセッションまたはゲートウェイを再起動してください。デフォルトのユーザーバイナリディレクトリがそのマシンに適していない場合に限り、--bin-dir <dir> を使用してください。

既存のツールを更新または再インストールするようユーザーから求められた場合は、update を使用してください。

npx -y @mvanhorn/printing-press-library update flight-goat
npx -y @mvanhorn/printing-press-library update

ローカル CLI が古いかどうかを判断する際は、ソースを調べる前に、インストール済みバイナリが報告するバージョンとカタログのリリースメタデータを比較してください。

<slug>-pp-cli --version
npx -y @mvanhorn/printing-press-library search <slug> --json
npx -y @mvanhorn/printing-press-library list --json

search --json または list --json では、カタログのバージョンに release.version、バイナリ名に release.cli_name を参照してください。ローカルの --version がカタログの release.version より古い場合は、通常は次のように、ユーザーが意図するバイナリディレクトリを指定してツールを更新してください。

npx -y @mvanhorn/printing-press-library update <slug> --bin-dir ~/.local/bin

カタログ項目に release メタデータがない場合、またはバイナリのバージョン文字列がない、セマンティックバージョンらしくない、あるいはその他の理由で疑わしい場合に限り、go version -m <binary>、リポジトリの調査、または .printing-press-release.json の直接読み取りに切り替えてください。たとえば、Substack はローカルで substack-pp-cli --version、リモートで npx -y @mvanhorn/printing-press-library search substack --json を実行して確認できます。カタログのバージョンのほうが新しい場合は、npx -y @mvanhorn/printing-press-library update substack --bin-dir ~/.local/bin で更新してください。

update <slug> は、そのツールのインストール処理に準じます。引数なしの update は、現在 PATH 上にある Printing Press の CLI を検出し、対応する該当スキルも含めてすべて更新します。

更新は冪等であるため、インストールまたは更新が正常に完了したら、定期的な更新ジョブを作成するかユーザーに提案してください。必ず事前に確認し、自動でスケジュールしないでください。CLI ごとにジョブを作成するより、統合したジョブを1つ作成することを優先してください。ユーザーが複数の Printing Press ツールをインストールしている場合があり、ツールごとにスケジュールを設定するとすぐに煩雑になるためです。

ほとんどのユーザーには、現在 PATH 上にある、インストール済みの Printing Press CLI と対応する該当スキルをすべて更新する、通知を抑えた週1回のジョブを1つスケジュールしてください。

npx -y @mvanhorn/printing-press-library update

特定のツールについて別の頻度やポリシーをユーザーが明示的に希望する場合に限り、ツールごとのスケジュール済みコマンドを使用してください。

npx -y @mvanhorn/printing-press-library update flight-goat

インストール済みのライブラリ CLI が reinstall を提供している場合は、update の便利な別名として扱ってください。

npx -y @mvanhorn/printing-press-library reinstall flight-goat

例：

npx -y @mvanhorn/printing-press-library install flight-goat

search または list の出力に表示されたインストールコマンドを使用してください。ハーネス固有のスキル直接インストールコマンドを標準の方法として作成しないでください。これらは、スキルのみをインストールする明示的なワークフローでのみ使用します。

インストールまたは更新後は、スキルを再読み込みするかセッションを再起動するまで、実行中のエージェントから該当するスキルが見えない場合があると想定してください。Hermes CLI セッションでは、/reload-skills を使用するか、新しいセッションを開始できます。Hermes ゲートウェイセッションでは、/restart または hermes gateway restart を使用してください。新しくインストールした該当スキルがすぐに表示されない場合は、OpenClaw エージェントの現在のセッションまたはゲートウェイを再起動してください。

Hermes ネイティブの使い方

Hermes にはネイティブのスキル、プロファイル、ゲートウェイセッション、cron ジョブ、メモリ、ツールセットがあるため、Hermes では Printing Press を単なるスキルインストーラー以上に活用できます。Hermes を汎用チャットハーネスのように扱うのではなく、これらの機能を使用してください。

Hermes でのインストールと再読み込み

特化ツールをインストールまたは更新した後は、呼び出す前に、Hermes が新しいスキルを実際に認識できることを確認してください。

npx -y @mvanhorn/printing-press-library install <slug>

次に、Hermes の実行環境に応じて再読み込みします。

• Hermes CLI：利用可能であれば /reload-skills を実行するか、新しい hermes セッションを開始します。
• Hermes ゲートウェイ：ゲートウェイのチャットで /restart を実行するか、シェルから hermes gateway restart を実行します。
• 名前付きプロファイル：スキルを使用するのと同じプロファイルにインストールして、再読み込みします。ある Hermes ホーム／プロファイルにインストールしたスキルは、別のプロファイルからは認識されない場合があります。

ローカルの Hermes インストールを確認する際に便利なコマンドは次のとおりです。

hermes skills list
hermes skills inspect <skill-or-url>
hermes config path
hermes config env-path
hermes profile list

これらのコマンドは診断のみに使用してください。ユーザーが明示的に Hermes 専用のスキルインストールを求めない限り、Printing Press カタログのエントリーのインストールには、カタログインストーラーを引き続き標準の方法として使用します。

Hermes プロファイル

Hermes プロファイルでは、設定、スキル、cron ジョブ、セッション、メモリが分離されています。ユーザーがプロファイル、ワークスペース、または別のアシスタント ID に言及した場合、デフォルトのプロファイルだと決めつけないでください。

「スキルが見つからない」という問題を診断する前に、次の点を確認してください。

• アクティブな Hermes プロファイル
• インストーラーの対象となった HERMES_HOME
• そのプロファイルの skills/ ディレクトリにスキルが存在するか
• インストール後に CLI またはゲートウェイを再起動したか

よくある失敗例は、あるプロファイルに特化スキルをインストールしてから、別のプロファイルで使おうとすることです。これは Printing Press の問題ではなく、インストール先の不一致です。

Hermes のツールセット

ほとんどの Printing Press CLI ではシェルの実行が必要なため、Hermes が CLI を実行するにはターミナルへのアクセスが必要です。新しくインストールした CLI を Hermes が使えない場合は、アクティブなプラットフォーム／セッションで terminal ツールセットが有効になっているか確認してください。

広範なツールアクセスをむやみに有効にしないでください。タスクに組み込みのウェブ／検索／ファイルツールだけで対応できる場合は、サードパーティの CLI をインストールして実行するより、組み込みツールを優先してください。

Hermes の cron 更新

インストール済みの Printing Press ツールを最新の状態に保ちたい Hermes ユーザーには、ツールごとに個別のジョブを増やすのではなく、更新をまとめたスケジュールジョブを 1 つ推奨してください。

Schedule: weekly, quiet hours preferred
Prompt: Run `npx -y @mvanhorn/printing-press-library update`, summarize any changes, and stay quiet if nothing changed.

Hermes の cron ツールまたは CLI を使用する場合は、ユーザーの明示的な承認を得てからジョブを作成してください。定期実行ジョブは、継続的な副作用を伴います。

適切な Hermes cron プロンプトは、単独で内容が完結しています。

Refresh installed Printing Press tools by running `npx -y @mvanhorn/printing-press-library update`. Report only updated tools, failures, or missing prerequisites. Do not print secrets. If nothing changed and there were no errors, say so briefly.

ユーザーが特定のツールについて異なる頻度やリスクポリシーを明示的に希望する場合に限り、ツールごとのスケジュールを使用してください。

Hermes のメモリとセッション検索

Hermes は、永続的なユーザー設定、環境の慣例、既知の認証情報の保存場所を記憶している場合があります。その情報を活用して、ユーザーに設定内容を繰り返し説明させないようにしてください。ただし、PR 番号、コミット SHA、一度だけダウンロードしたファイル、「今日ツール X をインストールした」といった、変動しやすいインストール結果をメモリに保存しないでください。

Printing Press の利用を繰り返した後に、メモリに保存するのに適した情報の例：

• ツールのインストールに使用する、ユーザーが希望する Hermes プロファイル
• 安定したシークレットマネージャーの慣例
• 永続的なワークスペースのパスに関する慣例
• 「ツールごとのジョブより、週次の一括更新を優先する」といった継続的なポリシー

メモリに保存するのに適さない情報の例：

• 一時的なブランチ名や PR 番号
• 一度だけの検索結果
• すぐに古くなるインストール済みバージョン
• 生の API キー、Cookie、トークン、セッションヘッダー

以前に何をインストールまたは決定したかをユーザーが尋ねた場合は、推測するよりも Hermes のセッション検索を優先してください。

検索の方法

ライブラリ CLI を標準のカタログインデックスとして使用してください。人間が読みやすい検索カードには、正式なインストールコマンドを示す install: 行があります。

npx -y @mvanhorn/printing-press-library search <keyword>

スクリプトを作成する場合や、構造化されたランキングが役立つ場合は、JSON を使用してください。

npx -y @mvanhorn/printing-press-library search <keyword> --json

例：

npx -y @mvanhorn/printing-press-library search flights
npx -y @mvanhorn/printing-press-library search espn --json
npx -y @mvanhorn/printing-press-library list --category travel --json

npx を利用できない場合、CLI の結果が曖昧な場合、または候補を選ぶ前に README／SKILL の詳細をさらに確認する必要がある場合に限り、フォールバックとしてリポジトリを調査してください。

rg -i "<service-or-capability>" registry.json library cli-skills

レジストリの構造が異なる場合は、生成されたカタログファイルを手作業で解析するのではなく、npm CLI の出力を優先してください。雰囲気より事実を、発掘調査より公式インターフェースを優先してください。

選択ルール

次の条件に当てはまる候補を優先します。

• 対象のサービスを直接指定している。
• README／SKILL の例が、ユーザーの依頼した作業に合致している。
• ユーザーが対応できる認証要件とセットアップ要件が文書化されている。
• ユーザーの OS／ランタイムに対応している。
• 外部への副作用が発生する前に、無害なコマンドで検証できる。

次の条件に当てはまる候補は避けます。

• 作業との関連性が曖昧である。
• ユーザーが持っていない認証情報が必要である。
• ユーザーの作業に公式アカウントのデータが必要なのに、そのスキルでは認証できないサイトのスクレーパーである。
• より安全な組み込みの API／ツールで、すでに作業を解決できる。
• 作業のリスクが高い、有料である、一般公開される、またはプライバシーに関わるもので、ユーザーが外部への操作を承認していない。

安全性と認証情報

• API キー、Cookie、トークン、セッションヘッダーを表示してはいけません。
• ローカルのシークレットマネージャーや環境ファイルを利用できる場合は、ユーザーにチャットへシークレットを貼り付けるよう求めてはいけません。
• サードパーティ製 CLI はコード実行として扱います。作業に必要なツールだけをインストールしてください。
• ユーザーが明示的に承認しない限り、公開、投稿、メール送信、購入、予約、外部状態の変更を行ってはいけません。

Hermes ユーザーには、Hermes の通常の環境ファイル、またはユーザーがすでに使用しているシークレットマネージャーを優先してください。Hermes の環境ファイルのパスを確認するには、次を使用します。

hermes config env-path

値を表示せずに、必要な変数が設定されていることを確認してください。特定の機能でのみキーが任意または必須であるとスキルに記載されている場合は、その違いを維持してください。ツール全体で認証情報が必須であるかのように説明してはいけません。

検証チェックリスト

成功を報告する前に、次のことを確認してください。

• 選択した候補が、ユーザーの依頼した作業に直接合致している。
• インストールコマンドの出所が search、list、または文書化された Printing Press CLI の動作である。
• CLI を --help または別の無害なコマンドで検証した。
• 新しくインストールしたスキルをすぐに利用できるようにするため、エージェントハーネスを再読み込み／再起動した。
• 必要な認証情報を、シークレットを表示せずに確認した。
• 明示的な承認なしに外部への副作用を発生させていない。
• Hermes の場合、可視性を診断する際に関連するプロファイル／セッション／ゲートウェイを考慮した。

ClawHub での README の動作

ClawHub では、SKILL.md（または skill.md）がスキルの README として表示されます。スキルフォルダー内の別の README.md は、公開される README ではありません。ユーザー向けの ClawHub ドキュメントはこのファイルに記載してください。