tw93/Kami

Kami – AI 기반 문서 디자인 스킬

소개 – Kami는 AI 에이전트(Claude Code, Codex, Cursor 등)를 위한 플러그인/스킬로, 자연어 요청을 세련된 스타일의 PDF, PNG 또는 편집 가능한 PowerPoint 파일로 변환합니다. 8개의 내장 템플릿(1페이지 문서, 이력서, 편지, 포트폴리오, 슬라이드, 주식 보고서, 변경 로그, 랜딩 페이지)이 포함되어 있으며 영어, 중국어, 일본어, 한국어를 지원합니다.

작동 방식 – 이 스킬은 에이전트의 ~/.agents/skills 폴더에 위치합니다. 에이전트에게 “make a one‑pager for my startup” 와 같이 요청하면 자동으로 Kami가 트리거되어 다음을 수행합니다:

1. 요청을 구조화된 브리핑(대상, 목적, 어조 등)으로 파싱합니다.
2. HTML 템플릿에 콘텐츠를 채웁니다.
3. WeasyPrint 를 사용하여 HTML을 PDF로 렌더링하거나, python‑pptx 를 통해 PPTX로, 또는 Marp 스타일의 Markdown 덱으로 변환합니다.
4. 선택적으로 Mermaid 텍스트에서 생성된 인라인 SVG 다이어그램을 추가하고, Kami의 따뜻한 양피지 팔레트에 맞춰 테마를 재설정합니다.
5. 최종 파일을 반환합니다.

주요 기능

• 다국어 지원 – 영어 및 중국어용 전체 레이아웃; 일본어/한국어용 폰트 폴백 지원.
• 8개의 기성 템플릿 및 랜딩 페이지 시스템.
• 다이어그램 통합 – Mermaid → SVG → PDF 호환.
• 브랜드 프로필 – ~/.config/kami/brand.md 파일을 통해 기본 폰트, 색상, 페이지 크기, 어조 등을 저장하여 설정을 반복할 필요가 없습니다.
• 제로 의존성 MCP 서버 – 소형 로컬 HTTP 서버 (mcp_server.py)를 통해 MCP 지원 에이전트라면 전체 스킬 프롬프트를 로드하지 않고도 Kami를 구동할 수 있습니다.
• 폰트 처리 – 스크립트가 누락된 CJK 폰트를 자동으로 설치하며, 오프라인 사용을 위해 폰트가 번들로 제공됩니다.
• 버전 확인 – GitHub 최신 릴리스에 대해 매일 자동으로 확인합니다.

설치

# generic agent install (Claude Code, Codex, Cursor, …)
npx skills add tw93/kami -a claude-code codex cursor -g -y

또는 README에 표시된 호스트별 플러그인 명령을 사용하거나, Claude Desktop용으로 미리 빌드된 kami.zip을 다운로드하세요.

사용법 – 슬래시 명령어가 필요 없습니다. 지원되는 언어로 자연스럽게 말하기만 하면 됩니다. 프롬프트 예시:

• English: make a resume for me
• 中文: 帮我做一份一页纸
• 日本語: スタートアップ向けの一枚資料を作って
• 한국어: 이력서를 만들어줘

디자인 철학 – 따뜻한 양피지 배경 (#f5f4ed), 잉크 블루 포인트, 세리프 타이포그래피, 넉넉한 여백. 모든 템플릿은 동일한 시각적 리듬을 따르며, 기술적인 결과물을 엄격하면서도 시각적으로 매력적으로 만듭니다.

라이선스 – 코드 및 템플릿은 MIT 라이선스. CJK 폰트는 각자의 라이선스를 따릅니다(TsangerJinKai02는 개인용으로만 사용 가능, 기타는 OFL).

추가 정보 – 전체 사양은 design.md, 치트 시트는 CHEATSHEET.md, 라이브 쇼케이스는 https://kami.tw93.fun 에서 확인할 수 있습니다.