Skip to content

joeseesun/qiaomu-cut-skill

qiaomu-cut

Verified

把一句话需求转成可复现、可验收视频工程的乔木智能剪辑导演。Use when the user asks to create, plan, edit, remix, explain, narrate, subtitle, animate, composite, or render a video—including one-line requests such as “制作一个科普视频:介绍 LLM 中的 RL”. Builds English-learning movie mixes, person profiles, explainers, code-drawn motion graphics (UI morph loops, showreels, kinetic-type promos, line-art/pixel/Three.js animation, lyric MVs), product launch videos, cinematic shorts, social clips, course/PPT videos, AI image/video/TTS/music-assisted stories, stock-footage stories, or multi-source montage. Routes across 33台词, ClipSeek/open media, local files, ListenHub, image generation, HTML/SVG/Canvas motion graphics with beat-grid storyboards and determinism probes, Manim, ffmpeg-full, captions, sound design, frame-0 video covers with YouTube thumbnails, and release checks.

FileKindSize
SKILL.mdskill md54.0 KB
agents/interface.yamlconfig17.2 KB
agents/openai.yamlconfig323 B
assets/explainer-social/base.cssother24.9 KB
assets/explainer-social/component-runtime.jsscript41.1 KB
assets/explainer-social/scene-shell.htmlother829 B
assets/motion-kit/qiaocut-motion.jsscript8.2 KB
assets/qiaomu-profile/qiaomu_avatar.jpegbinary5.6 MB
assets/qiaomu-profile/qiaomu_reward_qr.pngbinary515.9 KB
assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpgbinary8.3 KB
references/ad-concept-library.mdmarkdown6.5 KB
references/aesthetic-preferences.mdmarkdown3.0 KB
references/brand-card-templates.mdmarkdown1.6 KB
references/chinese-font-themes.mdmarkdown804 B
references/cinematic-techniques.mdmarkdown2.8 KB
references/code-motion-direction.mdmarkdown11.1 KB
references/cover-thumbnail-method.mdmarkdown6.4 KB
references/english-mix-fast-path.mdmarkdown6.0 KB
references/explainer-autopilot.mdmarkdown11.1 KB
references/feedback-evolution.mdmarkdown37.6 KB
references/ffmpeg-full.mdmarkdown1.7 KB
references/incremental-production.mdmarkdown4.4 KB
references/licensing.mdmarkdown1.9 KB
references/listenhub-provider.mdmarkdown12.6 KB
references/motion-prompt-patterns.mdmarkdown9.3 KB
references/movie-montage-fast-path.mdmarkdown4.4 KB
references/qiaocut-ir.mdmarkdown4.2 KB
references/renderer-engines.mdmarkdown3.3 KB
references/schemas/qiaocut.timeline.v1.schema.jsonconfig7.2 KB
references/social-safe-zones.mdmarkdown3.3 KB
references/source-adapters.mdmarkdown5.7 KB
references/source-selection-gate.mdmarkdown2.5 KB
references/styles/cinematic.mdmarkdown475 B
references/styles/explainer.mdmarkdown1.5 KB
references/styles/social-short.mdmarkdown383 B
references/timeline-schema.mdmarkdown12.2 KB
references/trust-boundary.mdmarkdown3.0 KB
references/workflows.mdmarkdown7.5 KB
scripts/adapters/33tc.jsscript2.1 KB
scripts/adapters/33tc_cli.jsscript4.8 KB
scripts/adapters/clipseek.jsexecutablescript5.4 KB
scripts/adapters/listenhub.jsscript35.7 KB
scripts/adapters/listenhub_cli.jsexecutablescript2.1 KB
scripts/adapters/local.jsscript2.4 KB
scripts/audio_beats.jsscript17.5 KB
scripts/bilingual_typography_smoke.jsscript1.4 KB
scripts/bootstrap_listenhub.shexecutablescript5.4 KB
scripts/bootstrap_macos.shexecutablescript2.5 KB
scripts/brand_templates.jsscript2.4 KB
scripts/brand_templates_smoke.jsscript869 B
scripts/complete_sentence.jsscript3.9 KB
scripts/component_motion_smoke.jsscript21.2 KB
scripts/concept_smoke.jsscript5.6 KB
scripts/cover.jsscript9.1 KB
scripts/cover_smoke.jsscript5.1 KB
scripts/english_mix.jsscript24.1 KB
scripts/english_mix_smoke.jsscript5.7 KB
scripts/explainer_beats.jsscript6.7 KB
scripts/explainer_beats_smoke.jsscript4.8 KB
scripts/explainer_cognitive_timing_smoke.jsscript5.8 KB
scripts/explainer_e2e_smoke.jsscript7.4 KB
scripts/explainer_pipeline.jsscript49.3 KB
scripts/explainer_pipeline_smoke.jsscript12.7 KB
scripts/explainer_spec.jsscript51.4 KB
scripts/explainer_timing.jsscript8.6 KB
scripts/fetch_generated.jsexecutablescript17.4 KB
scripts/ffmpeg_retry_shim_smoke.jsscript2.3 KB
scripts/file_narration_smoke.jsexecutablescript6.6 KB
scripts/ingest_asset.jsexecutablescript15.0 KB
scripts/kinetic_caption_smoke.jsscript1.4 KB
scripts/license_report.jsexecutablescript2.3 KB
scripts/listenhub_narration.jsexecutablescript11.0 KB
scripts/listenhub_smoke.jsexecutablescript26.7 KB
scripts/local_preferences.jsscript1.8 KB
scripts/motion_studio.jsscript55.9 KB
scripts/motion_studio_smoke.jsscript11.0 KB
scripts/movie_montage.jsscript24.7 KB
scripts/movie_montage_smoke.jsscript4.0 KB
scripts/qcut.jsexecutablescript40.8 KB
scripts/release_check.jsscript7.0 KB
scripts/render_project.jsscript85.1 KB
scripts/render_scene.jsscript26.4 KB
scripts/renderers/ass.jsexecutablescript2.7 KB
scripts/renderers/bilingual_ass.jsscript12.6 KB
scripts/renderers/html_scene.jsexecutablescript3.9 KB
scripts/renderers/procedural_music.jsscript7.6 KB
scripts/scene_content_cache.jsscript3.2 KB
scripts/scene_renderer_smoke.jsscript2.8 KB
scripts/security_smoke.jsscript10.2 KB
scripts/sentence_boundary_smoke.jsscript1.6 KB
scripts/setup_deps.jsscript8.4 KB
scripts/shims/ffmpegexecutablescript3.0 KB
scripts/source_review.jsexecutablescript5.1 KB
scripts/timeline_features_smoke.jsscript3.7 KB
scripts/trigger_eval.pyexecutablescript2.5 KB
scripts/validate_skill.pyexecutablescript3.1 KB
scripts/verify_marswave_vendor.jsexecutablescript3.5 KB
scripts/verify_video.jsexecutablescript3.4 KB

scripts/setup_deps.js

View on GitHub
#!/usr/bin/env node
'use strict';

/*
 * qcut setup — detect and install every local dependency the skill uses.
 *
 * Policy: missing tools are installed, not worked around. The agent runs this
 * whenever qcut doctor (or any command) reports a missing capability, then
 * continues the task. Installs are idempotent and pinned where it matters.
 *
 *   ffmpeg-full   libass/drawtext/xfade/loudnorm build        (brew | apt)
 *   font          Noto Sans CJK SC for deterministic captions  (brew cask | apt)
 *   browser       playwright-core in <skill>/.deps + headless Chromium (npm)
 *   manim         Manim Community CLI                          (brew | uv | pip)
 *   listenhub     pinned ListenHub + Coli CLIs                 (bootstrap_listenhub.sh)
 */

const fs = require('fs');
const os = require('os');
const path = require('path');
const { spawnSync } = require('child_process');

const SKILL_ROOT = path.resolve(__dirname, '..');
const DEPS_DIR = path.join(SKILL_ROOT, '.deps');
const PLAYWRIGHT_VERSION = '1.61.1';
const COMPONENTS = ['ffmpeg', 'font', 'browser', 'manim', 'listenhub'];

function which(command) {
  const result = spawnSync('which', [command], { encoding: 'utf8' });
  return result.status === 0 ? result.stdout.trim() : null;
}

