AI 이미지용 스킬 프롬프트 생성기

프로젝트 개요

skill-prompt-generator는 일반적인 크리에이티브 브리프를 풍부하고 상세하며 도메인에 정확한 AI 이미지 생성 프롬프트로 변환하는 오픈 소스 Claude Code Skills 라이브러리입니다. 이를 통해 Midjourney, DALL-E 3 또는 Stable Diffusion과 같은 도구로 워크플로우를 느리게 하는 수동 프롬프트 엔지니어링을 제거합니다.

프로젝트 배경 및 포지셔닝

존재 이유

효과적인 AI 이미지 프롬프트를 작성하려면 각 크리에이티브 도메인에 대한 깊은 어휘 지식이 필요합니다. 인물 사진 조명 용어는 포스터 레이아웃 언어, 제품 사진 재료 분류 또는 영화 모션 어휘와 근본적으로 다릅니다. 대부분의 개발자와 크리에이터는 이러한 폭넓은 지식이 부족하여 프롬프트가 너무 일반적이거나 내부적으로 일관성이 없습니다. skill-prompt-generator는 1,246개 이상의 요소로 구성된 SQLite 데이터베이스를 기반으로 하는 12개의 전문 Claude Code Skills로 해당 도메인 전문 지식을 패키징합니다. 스킬을 호출하면 몇 초 안에 전문가 수준의 프롬프트를 받을 수 있습니다.

유사 프로젝트와의 차이점

정적 프롬프트 템플릿 라이브러리 또는 단일 목적 빌더와 달리 skill-prompt-generator는 지능형 라우팅을 갖춘 네이티브 Claude Code Skills 시스템입니다. 엔진은 사용자의 의도를 읽고 12개의 도메인 모듈에서 올바른 전문 스킬을 자동으로 선택하며 의미론적 일관성 검사를 적용하여 충돌하는 요소를 방지하고 요소 데이터베이스에서 샘플링하여 다양성을 보장합니다. 버전 2.0은 다중 장르 장면을 위한 크로스 도메인 모드와 200,000개 이상의 색상, 테두리 및 레이아웃 조합을 기반으로 하는 디자인 모드를 추가합니다. 이는 규칙 기반 템플릿으로는 달성할 수 없는 기능을 훨씬 뛰어넘습니다.

기능 범주

📸 인물 사진

조명, 렌즈, 포즈, 피부 질감, 표정 및 시대에 대한 502개의 큐레이션된 요소
스마트 종속성 규칙 (예: 고대 시대는 전통적인 스타일링을 자동 트리거)
예: 골든 아워 림 조명, 85mm f/1.4 보케, 에디토리얼 패션 프레이밍, 시네마틱 컬러 그레이드
목적: 헤드샷, 라이프스타일 및 에디토리얼 작업을 위한 사실적이고 기술적으로 정확한 인물 프롬프트 생성

🎨 그래픽 디자인 및 포스터

레이아웃, 타이포그래피, 색상 이론 및 인쇄 규칙을 다루는 155개의 요소
디자인 모드는 실행 시마다 200,000개 이상의 색상-테두리-장식 조합을 샘플링합니다.
예: 스위스 그리드 포스터, 네온 브루탈리스트 카드, 미니멀리스트 브랜드 아이덴티티, 레트로 콘서트 전단지
목적: 실행 시마다 반복되지 않는 시각적으로 독특한 디자인 프롬프트 생성

🛍️ 제품 사진

테이블탑 조명, 재질 질감, 배경 및 브랜드 컨텍스트를 위한 77개의 상업용 요소
예: 떠다니는 화장품 병, 무광 세라믹 확산광, 히어로 샷 음료, 라이프스타일 플랫 레이
목적: 전문적인 구성 규칙으로 전자 상거래, 광고 및 카탈로그 이미지를 위한 프롬프트 제작

🖼️ 아트 스타일

