コンテンツ制作 · prime-skills/runcomfy-agent-skills

happyhorse-1-0

RunComfy上でHappyHorse 1.0を使用したText-to-Video生成を行います。HappyHorse 1.0の強み(Artificial Analysis Video Arenaで1位、インパス同期オーディオ付きネイティブ1080p、マルチショットでのキャラクター一貫性、6言語プロンプト対応)、生成時間/アスペクト比/解像度のスキーマ、およびWan 2.7 / Seedance 2 / LTX 2へルーティングすべきケースについて記載しています。ローカルのRunComfy CLIを介して`runcomfy run happyhorse/happyhorse-1-0/text-to-video`を呼び出します。「happyhorse」、「happy horse」、「happyhorse 1.0」、「happyhorse video」、または当該モデルでの動画生成を明示的に要求する指示によりトリガーされます。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author prime-skillsGitHub prime-skills/runcomfy-agent-skills ↗Stars 48License MIT(仓库根 LICENSE:Copyright (c) 2026 RunComfy / agentspace-so;GitHub API spdx=MIT)Commit fca19ae084
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

実装方式は「ノーコード+外部CLI委託」を採用:happyhorse-1-0/ 内には `SKILL.md` が1ファイルあるのみでスクリプトは存在しません。実行時はホストエージェントがBash経由で `runcomfy run happyhorse/happyhorse-1-0/text-to-video --input '<JSON>' --output-dir <path>` を実行します。映像と音声はRunComfyクラウド上で生成され、本スキルは意図を正確なJSONとプロンプトへ変換する役割のみを担います。

happyhorse-1-0/SKILL.md
1. The skill invokes `runcomfy run happyhorse/happyhorse-1-0/text-to-video` with a JSON body matching the schema.
`git ls-tree HEAD` にて happyhorse-1-0/ 配下には `SKILL.md` の1エントリのみであることを確認済み。本スキルは対象5スキルのうち、呼び出しチェーンを5段階の番号付き手順として明記している唯一のスキルです(他の4件は単一の散文のみ)。

完全なライフサイクルプロトコル(5ステップ):CLIがBearerトークンを付与してModel APIへPOST → `request_id` を取得 → 2秒ごとにGET `.../requests/<id>/status` をポーリング → 終了状態後にGET `.../requests/<id>/result` を実行 → ホストが `.runcomfy.net` または `.runcomfy.com` で終わるURLのみをダウンロードし、その他のURLは一覧表示のみで取得しません。

happyhorse-1-0/SKILL.md
4. On terminal status, the CLI fetches `GET .../requests/<id>/result` and downloads any URL whose host ends with `.runcomfy.net` or `.runcomfy.com` into `--output-dir`. Other URLs are listed but not fetched.
「ホワイトリストのホストのみダウンロードし、その他は一覧表示にとどめる」という規則は、同系統内で最も明確なデータ取得規律です。ステップ5の「停止したGPUへの課金を防ぐためCtrl-C時にPOST .../cancelを実行」と合わせ、本スキル独自のコスト管理ポリシーを構成しています。

入力スキーマはテキスト/画角/解像度/長さ/再現性/透かしを網羅する全7フィールド:`prompt`(≤2500文字、6言語対応)、`aspect_ratio`(5種、デフォルト16:9)、`resolution`(720P/1080P、デフォルト1080P)、`duration`(3–15秒、デフォルト5)、`seed`(デフォルト0)、`watermark`(デフォルトtrue)。

happyhorse-1-0/SKILL.md
| `watermark` | bool | no | true | Provider watermark. |
透かし(watermark)の無効化が可能なのは同系統スキルで唯一です(デフォルトはtrueでプロバイダ透かしを保持)。解像度のデフォルトが1080Pである点も5スキル中最高値であり、「ネイティブ1080p」の位置付けと一致しています。

プロンプティング手法は時間軸に特化:静止画の描写ではなく動作の遷移を記述(複数の時間的動詞を連結)、カメラショットやアングルを前置、イテレーション時は1つの視覚的ビートごとに1セグメントを構成します。

