Communitygithub.com

tpc-pascal/agent-skills

入力を受けて種類を判定し、リポジトリ内の兄弟スキル(ドキュメント、メディア、ペーパー、ウェブ)へ振り分け、レポート作成前に必須質問を行う調整スキルです。どのスキルを使えば良いかわからない場合や、複数スキルの連携が必要な場合に使用します。

agent-skills とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)のための入力調整役(オーケストレーター)です。自身はコードを持たず、ユーザーからの入力を解析し、その種類に応じて適切な子スキル(doc、media、paper、web、diagram)に転送します。例えば、PDFファイルはdocスキルへ、動画や画像はmediaスキルへ、ウェブページはwebスキルへ自動的にルーティングされます。さらに、ユーザーがレポート作成を要求した場合には、レポートの種類(国際標準またはベトナムの一般的な形式)、目的と読者、出力形式、使用するソースなどを最大4つの質問で事前に明確にします。質問は不足情報のみを尋ね、会話から既に分かっていることはスキップします。このスキルは、複数のスキルを連携させる統一エントリポイントとして機能し、ユーザーは`orchestrator`だけを覚えておけば、リポジトリ内のすべての機能にアクセスできます。対応プラットフォームは任意のAIエージェントで、CLIコマンド`npx skills add tpc-pascal/agent-skills --all`でインストールできます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tpc-pascal/agent-skills/tree/HEAD/skills/research/orchestrator

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

英語版: SKILL.en.md

orchestrator — 入力調整

スリムな自己記述スキル: 独自コードなし — 入力を受け取り、種類を判定し、適切な処理先に渡します。

このリポジトリ内のスキル

スキル使用場面
docPDF/DOCX/XLSX: テキスト抽出、OCR、変換、ページ分割/結合
media動画/音声/画像/URL: 要約、テキスト抽出、字幕、カット/結合、フレーム、ダウンロード
paper国際標準レポートまたはベトナムの一般的なレポート作成
webウェブページ/新聞/ソーシャルメディアの読み取り + 検索(Jina, agent-reach, exa)
diagramレポート用のMermaid図 / matplotlibグラフの描画
orchestrator(本スキル)上記スキルの調整 + レポート前の質問窓口

調整を機能させるために十分なインストール: npx skills add tpc-pascal/agent-skills --all(または--skill orchestrator web doc media paper diagram)。

入力タイプ別ルーティング表

入力 + ニーズ処理先
PDF/DOCX/XLSX(テキスト、OCR、変換、分割/結合)doc スキル
動画/音声/画像/メディアURL(要約、字幕、カット、フレーム、ダウンロード)media スキル
ウェブ/ソーシャルメディアの読み取り/検索(URL、記事、exa)web スキル
ソースからのレポート作成質問窓口(下記参照)→ paper スキルのいずれかの形式を選択
レポート用の図/グラフ描画diagram スキル

レポート要件の確認

トリガー: ユーザーがレポートの作成または書き直しを要求した場合(抽出や変換のみの要求には適用しません)。

詳細調査やレポート作成の前に、最大4つの質問を一度に行います。不足している部分のみを質問します:

  • 形式: 国際標準レポート、またはベトナムの一般的なレポート?

  • 目的と読者: 誰が読むのか、何を伝える必要があるのか?

  • 出力: 言語、形式、長さの制限はあるか?

  • ソースと範囲: どのソース/部分を使用すべきか;外部ソースの追加は許可されるか?

  • 要求や会話で既に明らかなことは再質問しません。ユーザーが自由裁量を委ねた場合は、適切な選択肢を選び、結果に影響する前提を簡潔に述べます。

  • 重要でない情報については回答を待つ必要はありません;ソースが不明な段階で詳細な見出しを選択する必要はありません。

  • 適切なスキルで抽出した後、paper の正しい形式でレポートを作成します。

調整ルール

  1. 入力言語に従う — ユーザーが話した言語で応答します。
  2. ソースファイルの出力を明記: <元のファイル名>.<拡張子>。ファイルを上書きしません。拡張子: ドキュメント .extract.md|.txt|.csv、要約 .digest.md、字幕 .srt|.vtt、クリップ .clip-<t1>-<t2>.mp4、レポート .report.md|.report.docx。
  3. 入力をインポートしない — 実際に存在するファイルのみを処理し、出力はそのファイルの隣/上に配置します;ファイルを勝手に追加しません。
  4. ウェブ/ソーシャル/検索の入力 → web スキル(Jina/agent-reach/exa)が先に読み取ります;メディアの入力 → media スキル。
  5. ロックされたコンテンツ(ソーシャルメディア、有料記事)→ web スキル(agent-reach/Jina)が代わりに読み取ります;ログインせず、ロック解除もしません — 読み取れない場合はユーザーに通知します。
  6. レポート/レポートファイル(すべての .report.docx): paper スキルに従って検証 — pdfinfo + pdftotext を使用し、捏造しません。
  7. Media スキルはセッションベースでフェッチが必要 → media スキル(fetch セクション)または scripts/fetch-session.sh --list を参照。
  8. ローカル優先: ローカルファイルにはローカルツールを優先します。ウェブ/APIは接続が必要;オフラインの場合は、実際に利用可能なローカル/キャッシュソースまたはユーザーが提供したもののみを使用し、アクセスできない部分を明記します。
  9. 常に書き込んだファイルを報告(名前 + パス)— 黙ったままにしません。

フロー記号

以下の図では、▸ は次のステップへの引き継ぎを意味します;→ はフローが継続することを示します;角括弧はソースまたは結果の種類を説明します。これらはフロー記号であり、ソースラベルや出力形式ではありません。

よくある調整フロー

PDFスキャン ▸ doc スキル ▸ テキスト/表 ▸ paper スキル ▸ レポート
URLウェブ/ソーシャル ▸ web スキル ▸ テキスト ▸ paper スキル(レポートが必要な場合)
URL/ファイル動画 ▸ media スキル ▸ ダイジェスト + フレーム ▸ paper スキル(レポートが必要な場合)
SRT/mm:ss ▸ media スキル ▸ トリム ▸ 結合

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル