Coreano escrito por IA,
breve y claro.
SimpleKorean es una skill de agente. Hace que la IA escriba documentos y respuestas en coreano sencillo.
Divide las oraciones largas, reduce los calcos de traducción y unifica la escritura de los términos.
Se inspira en SimpleEnglish y ASD-STE100.
01 Antes y después
Vea cómo cambia el mismo borrador
A la izquierda está el borrador original. A la derecha está el documento con SimpleKorean. Debajo de cada oración cambiada se indica la regla aplicada. El texto del ejemplo queda en coreano.
- em-dash 2 → 0
- Negrita 2 → 0
- Punto medio 3 → 0
- Terminaciones de consejo 2 → 0
- Oración más larga 12 eojeol → 11 eojeol
Borrador: ## 문제 해결
Revisado: ## 문제 해결
Borrador: **Postgres 연결 타임아웃** —
Revisado: ### Postgres 연결 타임아웃
Regla: Use un encabezado en lugar de negrita y em-dash
Borrador: sqlpipe가 connection timed out 오류를 내면 대부분 방화벽·보안 그룹이 5432 포트를 막고 있는 것입니다.
Revisado: sqlpipe가 connection timed out 오류를 내면 대부분 방화벽이나 보안 그룹이 5432 포트를 막습니다.
Regla: Una las palabras con una partícula, no con un punto medio. Use el presente simple
Borrador: nc -zv <호스트> 5432로 연결되는지 확인해 보시기 바랍니다.
Revisado: sqlpipe를 실행하는 호스트에서 nc -zv <호스트> 5432로 연결되는지 확인하세요.
Regla: Indique el host que ejecuta el comando. Cambie la terminación de consejo por la forma de orden «-하세요»
Borrador: **S3 권한 오류** —
Revisado: ### S3 권한 오류
Oración añadida en la revisión: sqlpipe가 AccessDenied 오류를 내면 먼저 aws sts get-caller-identity로 현재 쓰는 자격 증명을 확인하세요.
Regla: Ponga primero lo que se hace primero
Borrador: AccessDenied가 나면 ·버킷 정책에 읽기·쓰기 권한(s3:GetObject, s3:PutObject)이 있는지 확인하세요.
Revisado: 그다음 IAM 정책과 버킷 정책에 읽기와 쓰기 권한(s3:GetObject, s3:PutObject)이 있는지 확인하세요.
Regla: Una las palabras con «과» y «와» (y), no con un punto medio
Oración quitada del borrador: 먼저 aws sts get-caller-identity로 지금 쓰는 자격 증명을 확인하는 것이 좋습니다.
Regla: Se movió a la oración 6 de la derecha, sin la terminación de consejo
Fuente: evals/results/2026-10-21. Una persona emparejó las oraciones e indicó las reglas. Para ver más comparaciones, consulte los ejemplos de antes y después.
02 Resultados
Qué cambia al activar la skill
Publicamos las salidas originales que medimos. Puede volver a calcular las cifras de abajo a partir de esas salidas.
- Defectos de formato en respuestas
- 162 → 0
- Defectos visibles para el lector en 32 respuestas. Contamos em-dash, negrita, tablas y un encabezado o lista en la primera línea.
- Evaluación a ciegas
- 12 de 16
- Pares, de 16, en los que el juez eligió la respuesta de SimpleKorean sin saber cuál era. 3 pares empataron y 1 par perdió.
- Avisos del linter en documentos
- 0.71 → 0.17
- Avisos del linter por cada 100 eojeol. Un eojeol es una unidad de texto coreano entre dos espacios.
- Oración más larga
- 18 → 15 eojeol
- La oración más larga en 16 documentos. En el modo estricto es de 13 eojeol.
claude-sonnet-5-5 escribió los documentos y las respuestas. claude-opus-5-5 hizo de juez.
El juez también es Claude, así que puede favorecer a modelos de la misma familia.
03 Reglas
Oraciones cortas. La respuesta primero.
Las reglas dividen las oraciones largas, quitan el formato innecesario y corrigen los calcos de traducción.
- Respuesta
Ponga la respuesta en la primera oración
Evita: Una introducción que repite la pregunta
- Respuesta
No use negrita ni tablas
Evita: Formato alrededor de una respuesta de una línea
- Respuesta
No use em-dash
Evita: Ideas unidas solo a medias
- Documento
Escriba los procedimientos en 15 eojeol o menos, y las descripciones en 20 eojeol o menos
Evita: Oraciones largas que no terminan
- Documento
Ponga las condiciones antes de la orden con «-면» (si)
Evita: «단, ~경우» (sin embargo, en caso de ~) después de la orden, que el lector ve demasiado tarde
- Documento
Use la voz activa y tiempos simples
Evita: «되어지다» (doble pasiva), «~에 의해» (por ~), «-고 있습니다» (está haciendo)
- Documento
No use terminaciones de suposición ni de consejo
Evita: «-ㄹ 수도 있습니다» (puede que), «-것 같습니다» (parece)
- Documento
Dé a cada palabra un solo significado
Evita: Alternar «확인», «검증» y «점검» (todas significan «comprobar»)
Las reglas vienen de ASD-STE100, el inglés controlado de los documentos de mantenimiento aeronáutico. Las reglas completas están en SKILL.md.
04 Escritura
Un término, una escritura
La skill sigue las normas coreanas de transcripción de préstamos y los ejemplos del Instituto Nacional de la Lengua Coreana. Si no hay una escritura oficial, el proyecto elige una.
- 디렉터리no 디렉토리
- 메시지forma normativa
- 애플리케이션forma normativa
- 릴리스forma normativa
- 셸forma normativa
- 레포지토리forma habitual
- 바디forma habitual
- 칼럼forma habitual
- 리팩터링sin escritura oficial
- 반환값sin espacio
Si su empresa usa otra escritura, cámbiela en .simple-korean.json, en la raíz de su repositorio.
05 Instalación
Instálela según su herramienta
-
Claude Code
Instala la skill, tres hooks y el estilo de salida.
claude plugin marketplace add say8425/SimpleKorean claude plugin install simple-korean@simple-korean -
Codex
Instala la skill y el hook de inicio de sesión.
codex plugin marketplace add say8425/SimpleKorean codex plugin add simple-korean@simple-korean -
Otros agentes
Instala solo la skill con la CLI de skills.
npx skills add say8425/SimpleKorean -
Python
Use las reglas de respuesta y el linter desde código Python.
pip install "simple-korean==1.2.0"
Para usarla sin instalar, dé a su agente la URL del repositorio y pídale que siga el README.