function sh(command, args, options = {}) {
  process.stderr.write(`$ ${[command, ...args].join(' ')}\n`);
  const result = spawnSync(command, args, {
    cwd: options.cwd || SKILL_ROOT,
    env: { ...process.env, HOMEBREW_NO_AUTO_UPDATE: '1', HOMEBREW_NO_INSTALL_CLEANUP: '1', ...(options.env || {}) },
    stdio: ['ignore', 'inherit', 'inherit'],
    timeout: options.timeout || 45 * 60 * 1000
  });
  return result.status === 0;
}

function aptInstall(packages) {
  if (!which('apt-get')) return false;
  const prefix = process.getuid && process.getuid() === 0 ? [] : ['sudo', '-n'];
  const [command, ...rest] = [...prefix, 'apt-get', 'install', '-y', ...packages];
  return sh(command, rest);
}

// ---------- detection ----------

function ffmpegStatus() {
  const candidates = [process.env.QIAOMU_FFMPEG, '/opt/homebrew/opt/ffmpeg-full/bin/ffmpeg', '/usr/local/opt/ffmpeg-full/bin/ffmpeg', which('ffmpeg')].filter(Boolean);
  for (const candidate of candidates) {
    if (!fs.existsSync(candidate)) continue;
    const filters = spawnSync(candidate, ['-hide_banner', '-filters'], { encoding: 'utf8' });
    const text = `${filters.stdout}${filters.stderr}`;
    const missing = ['ass', 'drawtext', 'subtitles', 'overlay', 'loudnorm', 'sidechaincompress', 'zoompan', 'xfade', 'tmix', 'gblur']
      .filter((name) => !new RegExp(`\\b${name}\\b`).test(text));
    if (!missing.length) return { ok: true, path: candidate };
    if (candidate === candidates[candidates.length - 1]) return { ok: false, path: candidate, missing };
  }
  return { ok: false, missing: ['ffmpeg'] };
}

function fontStatus() {
  const files = [
    path.join(os.homedir(), 'Library/Fonts/NotoSansCJKsc-Regular.otf'),
    '/Library/Fonts/NotoSansCJKsc-Regular.otf',
    '/opt/homebrew/share/fonts/NotoSansCJKsc-Regular.otf',
    '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
    '/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc'
  ];
  const found = files.find((file) => fs.existsSync(file));
  if (found) return { ok: true, path: found };
  if (which('fc-list')) {
    const list = spawnSync('fc-list', [':lang=zh', 'family'], { encoding: 'utf8' }).stdout || '';
    if (/Noto Sans CJK SC/i.test(list)) return { ok: true, path: 'fontconfig' };
  }
  return { ok: false };
}

function browserStatus() {
  delete require.cache[require.resolve('./render_scene')];
  const engines = require('./render_scene').inspectSceneEngines();
  return { ok: engines.html.available, playwright: engines.html.playwright, browser: engines.html.browser };
}

function manimStatus() {
  const bin = process.env.QIAOMU_MANIM || which('manim');
  return bin ? { ok: true, path: bin } : { ok: false };
}

function listenhubStatus() {
  const result = spawnSync('bash', [path.join(__dirname, 'bootstrap_listenhub.sh'), '--check'], { encoding: 'utf8' });
  return { ok: result.status === 0, detail: String(result.stdout || result.stderr || '').trim().split('\n').slice(-3).join(' | ') };
}

const STATUS = { ffmpeg: ffmpegStatus, font: fontStatus, browser: browserStatus, manim: manimStatus, listenhub: listenhubStatus };

// ---------- installers ----------

function installFfmpeg() {
  if (process.platform === 'darwin' && which('brew')) return sh('brew', ['install', 'ffmpeg-full']);
  return aptInstall(['ffmpeg']);
}

function installFont() {
  if (process.platform === 'darwin' && which('brew')) return sh('brew', ['install', '--cask', 'font-noto-sans-cjk-sc']);
  return aptInstall(['fonts-noto-cjk']);
}

