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