From 3fe4ec0947b853a1335c51b91d33db73941e1035 Mon Sep 17 00:00:00 2001
From: james <li@jamesdeMacBook-Pro.local>
Date: Sat, 6 Jun 2026 20:38:35 -0700
Subject: [PATCH] feat: add _WRITING skill stub (rewrite + detect modes)

AI_WRITING_PATTERNS.md references a `_WRITING` skill that reads the
file as its rule source, but no such skill shipped in v5.0.0.

Add a minimal `_WRITING/SKILL.md` with:
- rewrite mode: strips AI-isms (P0 silently, P1/P2 with change log)
- detect mode: audits text and returns scored hit list by P-level
- Usage examples and P2 customization guidance

Closes #1304
---
 .../v5.0.0/.claude/skills/_WRITING/SKILL.md   | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 Releases/v5.0.0/.claude/skills/_WRITING/SKILL.md

diff --git a/Releases/v5.0.0/.claude/skills/_WRITING/SKILL.md b/Releases/v5.0.0/.claude/skills/_WRITING/SKILL.md
new file mode 100644
index 000000000..2b1302930
--- /dev/null
+++ b/Releases/v5.0.0/.claude/skills/_WRITING/SKILL.md
@@ -0,0 +1,65 @@
+---
+name: _WRITING
+description: "Two-mode AI writing pattern tool that uses AI_WRITING_PATTERNS.md as its rule source. rewrite mode: strips AI-isms from a given text (P0 credibility killers removed silently, P1/P2 surfaced as candidates with brief reason). detect mode: audits text and returns a scored list of pattern hits (P-level, pattern, excerpt, suggested fix). Invoke as: /writing rewrite <text or @file> or /writing detect <text or @file>. User-instantiated skill — extend with patterns from your own AI_WRITING_PATTERNS.md P2 section. USE WHEN: polish text for AI tells, rewrite AI-generated prose, detect AI writing patterns, scrub AI-isms, check writing for AI smell, writing audit, writing cleanup."
+---
+
+# _WRITING — AI Writing Pattern Cleaner
+
+Reads `~/.claude/PAI/USER/AI_WRITING_PATTERNS.md` as its rule source and operates in two modes.
+
+## Modes
+
+### `rewrite` — strip AI patterns from text
+
+**Input**: raw text (inline or via `@file`)
+
+**Workflow**:
+1. Load patterns from `AI_WRITING_PATTERNS.md` (P0, P1, P2 sections).
+2. Apply P0 (credibility killers) silently — remove without comment.
+3. For P1/P2 hits, propose the rewrite and state the pattern triggered.
+4. Output the cleaned text followed by a brief change log.
+
+**Output format**:
+```
+[Rewritten text]
+
+---
+Changes made:
+- Removed "Let me know if..." (P0)
+- Replaced "Here's the thing..." → "[rewritten phrase]" (P1)
+```
+
+### `detect` — audit text for AI tells
+
+**Input**: raw text (inline or via `@file`)
+
+**Workflow**:
+1. Load patterns from `AI_WRITING_PATTERNS.md`.
+2. Scan the text for each pattern by P-level.
+3. Return a scored hit list.
+
+**Output format**:
+```
+Pattern audit — 3 hits
+
+P0  "Let me know if you need anything else."  → Remove entirely
+P1  "Here's the thing:"                       → Cut or recast
+P2  [user-defined pattern]                    → [user-defined guidance]
+
+Overall AI-smell score: HIGH / MEDIUM / LOW / CLEAN
+```
+
+## Usage
+
+```
+/writing rewrite <text>
+/writing rewrite @path/to/file.md
+/writing detect <text>
+/writing detect @path/to/file.md
+```
+
+## Customization
+
+Add your own patterns to the **P2 section** of `~/.claude/PAI/USER/AI_WRITING_PATTERNS.md`. This skill reads that file on every invocation, so changes take effect immediately without restarting.
+
+The `_` prefix means this skill is user-instantiated — it ships as a starting point. Extend the P2 section with patterns specific to your voice and writing style.