imagen-infographic은(는) 무엇을 하나요?
좋은 인포그래픽은 복잡한 정보를 명확하고 기억에 남으며 몇 초 안에 훑어볼 수 있는 형태로 바꿉니다. 장식보다 이해를 우선시합니다. 이 스킬은 이를 반복 가능한 프로세스로 만듭니다: 사양 작성, 린트, 렌더링, 반환된 텍스트 확인.
디자인 규칙 (사양 작성 전에 읽으십시오)
-
하나의 명확한 메시지. 전체 내용을 한 문장으로 말할 수 있어야 합니다. 그 문장을 먼저
message로 작성하십시오.headline은 핵심 요점을 전달하여 독자가 약 5초 안에 요점을 파악할 수 있도록 합니다. 두 가지 경쟁 아이디어는 두 개의 인포그래픽 또는 하나의 기사 섹션을 만듭니다. -
정확하고 신뢰할 수 있는 데이터. 출처 자료의 사실만 사용하십시오. 모든 숫자에는 출처가 있으며, 바닥글에 출처가 나열됩니다. 오해의 소지가 있는 척도나 선별된 숫자는 차트가 없는 것보다 신뢰를 더 빠르게 무너뜨립니다.
-
하나의 지정된 대상. 복잡성과 어휘를 독자가 이미 알고 있는 수준에 맞추십시오. 일반적인 개요는 누구에게도 도움이 되지 않습니다.
-
계층 구조와 흐름. 크기, 대비, 배치가 시선을 안내합니다: 헤드라인, 패널 레이블, 짧은 구문 순서. 위에서 아래로의 순서 또는 명확한 모듈식 그리드를 사용하십시오.
-
**데이터에 맞는 시각화.
- 비교에는
bar. - 시간 경과에 따른 추세에는
line. - 순서에는
timeline또는process. - 관계에는
diagram. - 나란히 비교에는
comparison. - 하나의 큰 숫자에는
stat. - 짧은 목록에는
icons또는checklist.
3D, 조각이 많은 파이 차트, 의미 없는 장식은 사용하지 마십시오. 린트는
pie,donut,radar,3d를 거부합니다. - 비교에는
-
단순함과 절제. 레이블은 짧게, 구문은 더 짧게 유지하십시오. 2
3개의 글꼴과 24개의 색상을 사용하고 넉넉한 여백을 두십시오. 섹션에 단락이 필요하다면 인포그래픽이 아닌 기사에 속합니다. -
접근성. 텍스트 대비는 최소 4.5:1이어야 하며, 스크립트가 이를 확인합니다. 항목을 구분하는 유일한 방법으로 색상을 사용하지 마십시오: 레이블을 붙이십시오. 이미지는 휴대폰에서도 읽을 수 있어야 합니다.
-
일관성. 하나의 아이콘 스타일, 하나의 타이포그래피 시스템, 균일한 간격을 사용하십시오. 프롬프트에서 이를 요청하므로 혼합된 지시로 이를 방해하지 마십시오.
실패 모드. 렌더링 전에 사양에서 다음을 확인하십시오:
- 정보 과부하 또는 너무 많은 주제
- 예쁘지만 의미 없는 장식
- 독자가 요점을 찾기 위해 헤매게 만드는 약한 계층 구조
- 잘못되었거나 왜곡된 차트
- 출처 누락
- 읽을 수 없는 텍스트
워크플로
- 메시지 찾기. 출처(기사 섹션, 보고서, 노트)를 읽으십시오. 한 문장의
message를 작성하고audience를 선택하십시오. 한 문장을 작성할 수 없다면 자료가 인포그래픽에 적합하지 않은 것입니다. - 사양 작성, YAML 프론트매터가 포함된 마크다운 파일. 형식과 전체 예제는
references/spec-format.md에 있습니다. 3~6개의 패널을 사용하고, 각 패널에는 짧은 레이블, 시각화 유형, 최대 3개의 구문 또는 몇 개의 데이터 포인트가 있어야 합니다. - 린트:
린트는 규칙 1, 2, 5, 6, 7의 제한을 적용하고 문제당 한 줄씩 출력합니다. 제한이 아니라 사양을 수정하십시오: 각 제한은 과거의 인포그래픽이 그것 없이 실패했기 때문에 존재합니다.python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - 렌더링:
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--theme는 모든 imagen-diagrams 테마 ID를 사용할 수 있으며, 팔레트와 스타일을 채웁니다. 사양에palette:를 설정할 수도 있습니다.- 기본 가로 세로 비율은 3:4, 세로 포스터입니다. 슬라이드의 경우
aspect: "16:9"로 설정하십시오. - 스크립트는 이미지 옆에
out.prompt.txt를 작성하여 요청된 내용을 볼 수 있도록 합니다.--dry-run을 사용하면 프롬프트를 출력하고 비용이 발생하지 않습니다.
- 게이트. 스크립트는
imagen analyze로 이미지를 다시 읽습니다. 헤드라인, 모든 패널 레이블, 출처 바닥글이 올바르게 표기되어 나타나야 합니다. 스크립트는 최대 3번 시도(--attempts)하고 실패한 이미지는 삭제하므로, 실패는 깨진 이미지가 아니라 눈에 띄는 공백입니다. - 직접 결과를 확인하십시오. PNG를 열고 여덟 가지 규칙에 대해 확인하십시오. 게이트는 철자만 확인합니다. 계층 구조가 약하거나 차트의 척도가 잘못되었는지 알 수 없습니다. 그림이 규칙을 위반하면 사양을 변경하고(단어 줄이기, 다른 시각화) 다시 렌더링하십시오.
이미지를 기사에 포함할 때는 캡션과 이미지가 무엇을 보여주는지 설명하는 짧은 단락을 제공하십시오. 이미지를 볼 수 없는 독자도 메시지를 이해할 수 있어야 합니다.
씬(Scene): 아이디어를 가지고 작업하는 사람
씬은 기사에서 설명하는 순간의 사람을 플랫 일러스트로 표현한 것입니다: 긴 채팅 로그를 보고 머리를 긁적이는 개발자, 테스트가 통과되어 안도하는 모습, 화이트보드에 계획을 스케치하는 모습. 씬은 기술적인 글에 개인적인 느낌을 더합니다. 씬은 기사의 다이어그램 중 하나를 모니터나 화이트보드에 보여줄 수 있어, 사람과 개념을 연결합니다. 기사당 약 하나의 씬을 사용하고, 좌절하거나 안도하는 순간을 포착하십시오.
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox
씬 사양은 짧은 프론트매터 블록입니다(references/spec-format.md 참조): person (누가, 무엇을 하고, 어떤 기분인지), setting, 선택적 diagram (사양 기준 상대 경로의 PNG, 참조 이미지로 전송됨), theme 또는 palette, aspect (기본값 16:9). 씬에는 자체 텍스트가 없으므로 텍스트 게이트도 없습니다. 각각을 확인하십시오: 감정이 한눈에 읽혀야 하며, 이미지에 제목, 캡션 또는 말풍선이 없어야 합니다.
요구 사항
- PATH에
imagenCLI (gemini-imagen)가 있고 작동하는 키가 있어야 합니다. - imagen-diagrams 플러그인.
--theme와generate.py의 엔진 장애 조치에 필요합니다. 플러그인이 없으면 스크립트는imagen generate를 직접 호출하며, 사양에palette:를 설정해야 합니다. - PyYAML이 포함된 Python 3.
스크립트를 변경한 후 infographic.py --self-test를 실행하십시오. 이미지 호출 없이 린트 및 대비 규칙을 확인합니다.