← Commit history

Initial commit: skill/prose-style

Ray ·2d25b9ad44 ·2mo ago
2 files changed +86
README.mdadded+33
@@ -0,0 +1,33 @@+# Prose Style (Adom House Style)++The house standard for every piece of copy Adom ships: wiki pages, README files,+release notes, chat announcements, UI strings, component descriptions. A lot of it+is drafted by an AI and reads that way. This skill is how we fix that. The goal is+plain: it should read like a person wrote it.++Two things give AI writing away, and the skill kills both:++1. **Em-dashes.** Do not use them. A comma, colon, or period always works.+2. **The AI dialect** of favorite words <!-- prose-lint-disable -->(delve, seamless, robust, leverage) and+   sentence shapes ("it's not just X, it's Y", "in today's world").<!-- prose-lint-enable --> Rewrite them+   into plain statements.++Read `SKILL.md` for the full ruleset, the swap tables, and how to rewrite the+cadence. The deterministic enforcement lives in the companion `prose-lint` CLI.++## Install++```+adom-wiki install adom/prose-style+```++Ships in `adom/core`, so a standard Adom workstation already has it, and it pulls+`adom/prose-lint` as a dependency.++## Use it++Read it before writing any user-facing copy, then check the result:++```+prose-lint README.md+```
page.jsonadded+53
@@ -0,0 +1,53 @@+{+  "slug": "prose-style",+  "title": "Prose Style (Adom House Style)",+  "type": "skill",+  "version": "0.1.0",+  "description": "The Adom house writing style. Apply to ALL user-facing copy you write: NO em-dashes (use a comma, colon, or period), and cut the tics that make text read as AI-generated (delve, seamless, robust, leverage, 'it's not just X, it's Y', 'in today's world'). Write plainly, like a person. Read before writing any README, wiki page, release note, chat message, UI string, or docs.",+  "tags": [+    "skill",+    "writing",+    "house-style",+    "copy"+  ],+  "dependencies": {+    "adom/prose-lint": "^0.1.0"+  },+  "discovery_triggers": [+    "write the readme",+    "write release notes",+    "write the wiki page",+    "draft an announcement",+    "make this sound less AI",+    "remove em-dashes",+    "house style",+    "does this read as AI-written"+  ],+  "discovery_pitch": "Read before writing any user-facing copy so it sounds like a person, not a model: no em-dashes, no AI-tells.",+  "sample_prompts": [+    {+      "label": "Write a README",+      "prompt": "write the README for this tool"+    },+    {+      "label": "De-AI a draft",+      "prompt": "this reads AI-generated, rewrite it in our house style"+    }+  ],+  "scripts": {+    "install": "./install.sh",+    "uninstall": "./uninstall.sh"+  },+  "hero": {+    "type": "billboard",+    "headline": "Adom House Style",+    "subhead": "No em-dashes. No AI slop. Write like a person.",+    "screenshot": "docs/hero.png"+  },+  "visibility": "public",+  "org": "adom",+  "author": {+    "name": "Ray",+    "email": "[email protected]"+  }+}\ No newline at end of file