AminBlg/SimpleEnglish

SimpleEnglish – 平易な英語のLLM出力を実現するAgent Skill

機能概要

• 大規模言語モデルが、航空宇宙マニュアルで使用される制御言語であるASD-STE100簡易化テクニカル英語のスタイルで回答を書き換えるようにするプラグイン（スキルと呼ばれる）を提供します。
• 2つの出力モード：
  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ダッシュ、太字、見出し、箇条書き）が95%減少と報告されています。
• STE-linter違反は、バージョン2.0.1で（スキルなしの）100語あたり4.09から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搭載コーディングアシスタントを使用し、非技術スタッフが簡単に読める出力を必要とするすべての人。