Skip to content

The open-source app everyone uses to manage agents at work

feat(skills-catalog): add optional /simplified-english skill (#10410)

Dottaefe8b3b70753
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",