Communitygithub.com

Anhvu1107/all-agent-skill

요청이 i18n 현지화(국제화 및 현지화 패턴)와 일치할 때 항상 사용합니다.

all-agent-skill란 무엇인가요?

이 스킬은 AI 에이전트에게 국제화(i18n) 및 현지화(L10n) 모범 사례를 제공합니다. React (react-i18next), Next.js (next-intl), Python (gettext)를 포함한 여러 프레임워크와 플랫폼을 지원하며, 번역 키 사용, 로케일 파일 구조, RTL(오른쪽에서 왼쪽) 언어 레이아웃, 날짜/숫자 형식 등 실제 번역 파이프라인에 필요한 광범위한 개념을 다룹니다. 핵심 동작 원리는 사용자 요청에 따라 참조 문서(`senior-master-standard.md`, `usage-routing.md`, `quality-checklist.md`)를 먼저 로드한 후, 일치하는 상속 문서, 스크립트, 애셋, 예제를 동적으로 로드하는 선택적 읽기 규칙을 따릅니다. 또한 코드 내 하드코딩된 문자열을 감지하고 누락된 번역을 찾는 `scripts/i18n_checker.py` 스크립트를 제공하여 현지화 품질을 자동으로 검사합니다. 이 스킬은 다국어 애플리케이션 개발 시 발생하는 일반적인 문제(번역 누락, 하드코딩된 문자열, 플러리얼리제이션 오류 등)를 해결하고 현지화 관련 결정을 체계적으로 지원하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/i18n-localization

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

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

문서

i18n 및 현지화

선택적 읽기 규칙

다음부터 시작하세요:

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

그리고 나서 사용자의 실제 작업과 일치하는 상속된 문서, 스크립트, 애셋 또는 예제만 로드하세요.

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


1. 핵심 개념

용어의미
i18n국제화 - 앱을 번역 가능하도록 만드는 과정
L10n현지화 - 실제 번역 과정
Locale (로케일)언어 + 지역 (예: 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 20 individual skills — each has its own dedicated page.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when working with Remotion code, video compositions, rendering logic, timing, media assets, or React-based motion workflows.

관련 스킬