Agent Skills 표준을 지원하는 모든 하네스(harness)에서 작동합니다: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode 및 약 25개 이상의 도구. 폴더 하나로 구성되며, 의존성(dependencies)이 없고, MIT 라이선스입니다.

🔥 Before / after

왼쪽 열은 편집되지 않은 실제 Claude 출력물입니다. 오른쪽 열은 동일한 모델에 해당 기술(skill)을 로드한 결과입니다.

sqlpipe의 견고한 아키텍처 (architecture)를 활용하면, 사용자는 최소한의 설정 오버헤드 (configuration overhead)로 Postgres 테이블을 S3로 원활하게 동기화할 수 있습니다. 시작하기 전에 AWS 자격 증명 (credentials)이 올바르게 구성되었는지 확인해야 합니다. 이는 나중에 발생할 수 있는 짜증 나는 권한 문제를 방지하는 데 매우 중요합니다.

sqlpipe는 Postgres 테이블을 S3로 복사합니다. 하나의 설정 파일이 필요합니다.

시작하기 전에 AWS 자격 증명 (credentials)이 올바른지 확인하십시오. 올바르지 않으면 S3가 권한 오류와 함께 업로드를 거부합니다.

이런! 연결을 설정하는 동안 문제가 발생했습니다. 자격 증명 (credentials)이 올바르게 구성되었는지 확인하고 다시 시도하십시오. 문제가 지속되면 관리자에게 문의하십시오.

데이터베이스 연결에 실패했습니다: app 사용자의 비밀번호가 올바르지 않습니다.
DB_PASSWORD를 올바른 값으로 설정한 후 다시 연결하십시오.

일부 사용자의 서비스 접속 능력에 영향을 미쳤을 수 있는 문제를 확인했습니다. 이로 인해 발생한 불편에 대해 진심으로 사과드립니다.

UTC 기준 14:02에서 14:31 사이에 요청의 12%가 실패했습니다. 14:00에 진행된 배포 (deploy)에서 캐시 워밍업 (cache warmup) 단계가 제거되었습니다. 14:27에 이를 복구했습니다.

┌── 측정값: 6개 Claude 모델 × 8개 작업 × 2개 조건, 96회 실행 ──┐
│  100단어당 STE 위반 횟수     ▼ 72.9%  (모든 모델이 승리함)    │
│  출력 토큰 (output tokens)  ▼ 6개 모델 모두에서 감소          │
...

examples/before-after.md에서 더 많은 재작성 사례를 확인하세요: README, 에러 메시지 (error messages), 장애 보고서 (incident reports), 릴리스 노트 (release notes).

📦 설치 (Install)

npx skills add AminBlg/SimpleEnglish

이것으로 끝입니다. skills CLI는 사용자의 에이전트 (Claude Code, Cursor, Codex, Copilot, Gemini CLI 등)를 감지하고 선택한 에이전트에 설치합니다. 설치하기 전에 먼저 시도해 보세요:

npx skills use AminBlg/SimpleEnglish@simple-english

SKILL.md 지원이 전혀 없나요? 에이전트(AGENTS.md)의 시스템 프롬프트(system prompt)나 .cursorrules에 prompts/system-prompt.md를 붙여넣으세요. 예산(토큰 제한)이 빠듯한 경우를 위한 ~60토큰 버전도 있습니다.

그다음 어떤 기술 문서 작성을 요청하거나, 다음과 같이 말하세요: "rewrite this with simple-english" (이것을 simple-english로 다시 작성해줘).

🖱️ 터미널이 없나요? (claude.ai, ChatGPT, Gemini)

Claude.ai (유료 플랜)는 스킬(skills)을 기본적으로 지원합니다:

1. 스킬 파일을 다운로드합니다: SKILL.md를 열고 저장합니다 (Ctrl+S / Cmd+S).
2. claude.ai에서 Settings → Capabilities로 이동하여 코드 실행(code execution)을 켭니다.
3. Settings → Customize → Skills → Upload로 이동하여 저장한 SKILL.md를 업로드합니다.
4. 스킬을 활성화(Toggle on)합니다. 완료되었습니다. Claude는 기술 문서 작성을 요청할 때 이 스킬을 적용합니다.

