Agent Skill to Force Docs in ASD-STE100 Simplified Technical English AminBlg / SimpleEnglish Public Notifications You must be signed in to change notification settings Fork 8 Star 380 mainBranchesTag
By Coderz Club · 2026-07-31 · Tags: tech, git
Agent Skill to Force Docs in ASD-STE100 Simplified Technical English
AminBlg / SimpleEnglish Public Notifications You must be signed in to change notification settings Fork 8 Star 380 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History9 Commits9 Commitsevalsevals examplesexamples promptsprompts skills/simple-englishskills/simple-english .gitignore.gitignore LICENSELICENSE README.mdREADME.md View all filesRepository files navigation ✈️ your AI writes like a LinkedIn post. make it write like a Boeing manual. An agent skill that forces LLMs to write docs in ASD-STE100 Simplified Technical English: the controlled language aerospace has used since 1983 so a tired mechanic cannot misread an instruction. AI slop dies as a side effect. 💀 See it · Install · The rules · Not just docs · Receipts · FAQ Works in every harness that speaks the Agent Skills standard: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode, and ~25 more. One folder, no dependencies, MIT. 🔥 Before / after Left column is real unedited Claude output. Right column is the same model with the skill loaded. 🤖 Without skill ✈️ With skill Leveraging sqlpipe's robust architecture, users can seamlessly synchronize their Postgres tables to S3 with minimal configuration overhead. Before getting started, you should ensure that your AWS credentials have been properly configured — this is crucial for avoiding frustrating permission issues down the line. sqlpipe copies your Postgres tables to S3. It needs one configuration file. Before you start, make sure that your AWS credentials are correct. If they are not, S3 rejects the upload with a permission error. Oops! Something went wrong while attempting to establish a connection. Please ensure your credentials have been properly configured and try again, or reach out to your administrator if the issue persists. Connection to the database failed: the password for user app was not correct. Set DB_PASSWORD to the correct value, then connect again. We have identified an issue that may have impacted some users' ability to access the service. We sincerely apologize for any inconvenience this may have caused. Between 14:02 and 14:31 UTC, 12% of requests failed. A deploy at 14:00 removed the cache warmup step. We reverted it at 14:27. ┌── measured: 6 Claude models × 8 tasks × 2 conditions, 96 runs ──┐ │ STE violations per 100 words ▼ 72.9% (every model won) │ │ output tokens ▼ on all 6 models │ │ mean sentence length 11.2 → 9.7 words │ │ "seamlessly" survived 0 │ └─────────────────────────────────────────────────────────────────┘ More rewrites in examples/before-after.md: READMEs, error messages, incident reports, release notes. 📦 Install npx skills add AminBlg/SimpleEnglish That is it. The skills CLI detects your agents (Claude Code, Cursor, Codex, Copilot, Gemini CLI, and more) and installs for the ones you pick. Try before installing: npx skills use AminBlg/SimpleEnglish@simple-english No SKILL.md support at all? Paste prompts/system-prompt.md into your system prompt, AGENTS.md, or .cursorrules. There is even a ~60-token version for tight budgets. Then ask for any technical writing, or say: "rewrite this with simple-english". 🖱️ No terminal? (claude.ai, ChatGPT, Gemini) Claude.ai (paid plans) supports skills natively: Download the skill file: open SKILL.md and save it (Ctrl+S / Cmd+S). In claude.ai, go to Settings → Capabilities and turn on code execution. Go to Settings → Customize → Skills → Upload and upload the saved SKILL.md. Toggle the skill on. Done. Claude applies it when you ask for technical writing. ChatGPT: no skill support, so use the prompt version. Copy the block from prompts/system-prompt.md into Settings → Personalization → Custom Instructions, or into the instructions of a Project or Custom GPT. Gemini: create a Gem and paste the same block into its instructions. Any other chatbot: attach or paste prompts/system-prompt.md into the chat and say "apply this to everything you write for me". 📏 The rules 53 numbered rules, 9 sections, written in 1983 by people whose readers die when a sentence is ambiguous. The ones doing the heavy lifting: Rule What it kills 🪦 Max 20 words per instruction, 25 per description The run-on sentence One word = one meaning, whole document check/verify/confirm/validate roulette Simple tenses only "has been updated" → "we updated" No "-ing" verb forms ", making it easy to..." clauses Active voice "it should be noted that" No should/would/may/might Hedging. (can, will, must survive) Condition BEFORE command Trailing "...if the flag is set" that readers execute too late One instruction per sentence Steps nobody can follow at 2 a.m. Keep articles, keep "that" Telegraph style. STE is short, not terse Full paraphrased set with software examples: SKILL.md. Yes, this README breaks half of them. Marketing is explicitly out of STE scope. The skill knows that and stays in t
AminBlg / SimpleEnglish Public Notifications You must be signed in to change notification settings Fork 8 Star 380 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History9 Commits9 Commitsevalsevals examplesexamples promptsprompts skills/simple-englishskills/simple-english .gitignore.gitignore LICENSELICENSE README.mdREADME.md View all filesRepository files navigation ✈️ your AI writes like a LinkedIn post. make it write like a Boeing manual. An agent skill that forces LLMs to write docs in ASD-STE100 Simplified Technical English: the controlled language aerospace has used since 1983 so a tired mechanic cannot misread an instruction. AI slop dies as a side effect. 💀 See it · Install · The rules · Not just docs · Receipts · FAQ Works in every harness that speaks the Agent Skills standard: Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode, and ~25 more. One folder, no dependencies, MIT. 🔥 Before / after Left column is real unedited Claude output. Right column is the same model with the skill loaded. 🤖 Without skill ✈️ With skill Leveraging sqlpipe's robust architecture, users can seamlessly synchronize their Postgres tables to S3 with minimal configuration overhead. Before getting started, you should ensure that your AWS credentials have been properly configured — this is crucial for avoiding frustrating permission issues down the line. sqlpipe copies your Postgres tables to S3. It needs one configuration file. Before you start, make sure that your AWS credentials are correct. If they are not, S3 rejects the upload with a permission error. Oops! Something went wrong while attempting to establish a connection. Please ensure your credentials have been properly configured and try again, or reach out to your administrator if the issue persists. Connection to the database failed: the password for user app was not correct. Set DB_PASSWORD to the correct value, then connect again. We have identified an issue that may have impacted some users' ability to access the service. We sincerely apologize for any inconvenience this may have caused. Between 14:02 and 14:31 UTC, 12% of requests failed. A deploy at 14:00 removed the cache warmup step. We reverted it at 14:27. ┌── measured: 6 Claude models × 8 tasks × 2 conditions, 96 runs ──┐ │ STE violations per 100 words ▼ 72.9% (every model won) │ │ output tokens ▼ on all 6 models │ │ mean sentence length 11.2 → 9.7 words │ │ "seamlessly" survived 0 │ └─────────────────────────────────────────────────────────────────┘ More rewrites in examples/before-after.md: READMEs, error messages, incident reports, release notes. 📦 Install npx skills add AminBlg/SimpleEnglish That is it. The skills CLI detects your agents (Claude Code, Cursor, Codex, Copilot, Gemini CLI, and more) and installs for the ones you pick. Try before installing: npx skills use AminBlg/SimpleEnglish@simple-english No SKILL.md support at all? Paste prompts/system-prompt.md into your system prompt, AGENTS.md, or .cursorrules. There is even a ~60-token version for tight budgets. Then ask for any technical writing, or say: "rewrite this with simple-english". 🖱️ No terminal? (claude.ai, ChatGPT, Gemini) Claude.ai (paid plans) supports skills natively: Download the skill file: open SKILL.md and save it (Ctrl+S / Cmd+S). In claude.ai, go to Settings → Capabilities and turn on code execution. Go to Settings → Customize → Skills → Upload and upload the saved SKILL.md. Toggle the skill on. Done. Claude applies it when you ask for technical writing. ChatGPT: no skill support, so use the prompt version. Copy the block from prompts/system-prompt.md into Settings → Personalization → Custom Instructions, or into the instructions of a Project or Custom GPT. Gemini: create a Gem and paste the same block into its instructions. Any other chatbot: attach or paste prompts/system-prompt.md into the chat and say "apply this to everything you write for me". 📏 The rules 53 numbered rules, 9 sections, written in 1983 by people whose readers die when a sentence is ambiguous. The ones doing the heavy lifting: Rule What it kills 🪦 Max 20 words per instruction, 25 per description The run-on sentence One word = one meaning, whole document check/verify/confirm/validate roulette Simple tenses only "has been updated" → "we updated" No "-ing" verb forms ", making it easy to..." clauses Active voice "it should be noted that" No should/would/may/might Hedging. (can, will, must survive) Condition BEFORE command Trailing "...if the flag is set" that readers execute too late One instruction per sentence Steps nobody can follow at 2 a.m. Keep articles, keep "that" Telegraph style. STE is short, not terse Full paraphrased set with software examples: SKILL.md. Yes, this README breaks half of them. Marketing is explicitly out of STE scope. The skill knows that and stays in t