name	hermes
description	Hermes Agent CLI reference for Claude Code: oneshot image generation, baoyu-infographic, and blog automation.
version	1.0.0
author	goddaehee
license	MIT
platforms	["macos"]
metadata	{"tags":["hermes","image-gen","infographic","blog-automation","ai-agent"],"homepage":"https://github.com/goddaehee/hermes-claude-skill"}

Hermes Agent — Claude Code 활용 가이드

Version: v1.0.0 (2026-05-11 최초 작성. hermes --help + hermes tools list + hermes status 직접 실행 기반)

사전 조건

# 설치 위치 확인
which hermes                          # /Users/<user>/.local/bin/hermes
hermes version                        # 버전 확인

# 인증 상태 + 현재 모델/프로바이더 확인
hermes status                         # Provider: OpenAI Codex, Model: gpt-5.5 (검증완료/2026-05-11)

# 툴셋 활성화 상태 확인
hermes tools list                     # image_gen, vision, file, web 등 활성화 여부

hermes model 및 hermes config 하위 명령은 대화형 TTY 필요. 파이프·서브프로세스에서 실행 불가.

핵심 CLI 패턴

자동화용 비대화형 실행 (검증완료/2026-05-11, Hermes 직접 자문)

# 자동화 권장 형태 — hermes chat -Q (quote 깨짐 방지를 위해 프롬프트 파일 사용)
hermes chat -Q \
  --source tool \
  -s baoyu-infographic \
  -t image_gen,file,skills \
  -q "$(cat "$PROMPT_FILE")"

# stdout/stderr 분리 로그
hermes chat -Q \
  --source tool \
  -s baoyu-infographic \
  -t image_gen,file,skills \
  -q "$(cat "$PROMPT_FILE")" \
  > "$OUTPUT_DIR/logs/hermes.stdout.txt" \
  2> "$OUTPUT_DIR/logs/hermes.stderr.txt"

# 인라인 프롬프트 (짧은 테스트용)
hermes chat -Q --source tool -s baoyu-infographic -t image_gen,file -q "PROMPT"

[FACT] -Q = 비대화형(non-interactive) 모드. --source tool = 자동화 소스 마커. -s 는 --skills 의 단축 플래그. (출처: Hermes 직접 자문 2026-05-11)

단순 oneshot (탑레벨 `-z` 플래그)

# hermes --help에서 확인된 탑레벨 플래그 (-z)
hermes -z "PROMPT" -t image_gen,file --skills baoyu-infographic --accept-hooks --yolo

# 모델 오버라이드
hermes -z "PROMPT" -m gpt-5.5 --provider codex

[ESTIMATE] -z 플래그는 탑레벨 help에 표시되나, 자동화 안정성은 hermes chat -Q 형태가 더 권장됨 (Hermes 자문 기반). quote 처리가 복잡한 멀티라인 프롬프트는 반드시 프롬프트 파일 방식 사용.

[UNVERIFIED] 이미지 생성 모델(gpt-image-2) 개별 지정 플래그는 검증 중. 현재 환경은 Provider: OpenAI Codex / Model: gpt-5.5이며 image_gen 툴셋은 Codex 연결을 통해 gpt-image-2를 호출하는 것으로 추정됨.

빌트인 툴셋 (검증완료/2026-05-11, `hermes tools list` 기준)

툴셋	아이콘	상태	설명
`image_gen`	🎨	✓ enabled	이미지 생성 (baoyu-infographic 등과 연동)
`vision`	👁️	✓ enabled	이미지 분석 / Vision
`file`	📁	✓ enabled	파일 읽기/쓰기 (manifest 저장 핵심)
`web`	🔍	✓ enabled	웹 검색 & 스크래핑
`browser`	🌐	✓ enabled	브라우저 자동화
`terminal`	💻	✓ enabled	터미널 & 프로세스
`code_execution`	⚡	✓ enabled	코드 실행
`tts`	🔊	✓ enabled	텍스트 음성 변환
`computer_use`	🖱️	✓ enabled	macOS Computer Use
`video`	🎬	✗ disabled	비디오 분석
`moa`	🧠	✗ disabled	Mixture of Agents

