Agent skill
de-ai-flavor
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.
Install this agent skill to your Project
npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/de-ai-flavor
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
runbook
Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).
ask
Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.
project-brief
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
codex-test-gen
Generate unit tests for specified functions using Codex MCP
bug-fix
Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.
skill-health-check
Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.
Didn't find tool you were looking for?