AminBlg/SimpleEnglish

SimpleEnglish – 일반 영어 LLM 출력을 위한 에이전트 스킬

기능 설명

• 대규모 언어 모델이 ASD‑STE100 Simplified Technical English 스타일로 답변을 다시 작성하도록 만드는 플러그인(스킬이라고 함)을 제공합니다. 이는 항공 우주 매뉴얼에 사용되는 통제된 언어입니다.
• 두 가지 출력 모드:
  1. Plain – 대부분의 서식을 제거하고, 문장 길이를 제한하며, 축약형, 굵게, 머리글 등을 금지합니다.
  2. Strict – 인증에 준하는 준수를 위해 전체 STE 어휘 제한을 추가합니다.
• 오픈 Agent Skills 표준을 따르는 모든 에이전트(Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode 등)와 작동합니다.

설치 방법

# 일반적인 스킬 설치 (런타임 훅 없음)
npx skills add AminBlg/SimpleEnglish

• 전체 기능(세션 훅 및 출력 스타일)을 위해 에이전트별 플러그인을 설치하세요. 예:
  • Claude Code:

    claude plugin marketplace add AminBlg/SimpleEnglish && \
    claude plugin install simple-english@simple-english
    

  • Codex:

    codex plugin marketplace add AminBlg/SimpleEnglish
    codex plugin add simple-english@simple-english
    

• 에이전트가 스킬 형식을 지원하지 않는 경우, prompts/system-prompt.md에서 시스템 프롬프트 블록을 복사하여 자체 프롬프트 구성에 붙여넣을 수 있습니다.

일반적인 사용법

• 스킬이 활성화된 후, 모델에게 *"이것을 simple-english로 다시 작성해"*라고 요청하거나 기술 문서(README, 런북, 오류 메시지 등) 작성을 요청하세요.
• 출력 스타일은 에이전트 설정에서 simple-english:simple-english로 식별됩니다.

벤치마크 및 증거

• 9개의 Claude 모델, Claude-sonnet-4-6, GPT-4.1-mini에서 평가되었습니다.
• 스킬이 없는 동일 모델과 비교하여 표시 결함(em-dash, 굵게, 머리글, 불릿)이 95% 감소한 것으로 보고되었습니다.
• STE-linter 위반이(스킬 없음) 단어 100개당 4.09에서 버전 2.0.1에서 0.91로 감소 – 78% 감소.
• 인간 평가자는 16개의 블라인드 쌍 중 14개에서 스킬이 활성화된 출력을 선호했습니다.

프로젝트 구조

• SKILL.md – 공식 Agent Skills 정의(≈1,700토큰, 53개의 번호가 매겨진 STE 규칙).
• prompts/system-prompt.md – 스킬 지원이 없는 에이전트를 위한 붙여넣기 가능한 시스템 프롬프트.
• evals/ – CI 생성 벤치마크에 사용된 스크립트 및 원시 결과.
• tools/ste-dictionary/ – 무료 PDF에서 공식 STE 단어 목록을 추출할 수 있는 도우미(저장소는 표준의 저작권을 존중하여 사전 자체를 포함하지 않습니다).

라이선스

• MIT. 저장소는 STE 규칙을 의역만 하며 저작권이 있는 표준 텍스트를 포함하지 않습니다.

도움이 될 수 있는 대상

• LLM이 생성한 일관되고 모호함 없는 문서를 원하는 개발자.
• 오해로 인해 비용이 많이 드는 오류가 발생할 수 있는 내부 도구 또는 API를 유지 관리하는 팀.
• LLM 기반 코딩 어시스턴트를 사용하고 비기술 직원이 쉽게 읽을 수 있는 출력이 필요한 모든 사람.

---

SUMMARY: SimpleEnglish는 LLM이 ASD‑STE100 Simplified Technical English의 규율 있고 전문 용어가 없는 스타일로 답변을 다시 작성하도록 강제하는 Agent-Skills 플러그인입니다. 모든 Agent Skills 호환 모델(Claude, Codex, Gemini 등)과 작동하며, 일반 모드와 더 엄격한 STE 어휘 모드를 제공하고, 단일 npx skills add 명령과 선택적 에이전트별 플러그인으로 설치됩니다. 벤치마크에 따르면 서식 결함이 95% 감소하고 STE 규칙 위반이 78% 감소하며, 인간 평가자는 대부분의 경우 스킬이 활성화된 출력을 선호했습니다. 이 프로젝트는 MIT 라이선스이며 의역된 규칙 정의만 포함합니다.

TITLE: SimpleEnglish – LLM이 항공 우주 등급 Simplified Technical English로 작성하도록 만드는 에이전트 스킬