Claude Code Skill은 관련 작업일 때 Claude가 불러오는 지침 폴더이고, npx skills add globalize-now/globalize-skills로 국제화(i18n)와 번역 동기화를 처리하는 Skill을 설치할 수 있어요. globalize.now는 i18n을 구성하고, 하드코딩된 UI 문자열을 추출하고, 번역 키를 생성하고, Git 푸시마다 로케일 파일을 동기화하는 AI 기반 현지화 인프라예요. Skill 형식 덕분에 i18n이 AI 코딩 도구 안의 반복 가능한 절차가 되고, 번역은 그 뒤에서 자동으로 이뤄져요.
Claude Code Skill이란?
Claude Code Skill은 SKILL.md 파일이 들어 있는 폴더예요. 파일은 Skill의 이름과 설명을 담은 YAML 프론트매터로 시작하고, 그 뒤에 Skill이 활성화됐을 때 Claude가 따르는 Markdown 지침이 이어져요.
형식은 일부러 최소한으로 만들었어요. Claude Code는 세션을 시작할 때 프론트매터만 불러와요. Skill당 대략 30~50토큰이라, 에이전트가 수백 개의 Skill 메타데이터를 들고 있어도 컨텍스트가 부풀지 않아요. 전체 지침은 현재 작업이 설명과 맞을 때만 불러와요.
Anthropic은 2025년 10월에 Agent Skills를 출시하고 곧이어 사양을 오픈 표준으로 공개했어요. 지금은 Cursor, OpenAI Codex CLI, Gemini CLI, GitHub Copilot, VS Code를 포함해 26개가 넘는 도구가 이 형식을 채택하고 있어요. 사양은 SKILL.md 본문을 5,000토큰 이하로, 전체 디렉터리를 500줄 이하로 유지하길 권장해요.
Skill에는 하위 폴더에 스크립트(Python, Bash, JavaScript)와 참조 파일을 넣을 수 있고, Claude는 필요할 때만 불러와요. 구조는 시니어 엔지니어가 신입을 온보딩하는 방식과 같아요. 앞에는 짧은 개요를 두고, 깊은 참고 자료는 한 단계 아래에 두는 거예요.
Claude Code에 i18n Skill이 왜 필요한가요?
국제화(i18n)는 프로젝트마다 반복되는 절차적 작업이에요. i18n 라이브러리를 고르고, 코드베이스를 스캔하고, 번역 키를 생성하고, 로케일 파일을 작성하죠. 번역 단계인 현지화는 그 뒤에 푸시마다 일어나요. 둘 다 일관되지 않으면 코드베이스가 어긋나요. Claude Code는 세션마다 i18n 설정을 처음부터 추론할 수 있지만, 실행할 때마다 선택이 달라져요.
Skill은 이런 어긋남을 없애 줘요. 절차를 한 번 정의해 두면 Claude가 그대로 따라요. 프레임워크 감지, 라이브러리 선택, 키 네이밍, 로케일 파일 형식이 실행할 때마다 같아져요.
Anthropic이 자체 번들 Skill에 쓰는 것과 같은 패턴이에요. PowerPoint, Excel, Word, PDF Skill은 도메인 전문성을 하나로 묶은 것인데, 이게 없으면 Claude가 작업마다 문서 규칙을 처음부터 다시 파악해야 해요. 현지화도 마찬가지예요. 규칙은 실재하고, 프레임워크마다 다르고, 다시 파악하기 번거로워요.
Cursor, Claude Code, Codex로 React나 Next.js 앱을 만드는 vibe coder에게는 전통적인 팀보다 더 중요해요. AI 코딩 도구의 핵심은 아키텍처 결정을 하느라 에이전트를 끊지 않는 거니까요. 현지화 Skill이 있으면 번역 대시보드로 넘어가거나 프로젝트마다 i18n 스캐폴드를 다시 짤 필요 없이 에이전트가 계속 작업해요.
npx skills add globalize-now/globalize-skills는 Claude Code Skill로 어떻게 동작하나요?
프로젝트 루트에서 명령 하나를 실행하세요:
npx skills add globalize-now/globalize-skills
설치 프로그램은 저장소의 표준 Claude Code Skill 디렉터리에 Skill을 써 넣어요. import할 라이브러리도, 추가할 데코레이터도, 작성할 설정 파일도 없어요. 이제 저장소에 Claude가 프로젝트를 현지화하는 데 필요한 절차가 들어 있어요.
그다음 Claude Code를 열고 평소 말투로 요청하세요:
Set up localization for this project
Claude Code는 설명을 보고 새 Skill을 감지해 전체 SKILL.md를 컨텍스트에 불러오고 절차를 실행해요. Skill은 파일 트리를 훑어 프레임워크(Next.js App Router, Vite + React, Remix 등)를 파악하고, i18n 라이브러리가 없으면 알맞은 것(next-intl, react-i18next, i18next, @lingui)을 고르고, 하드코딩된 문자열을 일관된 이름의 번역 키로 바꿔요.
로케일 파일은 같은 커밋으로 저장소에 반영돼요. 에이전트가 Claude Code의 일반적인 Git 흐름으로 변경 사항을 커밋하고, 여러분은 다른 PR과 똑같이 diff를 검토하면 돼요.
동기화 레이어는 globalize.now 서버에서 실행돼요. 저장소에 푸시할 때마다 새 문자열을 추출하고, 번역 키를 다시 생성하고, 그 키를 나머지 로케일로 번역해요. 다음 푸시 때 동기화된 로케일 파일이 저장소로 돌아와요. Skill 자체는 실행 중인 서버가 필요 없어요. 저장소와 함께 이동하고, Skill을 지원하는 어떤 에이전트에서도 동작해요.
전체 설정 과정은 Claude Code 연동 페이지 또는 관련 가이드인 Cursor로 만든 Next.js 앱에 15분 만에 i18n 적용하기에서 확인하세요.
Claude Code Skill은 왜 현지화의 표준이 되고 있나요?
Skill 생태계는 빠르게 채워지고 있어요. 2026년 2월 Bosch Research와 Carnegie Mellon University 연구진이 공개 등록된 Skill을 분석했는데, 20일 만에 약 2,000개에서 40,000개 이상으로 대략 18배 늘었어요. 기본값이 자리 잡는 중이고, 그 자리는 Skill이 등장해 설치되는 순서대로 채워져요.
Anthropic 공식 파트너 디렉터리에는 이미 Atlassian, Canva, Cloudflare, Figma, Notion, Ramp, Sentry, Stripe, Zapier의 Skill이 올라와 있어요. 아직 현지화 벤더는 하나도 없어요. Lokalise, Crowdin, Phrase는 Skill이 아니라 MCP 서버와 CLI 도구에 투자했어요. 다른 접점에 베팅한 셈이에요.
MCP와 Skill은 푸는 문제가 달라요. MCP 서버는 실시간 연결로 도구와 데이터를 노출해요. Skill은 Claude가 필요할 때 읽는 절차 지침을 묶은 것으로, 저장소와 함께 이동해요. 현지화는 절차적이고, 저장소에 묶여 있고, 오프라인에서도 안전한 작업이에요. Skill 형식이 잘 맞아요.
발견 경로도 중요해요. npx 설치 방식은 이미 npx create-next-app 또는 npx vercel를 쓰는 개발자에게 가장 손쉬운 방법이에요. 명령 하나를 입력하면 Skill이 설치되고, Claude Code가 바로 인식해요. MCP 서버 인증, 자격 증명 설정, 실시간 연결 관리와 비교해 보세요. 일은 더 많은데 이식성은 떨어져요.
검색 동향도 이 변화를 보여줘요. “Claude Code가 만든 앱을 현지화하는 방법” 같은 쿼리는 Google 상위 결과에서 Skill 기반 답변으로 수렴하고 있고, 예전의 MCP 서버 튜토리얼을 대체하고 있어요. 패턴은 분명해요. 한 줄짜리 npx 설치와 절차를 처리하는 Skill이에요.
그래서 문서가 잘 갖춰진 첫 번째 현지화 Skill이 에이전트가 가장 먼저 찾는 답이 돼요. Claude Code가 어떤 작업용 Skill을 한 번 설치하고 나면, 다음 세션에서는 “어떤 i18n 도구를 써야 할까”라는 질문이 거의 나오지 않아요. Skill이 기본값이고, 다음 프로젝트도 거기서 시작해요.
이 변화가 현지화 도구에 어떤 영향을 주는지 더 넓게 보려면 AI로 만든 앱을 위한 globalize.now와 Lokalise·Crowdin 비교와 개발자 개요를 참고하세요.
globalize.now는 npx skills add globalize-now/globalize-skills로 설치하는 Claude Code Skill로, 그리고 저장소를 한 번에 변환해 주는 앱 내 연결 플로우로 제공돼요. globalize.now에서 둘 중 편한 방법으로 시작하세요.
globalize.now는 하드코딩된 앱 문구를 번역할 수 있는 로케일 파일로 바꾸고, 배포할 때마다 최신 상태로 유지해요.
globalize.now 무료로 시작하기