happyhorse-1-0/SKILL.md
**Describe motion over time, not a still.** "A woman turns from the window, walks two paces to the desk, picks up the cup, lifts it to her face, takes a sip" beats "a woman drinking coffee".
「なぜ静止画的な記述では不鮮明になるのか」(時間的動詞の欠如により運動事前分布の適用先が失われるため)というメカニズムを解説しており、単なる「手順」にとどまらず「理由」まで言及した数少ないセクションです。

マルチショットの一貫性は「ショットごとにアンカーを再言及する」ことで実現:2つのビートを記述する際、同一の服装や小道具(red wool coat / blue scarfなど)を各ショットで再言及することで、モデルがカットを跨いだアイデンティティを維持できるようになります。

happyhorse-1-0/SKILL.md
**Multi-shot consistency** — when describing two beats, restate the anchor at each: `"Shot 1: tall woman in red wool coat, blue scarf, in a rainy alley. Shot 2: same woman in red coat / blue scarf, now ducking under an awning."` HappyHorse holds the look but needs the anchor.
「モデルは維持可能だがアンカーが必要」と能力と前提条件の双方を明示し、カット間の一貫性が全自動で実現されるという誤解を防いでいます。

音声は同一パスで生成されます(対話/環境音/フォーリー)が、外部音源によるリップシンク駆動には非対応です。音源駆動が必要な場合はWan 2.7(`audio_url`)またはSeedance 2.0 Proへの切り替えが推奨されており、この境界はLimitationsに明記されています。

happyhorse-1-0/SKILL.md
- **Audio is in-pass only** — you can't pass external audio to drive lip-sync. For audio-driven lip-sync, use Wan 2.7 (which accepts an `audio_url`) or Seedance 2.0 Pro.
`seedance-v2` と明確な役割分担を形成:本スキルは音声生成(トーン制御可能)を行い、`wan-2-7` は音声入力受容(ユーザー音源にリップシンクを同期)を担当します。

自己制約セクション(同系統で唯一):「セルフホスト型の動画ランナーではない」「能力を直接付与するものではなく、有効なRunComfyアカウントに依存する」ことを明記し、スキルの位置付けを厳格に定義しています。

happyhorse-1-0/SKILL.md
Not a self-hosted video runner. Not a capability grant — depends on a working RunComfy account.
5つのスキルの中で唯一「## What this skill is not」の小見出しを備えており、「スキル=ローカルの処理能力」という一般的な誤解を未然に防止しています。

ルーティングテーブルにより同系統の他動画モデルの分担を網羅(音源リップシンク → Wan 2.7、参照動画+詳細な対話リップシンク → Seedance 2.0 Pro、モーション編集 → Kling、高速イテレーション → LTX 2)。また、ユーザーから明示的な指名があった場合は無条件で本スキルにルーティングすると宣言しています。

happyhorse-1-0/SKILL.md
| Detailed lip-synced dialogue + reference video | Seedance 2.0 Pro |
ドキュメント内の「If the user said "HappyHorse" / "happy horse video" explicitly, route here regardless.」に合致。リポジトリ内には Wan 2.7 および Seedance 2.0 の同名スキルディレクトリが存在しますが、Kling Video O1 と LTX 2 は存在しません(second_pass 参照)。

2コア機能

01Text-to-Video生成(t2v単一エンドポイント、prompt ≤ 2500文字)
02ネイティブ1080p出力(720P/1080P選択可能、デフォルト1080P)
03同一パスでの同期オーディオ生成(対話/環境音/フォーリー)、プロンプトで聴覚要素を指定
04マルチショットにおけるキャラクター/衣装の一貫性(ショットごとのアンカー再言及手法)
056言語のプロンプト対応(CN/EN/JP/KR/DE/FR)
06動画尺/アスペクト比の制御(3–15秒、5種のアスペクト比、非列挙値は422エラー)
07プロバイダ透かしの切り替え(`watermark` デフォルトtrue、falseに設定可能)
08障害対策およびコスト管理の説明(sysexits終了コード + 停止済みGPUへの課金を防ぐCtrl-Cでのリモートキャンセル)

3外部依存関係

KindDependency / Endpoint
cliruncomfy(RunComfy 官方 CLI)
package@runcomfy/cli(npm 全局包)
packagenpx skills(skills.sh 安装器)
apiRunComfy Model API(HappyHorse 1.0 text-to-video)
apiRunComfy 请求状态/结果/取消端点(轮询与中断)
networkRunComfy 产物下载白名单
networkRunComfy 站点/模型页/文档(文档引用,非运行时调用)
networkGitHub(技能源码链接)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • scripts/: ローカルスクリプトまたはコマンドの実行: (スキル本体にスクリプトなし)ホストエージェントがBash経由で外部CLIを実行:`runcomfy run <vendor>/<model>/<endp`
  • 网络端点: 外部ネットワークアクセスの宣言: POST `https://model-api.runcomfy.net/v1/models/happyhorse/happyhorse-1-0/tex`
  • 本地工作目录: ファイル入出力および成果物の出力: 生成された成果物は外部CLIによってダウンロードされ `--output-dir` に書き込まれる(ドキュメントにはディスク枯渇を防ぐため単一ファイルが2 GiBを超えた場合は中止すると記載)
監査ノート: 今回の統一評価基準に基づき判定(同一リポジトリの image-edit および本バッチの同系統他スキルと同様にオレンジ判定):実行時にサードパーティ製npmパッケージ/CLI `@runcomfy/cli` を呼び出し、当該CLIが実行ごとにユーザーのRunComfy認証情報(`~/.config/runcomfy/token.json` または `RUNCOMFY_TOKEN`)を読み取るため、「認証情報/クォータに触れるサードパーティCLI/リモートパッケージの呼び出し」に該当します。CLIの実装、Model APIの挙動、0600のトークン権限、2 GiBの上限設定、終了コードの意味、ステップ5のキャンセルHTTPメソッド等の記述はすべてリポジトリ外にあり、本検証ピンではソースコードを確認できないため、「判断に迷う場合は上位を採用」の原則に従いオレンジと評価します。また、1080p動画は1回あたりの推論単価が高く都度課金制であり、終了コード75のリトライ仕様と相まってクレジット消費が拡大するリスクがあります。生成物は同期音声付きの動画で透かしの無効化も可能なため、ディープフェイク等の悪用リスクが存在します(ドキュメントに注意喚起なし)。なお、スキル本体は純粋なMarkdownであり、スクリプト、難読化、隠蔽されたエンドポイントは含まれていないため、レッド判定には至りません。

5二重目の独立検証

  • [ok] skill 目录内容 = 仅 SKILL.md — git ls-tree HEAD 与 ls -a 双向核实;仓库根仅 LICENSE + README.md + 31 个技能目录,无 scripts/、plugins/、.claude/。
  • [ok] 全部外部依赖条目回查调用点真实存在 — runcomfy CLI 调用点 3 处(默认/竖屏/720p 试跑)、npm 安装 1 处、npx skills 1 处、model-api POST 1 处、status/result/cancel 三个端点各 1 处、白名单 1 处、文档/模型页/GitHub 链接多处,均实读命中。
  • [discrepancy] Ctrl-C 取消的 HTTP 语义与同仓 CLI 说明书一致 — 本技能写『Ctrl-C 时发送 POST .../requests/<id>/cancel』,同仓 runcomfy-cli/SKILL.md 写『Ctrl-C sends DELETE to the request endpoint』,其余四份兄弟技能只写 '`Ctrl-C` cancels the remote request before exit.'(不含动词)。同一个 CLI 在两份文档里被描述成两种 HTTP 动词,至少一处不准确;CLI 源码不在仓内,无法在本仓判定孰是。
  • [unlocatable] #1 on Artificial Analysis Video Arena(Elo 1333 t2v / 1392 i2v)主张 — 该排名出现在 description、正文首段与 Where it shines 三处,但本技能未给任何链接或数据来源;同仓 ai-video-generation/SKILL.md 与 image-to-video/SKILL.md 复述同一主张(后者写 Elo 1392)。榜单本身在仓外(artificialanalysis.ai),本次未做独立核实,记为源码内无法定位的证据。
  • [discrepancy] 路由建议的目标模型在本仓有对应技能 — 'Cinematic motion editing on existing footage | Kling Video O1' 与 'Ultra-fast iteration (sub-second per frame) | LTX 2' 在仓库内没有同名技能目录(全仓无 ltx-* 目录;kling-3-0/SKILL.md 自称 'Kling 3.0 (also called Kling V3.0)')。Wan 2.7 / Seedance 2.0 Pro 两条有同名目录,属有效引用。
  • [unlocatable] Security & Privacy 的技术断言可在本仓证实 — 0600 token 权限、2 GiB 下载上限、无 shell 展开、下载白名单、退出码语义、轮询间隔 2s 与取消动词均为仓外 @runcomfy/cli 行为;仓内无 CLI 源码或版本 pin,只能作为文档自述引用。
  • [discrepancy] 安装一行与 GitHub 链接指向旧仓 agentspace-so/runcomfy-skills — 安装行 `npx skills add agentspace-so/runcomfy-skills --skill happyhorse-1-0 -g` 与 GitHub 链接 github.com/agentspace-so/runcomfy-skills 指向旧仓;本仓 pin 在 prime-skills/runcomfy-agent-skills(README 用 runcomfy-agent-skills)。gh api:旧仓仍存在(5★、pushed 2026-04-29、含 happyhorse-1-0 目录);prime-skills/runcomfy-agent-skills 与 agentspace-so/runcomfy-agent-skills 为同一仓(相同 stats)。按文档安装可能装到旧版。
  • [discrepancy] 『watermark 可关』的安全含义是否被文档提示 — schema 给出 `watermark` 默认 true、可设 false(示例小节标题即 '**Vertical short (9:16, 8s, no watermark):**' 并把 watermark 设为 false),但 Security & Privacy 段完全未提『关闭供应方水印后产物无来源标识』这一滥用面(本族其它技能不提供该开关,无同类提示可比)。属安全提示覆盖不全,非代码风险。

6結論

  • ライフサイクルとコスト管理が最も具体的に記載:5つの番号付き手順(投入→`request_id`→2秒毎のポーリング→結果取得→ホワイトリスト限定ダウンロード)を提示し、Ctrl-Cによりリモートタスクをキャンセルして停止GPUへの課金を防ぐ仕様を説明。
  • 最高のデフォルト納品仕様:デフォルト1080Pかつプロバイダ透かしを保持し商業納品に最適。同時にコストを抑える720P/3sの「低コスト試行」手法も提示。
  • マルチショットの一貫性に対し実践的な記述法(ショットごとに服装/小道具アンカーを再言及)を提供し、「モデルは維持可能だがアンカーが必要」と誠実に制約を説明。
  • 単なるルール提示にとどまらずプロンプト手法のメカニズムを解説(静止画的記述→動作の曖昧化;時間的動詞が必要)。そのまま流用可能な3つのプロンプト例を付属。
  • 自己制約の明確化(セルフホストランナーではない、能力付与ではない)により、スキルがローカル計算リソースや権限そのものであるという誤認を排除。
  • 最適な用途: 適しているケース:ネイティブ1080pおよび同一パス同期オーディオ(対話/環境音/フォーリー)を必要とするブランド動画や製品デモ、ショット間でのキャラクター/衣装の一貫性が求められるマルチショット構成(「ショットごとのアンカー再言及」記述に準拠)、多言語ショート広告(6言語プロンプト対応)、本番出力前に720P/3sでプレビューを行うコスト重視のパイプライン。前提条件:RunComfy CLIがインストール済みかつログイン済み(または `RUNCOMFY_TOKEN` が設定済み)であること。
    不向きな用途: 適していないケース:自前の音源で正確なリップシンクを駆動したい場合(`wan-2-7` の `audio_url` または Seedance 2.0 Pro を利用すべき)、15秒を超える単一ショットが必要な場合(分割が必要)、Image-to-Video(ドキュメント上、本t2vテンプレートはテキスト駆動限定と明記)、超広角アスペクト比(5種類のみ対応、超広角はクロップまたは拒否)、および素材/データが外部に出てはならない環境や監査可能な実行コードが求められるコンプライアンス環境(本スキルの全処理はリポジトリ外のCLIおよびRunComfyクラウド上で実行されるため)。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload happyhorse-1-0.tar.gz
    sha256: ed6d01d2aaa14890…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit fca19ae084.