고전에서 현대까지 51개의 순수 미술 기법 요소
예: 중국 수묵화, 임파스토 유화, 생성 기하학적 추상화, 레트로 팝 아트 할포톤
목적: 갤러리 품질의 이미지 생성을 위해 모든 주제에 장르에 맞는 아트 어휘 적용

🎬 비디오 생성

카메라 움직임, 페이싱 및 동적 장면 구성을 위한 49개의 모션 인식 요소
예: 트래킹 돌리 푸시인, 슬로우 모션 스플래시, 항공 타임랩스, 랙 포커스 리빌
목적: 올바른 영화 언어로 Sora, Kling 또는 RunwayML과 같은 도구를 위한 비디오 프롬프트 생성

📷 일반 사진 기법

노출, 피사계 심도, 색상 보정 및 구성 프레이밍을 다루는 205개의 요소
예: 틸트 시프트 미니어처, 크로스 프로세스 필름 시뮬레이션, HDR 풍경, 3분의 1 법칙 크롭
목적: 주제 유형에 관계없이 사진 정밀도로 모든 도메인 보강

핵심 하이라이트

지능형 4단계 도메인 라우팅 — 내장된 의사 결정 트리가 사용자의 의도를 검사하고, 기본 도메인을 분류하고, 충돌을 감지하고, 수동 구성 없이 가장 적절한 전문 스킬을 호출합니다. 사용자는 어떤 스킬을 호출해야 하는지 알 필요가 없습니다.

1,246개 이상의 요소 SQLite 데이터베이스 — 모든 프롬프트 어휘는 도메인, 카테고리, 재사용성 점수 및 사용 횟수 메타데이터가 있는 정규화된 관계형 데이터베이스(elements.db)에 저장됩니다. 이를 통해 소스 코드를 건드리지 않고 라이브러리를 쿼리 가능하고 버전 관리 가능하며 확장 가능하게 만들 수 있습니다.

세 가지 생성 모드(v2.0) — 인물 사진 모드는 v1.0의 전체 하위 호환성을 유지합니다. 크로스 도메인 모드는 복잡한 장면을 위해 2-4개의 도메인 어휘를 혼합합니다. 디자인 모드는 200,000개 이상의 색상-테두리-레이아웃 조합에 YAML 변수 샘플러를 연결하여 그래픽 출력을 생성합니다.

자가 학습 범용 학습기 — 내장된 추출 파이프라인은 새 프롬프트를 스캔하여 정의되지 않은 기능을 찾고, 카테고리 중요도에 따라 우선 순위를 지정하고, 데이터베이스에 커밋하기 전에 인간의 승인을 위한 검토 보고서를 생성합니다. 이를 통해 라이브러리가 시간이 지남에 따라 자율적으로 성장할 수 있습니다.

의미론적 일관성 엔진 — 프롬프트를 최종 확정하기 전에 IntelligentGenerator는 check_consistency() 및 resolve_conflicts()를 실행하여 호환되지 않는 요소 쌍(예: 빅토리아 시대 배경의 네온 사이버펑크 조명)을 감지하고 자동으로 수정하여 일관성 없는 이미지 출력을 방지합니다.

전체 Python API + 스킬 인터페이스 — 개발자는 Python 스크립트에서 직접 intelligent_generator.py를 호출하거나 Claude Code Skills 인터페이스를 통해 통합하여 프로그래밍 방식 파이프라인과 대화형 크리에이티브 세션을 모두 지원할 수 있습니다.

역할별 사용 사례

일반 개발자
이미지 생성 파이프라인에 Python API를 통합합니다. 한 줄의 주제 설명을 전달하면 확산 모델 API로 직접 전달할 수 있는 프로덕션 준비 프롬프트 문자열을 받습니다. 자가 학습 시스템은 라이브러리가 새로운 프롬프트를 제공함에 따라 개선됨을 의미합니다.