-t 플래그로 여러 툴셋 활성화: -t image_gen,file,web

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, `hermes skills list` 기준)

스킬	카테고리	설명
`baoyu-infographic`	creative	21 layouts × 21 styles 인포그래픽 생성기
`kie-image-generator`	openclaw-imports	13+ 모델 선택, 가격 추적, 고품질 이미지
`image-prompt-guide`	openclaw-imports	이미지 프롬프트 구조 가이드
`architecture-diagram`	creative	아키텍처 다이어그램 자동 생성
`excalidraw`	creative	Excalidraw 스타일 다이어그램
`claude-design`	creative	Claude 스타일 디자인

baoyu-infographic 레이아웃 × 스타일 (출처: `~/.hermes/skills/creative/baoyu-infographic/SKILL.md` [FACT])

레이아웃 21종

레이아웃	용도
`linear-progression`	타임라인, 프로세스, 튜토리얼
`binary-comparison`	A vs B, 비교/대조
`comparison-matrix`	다중 요소 비교
`hierarchical-layers`	피라미드, 우선순위
`tree-branching`	카테고리, 분류
`hub-spoke`	중심 개념 + 관련 항목
`structural-breakdown`	분해도, 단면도
`bento-grid`	다중 주제 개요 (기본값)
`iceberg`	표면 vs 숨겨진 측면
`bridge`	문제-해결 구조
`funnel`	전환, 필터링
`isometric-map`	공간 관계
`dashboard`	메트릭, KPI
`periodic-table`	카테고리 컬렉션
`comic-strip`	내러티브, 시퀀스
`story-mountain`	플롯 구조
`jigsaw`	상호 연결 구성 요소
`venn-diagram`	겹치는 개념
`winding-roadmap`	여정, 마일스톤
`circular-flow`	사이클, 반복 프로세스
`dense-modules`	고밀도 데이터 가이드

스타일 21종

스타일	설명
`craft-handmade`	손으로 그린 종이 공예 (기본값)
`technical-schematic`	청사진, 엔지니어링 도면
`hand-drawn-edu`	마카롱 파스텔, 손그림, 교육용
`corporate-memphis`	평면 벡터, 선명한 색상
`bold-graphic`	코믹 스타일, 하프톤
`ikea-manual`	미니멀 선 아트
`ui-wireframe`	회색조 인터페이스 목업
`cyberpunk-neon`	네온 글로우, 미래적
`kawaii`	일본 귀여운 스타일
`chalkboard`	칠판 위 분필
`storybook-watercolor`	부드러운 수채화
`aged-academia`	빈티지 과학, 세피아
`origami`	접힌 종이, 기하학
`pixel-art`	레트로 8비트
`subway-map`	지하철 노선도
`knolling`	정리된 플랫레이
`lego-brick`	레고 블록
`pop-laboratory`	청사진 격자, 좌표 마커
`morandi-journal`	손그림 낙서, 따뜻한 색조
`retro-pop-grid`	1970년대 레트로 팝
`claymation`	3D 클레이 피규어

한국어 블로그 권장 조합 ([출처: Hermes 직접 자문 2026-05-11])

섹션 유형	레이아웃	스타일	비고
기술 설명/아키텍처	`bento-grid`	`technical-schematic`	기술 독자 기본값
초보자 개념 설명	`hub-spoke`	`hand-drawn-edu`	beginner audience
단계별 튜토리얼	`linear-progression`	`ikea-manual`	Step N 구조
초보 튜토리얼	`linear-progression`	`hand-drawn-edu`	beginner audience
비교/A vs B	`binary-comparison`	`corporate-memphis`	비교 섹션
체크리스트/Q&A	`dashboard`	`corporate-memphis`	요약 섹션
인트로/결론/썸네일	`bento-grid`	`bold-graphic`	시각적 임팩트
내부 구조/원리	`structural-breakdown`	`technical-schematic`	아키텍처 설명

JSON I/O 계약 (블로그 이미지 자동화용)

입력 스키마 (`cardnews-input.json`)

{
  "article_id": "20260511-example",
  "output_dir": "/path/to/runs/<run-id>/images",
  "default_model": "codex/gpt-image-2",
  "aspect_ratio": "16:9",
  "items": [
    {
      "paragraph_id": "section-01",
      "heading": "섹션 제목",
      "text": "섹션 핵심 내용 2~3문장",
      "layout": "bento-grid",
      "style": "technical-schematic"
    }
  ]
}

