de-slopify
Removes AI writing artifacts from documentation and code. Use when editing LLM-generated prose, reviewing READMEs, polishing docs before publishing, or cleaning up AI-generated code. Use for emdash cleanup, formulaic phrase removal, tone calibration, over-commented code, verbose naming, and AI code smell detection.
- Installs
- 137
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/oakoss/agent-skills --skill de-slopify- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads de-slopify automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
De-Slopify
Overview
De-slopify is a methodology for removing telltale signs of AI-generated content from documentation, prose, and code. LLMs produce statistically regular output with characteristic vocabulary, punctuation habits, and structural patterns that make text and code feel inauthentic. Some patterns appear over 1,000x more frequently in LLM output than human writing.
When to use: Before publishing READMEs, after AI-assisted writing sessions, during documentation reviews, when reviewing AI-generated code for over-engineering, before committing prose or code that an LLM touched.
When NOT to use: On code logic or algorithms where correctness matters more than style. On technical specifications where precision outweighs voice. On content that was already human-written and reads naturally.
Quick Reference
| Category | Pattern | Fix |
|---|---|---|
| Punctuation | Emdash overuse | Semicolons, commas, colons, or split into two sentences |
| Phrase | "Here's why" / "Here's why it matters" | Explain why directly without the lead-in |
| Phrase | "It's not X, it's Y" | "This is Y" or restate the distinction |
| Phrase | "Let's dive in" / "Let's get started" | Delete; just start the content |
| Phrase | "It's worth noting" / "Keep in mind" | Delete the hedge; state the fact |
| Phrase | "At its core" / "In essence" / "Fundamentally" | Delete; say the thing directly |
| Vocabulary | "delve", "tapestry", "landscape", "nuanced" | Replace with plain, specific language |
| Vocabulary | "revolutionize", "cutting-edge", "game-changer" | Replace with concrete claims or delete |
| Structure | Uniform sentence length throughout | Mix short (5-word) and long (20+ word) sentences |
| Structure | Perfectly balanced lists of exactly 3 items | Vary list length; humans use 2, 4, or odd counts |
| Structure | Generic claims without specifics | Add names, dates, numbers, or first-person detail |
| Sycophancy | "Great question!" / "Absolutely!" | Delete; answer the question directly |
| Meta | "Let me break this down..." / "Let me explain" | Delete the preamble; just break it down |
| Structure | Numbered lists where a sentence suffices | Use a sentence; reserve lists for genuinely parallel items |
| Closer | "In conclusion" / "To summarize" | Delete or replace with a specific takeaway |
| Code | Over-commented trivial functions | Remove comments that restate the code |
| Code | Unnecessary abstractions and design patterns | Flatten to the simplest working solution |
| Code | Verbose or overly descriptive variable names | Use domain-appropriate concise names |
| Code | Defensive error handling on every operation | Handle errors only where failure is realistic |
Common Mistakes
| Mistake | Correct Pattern |
|---|---|
| Replacing every emdash mechanically | Evaluate context; sometimes an emdash is the right choice |
| Editing code blocks for style | Focus on prose; leave code examples and technical syntax untouched |
| Removing all structure to sound casual | Keep headers, tables, and lists intact; rewrite prose only |
| Over-correcting into choppy fragments | Read aloud after editing; recombine sentences that lost flow |
| Applying fixes without defining target voice | Set persona, tone, and audience before starting edits |
| Running regex replacements instead of reading | Manual line-by-line review is required; context determines fixes |
| Ignoring AI code smells | Review AI-generated code for over-engineering, verbose names, and unnecessary abstractions |
| Removing all LLM-typical words unconditionally | Some flagged words are perfectly natural in context; use judgment |
Delegation
- Scan a repository for documentation files that need de-slopifying: Use
Exploreagent - Rewrite an entire documentation site to remove AI artifacts: Use
Taskagent - Plan a documentation voice guide and editorial workflow: Use
Planagent - Review AI-generated code for slop patterns: Use
code-revieweragent
For systematic quality auditing across 12 dimensions (architecture, security, testing, performance, etc.), use the
quality-auditorskill.
References
- Prose patterns: emdash alternatives, phrase replacements, and voice calibration
- Before-and-after examples of common AI writing fixes
- AI slop vocabulary: words and phrases that signal LLM authorship
- Code slop: detecting and fixing AI-generated code smells
- Review workflow: prompts, checklists, and integration
FAQ
What does the de-slopify skill do?
Removes AI writing artifacts from documentation and code. Use when editing LLM-generated prose, reviewing READMEs, polishing docs before publishing, or cleaning up AI-generated code. Use for emdash cleanup, formulaic phrase removal, tone calibration, over-commented code, verbose naming, and AI code smell detection.
How do I install de-slopify?
Run npx skills add https://github.com/oakoss/agent-skills --skill de-slopify in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/de-slopify/ (personal) or .claude/skills/de-slopify/ (project).
Which AI agents can use de-slopify?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is de-slopify safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains de-slopify?
It is published by oakoss in oakoss/agent-skills. It has 137 recorded installs.
More from oakoss/agent-skills
ui-ux-polish
oakoss/agent-skills
Iterative UI/UX polishing workflow for web applications. Use when improving visual polish, refining desktop and mobile UX separately, running iterative enhancement cycles, applying design patterns like glassmorphism or bento grids, or auditing accessibility and WCAG compliance. Use for Stripe-level visual quality, responsive optimization, and design system alignment.
playwright
oakoss/agent-skills
Playwright browser automation API, web scraping, and tooling. Covers locator strategies, assertions, API testing, stealth mode, anti-bot bypass, authenticated sessions, screenshots/PDFs, Docker deployment, configuration, debugging, and MCP integration with AI agents. Prevents documented errors including CI timeout hangs, extension testing failures, and navigation issues. Use when automating browsers, scraping protected sites, bypassing bot detection, generating screenshots/PDFs, configuring Playwright Test, troubleshooting Playwright errors, or learning Playwright API patterns. For E2E test architecture, Page Object Models, CI sharding strategies, or test organization patterns, use the e2e-testing skill instead.
coolify
oakoss/agent-skills
Coolify self-hosted PaaS for deploying applications, databases, and services via REST API and Git integration. Covers API authentication, deployment triggers, build packs (Nixpacks, Dockerfile, Compose), CI/CD with GitHub Actions webhooks, environment management, and Traefik proxy configuration. Use when deploying apps to Coolify, triggering deployments via API, configuring build packs, setting up GitHub Actions CI/CD pipelines, managing environment variables, or troubleshooting deployment failures.
application-security
oakoss/agent-skills
Application security covering threat modeling (STRIDE), OWASP Top 10 (2025), OWASP API Security Top 10 (2023), secure coding review, authentication/authorization patterns, input validation, encryption, security headers, supply chain security, compliance (GDPR/HIPAA/SOC2/PCI-DSS), and security monitoring. Use when reviewing code for vulnerabilities, implementing auth patterns, securing APIs, configuring security headers, hardening supply chain, preventing injection attacks, or preparing for compliance audits.
find-skills
oakoss/agent-skills
Discovers and installs agent skills from the open ecosystem. Enriches search results with descriptions fetched from skills.sh. Use when a user asks "how do I do X", "find a skill for X", "is there a skill that can...", or wants to extend agent capabilities. Use for skill discovery, skill search, skill install, finding tools.
drizzle-orm
oakoss/agent-skills
Drizzle ORM for type-safe SQL with PostgreSQL, MySQL, and SQLite. Use when defining schemas, writing queries, managing relations, running migrations, or using drizzle-kit. Use for drizzle, orm, schema, query, migration, pgTable, relations, drizzle-kit, drizzle-zod.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.