/de-ai-flavor

name: de-ai-flavor
description: "Remove AI artifacts from documents. Use when: cleaning AI-generated text, removing tool names, fixing boilerplate patterns. Not for: doc review (use doc-review), doc refactoring (use doc-refactor). Output: cleaned document preserving original intent."
allowed-tools: Read, Grep, Glob, Edit

De-AI-Flavor Skill

Trigger

• Keywords: de-ai, remove AI traces, humanize document, de-ai-flavor, humanize

When NOT to Use

• Co-Authored-By in CHANGELOG (Git convention)
• Documents discussing AI technology (topic itself requires it)
• Quoting others' AI-related content
• Variable/function names in code

Usage

/de-ai-flavor docs/xxx.md           # Process specified file
/de-ai-flavor docs/                 # Process all .md in directory
/de-ai-flavor                       # Process .md in git diff

Detection Rules

| Type | Pattern | Action | | ----------------- | --------------------------------------------------- | ------- | | Tool names | Claude/Codex/GPT/AI assistant | Remove | | Boilerplate | "Let me...", "First...then...", "In conclusion" | Rewrite | | Over-structuring | One sentence per heading, too many #### levels | Simplify| | Service tone | "Hope this helps", "If you have questions..." | Remove | | Self-description | "Next I will...", "I will proceed to..." | Remove | | Iteration leaks | "Round 1/Round 2/Round N" | Rewrite |

Workflow

Scan file -> Mark AI traces -> Remove/Rewrite/Simplify -> Output summary

Verification

• All tool names removed
• Boilerplate rewritten to natural tone
• Structure not overly flat or nested

Output Format

## De-AI-Flavor Results

**File**: `docs/xxx.md`

| Line | Original              | Change                  | Reason           |
| ---- | --------------------- | ----------------------- | ---------------- |
| 15   | Let me explain...     | Removed                 | AI self-description |
| 32   | Claude suggests...    | Changed to "Suggest..." | Tool name        |

**Stats**: Removed 3 tool names | Rewrote 5 boilerplate | Simplified 2 structures

Examples

Input: /de-ai-flavor docs/tech-spec.md
Action: Scan -> Remove "Claude suggests" -> Rewrite "Let me explain" -> Output summary

Input: This document feels very AI-generated, please clean it up
Action: Detect git diff -> Mark AI traces -> Batch process -> Output stats