출력 매니페스트 (`cardnews-manifest.json`)

{
  "article_id": "20260511-example",
  "generated_at": "2026-05-11T12:00:00Z",
  "model": "codex/gpt-image-2",
  "items": [
    {
      "paragraph_id": "section-01",
      "heading": "섹션 제목",
      "image_path": "/path/to/images/section-01.png",
      "image_url": null,
      "prompt_path": "/path/to/prompts/section-01.md",
      "layout": "bento-grid",
      "style": "technical-schematic",
      "aspect_ratio": "16:9",
      "alt_ko": "섹션 제목 관련 인포그래픽",
      "cost_usd": null
    }
  ]
}

image_path 또는 image_url 중 하나가 반드시 존재해야 함. URL이면 다운로드 후 image_path에 로컬 경로 기록.

주의 사항

cmux pane 자동화 비추천: cmux send로 Hermes 페인에 메시지 전송 시 멀티라인 텍스트가 Enter로 분리됨. 자동화는 hermes chat -Q(기본 패턴) 또는 hermes chat -Q --source tool을 사용. hermes -z는 레거시 플래그이며 chat -Q와 기능이 겹침.
URL vs 로컬 path: image_generate 툴이 URL 또는 로컬 path를 반환할 수 있음. wrapper 스크립트에서 URL 감지 시 curl -L -o 다운로드 처리 필수.
Codex 인증: hermes status에서 Provider: OpenAI Codex 표시 시 Codex 연결 활성. 인증 만료 시 hermes login codex 재실행.
한국어 텍스트 렌더링: gpt-image-2의 한글 인포그래픽 내 텍스트 렌더링 안정성은 실측 필요 [UNVERIFIED]. 깨짐 시 baoyu 스킬 프롬프트에 "minimal text, use English labels only" 추가 또는 alt_ko/figcaption으로 보완.
비용 가드: 생성 비용은 사용하는 이미지 모델에 따라 다름 [UNVERIFIED, 실측 필요]. HERMES_BUDGET_USD 환경변수로 상한 설정 권장.

트러블슈팅

증상	확인 방법
`hermes: command not found`	`~/.local/bin/hermes` 경로 확인, PATH 설정
image_gen 결과 없음	`hermes tools list`에서 image_gen enabled 확인
`hermes model` 실행 불가	대화형 TTY 필요, `hermes -z` oneshot으로 대체
baoyu-infographic 스킬 없음	`hermes skills list \| grep baoyu` 확인
manifest 미생성	`--yolo --accept-hooks` 플래그 추가 후 재시도
URL 이미지 반환됨	wrapper에서 `curl -L -o images/<id>.png <url>` 다운로드

name	hermes
description	Hermes Agent CLI reference for Claude Code: oneshot image generation, baoyu-infographic, and blog automation.
version	1.0.0
author	goddaehee
license	MIT
platforms	["macos"]
metadata	{"tags":["hermes","image-gen","infographic","blog-automation","ai-agent"],"homepage":"https://github.com/goddaehee/hermes-claude-skill"}

Hermes Agent — Claude Code 활용 가이드

Version: v1.0.0 (2026-05-11 최초 작성. hermes --help + hermes tools list + hermes status 직접 실행 기반)

사전 조건

# 설치 위치 확인
which hermes                          # /Users/<user>/.local/bin/hermes
hermes version                        # 버전 확인

# 인증 상태 + 현재 모델/프로바이더 확인
hermes status                         # Provider: OpenAI Codex, Model: gpt-5.5 (검증완료/2026-05-11)

# 툴셋 활성화 상태 확인
hermes tools list                     # image_gen, vision, file, web 등 활성화 여부

hermes model 및 hermes config 하위 명령은 대화형 TTY 필요. 파이프·서브프로세스에서 실행 불가.

핵심 CLI 패턴

자동화용 비대화형 실행 (검증완료/2026-05-11, Hermes 직접 자문)