ChatGPT: 스킬 지원이 없으므로 프롬프트 버전을 사용하세요. prompts/system-prompt.md의 블록을 복사하여 Settings → Personalization → Custom Instructions에 붙여넣거나, 프로젝트(Project) 또는 커스텀 GPT(Custom GPT)의 지침(instructions)에 넣으세요.

Gemini: Gem을 생성하고 동일한 블록을 지침에 붙여넣으세요.

기타 모든 챗봇: prompts/system-prompt.md를 채팅에 첨부하거나 붙여넣은 뒤 "apply this to everything you write for me" (내가 작성하는 모든 것에 이것을 적용해줘)라고 말하세요.

📏 규칙 (The rules)

53개의 번호가 매겨진 규칙, 9개의 섹션으로 구성되어 있으며, 문장이 모호할 경우 독자가 사망할 수도 있는 환경의 사람들이 1983년에 작성했습니다. 핵심적인 규칙들은 다음과 같습니다:

소프트웨어 예시가 포함된 전체 의역 세트는 SKILL.md에서 확인할 수 있습니다. 네, 이 README 파일은 규칙의 절반을 어기고 있습니다. 마케팅은 STE(Simplified Technical English) 범위에서 명시적으로 제외됩니다. 이 스킬은 그 사실을 알고 있으며 문서 내에 머무릅니다. 😌

🧰 문서만이 아닙니다

이 스킬은 다음과 같은 용도에 맞게 조정된 버전(use-cases.md)을 제공합니다:

• 🚨 오류 메시지(Error messages): 발생한 일 → 왜 그런지 → 무엇을 해야 하는 순서로 작성
• 📟 런북(Runbooks): STE의 주 영역입니다. 런북은 유지보수 매뉴얼(maintenance manual)입니다.
• 🧯 사건 보고서(Incident reports):

이것이 출력물을 STE 인증(STE-certified) 상태로 만드나요? 아니요. 어떤 것도 그렇게 만들 수 없습니다. 왜냐하면 ASD는 어떤 도구도 인증하지 않기 때문입니다. 기본 모드(Default mode)는 실용적입니다: 구조적 규칙 + 사용자의 도메인 어휘(domain vocabulary). 엄격 모드(Strict mode)는 그에 근접합니다. 단어 수준의 판정 기준은 공식 표준에 있으며, 이는 무료 다운로드가 가능합니다.

내 문서가 로봇처럼 들릴까요? 에어버스(Airbus) 매뉴얼처럼 들릴 것입니다: 단조롭고 오독(misread)이 불가능한 방식입니다. 문서를 작성하는 데 있어서는 그것이 핵심입니다. 여러분의 블로그를 위해서는 여러분만의 목소리를 유지하세요. ✍️

왜 그냥 "명확하게 작성해줘"라고 프롬프트(prompt)를 입력하지 않나요? "명확함"은 의견입니다. "20단어를 넘는 문장은 작성하지 말 것"은 사양(spec)입니다. 에이전트(Agents)는 사양을 따릅니다. 📐

왜 40년 된 항공우주 표준을 사용하나요? 그것이 단순한 느낌(vibes)이 아니기 때문입니다. 이 표준은 유지 관리되고 있으며(Issue 9, 2025년 1월), 번호가 매겨져 있고, 테스트 가능합니다. 그리고 이것은 우연히도 모든 AI 글쓰기 특징(AI writing tell)의 거의 완벽한 부정(negative)이 됩니다.

⚖️ 라이선스 및 상태

이곳의 모든 항목에는 MIT 라이선스가 적용됩니다. 이 리포지토리(repo)는 교육을 위해 규칙을 의역(paraphrase)했을 뿐이며, 사양(spec) 텍스트나 사전 콘텐츠를 전혀 재현하지 않습니다. 비공식 프로젝트이며, ASD 또는 STEMG와 제휴하거나 승인받지 않았습니다. ASD-STE100은 ASD의 등록 상표입니다.