Communitygithub.com

Desesbraker/agentes-vip

국제화 및 지역화 패턴. 하드코딩된 문자열 탐지, 번역 관리, 로케일 파일, RTL 지원.

agentes-vip란 무엇인가요?

이 스킬은 소프트웨어 애플리케이션에서 국제화(i18n)와 지역화(L10n)를 효과적으로 구현하기 위한 모범 사례와 패턴을 제공합니다. React, Next.js, Python 등 주요 프레임워크에서 사용할 수 있는 구체적인 코드 예제와 파일 구조를 포함하여 개발자가 다국어 지원을 손쉽게 통합할 수 있도록 돕습니다. 특히 하드코딩된 문자열을 감지하고 번역 누락을 방지하는 스크립트 도구를 제공하며, RTL(오른쪽에서 왼쪽 쓰기) 언어 지원을 위한 CSS 논리 속성 사용법도 다룹니다. 이 문서를 기반으로 하는 AI 에이전트는 사용자의 프로젝트에서 i18n 상태를 진단하고, 로케일 파일을 생성하거나 리팩토링하며, 최종적으로 전 세계 사용자를 대상으로 하는 애플리케이션의 접근성과 확장성을 높일 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/i18n-localization

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

i18n 및 지역화

국제화(i18n) 및 지역화(L10n) 모범 사례.


1. 핵심 개념

용어의미
i18n국제화 - 앱을 번역 가능하게 만들기
L10n지역화 - 실제 번역 작업
로케일언어 + 지역 (en-US, tr-TR)
RTL오른쪽에서 왼쪽으로 쓰는 언어 (아랍어, 히브리어)

2. i18n이 필요한 경우

프로젝트 유형i18n 필요 여부
공개 웹 앱✅ 예
SaaS 제품✅ 예
내부 도구⚠️ 가능성 있음
단일 지역 앱⚠️ 미래 고려
개인 프로젝트❌ 선택 사항

3. 구현 패턴

React (react-i18next)

import { useTranslation } from 'react-i18next';

function Welcome() {
  const { t } = useTranslation();
  return <h1>{t('welcome.title')}</h1>;
}

Next.js (next-intl)

import { useTranslations } from 'next-intl';

export default function Page() {
  const t = useTranslations('Home');
  return <h1>{t('title')}</h1>;
}

Python (gettext)

from gettext import gettext as _

print(_("Welcome to our app"))

4. 파일 구조

locales/
├── en/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
├── tr/
│   ├── common.json
│   ├── auth.json
│   └── errors.json
└── ar/          # RTL
    └── ...

5. 모범 사례

권장 사항 ✅

  • 번역 키를 사용하고 원시 텍스트를 사용하지 마세요
  • 번역을 기능별로 네임스페이스화하세요
  • 복수형을 지원하세요
  • 로케일별 날짜/숫자 형식을 처리하세요
  • 처음부터 RTL을 계획하세요
  • 복잡한 문자열에는 ICU 메시지 형식을 사용하세요

금지 사항 ❌

  • 컴포넌트에 문자열을 하드코딩하지 마세요
  • 번역된 문자열을 연결하지 마세요
  • 텍스트 길이를 가정하지 마세요 (독일어는 30% 더 깁니다)
  • RTL 레이아웃을 잊지 마세요
  • 같은 파일에 언어를 혼용하지 마세요

6. 일반적인 문제

문제해결책
누락된 번역기본 언어로 폴백
하드코딩된 문자열린터/검사 스크립트 사용
날짜 형식Intl.DateTimeFormat 사용
숫자 형식Intl.NumberFormat 사용
복수형ICU 메시지 형식 사용

7. RTL 지원

/* CSS 논리 속성 */
.container {
  margin-inline-start: 1rem;  /* margin-left 아님 */
  padding-inline-end: 1rem;   /* padding-right 아님 */
}

[dir="rtl"] .icon {
  transform: scaleX(-1);
}

8. 체크리스트

배포 전:

  • 모든 사용자 대상 문자열이 번역 키를 사용합니다
  • 지원하는 모든 언어에 대한 로케일 파일이 존재합니다
  • 날짜/숫자 형식이 Intl API를 사용합니다
  • RTL 레이아웃이 테스트되었습니다 (해당하는 경우)
  • 폴백 언어가 설정되었습니다
  • 컴포넌트에 하드코딩된 문자열이 없습니다

스크립트

스크립트용도명령어
scripts/i18n_checker.py하드코딩된 문자열 및 누락된 번역 탐지python scripts/i18n_checker.py <project_path>

사용 시기

이 스킬은 개요에 설명된 워크플로우나 작업을 실행할 때 적용됩니다.

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

관련 스킬