sepia란 무엇인가요?
sepia는 AI 보조 소설 및 전문 문서 작성을 개선하기 위한 휴대용 Agent Skill입니다. 하나의 표준 SKILL.md를 사용하므로 Claude Code, Codex, Grok Build, Antigravity에서 플랫폼별 지침을 따로 작성하지 않고 사용할 수 있습니다.
어휘와 문장 구문에 집중하는 도구와 달리, sepia는 글이 기계적으로 생성된 것처럼 느껴지게 만드는 구조적 패턴에서 출발합니다. 소설의 경우 지나치게 깔끔한 인과관계, 화자가 설명하는 주제, 선형적인 시간 흐름, 제한적인 감정 표현, 현실 세계에 대한 언급 부재, 성장이나 수용만으로 완전히 해결되는 결말 등이 이에 해당합니다.
전문 문서에서 sepia는 다른 문제를 살펴봅니다. 정보 없는 군더더기, 불필요한 완곡한 표현, 챗봇의 흔적, 부적절한 문체, 반복적인 형식, 문서가 사용되는 장소의 기대에 부응하지 못하는 문제 등이 대상입니다.
핵심 원칙: 감지된 모든 AI 경향을 기계적으로 되돌리기보다, 글을 인간이 작성한 글의 분포에 맞게 조정합니다.
주요 기능
네 가지 글쓰기 작업
sepia는 초안의 단계에 따라 사용할 수 있는 네 가지 작업을 제공합니다.
- write: 관련 소설 또는 전문 문서 작성 규칙에 따라 새로운 글을 작성합니다.
- review: 텍스트를 편집하지 않고 문제를 진단합니다.
- refactor: 초안을 최대한 보존하면서 최소한의 targeted 편집을 수행합니다.
- recreate: 부분적인 편집만으로 부족할 때 내용을 전면 재작성합니다.
세 단계 소설 프로토콜
- 서사 구조: 주제 설명, 지나치게 정돈된 인과관계, 공개 시점, 감정 양식, 인물 관계망, 현실의 사물에 대한 언급을 다룹니다.
- 담화 흐름: 반복되는 문단-질문 형식을 깨고, 이야기 중반의 처짐을 보완하며, 리듬과 정보 배치를 다양하게 합니다.
- 표면 문체: 더 큰 구조적 문제가 처리된 뒤 진부한 표현, 구문 형식, 어휘, 문체를 수정합니다.
이 스킬에는 30개 특성을 사용하는 소설 진단 기준과 Claude, GPT, Gemini, DeepSeek, Kimi와 관련된 패턴에 대한 교정 지침도 포함되어 있습니다.
전문 문서 규칙
전문 문서 작성에는 공통 체크리스트와 지원되는 각 문서 유형별 간결한 규칙 파일이 사용됩니다.
- 릴리스 노트 및 공지: 사용자 영향부터 제시하고, 근거 자료로 주장을 뒷받침하며, 과장된 마케팅 표현을 피합니다.
- 풀 리퀘스트 및 이슈 답변: 먼저 답변하고
file:line을 인용하며, 습관적인 칭찬을 피하고, 사안의 중요도에 맞춰 길이를 조절합니다. - 사후 분석: 사람을 비난하지 않는 태도를 유지하면서 메커니즘은 엄격하게 검토하고, 타임스탬프, 막다른 시도, 담당자가 명시된 조치 항목을 포함합니다.
- 티켓 및 작업 지시서: 제목에 결과를 명시하고, 검증 가능한 완료 기준을 제공하며, 정보를 반복하는 대신 링크합니다.
- 기술 문서: 문제로 시작하고, 실제 막다른 시도 한 가지와 분명한 견해 한 가지를 포함하며, 수치에는 해당 조건을 명시합니다.
sepia 설치
기본 설치 범위는 사용자 계정이므로 한 번 설치하면 여러 프로젝트에서 사용할 수 있습니다. 사용 중인 에이전트 플랫폼에 해당하는 지침을 선택하세요.
Claude Code
# 설치
claude plugin marketplace add Nanako0129/sepia
claude plugin install sepia@sepia --scope user
# 업데이트
claude plugin marketplace update sepia
claude plugin update sepiaClaude Code의 세션 내 플러그인 대화상자에서 설치하는 경우, 범위를 선택하라는 메시지가 표시되면 User를 선택하세요.
Codex
# 설치
codex plugin marketplace add Nanako0129/sepia
codex plugin add sepia@sepia
# 업데이트
codex plugin marketplace upgrade sepia
codex plugin add sepia@sepiaCodex를 업데이트하려면 마켓플레이스 스냅샷을 새로 고친 다음 플러그인을 다시 추가해야 새 버전을 받을 수 있습니다.
Grok Build
# 설치
grok plugin install Nanako0129/sepia --trust
# 업데이트
grok plugin updateGrok Build는 기존 Claude Code 설치에서 sepia를 자동으로 찾을 수도 있습니다.
Antigravity
Antigravity는 이 스킬에 마켓플레이스를 사용하지 않습니다. 저장소를 클론하고 스킬 디렉터리를 복사한 뒤 전역 /sepia 워크플로를 설치하세요.
# 설치
git clone https://github.com/Nanako0129/sepia.git ~/.sepia
mkdir -p ~/.gemini/config/skills ~/.gemini/antigravity/global_workflows
cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md
# 업데이트
git -C ~/.sepia pull
rm -rf ~/.gemini/config/skills/sepia && cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md네 플랫폼 모두에 설치
저장소에는 지원되는 네 플랫폼 모두에 사용자 범위로 sepia를 설치하는 스크립트가 포함되어 있습니다.
curl -fsSL https://raw.githubusercontent.com/Nanako0129/sepia/main/install.sh | bash스크립트는 프로젝트를 ~/.sepia에 클론합니다. 다른 위치를 사용하려면 SEPIA_HOME을 설정하세요. 같은 명령을 다시 실행하면 설치가 업데이트됩니다. 실행 전에 스크립트를 확인하려면 저장소를 클론하고 체크아웃한 디렉터리에서 ./install.sh를 실행하세요.
Skills CLI로 설치
Skills CLI를 통해 sepia를 설치할 수도 있으며, 77개가 넘는 에이전트를 지원합니다.
npx skills add Nanako0129/sepia -g
npx skills update -g-g 옵션은 사용자 범위를 선택합니다. 이 옵션이 없으면 CLI는 기본적으로 프로젝트 범위를 사용합니다.
기본 사용법
설치한 후 에이전트에게 sepia를 적용하고 네 가지 작업 중 하나를 지정하도록 요청하세요. 아래 예시는 플랫폼별 셸 명령어가 아니라 요청 문구를 보여 줍니다.
새 문서 작성
간단한 개요에서 시작할 때는 write를 사용하세요. sepia가 올바른 규칙을 선택할 수 있도록 대상 문서 유형을 명시하세요.
sepia의 write 작업을 사용해 다음 변경 사항으로 릴리스 노트를 작성하세요.
사용자 영향을 먼저 제시하고 각 주장을 구체적인 근거 자료로 뒷받침하세요.픽션의 경우 모든 구조적 전개를 일일이 지시하기보다 전제, 제약 조건, 의도한 형식을 제공하세요.
sepia의 write 작업을 사용해 다음 전제로 단편소설을 작성하세요.
픽션 프로토콜을 적용하되 모호함을 유지하고 주제를 설명하지 마세요.초안을 바꾸지 않고 진단하기
무엇을 수정할지 결정하기 전에 문제점을 확인하려면 review를 선택하세요. 원본이 변경되지 않도록 진단만 수행하도록 명시적으로 요청하세요.
sepia로 이 이야기를 검토하세요. 진단만 하고 다시 쓰지 마세요.
서사 구조를 우선한 다음 담화 흐름과 표면 문체를 살펴보세요.전문 문서의 경우 문서 유형을 명시하세요.
sepia로 이 인시던트 사후 분석을 검토하세요.
타임스탬프, 막다른 지점, 메커니즘 분석, 담당자가 지정된 조치 항목을 확인하세요.
초안을 편집하지 마세요.최소한으로 변경하기
초안이 대체로 타당하고 가능한 한 기존의 목소리, 사실, 구성을 유지해야 한다면 refactor를 사용하세요.
sepia로 이 기술 문서를 최소한으로 수정해 리팩터링하세요.
기술적 주장과 문체는 유지하면서 군더더기를 제거하고 문서 유형과 맞지 않는 부분을 고치세요.처음부터 다시 쓰기
구조적 문제를 국소적인 수정만으로 깔끔하게 해결할 수 없다면 recreate를 사용하세요.
sepia로 이 릴리스 공지를 처음부터 다시 작성하세요.
검증된 사실은 모두 유지하고 사용자 영향을 먼저 제시하며 마케팅성 과장은 제거하세요.recreate는 전체를 다시 쓰는 작업이므로 반드시 유지해야 하는 사실, 인용문, 참고 자료 또는 제약 조건을 명시하세요.
적절한 작업 선택
- 원본 자료나 개요는 있지만 활용할 수 있는 초안이 없을 때는 write를 선택하세요.
- 변경 없이 진단, 편집 계획 또는 제2의 의견이 필요할 때는 review를 선택하세요.
- 완전히 새로운 구조를 만드는 것보다 기존 초안을 보존하는 일이 중요할 때는 refactor를 선택하세요.
- 초안의 구조, 구성 또는 문체가 근본적으로 부적절할 때는 recreate를 선택하세요.
고급 팁
모든 픽션 규칙을 적용하지 마세요
sepia는 이야기에서 유용한 전개를 약 세 가지에서 다섯 가지 선택하고 나머지에는 여지를 남기도록 설계되었습니다. 모든 수정을 적용하면 한 가지 뚜렷한 패턴이 다른 패턴으로 대체될 수 있습니다. 규칙 적용 범위를 극대화하기보다 영향이 가장 큰 문제를 우선하도록 에이전트에 요청하세요.
sepia로 이 이야기를 검토하고 영향이 가장 큰 문제 다섯 가지를 찾으세요.
상위 세 가지만 리팩터링하고 의도적인 불규칙성은 그대로 두세요.구조 순서에 따라 수정하세요
픽션에서는 서사 구조를 확정하기 전에 문장을 다듬지 마세요. 구조를 검토하고 담화 흐름을 바로잡은 다음 표면 문체를 조정하는 순서가 더 좋습니다. 이렇게 하면 대규모 수정 과정에서 문장 수준의 다듬기가 사라지는 일을 막을 수 있습니다.
문서 유형과 근거를 제공하세요
전문적인 글쓰기 규칙은 맥락에 따라 달라집니다. 초안이 티켓, 풀 리퀘스트 답변, 사후 분석, 릴리스 노트 또는 기술 문서인지 sepia에 알려 주세요. 관련 파일, 줄 참조, 타임스탬프, 승인 기준, 링크, 측정값, 조건을 포함하면 출력이 구체성을 유지할 수 있습니다.
프로젝트에 sepia 고정하기
저장소가 특정 버전의 스킬을 유지해야 할 때는 프로젝트 범위를 사용하세요. Codex와 Antigravity에서는 skills/sepia/를 .agents/skills/sepia로 커밋하고, Claude Code에서는 .claude/skills/sepia로 커밋하세요.
팀이 각 기여자의 사용자 범위 설치에 의존하는 대신 저장소에 자체 스킬 버전을 포함하려 할 때 유용한 방법입니다.
참조 계층 살펴보기
정식 스킬은 skills/sepia/SKILL.md에 있습니다. 참조 파일은 서사 구조, 담화 흐름, 표면 문체, 진단, 모델별 특징, 공통 전문 규칙, 문서 유형별 영역을 분리합니다. research/ 디렉터리에는 프로젝트가 정리한 근거 자료와 출처 링크가 들어 있습니다.
설치를 최신 상태로 유지하기
선택한 플랫폼에 맞는 업데이트 명령어를 사용하세요. install.sh로 모든 플랫폼을 설치했다면 같은 설치 명령어를 다시 실행하세요. Antigravity를 수동으로 설정한 경우 저장소를 다시 가져온 뒤 업데이트된 스킬 및 워크플로 파일을 다시 복사해야 합니다.
결론
sepia는 사람이 쓴 듯한 글이 단순히 어휘의 문제가 아니라고 봅니다. 픽션 워크플로는 서사 구조에서 시작해 담화 흐름을 거쳐 표면 문체로 마무리되며, 전문적인 글쓰기 규칙은 특정 문서 유형의 기대에 맞게 조정됩니다. 사용자 범위 또는 프로젝트 범위에 설치하고, 편집 목표에 맞는 작업을 선택한 뒤, 가능한 모든 규칙을 적용하기보다 영향이 큰 변경 몇 가지만 적용하세요.
sepia는 MIT 라이선스로 배포됩니다. 소스, 참조 파일, 설치 스크립트 및 연구 정리 자료는 GitHub 저장소에서 확인할 수 있습니다.