Communitygithub.com

100x-localize

광고 스크립트/카피를 멕시코 스페인어(기본값)로 현지화하는 스킬입니다.

100x-localize란 무엇인가요?

이 스킬은 주어진 소스 텍스트(모든 언어 가능)를 멕시코 스페인어(기본)로 현지화하며, 단순한 단어 대 단어 번역이 아닌 '압축 및 현지화'를 수행합니다. 소스 텍스트 길이의 0.5배에서 1.1배 사이로 문자 수를 제한하여 실제 구어체 데이터 기반의 강도 분포를 반영하도록 설계되었습니다. 주로 Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용되며, 텍스트 형태의 입력만 받고 비디오/오디오 파일은 처리하지 않습니다. 사용자는 '투입어 현지화' 또는 '이 ad copy를 스페인어로 번역해줘' 같은 문장으로 트리거할 수 있습니다. 선택적으로 타겟 지역(기본값 'mx', 'generic-latam' 가능)과 레지스터 프로필(기본값 'default', 보수적 규제 프로필은 선택 사항)을 지정할 수 있습니다. 4가지 핵심 공리(압축, 레지스터 강도 기본값, 인칭 일관성(tú 고정), 허위 권위 주장 금지)를 엄격히 준수하며, 출력물은 schema.json 구조로 제공됩니다. 또한 '100x-persona'나 '100x-search-query' 같은 상위 스킬의 출력물을 참조할 수 있지만, 이 스킬 자체는 독립적으로 실행 가능하며 사용자에게 다른 스킬을 먼저 요구하지 않습니다. validate.js 스크립트를 통해 JSON 스키마 검증(ajv 사용)과 추가적인 길이/내용 규칙 검사를 자동화할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kezd088/100x-skill-tiktok/tree/main/skills/100x-localize

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

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

문서

100x-localize은(는) 무엇을 하나요?

한 줄 요약

소스 텍스트(모든 소스 언어)를 입력하면 멕시코 스페인어 기본 현지화 버전을 출력합니다. 단순한 단어 대 단어 번역이 아니라, 적극적으로 길이를 압축하고 실제 구어체 데이터의 강도 분포에 맞춥니다. 100x 시스템의 L2 크리에이티브 생성 계층에 속하며, "2c 투입어 현지화" 단계에 해당합니다.

언제 트리거되는가

사용자가 다음과 같이 말할 때:

  • "투입어 현지화" / "스페인어로 현지화" / "스페인어 카피로 번역" / "멕시코 스페인어로 개작" / "이 카피 어떻게 현지화할까"
  • "localize this ad copy" / "translate this script into Spanish" / "adapt this for the Spanish market" / "Mexican Spanish localization"
  • 또는 소스 텍스트(소스 언어는 보통 영어 또는 중국어)를 바로 주면서 스페인어 현지화 버전을 요청할 때

입력

최소 입력 (카테고리 A, 필수): source_script — 완전한 소스 텍스트 평문 (소스 언어는 상관없음). 본 스킬은 비디오/오디오 파일을 받지 않으며, 텍스트만 처리합니다.

부가 입력 (카테고리 B, 모두 명시적 기본값 있음, workflow.md Phase 1 참조): target_region (기본값 "mx", mx/generic-latam만 허용, 그 외 값은 generic-latam으로 강등되고 meta.warnings에 기록), register_profile (기본값 "default", 실제 구어체 데이터 강도에 맞춤, 보수적 프로필이 아님, "핵심 제약" 공리 2 참조).

상위 선택적 출력물 (카테고리 C, 없으면 조용히 건너뜀, 차단하지 않으며 사용자에게 다른 스킬을 먼저 실행하라고 요구하지 않음): 100x-persona의 인물/시나리오 카드, 100x-search-query의 검색어 결과.

출력

schema.json 구조 참조: source_script (원문 에코) + target_region + register_profile + localized_script (스페인어 현지화 결과물) + meta (필수: generated_by, warnings; 선택 정보 필드: compression_ratio).

