예전에는 앱을 현지화하려면 SDK를 추가하고, 프로바이더를 연결하고, 키를 직접 관리해야 했어요. AI 코딩 에이전트가 있으면 더 짧은 길이 있어요. skill을 설치하면 에이전트가 연결 작업을 해요. globalize.now는 오픈 에이전트 skill로 제공되는 AI 기반 현지화 인프라예요. 명령어 하나를 실행하면 에이전트가 플레이북을 읽고, 새로운 연결 코드를 직접 관리하지 않아도 코드베이스가 번역 가능한 구조로 바뀌어요.
에이전트 Skill이란 무엇인가요?
에이전트 skill은 코딩 에이전트가 읽고 실행하는 작은 지침 패키지예요. 오픈 skills 생태계로 배포되고, skills CLI로 설치해요. 예를 들면 npx skills add owner/repo 같은 명령이에요. 같은 명령으로 Claude Code, Cursor, Codex, OpenCode를 비롯해 50개가 넘는 에이전트에서 똑같이 동작해요.
skill은 SKILL.md 파일과 필요한 보조 파일로 이루어져 있고, 에이전트가 이미 참조하는 디렉터리에 설치돼요. CLI는 이를 하나의 기준 사본에 링크하고 설치 내역을 lockfile에 기록해요. 그래서 skill은 벤더 계정이 아니라 프로젝트 안에서 다른 코드와 함께 버전 관리돼요. 공개 레지스트리도 있어서, skill도 다른 의존성처럼 찾아보고, 읽어보고, 버전을 고정할 수 있어요.
눈여겨볼 변화는 이거예요. skill은 에이전트가 연동하는 제품이 아니라, 에이전트가 습득해서 코드에 적용하는 지식이에요. 이 차이는 팀원이 합류할 때 바로 드러나요. 저장소를 클론하면 skill이 이미 들어 있고, 그 팀원의 에이전트도 내 에이전트와 똑같은 방식으로 현지화를 처리해요.
i18n을 SDK가 아니라 skill로 제공하는 이유는 뭔가요?
국제화에서 어려운 부분은 리팩터링이고, skill은 그 작업을 에이전트가 대신하도록 가르치기 때문이에요. SDK는 코드가 이미 번역에 맞게 구조화되어 있다고 가정해요. 하드코딩된 문자열을 찾고, 키 체계를 설계하고, 로케일 파일을 만들고, 런타임 라이브러리를 연결하는 일은 여전히 직접 해야 하죠.
AI로 만든 앱은 이 문제가 더 심해요. 코딩 에이전트는 번역 구조가 아니라 동작하는 화면에 맞춰 최적화하기 때문이에요. 결과물은 대개 정상 동작하고 바로 배포할 수 있지만, 키를 쓰는 호출 대신 <button>Submit order</button> 같은 문자열이 가득해요. 프로젝트 전체로 보면 현지화는 설정 변경이 아니라 리팩터링이에요.
방치하면 문제는 계속 쌓여요. 같은 레이블이 조금씩 다르게 세 번 작성되고, 개수는 1 messages처럼 표시되고, 처음 언어를 추가하는 순간 반은 영어인 화면이 튀어나와요. skill은 이런 문제가 작은 티켓 100개로 불어나기 전에 한 번에 잡도록 만들어졌어요.
skill은 그 리팩터링을 에이전트가 실행할 수 있는 지침으로 담아요. 프레임워크를 감지하고, next-intl이나 i18next처럼 이미 쓰는 i18n 런타임을 확인하고, 영어 문자열을 추출해서 키와 로케일 파일을 생성해요. 버전을 관리하고 유지해야 할 새 런타임을 들여오는 게 아니에요. skill은 설정만 끝내고 물러나요.
skill은 MCP 서버와 뭐가 다른가요?
MCP 서버는 에이전트가 호출하는 서비스이고, skill은 프로젝트 안의 파일일 뿐이에요. Model Context Protocol은 실행 중인 서버를 통해 에이전트에 실시간 도구와 데이터를 제공하기에 좋은 방식이에요. 하지만 서버는 직접 또는 벤더가 호스팅해야 하고, 에이전트는 그 서버에 접근할 수 있어야만 동작해요.
skill 뒤에는 서비스가 없어요. 저장소에 함께 담기는 텍스트와 코드이고, 네트워크 호출 없이 동작하고, 다른 변경과 똑같이 pull request에 나타나요. 코드베이스를 국제화하는 일회성 설정 작업이라면, 계속 띄워 둬야 하는 서비스보다 파일이 나아요. skill이 무엇을 할지 읽어보고, 실행하고, diff를 리뷰하면 돼요.
skill은 여러 개를 함께 쓸 수도 있어요. 여러 개를 설치해도 나란히 공존해요. 각각이 실행하고 비용을 내야 하는 별도 프로세스가 아니라 지침일 뿐이거든요.
globalize.now는 에이전트 skill로 어떻게 설치하나요?
명령어 하나면 돼요. 나머지는 에이전트가 이어서 처리해요.
npx skills add globalize-now/globalize-skills --all
--all 플래그를 쓰면 내 머신에 있는 모든 에이전트에 모든 skill을 설치해요. 어떤 에이전트를 쓰는지 확실하지 않다면 안전한 기본값이에요. CLI는 globalize.now skill을 에이전트가 skill을 찾는 위치에 넣어 줘요. Claude Code와 Cursor를 포함해, 이미 쓰고 있는 에이전트에서 그대로 동작해요.
그다음 에이전트에 i18n 설정을 요청하면 플레이북대로 진행해요. 프레임워크를 감지하고, 런타임 라이브러리를 확인하고, 사용자에게 보이는 영어 문자열을 찾아서 키와 로케일 파일을 생성해요. 개발자라면 변경 전후가 어떻게 달라지는지 바로 알아볼 거예요.
// before
<button>Submit order</button>
// after
<button>{t("checkout.submit_order")}</button>
키는 skill이 만들고 관리하는 로케일 파일에 들어가요.
/locales
en.json
de.json
es.json
fr.json
영어 파일은 에이전트가 찾은 문자열로 채워져요. 다른 언어는 푸시할 때마다 생성되고 최신 상태로 유지돼요. 새 시장을 추가하는 일이 스프린트가 아니라 로케일 파일 하나로 끝나요.
설정이 끝나면 Git 푸시마다 번역이 동기화돼요. 내보내기도, 처리할 대기열도 없어요. vibe coding으로 앱을 만들고 있다면 이게 작업의 전부예요. 자세한 내용이 궁금한 개발자라면, 같은 skill이 리팩터링을 깔끔하게 마치고 표준 로케일 파일을 남겨 줘요.
번역은 내 저장소에 남나요?
네. skill이 생성하는 로케일 파일은 다른 소스 파일처럼 저장소에 커밋돼요. 벤더 종속을 따질 때 가장 중요한 부분이에요.
어떤 방식은 번역된 문자열을 빌드 단계나 호스팅 대시보드로 옮겨요. 그러면 그 방식을 떠나는 날 번역 레이어도 함께 사라져요. 저장소 기반 로케일 파일이라면 en.json, de.json 같은 파일이 전부 프로젝트 안의 일반 파일이에요. skill이 내일 사라져도 앱은 지금 지원하는 모든 언어를 그대로 배포해요. 떠나는 건 skill을 다시 설치하지 않는 것뿐이고, 옮겨 올 것도 없어요. 내 것이 다른 곳에 있었던 적이 없으니까요. 그래서 globalize.now는 앱을 감싸지 않고, 키와 로케일 파일을 생성하는 스택의 인프라 레이어에 자리해요.
skill 방식은 특정 벤더에 종속되나요?
아니요. 오히려 벤더 종속을 피할 수 있다는 점이 이 방식을 택할 이유예요. skill은 폐쇄적인 플러그인 스토어가 아니라, 지원하는 어떤 에이전트든 읽을 수 있는 오픈 레지스트리에서 설치해요. 결과물도 독점 포맷이 아니라, 이미 선택한 런타임 라이브러리용 표준 로케일 파일이라서 나중에 되돌릴 일이 없어요.
skill은 파일일 뿐이라서 실행하기 전에 무엇을 하는지 정확히 읽어볼 수 있어요. 주장보다 전체 과정을 보고 싶다면 AI로 만든 앱을 현지화하는 방법 가이드에서 같은 설정을 처음부터 끝까지 다뤄요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기