VoxFlow 스킬 — 카드
텍스트를 독특하고 일관된 시각적 카드 이미지 세트로 변환합니다. 각 카드는 자체 웹페이지이며, 모든 카드는 하나의 크기와 스타일 시스템을 공유합니다. Playwright로 렌더링하고 PNG로 내보냅니다.
이것은 정적 카드 이미지 스킬입니다. 다른 표면으로 전환하려면 다음을 사용하세요:
- 아티클 → 세로형 카드 비디오 (슬라이스) — 1080×1920 릴, 13가지 테마 →
voxflow:slice - 짧은 비디오 / AI 클립 / 지식 카드 비디오 →
voxflow:video - 다중 화자 팟캐스트 →
voxflow:podcast - TTS / 음성 / 설치 / 인증 / 할당량 →
voxflow:hub
0단계 · 로그인 게이트 (필수, 먼저 수행)
이 스킬은 VoxFlow의 일부이며 로그인된 계정이 필요합니다. 어떤 작업보다 먼저 — 질문, 조사, 디자인 전에 — 로그인 상태를 확인하세요:
voxflow status
- 계정 및 남은 할당량 출력 → 로그인됨, 워크플로우 계속 진행.
- 오류 발생 / "not logged in" 표시 → 중지.
voxflow login실행 (브라우저 열림 — Google 또는 이메일 OTP), 사용자가 완료할 때까지 기다린 후voxflow status를 다시 실행하십시오. 로그인이 성공할 때까지 파라미터를 수집하거나 카드를 생성하지 마십시오. voxflow: command not found→ 먼저npm install -g voxflow를 실행한 후voxflow login을 실행하십시오.
이 게이트를 절대 건너뛰지 말고, 인증되지 않은 사용자를 위해 카드를 생성하지 말며, 토큰을 절대 임의로 만들지 마십시오. 캐시된 토큰은 ~/.config/voxflow/token.json에 있습니다. CI의 경우 VOXFLOW_TOKEN이 인식됩니다.
개요
소스 콘텐츠에서 공유 가능한 시각적 카드 세트를 만듭니다. 각 카드를 자체 웹페이지로 처리하고, 모든 카드의 크기와 스타일 시스템을 동일하게 유지하며, Playwright로 렌더링하고, 이미지를 내보내고, 약한 카드를 반복 개선합니다.
취향 기준
references/taste.md는 모든 카드 몰드, 테마, 레이아웃 및 디자인 언어를 제한하는 제약 체크리스트입니다. 워크플로우 시작 시 낭송해야 하는 시작 의식이 아니라, 디자인 시점에 작용하는 바닥(baseline)으로 취급하십시오.
references/taste.md는 워크플로우 시작 시가 아닌 두 가지 시점에만 로드하십시오:- 테마 프리셋 및 디자인 언어를 선택할 때 (워크플로우 4단계), 선택이 하드 제약 조건을 위반하지 않도록 합니다.
- QA 점수 평가 중 (워크플로우 7단계), 명시적인 검증 차원 중 하나로 사용합니다.
- 다른 단계 (파라미터 수집, 조사, 카피 계획)에서는
references/taste.md를 다시 로드할 필요가 없습니다. 제약 조건은 이미 선택된 프리셋과 언어를 통해 흘러 들어갑니다. - 핵심 목표는 명백한 AI 생성 디자인 흔적을 제거하는 것입니다.
- 하드 제약 조건에는 다음이 포함됩니다: 기본 Inter 글꼴 사용 금지, 순수 검정색 사용 금지, 기본 중앙 히어로 이미지 사용 금지, 세 개의 동일한 카드로 구성된 레이아웃 금지, 일반적인 AI 생성 카피 스타일 금지, 가짜처럼 보이는 데이터 사용 금지.
- 취향이 비어 있음을 의미하지 않습니다.
references/taste.md의 밀도 규칙을 사용하여 실제 카드 세트에는 사용자가 명시적으로 포스터 전용 또는 시네마틱 전용 세트를 요청하지 않는 한 최소한 하나의 유용한 정보 카드가 포함되도록 하십시오. - 테마 프리셋 또는 디자인 언어가
references/taste.md와 충돌하는 경우, 사용자가 금지된 스타일을 명시적으로 요청하지 않는 한 취향 기준이 우선합니다.
입력
다음을 수집하거나 추론하십시오:
content: 소스 텍스트, 개요, 노트, URL, 주제 또는 브리프.ratio: 사용자가3:4,9:16또는 다른 비율을 요청하지 않는 한 기본값은1:1입니다.count: 콘텐츠 밀도에 기반한 자동 개수를 기본값으로 하고, 명시적인 수량을 허용합니다.style: 명시적인 스타일 방향, 브랜드 제약, 대상 청중, 분위기 및 플랫폼을 허용합니다.content-language: zh / en / 혼합. 소스에서 추론하고, 모호하고 글꼴 선택을 변경하는 경우에만 질문합니다.references/fonts.md의 언어 오버라이드를 구동합니다.output: 사용자가 지정하지 않는 한cards/<slug>/와 같은 명확한 로컬 폴더를 선택합니다.
중요한 사실이 최신이거나 논쟁의 여지가 있을 수 있는 경우, 계획하기 전에 검색하거나 확인하십시오. 연구가 콘텐츠에 영향을 미칠 때 사용자가 출처 속성을 확인할 수 있도록 유지하십시오. 연구 및 사실 확인 섹션에서 이것이 빠른 확인 대신 전체 심층 연구 단계가 되는 경우를 참조하십시오.
연구 및 사실 확인
파라미터 수집과 디자인 작업 사이에 이 단계를 삽입하되, 입력이 카드 콘텐츠로 독립적으로 사용될 수 없는 경우에만 수행합니다.
content가 다음 중 하나인 경우 심층 연구를 트리거합니다: 주제 구문, 한 문장 브리프, 아직 본문을 읽지 않은 URL, 트윗 길이의 아이디어, 질문, 또는 "X를 설명해 줘 / X를 다뤄 줘 / X에 대한 카드를 만들어 줘"와 같은 요청.content가 이미 자체 완결된 아티클, 대본, 구조화된 노트 세트, 완전히 작성된 개요, 또는 사용자가 분명히 카드에 대해가 아니라 카드로부터 만들기를 원하는 텍스트인 경우 심층 연구를 건너뜁니다.- 트리거되면 시각적 계획 전에 사실 개요를 생성합니다:
- 핵심 주장 또는 테제.
- 구체적인 숫자, 이름, 날짜 또는 메커니즘을 포함한 3-7개의 뒷받침 포인트.
sources.md에 포함될 URL 또는 문서 참조가 있는 각 중요 사실에 대한 출처.- 사용자가 해결해야 하는 미해결 질문 또는 논쟁점.
- 사실 개요를 사용자에게 제시하고 테마/디자인 언어 선택으로 넘어가기 전에 확인, 추가 또는 수정을 요청합니다. 이것은 이후의 컨셉/시각적 확인과는 별개의 확인입니다.
- 이 단계의 출력물은 "뼈대" — 주장과 증거 — 이며 완성된 카드 카피가 아닙니다. 카드 수준의 훅, 설명자 및 핵심 내용은 나중에 콘텐츠 구조화(5단계)에서 확인된 뼈대 위에 작성됩니다.
- 사실 개요가 확인되는 즉시 여기서 수집된 출처를 출력 폴더 안의
sources.md에 기록합니다.
트리거 예시
다음과 같은 경우 심층 연구를 실행합니다:
- "MCP 프로토콜을 설명하는 카드 세트를 만들어 줘" — 주제만 있고 본문 없음.
- "이 글을 카드로 만들어 줘: https://example.com/post" — 이 대화에서 내용을 아직 읽지 않은 URL.
- "RAG 최적화 팁에 관한 카드 세트를 만들고 싶어, 특히 chunking에 집중해서" — 주제 + 각도, 구체적인 요점이나 데이터 없음.
- "Cloudflare Durable Objects는 어떤 시나리오에 적합해? 카드 몇 장 만들어 줘" — 질문 또는 "X를 설명해 줘 / X를 다뤄 줘" 형식.
- 단일 트윗, 헤드라인 또는 주제를 명명하지만 증거를 제공하지 않는 한 줄 브리프.
다음과 같은 경우 심층 연구를 건너뜁니다:
- 사용자가 전체 아티클, 블로그 게시물, 대본 또는 인터뷰 본문(약 500단어 이상의 자체 완결된 소스 콘텐츠)을 붙여넣는 경우.
- 사용자가 구조화된 노트, 회의록, 강의 노트 또는 각 카드의 제목과 2-4개의 요점이 이미 나열된 완성된 개요를 제공하는 경우.
- 사용자가 자신의 완성된 카피를 제공하고 시각적 처리만 요청하는 경우 ("이 문단을 카드로 배열해 줘", "이 카피를 예쁘게 꾸며 줘").
- 사용자가 명시적으로 "자료 찾지 마 / 이거 기반으로 바로 써 / 확장하지 마"라고 말하는 경우, 입력 길이에 관계없이.
경계선 입력
- 짧은 브리프 + 야망 불일치 — 예: 200단어 요약에 "7장으로 확장해 줘". 브리프가 목표 개수를 채우기에는 너무 얇으므로, 연구를 트리거하고 확장하기 전에 브리프에 증거가 부족함을 표면화하십시오.
- 아티클 + "최신 데이터 좀 더 보충해 줘 / 사례 좀 추가해 줘" — 요청된 추가 사항에 대해서만 범위가 제한된 연구 패스를 실행하고, 사용자가 이미 작성한 부분을 다시 연구하지 마십시오.
- 증거 없이 제목만 있는 글머리 기호 목록 — 예: "1. 성능 더 좋음 2. 더 저렴함 3. 더 안전함". 구체적인 숫자나 예를 첨부하기 위해 연구를 트리거하고, 그렇지 않으면 카드가 AI 채우기처럼 읽힐 것입니다.
- 아티클 + 사용자 자신의 의견 또는 견해 — 소스에 대한 연구는 건너뛰되, 의견을 그대로 유지할지 재구성할지 사용자에게 확인하십시오.
- 이 대화에서 이미 본문을 가져와 논의한 URL — 붙여넣은 콘텐츠로 처리하고 연구는 건너뛰되, URL을
sources.md에 기록합니다.
입력이 모호한 경우, 추측하는 대신 명확한 질문 하나를 하십시오 ("이 내용을 바로 카드로 만들까요, 아니면 제가 먼저 자료를 조사해서 확장할까요?") — 잘못된 연구 결정은 사용자의 시간이나 모델의 연구 예산을 낭비합니다.
사용자에게 질문하기
컨셉 계획 전, 시작 부분 근처에서 누락된 생성 파라미터에 대해 한 번 질문하십시오. "사용자에게 질문하기"를 이식 가능한 결정 정책으로 취급하고, 특정 도구를 호출해야 하는 요구 사항으로 취급하지 마십시오. 다양한 코딩 에이전트는 다양한 상호 작용 기본 요소를 노출하므로, 스킬은 구조화된 질문 도구가 있거나, 없거나, 에이전트의 작동 모드에 의해 권장되지 않는 경우에도 작동해야 합니다.
- 먼저
content,ratio,count,theme/style,platform/audience,output/constraints에 대해 알려진 값을 추출합니다. - 의미 있는 선택이 여전히 누락된 경우 계획하기 전에 사용자에게 생성 파라미터를 확인하도록 요청하십시오. 사용자가 "만들어 줘 / 생성해 줘 / 제작해 줘 / 바로 이미지로 내보내 줘 / 빨리 내보내 줘"와 같은 구문을 사용하는 경우에도 이렇게 하십시오. 이러한 구문은 묵시적인 파라미터 추론이 아닌 실행을 요청하는 것입니다.
- 답변이 출력물을 실질적으로 변경하는 경우 질문하십시오. 우선 순위:
content/source intent,ratio,count,theme/style,platform/audience,output/constraints. - 기본적으로 최대 3개의 간결한 질문을 하십시오. 사용자가 명시적으로 구성 선택을 원하거나 출력의 중요도가 높은 경우에만 최대 5개까지 사용할 수 있습니다.
- 사용자의 원래 요청에 이미 명시적인 파라미터에 대해서는 다시 질문하지 마십시오.
- 사용자가 명시적으로 질문하지 말라고 하거나 기본 파라미터를 명시적으로 승인한 경우에만 질문 단계를 건너뜁니다. 이 경우 기본값을 사용하고 실행 전 또는 실행 중에 가정을 간략히 명시하십시오.
호환성 전략
현재 환경에서 사용 가능한 최상의 질문 메커니즘을 사용하십시오:
- 환경이
ask_user_question,ask question또는 이에 상응하는 기본 명확화 기능을 지원하는 경우, 해당 기본 상호 작용을 사용하여 차단 질문을 명확히 하십시오. - 환경이 기본 질문 기능을 지원하지 않는 경우, 일반 대화에서 직접 질문하십시오.
- 한 번에 2-5개의 질문을 하십시오.
- 누락된 정보가 작업을 차단하지 않는 경우에도 최종 출력에 영향을 미치는 파라미터에 대해 한 번 확인을 요청하십시오. 사용자가 이미 기본값을 승인했거나 질문을 원하지 않는 경우, 합리적인 가정을 하고 계속 진행하십시오.
- 최종 응답,
sources.md또는credits.md에서 중요한 가정을 명시적으로 나열하십시오.
중지 조건
다음 중 하나가 참인 경우에만 생성 전에 중지하고 질문하십시오:
- 사용 가능한
content, 주제, URL 또는 소스 자료가 없습니다. - 소스 의도가 모호하고 잘못 선택하면 작업이 낭비됩니다. 예: "이 텍스트를 그대로 사용" 대 "이 주제를 조사하고 확장".
- 요청된 비율/플랫폼이 모순되거나 단일 내보내기로 충족할 수 없습니다.
- 시각적 방향이 누락된 브랜드, 법률, 접근성 또는 정확한 카피 제약 조건에 의해 규율됩니다.
- 연구 결과 핵심 주장을 변경할 논쟁의 여지가 있는 사실이 발견됩니다.
그렇지 않으면, 의미 있는 생성 파라미터에 대해 한 번 확인을 요청한 다음 문서화된 가정을 가지고 진행하고 이를 sources.md 또는 최종 응답에 기록하십시오.
비율 질문
다음 기본 선택을 사용하십시오:
1:1정사각형 카드: 일반적인 소셜 공유용.3:4세로형 그래픽 카드: 더 풍부한 텍스트/이미지 게시물용.9:16스토리, 릴, 숏폼 비디오 커버 또는 모바일 우선 카드용.
사용자가 제공하는 경우 4:5, 16:9와 같은 자유 형식 비율 또는 정확한 픽셀 크기를 허용합니다.
개수 질문
다음 기본 선택을 사용하십시오:
- 콘텐츠에 기반한 자동 추천.
3카드: 간결한 내러티브용.5카드: 표준 설명자용.7카드: 더 완전한 캐러셀용.
자동 추천 시, 아이디어를 군더더기 없이 다루는 가장 작은 세트를 선택하십시오. 설명자의 경우 3-7장, 공지의 경우 1-3장을 선호하십시오.
테마 질문
전체 프리셋 카탈로그를 사용자에게 직접 노출하지 마십시오. references/themes/presets.md를 로드하고, 시각적 방향이 중요한 경우 references/design-languages.md를 로드한 다음, 콘텐츠, 플랫폼, 청중 및 공유 목표에 따라 3-5개의 시나리오 기반 스타일 옵션을 추천하십시오. 사용자가 선택한 시나리오를 내부적으로 최종 테마 프리셋 및 디자인 언어 조합에 매핑하십시오.
사용자에게 스타일을 선택하도록 요청할 때, 하나의 추천과 모호한 "아니면 바꿀까요?" 질문만 제시하지 마십시오. 각각 다음을 포함하는 3-5개의 구체적인 옵션을 제공하십시오:
- 짧은 사용자 대상 스타일 이름;
- 가장 잘 작동하는 상황;
- 한 줄 시각적 설명;
- 내부 테마 프리셋 및 디자인 언어 매핑.
출력물이 몇 가지 동일한 모양으로 수렴되지 않고 적절하게 유지되도록 2계층 선택 로직을 사용하십시오:
-
기본 추천 계층:
- 콘텐츠 유형, 플랫폼, 청중 및 공유 목표에 따라 3-5개의 적합도가 높은 스타일을 제공합니다.
- 추천 세트를 사용자의 작업에 충분히 가깝게 유지하여 모든 옵션이 대대적인 재작업 없이 성공할 수 있도록 합니다.
- 토큰 이름이 아닌 가시적인 결과가 다른 옵션을 선호합니다. 예: 보수적인 보고서, 데이터 포스터, 소셜 노트북, 잡지 설명자, 대담한 의견.
-
변형 변동 계층:
- 사용자가 정확한 스타일을 강력하게 지정하지 않은 경우, 항상 상위 기본값을 선택하는 대신 호환 가능한 패밀리 내에서 회전합니다.
- 유사한 작업 전반에 걸쳐 다음 차원 중 적어도 두 가지를 변경합니다: 테마 프리셋, 기본 디자인 언어, 수정자, 레이아웃 레시피, 시각적 앵커, 표면 은유 또는 제목 구성.
- 변형이 콘텐츠와 의미적으로 호환되도록 유지합니다. 주제, 플랫폼, 접근성 또는 사실적 명확성과 충돌하는 무작위 참신함을 사용하지 마십시오.
- 변형을 검사할 수 있도록 최종 선택된 조합을 컨셉 계획 또는
sources.md/credits.md에 기록합니다.
사용자 대상 시나리오 레이블을 사용하십시오(예):
- 엔지니어링 인포그래픽:
engineering-paper,product-manual또는porcelain-research에 매핑. - 비즈니스 브리핑:
quiet-report,product-manual또는porcelain-research에 매핑. - 대담한 의견:
bold-editorial,magazine-eink또는newsroom-paper에 매핑. - 소셜 제품 노트:
social-notebook,magazine-eink또는bold-editorial에 매핑. - 사설 / 잡지:
magazine-eink,dune-gallery,field-notes또는kraft-editorial에 매핑.
디자인 언어 선택의 경우, 사용자 대상 시나리오 레이블을 사용하십시오(예):
- 기술적이지만 디자인된:
editorial-artifact + cutaway + annotation에 매핑. - 잡지 설명자:
image-led-magazine + edge-crop + asymmetric-space에 매핑.
...
[번역을 위해 잘림]
참고: 원본 SKILL.md가 잘렸습니다. 번역은 제공된 부분까지 완료되었습니다.