DevOps / 자동화 엔지니어
CrossDomainGenerator를 배치 작업에 포함하여 마케팅 자산, 제품 카탈로그 이미지 또는 소셜 미디어 콘텐츠를 대규모로 생성합니다. 200,000개 이상의 조합 공간은 수동 프롬프트 변형 없이 대규모 실행 전반에 걸쳐 시각적 다양성을 보장합니다.

데이터 및 연구 팀
SQLite 요소 데이터베이스를 프롬프트 엔지니어링 연구를 위한 구조화된 데이터 세트로 사용합니다. export_to_json()을 통해 버전 관리된 분석을 위해 내보내고, 요소 공동 발생 패턴을 쿼리하고, source_prompts에 저장된 프롬프트 품질 점수를 벤치마킹합니다.

제품 및 크리에이티브 팀
Claude Code Skills를 대화형으로 사용합니다. 일반 언어로 크리에이티브 컨셉을 설명하고, 라우팅 시스템이 올바른 스킬(art-master, design-master, video-master 등)을 선택하도록 하고, 프롬프트 구문을 배우지 않고 생성된 프롬프트를 반복합니다. 디자인 모드는 팀이 제어하는 YAML 구성 파일에 색상 팔레트와 타이포그래피 규칙을 인코딩하여 브랜드에 맞는 결과를 생성합니다.

빠른 시작

🔍 리소스 찾기

프로젝트의 1,246개 이상의 요소는 SQLite 데이터베이스에서 도메인별로 구성됩니다. 사용 가능한 요소를 탐색하려면 다음을 수행하십시오.

from element_db import ElementDB

db = ElementDB("extracted_results/elements.db")
print(db.get_stats())                        # 라이브러리 전체 메트릭
results = db.search_by_domain("portrait", min_reusability=0.7)

.claude/SKILL_ROUTING_GUIDE.md는 전체 4단계 의사 결정 트리와 12개의 스킬 정의를 문서화합니다. knowledge_base/ 디렉터리에는 사람이 읽을 수 있는 가이드(예: 색상 제어 이론)가 포함되어 있습니다.

🛠 설치 / 통합 방법

전제 조건: Python 3.9+, anthropic>=0.7.0, pyyaml>=6.0

# 1. 리포지토리 복제
git clone https://github.com/huangserva/skill-prompt-generator.git
cd skill-prompt-generator

# 2. 종속성 설치
pip install -r requirements.txt

# 3. Python API를 통해 프롬프트 생성
python - <<'EOF'
from intelligent_generator import assemble_prompt_from_elements, query_candidates_by_intent

intent = "a confident young woman in a sunlit café, editorial fashion style"
elements = query_candidates_by_intent(intent)
prompt = assemble_prompt_from_elements(elements, subject_desc=intent)
print(prompt)
EOF

Claude Code Skills 통합

.claude/ 디렉터리를 프로젝트 루트에 배치하고 Claude Code에서 프로젝트를 엽니다. 12개의 스킬이 즉시 사용 가능하며 추가 구성이 필요하지 않습니다.

# Claude Code에서 이미지를 설명하기만 하면 됩니다.
> Generate a product shot for a matte black water bottle on a marble surface
# → product-master 스킬로 자동 라우팅

v2.0 크로스 도메인 모드

from core.cross_domain_generator import CrossDomainGenerator

gen = CrossDomainGenerator()
result = gen.generate(
    intent="cyberpunk city street at night with neon reflections",
    mode="cross_domain"   # 생략 시 자동 감지
)
print(result["prompt"])

🤝 기여 방법

# 포크 및 복제
git clone https://github.com/<your-username>/skill-prompt-generator.git
cd skill-prompt-generator

# 기능 브랜치 생성
git checkout -b feature/add-architecture-domain

# ElementDB API를 통해 새 요소 추가 (직접 SQL보다 선호)
python - <<'EOF'
from element_db import ElementDB
db = ElementDB("extracted_results/elements.db")
db.add_element(
    domain="architecture",
    category="style",
    template="brutalist concrete façade with exposed aggregate",
    keywords=["brutalism", "concrete", "architecture"],
    reusability_score=0.85
)
EOF

# 범용 학습기를 실행하여 정의되지 않은 기능 검색
python -c "from intelligent_generator import IntelligentGenerator; IntelligentGenerator().run_learner()"

# 커밋하고 풀 리퀘스트 열기
git add -A && git commit -m "feat: add architecture domain elements"
git push origin feature/add-architecture-domain

프로젝트 구조

skill-prompt-generator/
├── intelligent_generator.py    # 메인 생성 엔진 및 IntelligentGenerator 클래스
├── element_db.py               # ElementDB CRUD, 검색, 가져오기/내보내기
├── framework_loader.py         # YAML 프레임워크 로딩 유틸리티
├── prompt_framework.yaml       # 7가지 범주 프레임워크 구성 (v1.0)
├── requirements.txt            # Python 종속성
│
├── core/                       # v2.0 아키텍처 모듈
│   ├── cross_domain_generator.py   # 통합 3모드 생성 인터페이스
│   ├── cross_domain_query.py       # 크로스 도메인 요소 검색 엔진
│   ├── design_bridge.py            # YAML 디자인 시스템 ↔ 프롬프트 브릿지
│   ├── variable_sampler.py         # 200K+ 조합 샘플러
│   ├── yaml_sampler.py             # YAML 변수 로딩 및 무작위 샘플링
│   └── schema_migration_v1.sql     # 데이터베이스 마이그레이션 스크립트
│
├── .claude/                    # Claude Code 통합
│   ├── claude.md               # 아키텍처 규칙 및 디자인 원칙
│   ├── SKILL_ROUTING_GUIDE.md  # 4단계 라우팅 의사 결정 트리
│   └── skills/                 # 12개의 스킬 디렉터리
│       ├── intelligent-prompt-generator/   # 인물 사진
│       ├── art-master/                     # 순수 미술 스타일
│       ├── design-master/                  # 그래픽 디자인 및 포스터
│       ├── product-master/                 # 제품 사진
│       ├── video-master/                   # 비디오 생성
│       ├── prompt-master/                  # 오케스트레이터 스킬
│       ├── domain-classifier/              # 의도 분류
│       ├── prompt-analyzer/                # 프롬프트 품질 분석
│       ├── prompt-extractor/               # 기능 추출
│       ├── prompt-xray/                    # 프롬프트 구조 검사
│       ├── universal-learner/              # 자가 학습 파이프라인
│       └── prompt-crafter/                 # 디자인 시스템 프롬프트 빌더
│
├── variables/                  # 디자인 시스템 YAML 구성
│   ├── colors.yaml             # 37가지 색상 구성표 (따뜻한-귀여운 + 현대적인-미니멀)
│   ├── borders.yaml            # 테두리 스타일 정의
│   └── decorations.yaml        # 장식 요소 라이브러리
│
├── design-logic/               # 디자인 템플릿 디렉터리
│   ├── modern-minimal/         # 딥 블루 / 뉴트럴 전문 스타일
│   └── warm-cute/              # 코랄 핑크 / 스카이 블루 접근 가능한 스타일
│
├── knowledge_base/             # 사람이 읽을 수 있는 도메인 가이드
│   └── how_to_control_color.md
│
└── extracted_results/          # 생성된 프롬프트 출력 (gitignored DB)
    └── .gitignore              # elements.db를 로컬에 유지

라이선스

MIT 라이선스