function installBrowser() {
  fs.mkdirSync(DEPS_DIR, { recursive: true });
  const manifest = path.join(DEPS_DIR, 'package.json');
  if (!fs.existsSync(manifest)) fs.writeFileSync(manifest, `${JSON.stringify({ name: 'qiaomu-cut-deps', private: true }, null, 2)}\n`);
  if (!sh('npm', ['install', '--no-audit', '--no-fund', '--prefix', DEPS_DIR, `playwright-core@${PLAYWRIGHT_VERSION}`])) return false;
  if (browserStatus().ok) return true;
  // No system Chrome/Chromium: download the pinned headless shell.
  const cli = path.join(DEPS_DIR, 'node_modules', 'playwright-core', 'cli.js');
  return sh(process.execPath, [cli, 'install', 'chromium-headless-shell']);
}

function installManim() {
  if (process.platform === 'darwin' && which('brew')) return sh('brew', ['install', 'manim']);
  if (which('uv')) return sh('uv', ['tool', 'install', 'manim']);
  if (which('pipx')) return sh('pipx', ['install', 'manim']);
  return sh('python3', ['-m', 'pip', 'install', '--user', 'manim']);
}

function installListenhub() {
  return sh('bash', [path.join(__dirname, 'bootstrap_listenhub.sh'), '--install']);
}

const INSTALL = { ffmpeg: installFfmpeg, font: installFont, browser: installBrowser, manim: installManim, listenhub: installListenhub };

function parseArgs(argv) {
  const flags = {};
  for (let index = 0; index < argv.length; index += 1) {
    const token = argv[index];
    if (!token.startsWith('--')) continue;
    const next = argv[index + 1];
    if (next && !next.startsWith('--')) { flags[token.slice(2)] = next; index += 1; }
    else flags[token.slice(2)] = true;
  }
  return flags;
}

// Executables inside the skill lose their exec bit under some sync tools.
function repairPermissions() {
  const repaired = [];
  const targets = [path.join(__dirname, 'shims', 'ffmpeg'), ...fs.readdirSync(__dirname).filter((name) => /\.sh$/.test(name)).map((name) => path.join(__dirname, name))];
  for (const file of targets) {
    try {
      fs.accessSync(file, fs.constants.X_OK);
    } catch (_) {
      try { fs.chmodSync(file, 0o755); repaired.push(path.relative(SKILL_ROOT, file)); } catch (__) {}
    }
  }
  return repaired;
}

function main() {
  const flags = parseArgs(process.argv.slice(2));
  const only = flags.only ? String(flags.only).split(',').map((item) => item.trim()).filter(Boolean) : COMPONENTS;
  const unknown = only.filter((item) => !COMPONENTS.includes(item));
  if (unknown.length) {
    process.stderr.write(`Unknown component(s): ${unknown.join(', ')}. Choose from ${COMPONENTS.join(', ')}.\n`);
    return 2;
  }
  const results = {};
  const repaired = flags.check ? [] : repairPermissions();
  for (const component of only) {
    const before = STATUS[component]();
    if (before.ok || flags.check) {
      results[component] = { ...before, action: before.ok ? 'present' : 'missing' };
      continue;
    }
    const attempted = INSTALL[component]();
    const after = STATUS[component]();
    results[component] = { ...after, action: after.ok ? 'installed' : 'install-failed', attempted };
  }
  const failed = Object.entries(results).filter(([, value]) => !value.ok).map(([key]) => key);
  const report = {
    ok: failed.length === 0,
    mode: flags.check ? 'check' : 'install',
    platform: process.platform,
    results,
    repairedPermissions: repaired,
    failed,
    hint: failed.length
      ? (flags.check ? 'Run qcut setup to install the missing components.' : 'Install failed; read the log above. Homebrew/apt may need network or sudo.')
      : 'All requested dependencies are ready.'
  };
  process.stdout.write(flags.json ? `${JSON.stringify(report, null, 2)}\n` : `${Object.entries(results).map(([key, value]) => `${value.ok ? '✓' : '✗'} ${key}: ${value.action}`).join('\n')}\n${report.hint}\n`);
  return report.ok ? 0 : 1;
}

if (require.main === module) process.exitCode = main();

module.exports = { COMPONENTS, STATUS };
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall