diff --git a/packages/skills-catalog/catalog/optional/content/simplified-english/SKILL.md b/packages/skills-catalog/catalog/optional/content/simplified-english/SKILL.md new file mode 100644 index 0000000000..5cc7bbeb92 --- /dev/null +++ b/packages/skills-catalog/catalog/optional/content/simplified-english/SKILL.md @@ -0,0 +1,40 @@ +--- +name: simplified-english +description: Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time. +key: paperclipai/optional/content/simplified-english +recommendedForRoles: + - engineer + - product + - writer + - devrel +tags: + - writing + - communication + - clarity + - style +--- + +# Simplified English + +For user-facing comments, plans, and documents, write using only ASD-STE100 Simplified Technical English. + +## Core rules + +- Use short sentences (procedures ≤ 20 words, descriptions ≤ 25 words). +- Give one instruction per sentence. +- Use approved words with one meaning each; avoid synonyms and jargon. +- Use the active voice and the present tense. +- Use articles ("the", "a") and do not drop words to save space. +- Write positive instructions; avoid negative or vague qualifiers. +- Keep paragraphs to one topic. + +## Approved words + +The approved words are the ASD-STE100 controlled vocabulary — the Dictionary in the current ASD-STE100 specification, plus the technical names and technical verbs that your subject needs. When a word is not approved, use the simplest common word that has one meaning. Prefer these house choices: + +- "start" / "stop" (not "initiate", "commence", "terminate", "kill") +- "make" (not "implement", "leverage", "utilize") +- "before" / "after" (not "prior to", "subsequent to") +- "about" (not "regarding", "in relation to") +- "help" (not "facilitate") +- "use" (not "utilize", "employ") diff --git a/packages/skills-catalog/generated/catalog.json b/packages/skills-catalog/generated/catalog.json index 8f423e1dd8..9456225a9e 100644 --- a/packages/skills-catalog/generated/catalog.json +++ b/packages/skills-catalog/generated/catalog.json @@ -2,7 +2,7 @@ "schemaVersion": 1, "packageName": "@paperclipai/skills-catalog", "packageVersion": "0.3.1", - "generatedAt": "2026-07-24T18:19:49.696Z", + "generatedAt": "2026-07-28T22:35:25.645Z", "skills": [ { "id": "paperclipai:bundled:docs:doc-maintenance", @@ -485,6 +485,42 @@ ], "contentHash": "sha256:efe8ea89b552df95222609867c9c75f1b40e16f457d34e7e4a124f54daa33efa" }, + { + "id": "paperclipai:optional:content:simplified-english", + "key": "paperclipai/optional/content/simplified-english", + "kind": "optional", + "category": "content", + "slug": "simplified-english", + "name": "simplified-english", + "description": "Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time.", + "path": "catalog/optional/content/simplified-english", + "entrypoint": "SKILL.md", + "trustLevel": "markdown_only", + "compatibility": "compatible", + "defaultInstall": false, + "recommendedForRoles": [ + "engineer", + "product", + "writer", + "devrel" + ], + "requires": [], + "tags": [ + "writing", + "communication", + "clarity", + "style" + ], + "files": [ + { + "path": "SKILL.md", + "kind": "skill", + "sizeBytes": 1578, + "sha256": "a0f7385599873910e2fabf400346016a07dacbc7ece27c0e3616ae8fd94ebfbb" + } + ], + "contentHash": "sha256:642321f40d51e0125df05c6fbace49aeb07ec30392058756909c259c9c5eac6a" + }, { "id": "paperclipai:optional:finance:ramp", "key": "paperclipai/optional/finance/ramp", diff --git a/packages/skills-catalog/src/shipped-catalog.test.ts b/packages/skills-catalog/src/shipped-catalog.test.ts index 99c6dd4d5d..2c9211f695 100644 --- a/packages/skills-catalog/src/shipped-catalog.test.ts +++ b/packages/skills-catalog/src/shipped-catalog.test.ts @@ -20,6 +20,7 @@ const EXPECTED_BUNDLED_KEYS = [ const EXPECTED_OPTIONAL_KEYS = [ "paperclipai/optional/browser/agent-browser", "paperclipai/optional/content/release-announcement", + "paperclipai/optional/content/simplified-english", "paperclipai/optional/finance/ramp", "paperclipai/optional/product/design-critique", "paperclipai/optional/research/last30days",