ishuagrawal/skills Skill 技能

技能简介

这是 Ishu Agrawal 开源的 Agent Skills 集合，每个技能都是一个含 SKILL.md 及其脚本、参考与素材的文件夹，兼容 Claude Code 以及任何支持开放 Agent Skills 格式的代理。当前主打技能 video-by-reference：把你喜欢的一支视频变成同风格的原创动画短片，并配自己的音轨。仓库本身被注册为 Claude Code marketplace（插件名 skills），可一键安装、可开自动更新、可用脚本打包发布。

核心能力

1. 风格参考转原创：读取你提供的参考视频，提取它的风格与节奏，生成一支有独立音轨的原创动画短片，而非简单复刻。
2. 多代理分发：同一份 SKILL.md 可装进 Claude Code、Cursor、Codex、OpenCode、Gemini CLI 等，也可上传到 claude.ai 与 Claude API。
3. 规范校验：scripts/check_skills.py 逐一检查每个 SKILL.md 是否符合 Agent Skills 规范，frontmatter 只保留 name、description、license、compatibility、metadata、allowed-tools，保证同一文件能直接上传 claude.ai。
4. 发布流水线：scripts/package_skills.sh 打出 dist/.zip，scripts/release.sh 按语义化版本改版本号、校验、提交、打 tag 并推送，tag 触发 GitHub Release 自动附上每个技能的 zip。
5. CI 持续验证：.github/workflows 在每次 push 时校验全部技能，Claude Code 只在 version 字符串变化时才视为新版本，因此必须走发布脚本。

安装配置

• Claude Code 会话内：/plugin marketplace add ishuagrawal/skills，然后 /plugin install skills@ishuagrawal 与 /reload-plugins。
• 终端方式：claude plugin marketplace add ishuagrawal/skills 加 claude plugin install ishuagrawal/skills --scope user。
• 其他代理：用第三方 skills CLI 执行 npx skills add ishuagrawal/skills，加 --skill video-by-reference 可只装单个技能，-a claude-code 指定目标，-g 装到用户级。
• 手动：把 skills// 复制到 ~/.claude/skills/（全项目）或 .claude/skills/（单项目）。
• 运行依赖：Node.js 22+、PATH 上的 ffmpeg 与 ffprobe、Python 3 加 numpy；渲染需要无头 Chromium（推荐 Playwright 的 chrome-headless-shell）。

使用步骤

1. 安装技能并新开会话。
2. 直接描述需求或调用 /skills:video-by-reference，Claude 在请求匹配时也会自动选中它。
3. 附上参考视频与素材，技能会在本地跑分析与渲染。
4. 更新：Claude Code 用 /plugin marketplace update ishuagrawal 加 /reload-plugins，或在 /plugin 的 Marketplaces 里对 ishuagrawal 开启自动更新；用 npx skills 的执行 npx skills update。

适用场景

• 把喜欢的成片风格迁移到自己的品牌或产品内容上。
• 为社媒批量产出风格统一的原创动画短片。
• 学习与研究 Agent Skills 的仓库结构、规范校验与发布流程。
• 团队把内部技能做成带 CI 与语义化版本的可分发插件。

适用人群：内容创作者、动效与短视频作者、Claude Code 插件开发者、想标准化管理技能的工程团队。

工作原理：技能以「参考视频 → 风格分析 → 本地渲染」为主线，分析阶段用 Python + numpy 读参考素材，渲染阶段靠 ffmpeg 与无头 Chromium 在本机出片，因此 claude.ai 与 API 沙箱因无网络与缺 Chrome/ffmpeg 只能读技能而难以渲染，效果最好的是 Claude Code 或其他本地代理。仓库结构用 .claude-plugin/marketplace.json 与 plugin.json 声明市场与版本，skills// 一目录一技能，发布由脚本统一驱动。

官方链接：GitHub 仓库 https://github.com/ishuagrawal/skills ；Agent Skills 规范参考 https://agentskills.io （MIT 协议）。