# 자동화 권장 형태 — hermes chat -Q (quote 깨짐 방지를 위해 프롬프트 파일 사용)
hermes chat -Q \
  --source tool \
  -s baoyu-infographic \
  -t image_gen,file,skills \
  -q "$(cat "$PROMPT_FILE")"

# stdout/stderr 분리 로그
hermes chat -Q \
  --source tool \
  -s baoyu-infographic \
  -t image_gen,file,skills \
  -q "$(cat "$PROMPT_FILE")" \
  > "$OUTPUT_DIR/logs/hermes.stdout.txt" \
  2> "$OUTPUT_DIR/logs/hermes.stderr.txt"

# 인라인 프롬프트 (짧은 테스트용)
hermes chat -Q --source tool -s baoyu-infographic -t image_gen,file -q "PROMPT"

[FACT] -Q = 비대화형(non-interactive) 모드. --source tool = 자동화 소스 마커. -s 는 --skills 의 단축 플래그. (출처: Hermes 직접 자문 2026-05-11)

단순 oneshot (탑레벨 `-z` 플래그)

# hermes --help에서 확인된 탑레벨 플래그 (-z)
hermes -z "PROMPT" -t image_gen,file --skills baoyu-infographic --accept-hooks --yolo

# 모델 오버라이드
hermes -z "PROMPT" -m gpt-5.5 --provider codex

[ESTIMATE] -z 플래그는 탑레벨 help에 표시되나, 자동화 안정성은 hermes chat -Q 형태가 더 권장됨 (Hermes 자문 기반). quote 처리가 복잡한 멀티라인 프롬프트는 반드시 프롬프트 파일 방식 사용.

[UNVERIFIED] 이미지 생성 모델(gpt-image-2) 개별 지정 플래그는 검증 중. 현재 환경은 Provider: OpenAI Codex / Model: gpt-5.5이며 image_gen 툴셋은 Codex 연결을 통해 gpt-image-2를 호출하는 것으로 추정됨.

빌트인 툴셋 (검증완료/2026-05-11, `hermes tools list` 기준)

툴셋	아이콘	상태	설명
`image_gen`	🎨	✓ enabled	이미지 생성 (baoyu-infographic 등과 연동)
`vision`	👁️	✓ enabled	이미지 분석 / Vision
`file`	📁	✓ enabled	파일 읽기/쓰기 (manifest 저장 핵심)
`web`	🔍	✓ enabled	웹 검색 & 스크래핑
`browser`	🌐	✓ enabled	브라우저 자동화
`terminal`	💻	✓ enabled	터미널 & 프로세스
`code_execution`	⚡	✓ enabled	코드 실행
`tts`	🔊	✓ enabled	텍스트 음성 변환
`computer_use`	🖱️	✓ enabled	macOS Computer Use
`video`	🎬	✗ disabled	비디오 분석
`moa`	🧠	✗ disabled	Mixture of Agents

-t 플래그로 여러 툴셋 활성화: -t image_gen,file,web

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, `hermes skills list` 기준)

스킬	카테고리	설명
`baoyu-infographic`	creative	21 layouts × 21 styles 인포그래픽 생성기
`kie-image-generator`	openclaw-imports	13+ 모델 선택, 가격 추적, 고품질 이미지
`image-prompt-guide`	openclaw-imports	이미지 프롬프트 구조 가이드
`architecture-diagram`	creative	아키텍처 다이어그램 자동 생성
`excalidraw`	creative	Excalidraw 스타일 다이어그램
`claude-design`	creative	Claude 스타일 디자인

baoyu-infographic 레이아웃 × 스타일 (출처: `~/.hermes/skills/creative/baoyu-infographic/SKILL.md` [FACT])

레이아웃 21종

레이아웃	용도
`linear-progression`	타임라인, 프로세스, 튜토리얼
`binary-comparison`	A vs B, 비교/대조
`comparison-matrix`	다중 요소 비교
`hierarchical-layers`	피라미드, 우선순위
`tree-branching`	카테고리, 분류
`hub-spoke`	중심 개념 + 관련 항목
`structural-breakdown`	분해도, 단면도
`bento-grid`	다중 주제 개요 (기본값)
`iceberg`	표면 vs 숨겨진 측면
`bridge`	문제-해결 구조
`funnel`	전환, 필터링
`isometric-map`	공간 관계
`dashboard`	메트릭, KPI
`periodic-table`	카테고리 컬렉션
`comic-strip`	내러티브, 시퀀스
`story-mountain`	플롯 구조
`jigsaw`	상호 연결 구성 요소
`venn-diagram`	겹치는 개념
`winding-roadmap`	여정, 마일스톤
`circular-flow`	사이클, 반복 프로세스
`dense-modules`	고밀도 데이터 가이드

