tw93/Kami

👩‍🚒 Good content deserves good paper.

9,718
GitHub 스타
455
포크
HTML
언어
MIT
라이선스
2026.07.10
최근 푸시
2026.05.28
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
Kami는 AI 에이전트와 함께 사용할 전문 문서 디자인 시스템으로, 일관된 출력과 다양한 템플릿을 제공합니다. 문서 생성 자동화가 필요한 개발자나 연구자에게 적합하며, 특히 영어와 중국어 사용자에게 최적화되어 있습니다.

강점

  • 에이전트가 안정적으로 실행할 수 있는 간단한 제약 언어와 9가지 템플릿을 제공하여 일관된 고품질 문서 출력을 보장합니다.
  • 다양한 AI 도구(Claude Code, Codex, Claude Desktop, 일반 에이전트)에 플러그인/스킬로 쉽게 설치할 수 있습니다.
  • 영어, 중국어, 일본어, 한국어를 지원하며, 자연어 프롬프트로 자동 트리거되어 사용이 편리합니다.

약점

  • 일본어와 한국어는 최선의 노력으로 지원되며, 전달 전 시각적 QA가 필요하다고 명시되어 있어 완벽한 지원이 아님을 알 수 있습니다.
  • 설치 방법이 도구별로 다양하고 일부 업데이트 명령어에 주의사항이 있어 초보자에게 혼란을 줄 수 있습니다.
  • 대형 CJK 글꼴이 스킬 패키지에서 제외되어 있어 추가 설치 스크립트가 필요할 수 있습니다.

주의사항

  • 일반 에이전트에서 `npx skills update` 명령어는 현재 사용하지 말아야 합니다. 저장소 루트 스킬을 단일 파일로 축소하는 버그가 있습니다.
  • Kami는 하루에 한 번 버전 확인을 수행하지만, 오프라인에서는 건너뛰고 데이터를 전송하지 않는다고 명시되어 있어 개인정보 문제는 없습니다.
  • 브랜드 프로필 파일(`~/.config/kami/brand.md`)은 선택 사항이지만, 사용자 정의를 원한다면 별도로 생성해야 합니다.

시작 가이드

  • 사용 중인 AI 도구(Claude Code, Codex, Claude Desktop 등)에 맞는 설치 방법을 선택하여 Kami를 설치합니다.
  • 필요에 따라 `~/.config/kami/brand.md` 파일을 생성하여 브랜드 프로필을 설정합니다.
  • 자연어 프롬프트로 다양한 문서(이력서, 보고서, 슬라이드 등)를 생성해보며 템플릿과 디자인 시스템을 테스트합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

<div align="center"> <img src="https://gw.alipayobjects.com/zos/k/vl/logo.svg" width="120" /> <h1>Kami</h1> <p><b>좋은 콘텐츠는 좋은 종이를 받을 자격이 있습니다.</b></p> </div>

왜 Kami인가

Kami(紙, かみ)는 일본어로 종이를 의미합니다: 완성된 아이디어가 도착하는 표면입니다. AI는 대부분의 사람이 수동으로 하는 것보다 더 나은 문서를 생성할 수 있습니다. 부족한 것은 능력이 아니라 제약입니다: 디자인 시스템 없이는 모든 세션이 평범한 회색과 일관성 없는 레이아웃으로 흘러갑니다.

Kami는 그 격차를 메웁니다: 하나의 제약 언어, 아홉 개의 템플릿, 에이전트가 안정적으로 실행할 수 있을 만큼 간단하고, 모든 출력물이 실제로 출시하고 싶은 것이 되도록 엄격합니다.

3부작의 일부: Kaku(書く)는 코드를 작성하고, Waza(技)는 습관을 훈련하며, Kami(紙)는 문서를 제공합니다.

쇼케이스

하나의 제약 세트에서 템플릿과 언어를 넘나드는 실제 PDF입니다. 미리보기를 클릭하여 열어보세요.

(표 생략: 데모 이미지와 설명 포함)

설치

Claude Code, v2.1.142 이상

/plugin marketplace add tw93/kami
/plugin install kami@kami

Codex 플러그인 마켓플레이스

codex plugin marketplace add tw93/kami
codex plugin add kami@kami

이렇게 하면 Kami가 저장소 마켓플레이스에서 Codex 플러그인으로 설치되므로, 향후 업데이트는 codex plugin marketplace upgrade kamicodex plugin add kami@kami를 사용할 수 있습니다.

일반 에이전트 (OpenCode, Pi 등 ~/.agents/를 읽는 도구)

npx skills add tw93/kami/plugins/kami/skills/kami -a '*' -g -y

