Toss UX Writing Skill

토스의 공개 UX 라이팅 가이드를 분석해 만든 비공식 한국어 제품 문구 스킬입니다.
에이전트가 버튼, 에러 메시지, 온보딩, 혜택 안내, 알림, 폼 문구를 토스식으로 다시 쓰도록 돕습니다.

Unofficial. This repository is not affiliated with Viva Republica/Toss. It does not redistribute Toss images or full source material. See NOTICE.md.

What this gives you

• SKILL.md: Claude/Hermes/Codex류 에이전트가 바로 읽을 수 있는 재사용 스킬
• references/: 토스식 말투를 문법·어휘·상황별 예외까지 쪼갠 분석 자료
• scripts/toss_style_lint.py: 한국어 UX 문구의 토스 스타일 위험 신호를 잡는 휴리스틱 린터
• prompts/: 시스템 프롬프트와 리뷰 프롬프트 템플릿
• templates/: PR/카피 리뷰 리포트 양식
• tests/: 린터 동작을 검증하는 테스트

Style model in one screen

해요체를 기본값으로 둬요.
수동형보다 능동형을 먼저 써요.
부정형보다 가능한 조건과 다음 행동을 먼저 말해요.
높은 경어보다 캐주얼한 존중을 써요.
명사+명사보다 동사형 문장을 써요.
단, 정책상 제한·사용자 안심·기간 만료처럼 명확성이 중요한 곳은 예외를 허용해요.

Install as a local agent skill

Hermes

mkdir -p ~/.hermes/skills/toss-ux-writing
cp -R SKILL.md references prompts scripts templates ~/.hermes/skills/toss-ux-writing/

Claude Code / other Agent Skills-compatible tools

mkdir -p ~/.claude/skills/toss-ux-writing
cp -R SKILL.md references prompts scripts templates ~/.claude/skills/toss-ux-writing/

Use without installing

Paste SKILL.md plus the relevant reference file into your agent context, or use prompts/toss-style-system-prompt.md as a system/developer prompt.

Quick use

Ask your agent:

이 문구를 toss-ux-writing 스킬 기준으로 고쳐줘.
원문/개선안/바꾼 이유/예외 여부를 표로 보여줘.

Or run the linter:

python3 scripts/toss_style_lint.py "카드를 해지하시겠어요?"
python3 scripts/toss_style_lint.py --format markdown docs/copy.md
python3 scripts/toss_style_lint.py --format json tests/fixtures/fail.txt

Example output:

카드를 해지하시겠어요?
→ 카드를 해지할까요?

Reason: 과도한 경어 `시겠어요`를 줄이고, 사용자가 실제로 결정하는 행동을 짧게 물어요.

Repository map

.
├── SKILL.md
├── references/
│   ├── tone-model.md
│   ├── decision-tree.md
│   ├── vocabulary.md
│   ├── surface-patterns.md
│   ├── examples.md
│   └── review-rubric.md
├── prompts/
│   ├── toss-style-system-prompt.md
│   └── rewrite-review-prompt.md
├── scripts/
│   └── toss_style_lint.py
├── templates/
│   └── copy-review-report.md
├── tests/
│   ├── fixtures/
│   └── test_lint.py
└── .github/workflows/ci.yml

Design principles

1. Pattern over mimicry — 토스 원문을 복제하지 않고, 재사용 가능한 문장 변환 규칙으로 추상화합니다.
2. Clarity over forced positivity — 제한·법적 불가·개인정보 안심처럼 부정형이 더 정확한 상황은 부정형을 씁니다.
3. Casual respect — 반말이 아니라 낮은 높이의 존중입니다. 해요체를 유지하되 ~시, ~께, 여쭙다를 줄입니다.
4. Surface-aware copy — 버튼, 다이얼로그, 알림, 폼, 에러, 혜택 안내는 서로 다른 길이와 위험도를 가집니다.
5. Auditable outputs — 개선안뿐 아니라 바꾼 이유와 적용 규칙을 함께 남깁니다.

Validate locally

python3 -m unittest discover -s tests
python3 scripts/toss_style_lint.py --format markdown tests/fixtures/fail.txt

Source

Primary source: Toss Apps in Toss Developer Center, “UX 라이팅” page. See NOTICE.md.