✅ 상업적 사용	허용됨 — 제품, SaaS, 고객 작업에 사용
✅ 수정	허용됨 — 포크, 확장, 브랜드 변경
✅ 배포	허용됨 — 출처 표시와 함께 재배포
✅ 개인 사용	허용됨 — 내부 도구, 연구
❌ 책임	보증 없음; 위험 부담으로 사용
❌ 상표	MIT는 프로젝트 이름에 대한 상표권을 부여하지 않습니다
ℹ️ 출처 표시	배포 시 원본 MIT 라이선스 텍스트 포함

FAQ

Q: 프롬프트 생성기를 사용하기 위해 Claude API 키가 필요합니까?
A: 핵심 Python 생성 엔진(intelligent_generator.py, element_db.py)은 API 호출 없이 로컬에서 실행됩니다. Claude API는 범용 학습기의 AI 지원 기능 추출 단계에서만 사용됩니다. 다른 모든 생성은 결정론적 Python입니다.

Q: 새 크리에이티브 도메인(예: 건축 또는 패션 일러스트레이션)을 추가하려면 어떻게 해야 합니까?
A: ElementDB.add_element()를 사용하여 새 domain 값으로 어휘를 삽입한 다음 기존 스킬 템플릿에 따라 .claude/skills/ 아래에 해당 스킬 디렉터리를 만듭니다. 라우팅 시스템은 SKILL_ROUTING_GUIDE.md에 키워드가 등록되면 새 도메인을 자동으로 인식합니다.

Q: v1.0과 v2.0의 차이점은 무엇입니까?
A: v1.0은 인물 사진 모드만 지원합니다(502개 요소, 7개 범주 프레임워크). v2.0은 1,246개 이상의 요소로 확장되고, 크로스 도메인 모드 및 디자인 모드를 추가하고, SQLite 사용률을 40%에서 80%로 높이고, 200,000개 이상의 디자인 조합을 도입합니다. v2.0은 100% 하위 호환되며 기존 v1.0 호출은 변경이 필요하지 않습니다.

Q: 생성된 프롬프트를 저장하고 재사용할 수 있습니까?
A: 예. save_generated_prompt()는 품질 점수, 사용자 의도 및 사용된 요소 ID와 함께 생성된 모든 프롬프트를 source_prompts 테이블에 영구 저장합니다. 범용 학습기는 나중에 이러한 저장된 프롬프트를 스캔하여 라이브러리에 대한 새 어휘를 검색할 수 있습니다.

Q: 일관성 검사기는 어떻게 잘못된 요소 조합을 방지합니까?
A: check_consistency()는 하드코딩된 비호환성 규칙(시대 충돌, 조명 모순, 스타일 충돌)에 대해 요소 쌍을 평가합니다. resolve_conflicts()는 우선 순위 계층(주제 > 조명 > 스타일 > 배경)을 적용하고 우선 순위가 낮은 충돌 요소를 호환되는 대안으로 자동 교체합니다.

빠른 링크

리포지토리: https://github.com/huangserva/skill-prompt-generator
v2.0 릴리스 노트: 리포지토리 루트의 README_v2.0.md
마이그레이션 가이드: 리포지토리 루트의 UPGRADE_GUIDE_v2.0.md
라우팅 참조: .claude/SKILL_ROUTING_GUIDE.md
아키텍처 원칙: .claude/claude.md
이슈 및 기능 요청: https://github.com/huangserva/skill-prompt-generator/issues

요약

skill-prompt-generator는 1,246개 이상의 요소 도메인 데이터베이스, 12개의 전문 스킬에 걸친 지능형 라우팅, 시간이 지남에 따라 라이브러리를 확장하는 자가 학습 파이프라인을 결합한 AI 이미지 프롬프트 생성을 위한 가장 완벽한 오픈 소스 Claude Code Skills 구현입니다. 모든 시각적 도메인의 어휘를 수동으로 마스터하지 않고도 전문적인 수준의 AI 이미지 프롬프트를 원하는 모든 개발자, 크리에이티브 팀 또는 자동화 엔지니어에게 적합한 도구입니다.

skill-prompt-generator