스타일 21종

스타일	설명
`craft-handmade`	손으로 그린 종이 공예 (기본값)
`technical-schematic`	청사진, 엔지니어링 도면
`hand-drawn-edu`	마카롱 파스텔, 손그림, 교육용
`corporate-memphis`	평면 벡터, 선명한 색상
`bold-graphic`	코믹 스타일, 하프톤
`ikea-manual`	미니멀 선 아트
`ui-wireframe`	회색조 인터페이스 목업
`cyberpunk-neon`	네온 글로우, 미래적
`kawaii`	일본 귀여운 스타일
`chalkboard`	칠판 위 분필
`storybook-watercolor`	부드러운 수채화
`aged-academia`	빈티지 과학, 세피아
`origami`	접힌 종이, 기하학
`pixel-art`	레트로 8비트
`subway-map`	지하철 노선도
`knolling`	정리된 플랫레이
`lego-brick`	레고 블록
`pop-laboratory`	청사진 격자, 좌표 마커
`morandi-journal`	손그림 낙서, 따뜻한 색조
`retro-pop-grid`	1970년대 레트로 팝
`claymation`	3D 클레이 피규어

한국어 블로그 권장 조합 ([출처: Hermes 직접 자문 2026-05-11])

섹션 유형	레이아웃	스타일	비고
기술 설명/아키텍처	`bento-grid`	`technical-schematic`	기술 독자 기본값
초보자 개념 설명	`hub-spoke`	`hand-drawn-edu`	beginner audience
단계별 튜토리얼	`linear-progression`	`ikea-manual`	Step N 구조
초보 튜토리얼	`linear-progression`	`hand-drawn-edu`	beginner audience
비교/A vs B	`binary-comparison`	`corporate-memphis`	비교 섹션
체크리스트/Q&A	`dashboard`	`corporate-memphis`	요약 섹션
인트로/결론/썸네일	`bento-grid`	`bold-graphic`	시각적 임팩트
내부 구조/원리	`structural-breakdown`	`technical-schematic`	아키텍처 설명

JSON I/O 계약 (블로그 이미지 자동화용)

입력 스키마 (`cardnews-input.json`)

{
  "article_id": "20260511-example",
  "output_dir": "/path/to/runs/<run-id>/images",
  "default_model": "codex/gpt-image-2",
  "aspect_ratio": "16:9",
  "items": [
    {
      "paragraph_id": "section-01",
      "heading": "섹션 제목",
      "text": "섹션 핵심 내용 2~3문장",
      "layout": "bento-grid",
      "style": "technical-schematic"
    }
  ]
}

출력 매니페스트 (`cardnews-manifest.json`)

{
  "article_id": "20260511-example",
  "generated_at": "2026-05-11T12:00:00Z",
  "model": "codex/gpt-image-2",
  "items": [
    {
      "paragraph_id": "section-01",
      "heading": "섹션 제목",
      "image_path": "/path/to/images/section-01.png",
      "image_url": null,
      "prompt_path": "/path/to/prompts/section-01.md",
      "layout": "bento-grid",
      "style": "technical-schematic",
      "aspect_ratio": "16:9",
      "alt_ko": "섹션 제목 관련 인포그래픽",
      "cost_usd": null
    }
  ]
}

image_path 또는 image_url 중 하나가 반드시 존재해야 함. URL이면 다운로드 후 image_path에 로컬 경로 기록.

주의 사항

