프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요 로그인

oil-cover Skill

저장소 ↗

제작자: oil-oil★ 303skill 1개

설치

할 수 있는 일

Video cover & thumbnail skill for Claude Code & Codex. 帮你用视频画面做小红书和 B 站封面。

제작자가 쓴 원문

  • 연결 방식 AI가 읽는 지시 파일이며, 외부 서비스를 호출하는 단계가 있습니다
  • 계정 또는 키 ZENMUX_API_KEY의 키가 필요한 단계가 있습니다 (README 기준)
  • 분류 디자인과 웹
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/oil-oil-oil-cover.svg)](https://mcp.popnx.com/en/skills/oil-oil-oil-cover)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

제작자: DayuanJiang널리 사용됨↓ 2.2만/주★ 3.7만 저장소 전체의 별6일 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

제작자: pascalorg널리 사용됨↓ 1천/주★ 2.6만 저장소 전체의 별그저께 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드✓ 서비스 회사 · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

제작자: nteract널리 사용됨↓ 8.5천/주★ 2.7천오늘 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
oil-cover
impeccablediagram-designfrontend-slidesguizang-ppt-skill
제작자oil-oilpbakauscathrynlaveryzarazhangruiop7418
Skill 수11111
GitHub 별303113,53668,71332,63930,137
마지막 코드 변경2026년 11월 16일2026년 11월 20일2026년 11월 19일2026년 6월 24일2026년 10월 30일
라이선스–Apache-2.0MITMITAGPL-3.0

oil-oil의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

CodexCursor

제작자 README와 repo 폴더 기준

설치

안전한가요?

  • 만든 사람

    GitHub 계정 oil-oil(개인), 만든 지 7년

  • 사용 현황과 관리

    ★ 303개, 아직 사용자가 적습니다 · 코드 마지막 수정 2026년 11월 16일

  • 스크립트가 있나요?

    컴퓨터에서 실행할 수 있는 스크립트가 22개 있습니다: scripts/credential-ui/public/app.js, scripts/credential-ui/public/favicon.svg, scripts/credential-ui/public/index.html, scripts/credential-ui/public/style.css 그리고 파일 18개 더

  • 인터넷을 사용하나요?

    인터넷에 접속하는 스크립트: scripts/credential-ui/tests/profile.test.ts, scripts/credential-ui/tests/native-smoke.ts, scripts/credential-ui/web/app.ts, scripts/credential-ui/public/app.js

  • 컴퓨터 전체 설정을 바꾸나요?

    hook이나 컴퓨터 설정을 쓰는 동작을 찾지 못했습니다

저장소 commit dde9572의 파일을 자동으로 검사했습니다(읽기만 했고 아무것도 실행하지 않았습니다). 안전을 보증하는 것은 아니니, 직접 읽어 보고 판단하세요

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

방법 1claude.ai에 업로드(웹과 앱)

  1. GitHub에서 내려받기

    이 Skill은 라이선스가 명시되어 있지 않기 때문에 저희 사이트에서 ZIP을 배포하지 않습니다. GitHub에서 내려받아 폴더를 직접 정리하거나, 위의 "AI가 대신 설치하기"를 사용하면 더 쉽습니다

    GitHub에서 내려받기(저장소 전체) ↗

    압축을 풀고 oil-cover 폴더만 다시 ZIP으로 압축하세요. ZIP의 맨 위에 SKILL.md가 들어 있는 oil-cover 폴더가 있어야 하며, 파일을 그냥 흩어 놓으면 안 됩니다

  2. claude.ai의 Skills 페이지를 열고 업로드하기

    +Create skillUpload a skill파일 oil-cover.zip 선택

    claude.ai/customize/skills 열기 ↗

  3. Upload 버튼이 보이지 않나요? 먼저 파일 생성 권한을 켜세요

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com

방법 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

설치할 위치

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Claude Code를 다시 열고 /oil-cover를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

제작자가 권하는 방법

Node.js 설치 (아직 없다면)

이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter

node -v
  • 버전 번호(예: v26.13.1)가 나오면 설치된 것입니다. 이 단계는 건너뛰세요
  • "command not found"(Windows는 "is not recognized")가 나오면 아직 설치하지 않았거나, 방금 설치해서 터미널을 닫았다가 다시 열어야 합니다
터미널 여는 법

Mac: ⌘ + Space를 누르고 Terminal 입력 후 Enter

Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"

아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다

Node.js 다운로드 페이지 열기 ↗

설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v

한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

제작자 README에서 가져온 명령으로, 제작자 코드를 내려받아 실행해요

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Claude Code를 다시 열고 /oil-cover를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

방법 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

설치할 위치

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

방법 2폴더를 직접 넣기

oil-cover 폴더를 ~/.agents/skills/oil-cover에 넣으세요

~는 홈 폴더($HOME)입니다

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

방법 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

설치할 위치

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

방법 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

설치할 위치

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Cursor Agent 채팅에서 /를 입력하고 oil-cover 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

Terminal을 쓰는 분께

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요

    명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

  3. Cursor Agent 채팅에서 /를 입력하고 oil-cover 선택

방법 1AI가 대신 설치하기

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · 이 문장을 복사해서 앱의 채팅에 붙여 넣으세요

설치할 위치

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요

프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다

AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

Terminal을 쓰는 분께

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

원본 SKILL.md 보기

아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요

처음 8,000자 표시 · GitHub에서 전체 파일 열기

---
name: oil-cover
description: 生成小红书和 B 站 AI 工具实操视频封面,支持脚本模式与 Agent 自主模式、真实视频证据、三画幅输出和可选创作者头像。仅在用户明确提到 oil-cover、$oil-cover、使用 oil-cover 或指定本 Skill 时触发;普通封面、首图、视频封面请求不要自动触发。
---

# oil-cover

为小红书 AI 工具实操内容生成稳定、清楚、干净、精致的视频封面。执行模式以用户配置为准;两种模式遵循同一套标题、产物和验收规则。

先检查当前视频已有产物:源视频、审校字幕、标题、画幅和头像配置未变且最终图已经验收时,直接复用。缺哪一版只生成哪一版;只改头像时复用无人物底图。用户选定已有版本后停止其他候选的生成。两种模式均遵守这条恢复规则,不因分析文件格式不同重做已有封面。

## API Key 配置入口

需要外部服务凭据时先读[API Key 配置与业务读取](references/api-key-setup.md):复用已有安全入口;本机缺少 Key 时使用随附固定页面,保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。

## 两种执行模式

- **模式一 · 脚本模式(默认)**:把活儿交给 `generate_oil_cover.py`,由脚本调用外部视觉服务完成选帧分析,并生成无人物底图;用户配置启用创作者头像时,再用确定性代码把透明头像合成到右下角。需要 Python、ffmpeg、Pillow 和所选服务的 API Key。下面「默认入口」到「输出说明」描述的都是这一模式。
- **模式二 · Agent 自主执行**:复用宿主视觉与内置生图能力,无需额外服务 Key,由执行的 Agent 自己读 SOP 完成选帧、分析和生图;用户配置启用头像时,再调用项目脚本的头像合成函数。完整流程见 `references/agent-native-flow.md`。

## 安装位置与用户配置

不要假设用户名、Skill 安装目录、视频库、脚本、素材镜像或密钥位置。

- `SKILL_DIR`:当前这份 `SKILL.md` 所在目录。
- 用户配置:`${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}`。它属于本机用户,不进入 Skill 仓库。
- Skill 内脚本:`$SKILL_DIR/scripts/generate_oil_cover.py`。若安装包没有脚本,读取配置里的 `script_path`;两者都不存在时说明安装不完整,不要猜个人目录。
- Skill 内资产:`$SKILL_DIR/assets/`。额外素材镜像仅从配置 `product_asset_mirror` 读取。
- API key:优先使用 `ZENMUX_API_KEY`;备用文件仅从 `api_key_file` 配置或 `--api-key-file` 读取。不要把 key 或个人绝对路径写进 Skill 仓库。

支持的用户配置:

```json
{
  "mode": "agent-native",
  "creator_name": "optional creator name",
  "script_path": "/optional/path/to/generate_oil_cover.py",
  "video_library_root": "/optional/path/to/video-library",
  "product_asset_mirror": "/optional/path/to/shared-product-assets",
  "api_key_file": "/optional/path/to/zenmux-key",
  "creator_portrait": {
    "enabled": false,
    "path": "/optional/path/to/portrait.png"
  }
}
```

路径允许使用 `~`,读取后必须展开。没有配置 `video_library_root` 时,所有持久产物默认跟随输入视频。配置后,同一视频的持久资源统一放进 `<video_library_root>/<视频标题>/`;从导出暂存目录开始处理时,先无覆盖地归位源视频,再生成字幕、封面和 sidecar。

### 选哪个模式(设一次,以后不问)

每次触发 oil-cover 时按这个顺序决定:

1. 先读用户配置的 `mode` 字段。
2. 已设为 `script` 或 `agent-native` → **直接按该模式执行,不再询问**。
3. 未设置(第一次)→ 问用户一次默认想用哪种模式,说明这是一次性设置;拿到答案后更新用户配置,再按选择执行。保留文件里的其他配置键,不要整份覆盖:

   ```bash
   mkdir -p "$(dirname "${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}")"
   # 合并写入 {"mode":"agent-native"},或设为 "script"
   ```

4. 用户随时可说「切换 / 改成 X 模式」覆盖默认(重写该文件),或在单次任务里临时指定某模式而**不**改默认偏好。

**前提与回退**:模式二要求执行 Agent 具备多模态视觉 + 支持参考图的生图工具,通过当前宿主实际提供的工具判断,不根据宿主品牌推断。若 `mode=agent-native` 但当前环境跑不了生图这一步,说明情况并给两条路——使用具备所需能力的宿主,或在已授权的服务范围内临时使用脚本模式——不要静默失败,也不要擅自改掉用户的默认偏好。

走模式二时,先完整读 `references/agent-native-flow.md` 和 `references/cover-rules.md`,按 SOP 执行,**忽略下面所有针对脚本的参数与说明**。

## 修改已有风格

用户反馈字号、留白或局部排版时,默认只调整对应问题,保留原有字体气质、配色体系、透视、装饰和主体表达。先保留可回退的图片与提示词,再做最小修改;未明确要求更换风格时,不全面重写视觉规范。

## 封面标题提炼(执行者职责)

封面主标题由执行本 skill 的 Agent 在跑脚本**之前**自己提炼,不交给脚本里的分析模型做,避免它理解错内容:

- 用户已经指定封面标题,或要求“封面也用文件名”时,直接锁定原文,只做视觉断行;只有未指定时才按下述方法提炼。视频文件名、封面标题、发布标题分别记录,不能互相覆盖。平台发布标题的长度限制不用于缩短封面标题。
- 视频标题只是主题输入,封面主标题不必和它一模一样。要突出这条视频最有分量的重点:结论、评价、对比、数字。
- **字数与品牌名解耦(防字号缩水)**:Agent 自拟主标题时,默认提炼为 **`2 行 × 3–5 字`(最佳 `4+4` 字,两行用空格分隔,如 `"AI 写前端 风格统一"`、`"后台设计 更有质感"`、`"一眼看懂 代码改动"`)**。不要把长英文品牌名或工具名(如 `Claude Code`、`GitHub Copilot`、`Screen Studio`)硬塞进主标题行内凑成 7–8 个字符导致整块标题字号被迫缩小;长品牌名应拆为标题上方的独立品牌小标(small product mark / eyebrow lockup),把主标题空间留给两行超大字(短词如 `AI` 除外)。
- 有字幕或文稿时(`.srt`/`.ass`/`.txt`,或视频旁的同名字幕文件)先通读一遍再提炼。`.ass`/`.srt` 先抽成纯文本(去掉时间轴和样式标记)。优先借用视频里的原话强词(例如口播里的「目前最强」「指哪打哪」这类明确判断),忠于内容,不夸大、不编造评价。
- 没有字幕、文稿或用户补充时,才退回视频标题本身做克制的精简。
- 提炼结果通过 `--title` 传给脚本;抽好的纯文本字幕通过 `--subtitle` 传入,供分析模型选帧、写副标题和点缀使用。分析模型会把 `--title` 当作已定稿的封面主标题,只做断行和排版,不再改写。
- **独立理解检查**:封面脱离文件名、正文和此前对话时,也要让第一次看到的人马上知道主题。主标题优先写清“对象 + 具体任务或结果”;不要单独用依赖上下文的反转短语(如“不只 X”)、泛化形容词或悬念句代替主题。若使用这类表达,副标题必须同时点明具体对象和结果。生成后只看封面做一次理解检查;仍说不清视频讲什么,就改写标题并重新生成、检查全部画幅。

## 默认入口

将实际存在的生成脚本绝对路径记为 `OIL_COVER_SCRIPT`。默认运行以下命令;有字幕时额外添加 `--subtitle "<实际纯文本字幕路径>"`,没有字幕时省略该参数:

```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
  --video "<视频路径>" \
  --title "<提炼后的封面主标题>" \
  --topic "<补充背景>"
```

如果用户提供的是截图或已选关键帧:

```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
  --image "<截图或关键帧路径>" \
  --logo "<可选 Logo 路径>" \
  --title "<标题或主题>" \
  --topic "<补充背景>"
```

默认不传 `--aspect` 时,脚本会并行生成小红书 `3:4` 竖屏版、通用/B 站首页主封面 `4:3` 横屏版和 `16:9` 横屏版。只重跑或按需生成部分画幅时使用 `--aspect both`(`3:4` + `4:3`)、`--aspect 3x4`、`--aspect 4x3`、`--aspect 16x9` 或逗号组合(如 `3x4,4x3`、`4x3,16x9`)。

## 进阶参数

- `--subtitle <脚本/字幕/转录文件>`:把上下文喂给 Gemini,帮助判断主题、标题措辞和证据选择。有完整文稿时优先加上。
- `--logo <Logo 路径>`:可多次传入多个产品 Logo 作为参考资产。
- 自动 Logo 匹配只把 `--title` 和 `--topic` 当作主产品依据。只要其中任一存在,就不再扫描字幕寻找 Logo,避免把口播里的次要产品错当成主产品。
- 主产品没有可信 Logo 资产时保持无外置 Logo,不拿字幕中的其他品牌代替,也不让生图模型发明近似标识;此时用准确产品名和真实界面建立识别。
- 如果标题、字幕、视频画面或截图能明确判断主产品有 Logo,但 `references/product-assets.md` 暂时没有对应资产,先联网寻找官方或可信来源的透明 PNG,归档到 `$SKILL_DIR/assets/product-logos/`;配置了 `product_asset_mirror` 时再同步到镜像目录。通过 `--logo` 传给脚本,高频复用的产品同步补充到 `product-assets.md` 和脚本的自动匹配表。
- 取帧策略是「本地预筛」:脚本用 ffmpeg 低分辨率扫描整段视频,对每帧算清晰度(拉普拉斯方差)、亮度、内容度,硬过滤掉黑屏/纯白/纯色/loading/模糊帧,再按时间分桶取每段最清晰的一帧,产出若干**真实高清候选**交给分析模型按语义挑最佳帧。全程不调模型选帧、不上传整段视频。这是唯一的自动取帧路径,没有旧的「视频选帧」/均匀盲采兜底——预筛若失败会直接报错,不会静默降级。
- `--frame-count <N>`:本地预筛产出多少个候选帧供分析模型挑选,默认 8。候选越多模型选择越好,但分析请求越大。
- `--scan-fps <N>`:本地预筛扫描的采样帧率,默认 0=自动(≤5 分钟视频用 2fps,更长用 1fps)。想抓更细的瞬间可调高。
- `--candidate-seconds 1,8,24.5`:手动指定取帧时间点,跳过本地预筛。已经知道哪几秒是关键画面时用。
- `--aspect all|both|3x4|4x3|16x9|组合`:默认 `all` 并行生成三版;`both`(或 `3x4,4x3`)只生成 `3:4` 和 `4:3`;单独生成或重跑时传入指定画幅或逗号组合(如 `4x3,16x9`)。
- `--cover-state-file <状态文件路径>`:可选,每完成或失败一个画幅立即原子写入 JSON 状态(含 `generated` 与最终路径),供并行发布编排实时追踪各画幅进度。
- `--bilibili-size <尺寸>`:B 站个人空间 `16:9` 伴随版的 API 尺寸,默认 `1280x720`;B 站个人空间槽使用此 `16:9` 文件独立上传。
- 副标题默认放开。如需禁用副标题、让外层只剩主标题,传 `--no-allow-subtitle`。
- 创作者头像由本地代码在生图后合成,不作为 Gemini 或 `gpt-image-2.5-flare` 的参考图上传。是否启用及素材路径来自用户配置;公开 Skill 默认关闭。默认布局参数为:3:4 宽约 55%、顶部约 58%、向右越界约 6%;4:3 宽约 38%、顶部约 40%、向右越界约 3%;16:9 宽约 32%、顶部约 40%、右侧内收约 2%。
- 用户明确要求无人物封面时传 `--no-default-creator-portrait`。配置启用头像时默认保留;未配置时保持无人物。

排查与验证:

- `--dry-run`:不调任何 API,只准备本地文件和 prompt,用于核对路径、规则文件和素材是否就位。
- `--skip-generate`:只跑 Gemini 分析和写 prompt,不调用图片 API。用来看 Gemini 选了哪一帧、标题怎么断行、prompt 写成什么样。
- `--generation-only`:用 `/images/generations` 而非 `/images/edits`,屏幕帧和 Logo 参考图不上传给图片 API;头像启用时始终只在本地合成。

## 脚本职责

- 脚本路径:优先 `$SKILL_DIR/scripts/generate_oil_cover.py`,否则使用用户配置 `script_path`
- 默认分析模型:`google/gemini-3.8-flash`
- 默认生图模型:`openai/gpt-image-2.5-flare`
- 默认规则文件:`references/cover-rules.md`
- 默认输出位置:视频(或图片)所在目录。最终封面命名 `<视频名>_3x4.png`、`<视频名>_4x3.png`、`<视频名>_16x9.png`,直接落在影片旁边方便查找;分析、prompt、原始响应等中间产物收进 `<视频名>.oil-cover/` 子目录。传 `--output-root` 可改到别处。

脚本负责用 ffmpeg 本地扫描+评分预筛出若干高清候选帧(默认策略,无需调模型),把候选交给视觉模型分析、由模型按语义选出最佳封面帧并生成封面方案和提示词、保存 sidecar、并行调用所选图片服务、生成无人物底图。用户配置启用头像时,再用 Pillow 把透明头像按画幅参数合成到右下角;头像不会进入 视觉或图片 API 的参考图列表。底图保存在 `<视频名>.oil-cover/<画幅>.generated-base.png`,合成记录保存在 `portrait_composite.json`,最终封面写到影片目录。本地预筛的打分明细写在 `<视频名>.oil-cover/frame_selection_local.json`。

## 何时读取参考文件

- 走模式二(Agent 自主执行)时,先完整读 `references/agent-native-flow.md`(流程 SOP)和 `references/cover-rules.md`(视觉规范)。
- 日常生成封面时(模式一),不需要手动读取完整视觉规范;脚本会把 `references/cover-rules.md` 传给 Gemini。
- 修改视觉规则、排查提示词遗漏、评审模型输出质量或调整脚本 guard 时,读取 `references/cover-rules.md`。
- 判断产品 Logo 或产品资产时,读取 `references/product-assets.md`。
- 新增产品 Logo、排查资产缺失或判断可信来源时,读取 `references/product-assets.md` 并按里面的补充规则执行。
- 如果用户要求复刻特定冲击型科技封面风格,读取 `references/impact-tech-cover-style.md`。

## 不可违反

- 生图模型必须一次性生成完整无人物底图,包括真实屏幕证据、标题、产品标识、点缀和风格化效果。
- 头像按配置直接合成,不要求预留避让空间,也不以头像遮挡为验收或返工条件。
- 本地后处理只允许执行一项:配置启用头像时,把配置的透明头像按固定参数 alpha 合成到右下角。不要本地贴字、贴 Logo、拼其他图片、重排、裁切改版或视觉修补。
- 源截图、重建 UI 和生图底图不保留人物、人脸、头像、摄像头气泡和真人画中画;配置启用头像时,最终封面只允许出现这一张代码合成的头像,否则最终封面保持无人物。
- 绝对不要把历史案例或上一次任务里的产品名、模型名、关键词、品牌色和点缀带入当前封面。所有外层文字和点缀都必须来自当前视频、当前标题、当前字幕、当前截图或当前用户补充信息。
- 外置产品 Logo 必须对应当前主标题或用户显式传入的参考资产;字幕里的次要品牌不能替代主产品,没有匹配资产时不放外置 Logo。
- 默认同时交付 `3:4`、`4:3` 和 `16:9` 三版;上游流程明确指定所需画幅集合(如未选 YouTube 时传 `--aspect both`)或单独重跑时,只生成指定画幅。
- 锁定标题的断行必须逐字拼回用户原题,不能在英文标识或版本号内部断开。写入生图 prompt 前统一替换完整标题指令,包括模型的逐行描述,只保留一套标题与断行;副标题和构图指令独立保留。重新应用 guard 后结果必须不变。
- 每次生图前保存 `.prompt.md` sideca

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
303
제작자
oil-oil
라이선스
라이선스 명시 없음 이 repo에는 라이선스가 없습니다. 기본적으로 제작자가 모든 권리를 가지므로 배포나 상업적 사용 전에 문의하세요.
최근 코드 수정
2026년 11월 16일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
agent-skill, agent-skills, bilibili, claude-code, claude-skills, codex, codex-skill, content-creation, cover, cover-design, image-generation, skill