auto-editor-effects について
auto-editor-effectsは、auto-editorで動画や音声の区間にアクションやアニメーションを適用するためのスキルです。条件付き編集、オーバーレイ、ランプ、キーフレーム、時間範囲の指定を扱います。
主な機能
- 01区間ラベルに応じたアクション
- 02動画と音声のエフェクト
- 03メディアと生成レイヤーの重ね合わせ
- 04ランプと時間指定キーフレーム
- 05時間範囲ごとのアクション指定
活用シーン
- 01無音区間の高速化や音量調整
- 02ロゴの追加とアニメーション
- 03フェードやズームの作成
- 04指定した時間範囲へのエフェクト適用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/auto-editor-effectsを入力して読み込まれたか確認します。
詳細
アクションとアニメーション
単にカットするのではなく、--when-active
（-w:1、音あり）と--when-inactive（-w:0、無音）で各セクションにアクションを設定します。デフォルトは-w:1 nil
（そのまま維持）、-w:0 cutです。アクションはカンマでつなぎ、順番に適用されます。
auto-editor video.mp4 -w:0 speed:8 # fast-forward through silence (pitch preserved)
auto-editor video.mp4 -w:0 speed:3,volume:0.5 # speed up AND halve volume of silent parts
-w:0／-w:1は、無音（ラベル0）とアクティブ（ラベル1）のクラスです。--edit:N／-e:Nでクラスを追加定義し、--when:N／-w:Nでアクションを設定できます（N = 2–255）。詳しくはauto-editorスキルの「Labels」セクションをご覧ください。以下のすべてのアクションは、任意の-w:Nの値として使用できます。
アクション
| アクション | 処理内容 | 形式／範囲 |
|---|---|---|
nil | 変更せずに維持 | — |
cut | セクションを削除 | — |
speed | ピッチを保ったままタイムストレッチ | speed:8、speed:0.5 |
varispeed | ピッチシフトによる速度変更（テープ／レコード盤方式） | varispeed:2（0.2–100） |
pitch | ピッチのみ変更、長さは維持 | pitch:12（1オクターブ上）、pitch:-7（−24–24半音） |
volume | 音量を調整（1=通常、0.5=−6dB） | volume:0.2 |
deesser | 歯擦音を軽減 | deesser:intensity[:max[:freq]]（各値は0–1） |
tone | MIDIノートから波形を生成（add:ジェネレーター） | add:tone:69、add:tone:36:saw |
invert | ピクセルを反転 | — |
zoom | ズーム倍率（1=なし） | zoom:2、zoom:0.5（>0–100） |
rotate | 時計回りに固定回転。クリッピングが発生しないように拡大 | rotate:90（--resolutionと組み合わせて使用） |
spin | 連続回転。deg/rate（1秒あたりの角度） | spin:0/120、spin:90/-45 |
drawbox | 塗りつぶし矩形 | drawbox:x:y:w:h:color |
pos | オーバーレイクリップを配置するx:y[:scale] | 主にadd／v3内で使用 |
add | レイヤーをオーバーレイ：ファイル内のすべてのストリーム | add:path[:x:y:scale] |
auto-editor video.mp4 -w:1 deesser:0.8:0.7:0.4
auto-editor video.mp4 -w:1 rotate:90 --resolution 1080,1920 # landscape → portrait
auto-editor video.mp4 -w:1 drawbox:0:0:1920:200:#000000 # redact a strip
オーバーレイ — add
addは仮想的な機能です。フレームごとのエフェクトではなく、オーバーレイレイヤーを追加します。
静止画はセクション全体に表示され、PNGのアルファ値は保持されます。配置を省略すると、画面に合わせて拡大縮小され、中央に配置されます。addの後につないだアクションは、ベースではなく、新しく追加されたオーバーレイに適用されます。addはファイル内のすべてのストリームを取り込みます。音声付き動画では映像レイヤーと音声レイヤーが追加され（別のストリームにはならず、ミックスされます）、音声のみのファイルでは映像なしで音声が追加され、画像では音声なしで映像が追加されます。ファイルの代わりにジェネレーターアクションを指定できます。confetti／drawboxは映像レイヤーを描画し、toneは音声レイヤーを合成します（そのため、add:toneのレイヤーを重ねると和音になります）。
auto-editor video.mp4 -w:1 add:./logo.png # centered, fit to canvas
auto-editor video.mp4 -w:1 add:./pip.mp4:900:60:0.25 # PiP in the corner, audio included
auto-editor video.mp4 -w:1 add:./pip.mp4:900:60:0.25,volume:0.3 # ...tucked under the base
auto-editor video.mp4 -w:1 add:./music.mp3,volume:0.4 # background music, no picture added
auto-editor video.mp4 -w:1 add:./logo.png,spin:0/-30 # the logo spins, not the base video
auto-editor song.mp3 -bg white -w:1 add:./cover.png # audio + image → video
auto-editor video.mp4 -w:1 add:tone:69 # 440 Hz tone over the audio
auto-editor video.mp4 -w:0 nil,add:tone:81 # beep the silence, don't cut it
auto-editor video.mp4 -w:1 add:tone:60,volume:1..0:ease=out # a plucked, decaying note
auto-editor video.mp4 -w:1 add:tone:36:saw # buzzy bass (sine|saw|square|triangle)
オーバーレイは、そのセクションが維持される場合にのみ表示されます。そのため、無音セクションでは-w:0 nil,add:...（維持＋オーバーレイ）を使用します。--set-actionでは、範囲が自動的に維持されます。
アニメーション — ランプ from..to
zoom、opacity、blur、brightness、volumeと、各posおよびpixelateフィールドはランプを受け付けます。値はセクション全体で補間され、最後のフレームでtoに達します。点が2つを超える場合はキーフレームとなり、均等に配置されます。
auto-editor video.mp4 -w:1 zoom:1..1.5 # Ken Burns
auto-editor video.mp4 -w:1 opacity:0..1 # fade in
auto-editor video.mp4 -w:1 volume:0..1 # audio fade in
auto-editor video.mp4 -w:1 zoom:1..1.5..1 # zoom in then out (keyframes)
auto-editor video.mp4 -w:1 pixelate:1..64 # dissolve into coarser blocks
auto-editor video.mp4 -w:1 add:./logo.png,pos:0..1200:40:1..0.5 # slide + shrink overlay
イージング — :ease=curve[:duration]。curve ∈ linear|in|out|inout。単独のease:トークンを指定すると、その後のすべてのアニメーションアクションにカーブが設定されます。rotate／spinはイージングの影響を受けません。
auto-editor video.mp4 -w:1 zoom:1..1.5:ease=inout
auto-editor video.mp4 -w:1 opacity:0..1:ease=in:2sec # ease over 2s, then hold
auto-editor video.mp4 -w:1 ease:out,zoom:1..1.3,brightness:0..0.3
時間指定キーフレーム — value@timeを指定すると、セクション開始からの時間にキーフレームが設定されます。時間にはフレーム数、sec、またはセクションに対する%を指定できます。最初のキーフレームより前と最後のキーフレームより後では、その値が維持されます。時間指定のキーフレームの間にある時間指定なしのキーフレームは、隣接するキーフレームの間に均等に配置されます。イージングカーブを指定すると、キーフレーム間の各ステップにイージングが適用されます（時間指定キーフレームではイージングのdurationは使用できません）。
auto-editor video.mp4 -w:1 zoom:[email protected]@1.5sec..1@100% # in by 1.5s, out by the end
auto-editor video.mp4 -w:1 volume:[email protected]@2sec..1@4sec # silent 2s, then fade in
auto-editor video.mp4 -w:1 opacity:1@80%..0:ease=in # fade out over the last 20%
時間範囲を指定 — --set-action
--set-action ACTION,START,ENDは、範囲構文を使って範囲内のデフォルトを上書きします（sec、start／end、負の値も使用できます）。この範囲は強制的に維持されます。
auto-editor video.mp4 --set-action nil,0,5sec
auto-editor video.mp4 --set-action speed:1.5,varispeed:1.5,30sec,end
auto-editor video.mp4 --set-action add:./logo.png:600:300:1.0,1sec,2sec
レシピ
auto-editor :mic -w:1 deesser:0.8:0.7:0.4 # record, then clean up speech
auto-editor podcast.mp3 -w:0 cut -w:1 speed:1.15 # cut silence, tighten speech
auto-editor video.mp4 -w:0 volume:0.3 # duck (not cut) the silence
auto-editor video.mp4 -w:1 varispeed:1.25 # nightcore (speed + pitch up)
auto-editor video.mp4 -w:0 pitch:12 # chipmunk the silence, same length
auto-editor video.mp4 -w:0 speed:6,volume:0.4 # fast, quiet silent sections
:micでは、Ctrl-Cを押して録音を終了します。アクションはその後に適用されます。
完全なリファレンス：https://auto-editor.com/ref/actions.md。シンプルなカット／テンポ／編集方法については、**auto-editor**スキルをご覧ください。