핵심 제약 (4가지 공리, axioms.md 참조)

  1. 압축 공리: 스페인어 출력 문자 수는 소스 텍스트 문자 수의 1.10배를 초과할 수 없으며 0.5배 미만일 수 없습니다. — 참조 코퍼스의 표기 길이 분포를 기준으로 계산되었으며, 스페인어는 동일한 정보량에 대해 자연스럽게 더 긴 표현을 사용합니다. 직역은 체계적으로 음성 내레이션 시간 예산을 초과하므로, 적극적으로 압축하여 개작해야 하며 직역이 아닙니다 (1.10/0.5라는 구체적인 숫자는 엔지니어링 판단이며 axioms.md 공리 1 참조).
  2. 레지스터 강도 기본값 공리: 기본값은 실제 구어체 데이터의 실제 강도 분포를 따릅니다. 07번 규격 파일(07_서반아어 구어체 스타일 규격.md) §5의 보수적 금지어 목록은 선택적 프로필 profiles/compliance-conservative.md로 강등되며, 기본값이 아닙니다 (해당 파일 §1은 자체적으로 "라이브러리 내 스페인어 히트 샘플에서 귀납한 실전 결론이 아니다"라고 선언하므로, 본 스킬은 그 보수적 조언을 기본적으로 반드시 따라야 하는 검증된 결론으로 간주하지 않습니다).
  3. 인칭 일관성 공리: 전체 텍스트에서 tú 호칭을 통일해야 하며, usted/vosotros를 혼용해서는 안 됩니다 (알려진 한계: 현재는 mx/generic-latam 두 target_region만 지원하며, 스페인 공식 usted/vosotros 레지스터나 아르헨티나 vos 활용형은 지원하지 않습니다. 이는 범위 제한이며, 이러한 지역을 요청하면 generic-latam으로 강등되고 안내 메시지가 표시되며 지원하는 척하지 않습니다. 또한 참조 코퍼스에는 usted가 실제로 등장하고 tú와 혼용되는 경우가 있습니다. 이 공리는 본 스킬이 자체 출력에 설정하는 품질 기준이며, 실제 코퍼스 현황에 대한 설명이 아닙니다. axioms.md 공리 3 참조. 현재 메커니즘은 대문자화/악센트 제거/제로 너비 보이지 않는 문자 삽입/조합 악센트 기호 삽입이라는 네 가지 우회 기법을 이미 커버합니다 (수동 검증 계층은 공리 2/3에 대해 보이지 않는 문자 + 조합 악센트 기호 이중 정규화를 수행하고, 공리 4의 권위 어족 탐지도 보이지 않는 문자를 제거합니다. 여전히 알려진 잔여 격차: schema.json 수준의 ajv pattern은 여전히 전처리 능력이 없으며(JSON Schema 규격 구조적 제한), 수동 계층의 보이지 않는 문자 코드 포인트 목록(6개)은 유니코드 문자 카테고리의 완전한 열거가 아닙니다. axioms.md 공리 2/3/4의 TODO 참조).
  4. 허위 권위 주장 금지 공리: 소스 텍스트에 없는 권위/인증 관련 주장(FDA/Harvard/OMS/임상 검증류 표현)을 도입해서는 안 됩니다. — 알려진 한계: 이는 폐쇄 어족 내 키워드 수준의 신규 추가만 막을 수 있습니다 (악센트 제거, 대소문자 혼용, 글자별 점 약어 등의 표기 변형에 대해 정규화를 수행하지만, 폐쇄 집합에 없는 가상의 기관명/인명을 만들어내는 것은 막을 수 없습니다). axioms.md 공리 4 참조.

3단계 워크플로우

workflow.md 참조: Phase 1 수신 + 검증 (카테고리 A/B/C, target_region/register_profile 강등 및 채우기) → Phase 2 (레지스터 강도 결정 → 언어 자연화 개작 → 길이 압축 → 문장별 자체 검사 → 일괄 자체 검사) → Phase 3 사용자 트리거 재작업 (L1 단일 라운드 압축 / L2 프로필 또는 지역 전환 / L3 전체 재시작; 인칭 레지스터에 대한 재작업 경로는 없음 — v1은 tú만 지원, "핵심 제약" 공리 3 참조).

독립 호출 보장

카테고리 A(source_script)가 없거나 사용자가 비디오/오디오 파일을 보낸 경우 → 고정된 거절 응답으로 재확인하며, 대신 추측하거나 스크립트를 대신 작성하지 않습니다. 카테고리 B(target_region/register_profile)가 없는 경우 → 문서화된 기본값을 직접 사용하여 계속 진행하며, 재확인하지 않고 차단하지 않습니다. 카테고 C(상위 100x-persona/100x-search-query 출력물)가 없는 경우 → 조용히 건너뛰며, 사용자에게 다른 스킬을 먼저 실행하라고 절대 요구하지 않습니다.

금지어

저에게 / 바랍니다 / 아마도 / 대략 / 가능한 / 어쩌면 / 우리 함께; AI 상담원스러운 표현(as an AI / I'd be happy to / feel free to); register_profile=="compliance-conservative" 프로필 하의 구체적 금지어 목록은 profiles/compliance-conservative.md 참조; 소스 텍스트에 없는 효과/인증/사용자 후기를 지어내지 않음 (공리 4 참조, 알려진 한계는 위 참조); 어떤 고객 카테고리 사전도 하드코딩하지 않음; v1이 구현하지 않은 지역/인칭 레지스터를 지원하는 척하지 않음 (공리 3 알려진 한계 참조).

라우팅 (권장, 강제 아님)

  • 이미 인물/시나리오 설정이 있고 현지화 어조를 특정 캐릭터에 맞추고 싶은 경우 → 인물/시나리오 스킬 (이미 구축된 경우, 출력물을 카테고리 C 참조로 사용 가능)
  • 아직 검색 키워드를 정하지 못했고 참고 자료를 먼저 찾고 싶은 경우 → 검색 키워드 스킬 (이미 구축된 경우)
  • 현지화 후 음성 해설/자막 타임라인을 생성하고 싶은 경우 → 음성 해설/자막 스킬 (이미 구축된 경우)
  • 처음으로 돌아가 재분류를 원하는 경우 → 100x 시스템 전체 진입점 (이미 구축된 경우)

위는 모두 "출력 후 필요에 따른 권장"이며, 전제 의존성이 아닙니다. 해당 스킬이 아직 구축되지 않아도 본 스킬의 독립적 작업에 영향을 미치지 않습니다.

출고 자체 점검

node scripts/validate.js --selftest를 실행하여 검증합니다. schema.json이 선언한 구조적 제약(required/additionalProperties/enum/pattern, 공리 2/3의 조건부 if/then+pattern 검사 포함)은 scripts/validate.js 내의 ajv (진짜 JSON Schema draft-07 검증기, package.json에 devDependency로 선언됨, 먼저 npm install 후 실행)에 의해 실제로 실행됩니다. 공리 1(압축비)과 공리 4(허위 권위 방지)는 두 개의 필드 간 비교 규칙으로, 바닐라 JSON Schema 구조로는 표현할 수 없으며(두 문자열 필드의 길이나 내용을 비교할 수 없음), scripts/validate.js의 수동 코드로 보완됩니다:

npm install                                                   # 최초 사용 시 ajv 설치
node scripts/validate.js <bundle.json> [bundle2.json ...]   # 출력물 검증
node scripts/validate.js --selftest                          # 내장 회귀 테스트 실행

출처

본 스킬은 다음 자료를 기반으로 구축되었습니다: 07_서반아어 구어체 스타일 규격.md (레지스터/자연화 규칙의 직접 출처이며, "실증적 결론이 아니다"라는 자체 선언은 그대로 유지됨) + 참조 코퍼스 (압축 공리와 레지스터 기본값 공리의 데이터 기반 제공) + T7 모듈 라이브러리 CSV (모듈 구조의 구조적 참조 제공). 파일별 개작 지점 및 판단 기준 설명은 sources.md를 참조하십시오.

Individual skills in this repo

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

관련 스킬