하위 경로는 독립형 스킬 패키지를 가리킵니다. tw93/kami만 사용하면 SKILL.md만 설치됩니다. 저장소 루트는 웹사이트 소스 역할도 하며, skills CLI는 루트 수준 스킬을 단일 파일로 취급하기 때문입니다.

Claude Desktop

kami.zip을 다운로드하고, Customize > Skills > "+" > Create skill을 연 다음 ZIP을 직접 업로드합니다. 압축을 풀 필요가 없습니다.

ZIP은 가볍습니다: 대형 CJK 글꼴은 스킬 패키지에서 제외됩니다. 저장소 체크아웃에서는 로컬 글꼴 파일을 먼저 로드한 다음 jsDelivr CDN을 사용합니다. 설치된 스킬에서는 scripts/ensure-fonts.sh가 누락된 중국어 또는 한국어 글꼴을 사용자 글꼴 디렉토리로 복구합니다.

업데이트

  • Claude Code: claude plugin update kami
  • Codex: codex plugin marketplace upgrade kami, 그런 다음 codex plugin add kami@kami로 설치된 스냅샷을 새로고침합니다.
  • Claude Desktop: 최신 kami.zip을 다운로드하고, 스킬 카드에서 "..."을 클릭하고 Replace를 선택한 다음 업로드합니다.
  • 일반 에이전트: npx skills add tw93/kami/plugins/kami/skills/kami -a '*' -g -y 명령을 다시 실행하면 기존 복사본을 덮어씁니다. 현재 npx skills update는 피하십시오: 저장소 루트 스킬을 단일 SKILL.md로 축소합니다(vercel-labs/skills#1517).

Kami는 또한 하루에 최대 한 번 조용한 버전 확인을 실행하며, 채팅에서 새 버전이 나왔을 때 알려줍니다. 공개 버전 파일만 읽고 데이터를 보내지 않으며, 오프라인에서는 건너뜁니다.

사용법

스킬은 자연어 요청에서 자동으로 트리거되며, 슬래시 명령이 필요하지 않습니다. 영어와 중국어에 최적화되어 있습니다. 일본어와 한국어는 최선의 CJK 경로를 통해 지원되며, 전달 전에 시각적 QA가 필요합니다.

언어별 예시 프롬프트:

  • 영어: make a one-pager for my startup / turn this research into a long doc / write a formal letter / make a portfolio of my projects / build me a resume / design a slide deck for my talk / make this talk as a Marp deck / build a landing page for my app
  • 중국어: 帮我做一份一页纸 / 帮我排版一份长文档 / 帮我写一封正式信件 / 帮我做一份作品集 / 帮我做一份简历 / 帮我做一套演讲幻灯片 / 帮我做一份 Markdown 风格的演示稿 / 帮我做一个产品落地页
  • 일본어: スタートアップ向けの一枚資料を作って / この調査を長文レポートに整えて / 正式な依頼文を作って / プロジェクト作品集を作って / 履歴書を作って / 登壇用スライドを作って / Marp で登壇スライドを作って / アプリのランディングページを作って
  • 한국어: 스타트업 원페이저를 만들어줘 / 이 리서치를 장문 문서로 정리해줘 / 정식 레터를 작성해줘 / 프로젝트 포트폴리오를 만들어줘 / 이력서를 만들어줘 / 발표용 슬라이드를 만들어줘 / Marp 슬라이드로 만들어줘 / 앱 랜딩 페이지를 만들어줘

브랜드 프로필 (선택 사항)

~/.config/kami/brand.md를 생성하여 신원, 브랜드, 기본값 및 작성 습관을 유지합니다. 전체 템플릿은 brand.example.md를 참조하십시오.

파일에는 이름, 역할, 이메일, 브랜드 색상, 언어, 페이지 크기, 톤과 같은 구조화된 필드를 위한 YAML frontmatter와 자유 형식 메모를 위한 Markdown 본문이 있습니다. Kami는 이를 가장 낮은 해상도의 컨텍스트로 취급합니다: 현재 요청이 모호할 때만 적용되며, 특정 문서에 필요한 것으로 항상 재정의할 수 있습니다. 목표는 모든 출력물이 동일하게 보이지 않으면서도 작업 전반에 걸쳐 친숙함을 느끼게 하는 것입니다.

디자인

따뜻한 양피지 캔버스 #f5f4ed, 잉크 블루 #1B365D를 유일한 악센트로, 세리프가 계층을 전달하며, 하드 섀도우나 화려한 팔레트가 없습니다. UI 프레임워크가 아닙니다. 인쇄물을 위한 제약 시스템입니다. 문서는 대시보드가 아닌 구성된 페이지로 읽혀야 합니다.

  • 템플릿. 아홉 가지 유형: One-Pager, Long Doc, Letter, Portfolio, Resume, Slides, Equity Report, Changelog, Landing Page. 영어, 중국어, 한국어 지원.
  • 다이어그램. 17가지 인라인 SVG 유형. 시퀀스, 클래스, ER 다이어그램은 Mermaid 텍스트로 작성 가능: beautiful-mermaid가 SVG를 렌더링하고 scripts/mermaid_normalize.py가 Kami 팔레트로 다시 테마를 적용하고 WeasyPrint에 안전하게 만듭니다. Node 번들 없음.
  • 슬라이드. 세 가지 렌더링 경로: 기본적으로 WeasyPrint HTML to PDF, 요청 시 편집 가능한 PPTX를 위한 python-pptx, Markdown 우선 데크를 위한 assets/templates/marp/의 Marp 변형.
  • 코드. Pygments가 설치된 경우 Pygments 기반 구문 강조. 설치되지 않은 경우 PDF는 여전히 렌더링되고 코드는 단색으로 유지됩니다.

Kami는 사용자가 작성하는 언어에 따라 올바른 변형을 선택합니다.

글꼴: 각 언어는 전체 페이지에 대해 단일 세리프 글꼴을 사용합니다. 중국어: TsangerJinKai02. 일본어: YuMincho. 한국어: Source Han Serif K. 영어: Charter. 글꼴 조건은 License를 참조하십시오.

전체 사양: design.md. 치트시트: CHEATSHEET.md.

문서를 넘어서

하나의 제약 세트가 페이지 너머에도 적용됩니다: 배포 가능한 웹사이트를 배치하고 AI 이미지 렌더러에 브리핑하여 Kami 스타일로 결과물을 반환합니다.

(표 생략: 랜딩 페이지 및 일러스트레이션 예시)

랜딩 페이지는 배포 가능한 다국어 사이트로 제공됩니다. 일러스트레이션은 호스트의 자체 이미지 모델에 의해 그려집니다: 호스트가 이미지를 생성할 수 있는 경우(ChatGPT 등) 직접 렌더링하고, 그렇지 않은 경우(Claude 또는 Codex 등) 브리핑을 출력하여 사용자가 이미지 모델에 붙여넣을 수 있습니다.

Redraw this as a clean editorial diagram. Background: warm parchment (#f5f4ed), never pure white. One accent only, ink blue (#1B365D); everything else in warm gray with a yellow-brown undertone, no other colors. Thin single-line geometric strokes and simple flat icons. No gradients, no drop shadows, no 3D. Labels in a serif typeface. Generous whitespace, calm and composed, like a figure in a well-typeset report.

<sub>ChatGPT Images로 단일 패스로 수동 터치업 없이 렌더링됨. Kami가 지정하고 렌더러가 그립니다.</sub>

배경

저는 미국 주식에 투자하는 것을 좋아하고 항상 Claude에게 리서치 보고서를 작성하도록 요청합니다. 모든 출력물은 동일한 기본 문서 모양(회색, 평평, 세션마다 다른 레이아웃)으로 나왔습니다. 구조를 스캔하기 어렵고, 형식이 구식이며, 페이지에서 계속 읽고 싶게 만드는 것이 없었습니다. 그래서 타이포그래피, 팔레트, 간격을 하나씩 수정하기 시작했고, 보고서가 실제로 즐길 수 있는 페이지가 될 때까지 계속했습니다.

나중에 "당신이 모르는 에이전트: 원칙, 아키텍처 및 엔지니어링 실무"를 발표해야 했습니다. 이미 문서가 있었고 처음부터 슬라이드를 만들고 싶지 않았기 때문에 Claude Design을 사용하여 제 스타일로 배치하고 여러 번 수정한 후 만족스러운 결과를 얻었습니다. 그 과정에서 인라인 SVG 차트, 통일된 따뜻한 팔레트, 더 타이트한 편집 리듬이 추가되었습니다. 정기적으로 출시하는 모든 문서를 다룰 때까지 계속 성장했고, 프로세스를 추상화하여 Kami가 되었습니다: 모든 에이전트에 전달하고 출력을 신뢰할 수 있는 하나의 조용한 디자인 시스템입니다.

지원

  • 저를 지원하는 가장 직접적인 방법은 유료 Mac 정리 앱인 Mole for Mac을 구매하는 것입니다.
  • Kami가 도움이 되었다면 별표를 눌러주시거나, 공유하거나, 이슈나 PR을 열어주세요.
  • 저는 TangYuan과 Coke라는 두 마리의 고양이가 있습니다. Kami가 당신의 삶을 즐겁게 한다면, 그들에게 <a href="https://cats.tw93.fun?name=Kami" target="_blank">캔 음식 🥩</a>을 줄 수 있습니다.

원본 저장소: tw93/Kami

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.