docwriter-org/plain-writing-skill

A plain-language writing skill for AI agents, with a revision view that shows what changed.

What it solves

It prevents AI agents from producing "slop"—text that is overly complex, assumes too much context, or uses unexplained technical terms—by enforcing a plain writing style.

How it works

The project provides a set of plain-text rules and steps (contained in a markdown file) that can be integrated into an AI agent's system prompt or rules file. The agent follows these guidelines to write and revise text, and it can specifically be triggered via a /plain-writing deslopify command to rewrite previous responses for clarity and conciseness.

Who it’s for

Users of AI agents (such as Claude Code, Codex, or pi) who want their AI-generated content to be clear, professional, and accessible to readers without deep project context, such as executives.

Highlights

  • Agent-agnostic: Works with any agent that can read a markdown file or accept system instructions.
  • Self-correcting: The skill includes instructions for the agent to check its own writing and remove unnecessary content.
  • "Deslopify" command: A dedicated command to rewrite unclear or overly technical responses into a clear structure.
  • Evaluation suite: Includes optional evaluation tools to measure the effectiveness of the writing skill.

Related

  • Project
    danyuchn/asd-ste100-skill

    A Claude Code skill that rewrites English into Simplified Technical English (ASD‑STE100) to make agent‑to‑agent messages unambiguous. It flags structural STE violations, offers strict and relaxed modes, and can show diffs or rule explanations. Install via `npx skills` or by cloning, then ask it to simplify tool descriptions, error messages, or prompts. MIT‑licensed.

  • Project
    petergyang/no-ai-slop

    A tool that removes over 20 common patterns of generic AI-generated writing to help authors maintain a personal, human voice in their AI-assisted drafts.

  • Project
    miqdadbadjuber/anti-slop

    anti‑slop is a rule‑based filter for AI coding assistants that strips generic UI fluff, hype‑filled copy, and unnecessary code comments. It provides 38 mandatory rules, a delivery‑gate report, and optional skill modules (UI, copy, accessibility, etc.). Install via `npx antislop-ai` or as a plugin for agents like Claude Code, Cursor, or Codex. Use it during generation or to audit existing output, then add your own `DESIGN.md` for real design direction.

  • Project
    yzhao062/agent-style

    A collection of 21 writing rules and a CLI tool that integrates into AI agents to improve the quality, clarity, and professional tone of generated technical prose.

  • Project
    KKKKhazix/khazix-skills

    A collection of structured instruction sets for AI agents that provide specialized workflows for goal setting, disk cleanup, research, and writing, following the Agent Skills open standard.