From 7065e4edff7c96f750c728cf684caaf16c712757 Mon Sep 17 00:00:00 2001 From: Charlie Kolb Date: Fri, 14 Aug 2026 11:06:28 +0000 Subject: [PATCH] docs: Instruct ASD-STE100 writing style in shared agent skills (no-changelog) (#36302) Co-authored-by: Claude Fable 5 --- .agents/skills/content-design/SKILL.md | 4 ++++ .agents/skills/conventions/SKILL.md | 4 ++++ .agents/skills/create-pr/SKILL.md | 3 +++ 3 files changed, 11 insertions(+) diff --git a/.agents/skills/content-design/SKILL.md b/.agents/skills/content-design/SKILL.md index 60a7ff461f0..c0fc03c01d2 100644 --- a/.agents/skills/content-design/SKILL.md +++ b/.agents/skills/content-design/SKILL.md @@ -111,6 +111,10 @@ When suggesting new keys, follow the existing hierarchy. Browse nearby keys in ### Language and grammar +**ASD-STE100 Simplified Technical English.** Use short sentences, the active +voice, and one instruction for each sentence. Use one approved word for each +meaning. + **US English.** Always. No exceptions. - Do: "categorizing", "color", "analyze" - Don't: "categorising", "colour", "analyse" diff --git a/.agents/skills/conventions/SKILL.md b/.agents/skills/conventions/SKILL.md index 05e36bcb0dc..aab9baa7be7 100644 --- a/.agents/skills/conventions/SKILL.md +++ b/.agents/skills/conventions/SKILL.md @@ -13,6 +13,10 @@ Use this skill when you need quick reminders on critical patterns. ## Critical Rules (Must Follow) +**Technical writing (comments, PRs, issues, docs):** +- Write in ASD-STE100 Simplified Technical English: short sentences, the + active voice, one instruction for each sentence + **TypeScript:** - Never `any` → use `unknown` - Prefer `satisfies` over `as` (except tests) diff --git a/.agents/skills/create-pr/SKILL.md b/.agents/skills/create-pr/SKILL.md index 8bd922099b7..d276cbc44d2 100644 --- a/.agents/skills/create-pr/SKILL.md +++ b/.agents/skills/create-pr/SKILL.md @@ -93,6 +93,9 @@ Creates GitHub PRs with titles that pass n8n's `check-pr-title` CI validation. Based on `.github/pull_request_template.md`: +Write the PR body in ASD-STE100 Simplified Technical English: use short +sentences, the active voice, and one instruction for each sentence. + ### Summary Section - Describe what the PR does - Include screenshots/videos for UI changes