cmux pane 자동화 비추천: cmux send로 Hermes 페인에 메시지 전송 시 멀티라인 텍스트가 Enter로 분리됨. 자동화는 hermes chat -Q(기본 패턴) 또는 hermes chat -Q --source tool을 사용. hermes -z는 레거시 플래그이며 chat -Q와 기능이 겹침.
URL vs 로컬 path: image_generate 툴이 URL 또는 로컬 path를 반환할 수 있음. wrapper 스크립트에서 URL 감지 시 curl -L -o 다운로드 처리 필수.
Codex 인증: hermes status에서 Provider: OpenAI Codex 표시 시 Codex 연결 활성. 인증 만료 시 hermes login codex 재실행.
한국어 텍스트 렌더링: gpt-image-2의 한글 인포그래픽 내 텍스트 렌더링 안정성은 실측 필요 [UNVERIFIED]. 깨짐 시 baoyu 스킬 프롬프트에 "minimal text, use English labels only" 추가 또는 alt_ko/figcaption으로 보완.
비용 가드: 생성 비용은 사용하는 이미지 모델에 따라 다름 [UNVERIFIED, 실측 필요]. HERMES_BUDGET_USD 환경변수로 상한 설정 권장.

트러블슈팅

증상	확인 방법
`hermes: command not found`	`~/.local/bin/hermes` 경로 확인, PATH 설정
image_gen 결과 없음	`hermes tools list`에서 image_gen enabled 확인
`hermes model` 실행 불가	대화형 TTY 필요, `hermes -z` oneshot으로 대체
baoyu-infographic 스킬 없음	`hermes skills list \| grep baoyu` 확인
manifest 미생성	`--yolo --accept-hooks` 플래그 추가 후 재시도
URL 이미지 반환됨	wrapper에서 `curl -L -o images/<id>.png <url>` 다운로드

hermes

Hermes Agent — Claude Code 활용 가이드

사전 조건

핵심 CLI 패턴

자동화용 비대화형 실행 (검증완료/2026-05-11, Hermes 직접 자문)

단순 oneshot (탑레벨 -z 플래그)

빌트인 툴셋 (검증완료/2026-05-11, hermes tools list 기준)

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, hermes skills list 기준)

baoyu-infographic 레이아웃 × 스타일 (출처: ~/.hermes/skills/creative/baoyu-infographic/SKILL.md [FACT])

레이아웃 21종

스타일 21종

한국어 블로그 권장 조합 ([출처: Hermes 직접 자문 2026-05-11])

JSON I/O 계약 (블로그 이미지 자동화용)

입력 스키마 (cardnews-input.json)

출력 매니페스트 (cardnews-manifest.json)

주의 사항

트러블슈팅

Hermes Agent — Claude Code 활용 가이드

사전 조건

핵심 CLI 패턴

자동화용 비대화형 실행 (검증완료/2026-05-11, Hermes 직접 자문)

단순 oneshot (탑레벨 -z 플래그)

빌트인 툴셋 (검증완료/2026-05-11, hermes tools list 기준)

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, hermes skills list 기준)

baoyu-infographic 레이아웃 × 스타일 (출처: ~/.hermes/skills/creative/baoyu-infographic/SKILL.md [FACT])

레이아웃 21종

스타일 21종

한국어 블로그 권장 조합 ([출처: Hermes 직접 자문 2026-05-11])

JSON I/O 계약 (블로그 이미지 자동화용)

입력 스키마 (cardnews-input.json)

출력 매니페스트 (cardnews-manifest.json)

주의 사항

트러블슈팅

단순 oneshot (탑레벨 `-z` 플래그)

빌트인 툴셋 (검증완료/2026-05-11, `hermes tools list` 기준)

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, `hermes skills list` 기준)

baoyu-infographic 레이아웃 × 스타일 (출처: `~/.hermes/skills/creative/baoyu-infographic/SKILL.md` [FACT])

입력 스키마 (`cardnews-input.json`)

출력 매니페스트 (`cardnews-manifest.json`)

단순 oneshot (탑레벨 `-z` 플래그)

빌트인 툴셋 (검증완료/2026-05-11, `hermes tools list` 기준)

이미지 관련 추천 스킬 카탈로그 (검증완료/2026-05-11, `hermes skills list` 기준)

baoyu-infographic 레이아웃 × 스타일 (출처: `~/.hermes/skills/creative/baoyu-infographic/SKILL.md` [FACT])

입력 스키마 (`cardnews-input.json`)

출력 매니페스트 (`cardnews-manifest.json`)