plain-writing

Rewrites prose in a plain style with simple words, complete sentences, and no jargon.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill plain-writing-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plain-writing
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/plain-writing
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill plain-writing-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated and everyday prose often contains jargon, filler, dashes, analogies, and vague phrasing that make text hard to read. This Skill enforces a concrete set of plain-writing rules so any prose you draft or revise reads clearly on the first pass. ## Core Features & Use Cases - Rule-based revision: Applies 26 explicit rules covering word choice, sentence structure, punctuation, and patterns to avoid, each with before-and-after examples. - Deslopify command: Rewrites an agent response into a clear structure for a sharp CEO or technical reader with no project context, leading with the conclusion and covering background, tradeoffs, and risks. - Use Case: You draft a README, proposal, or PR description and ask the agent to tighten it. The Skill rewrites it with simple everyday words, complete sentences, no dashes, and full explanations, while leaving code untouched. ## Quick Start Ask the agent to rewrite your draft using the plain-writing skill, or invoke "/plain-writing deslopify" on a previous response.

Frequently Asked Questions about plain-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make AI-generated writing sound plainer and clearer?

Apply a fixed set of plain-writing rules: use simple everyday words, write complete sentences, cut filler and jargon, and avoid dashes, analogies, and rhetorical patterns. This Skill encodes 26 such rules with before-and-after examples and revises text in two passes.

How do I rewrite a verbose AI response for an executive reader?

Use the deslopify command, which rewrites the previous agent response for a sharp CEO or technical reader with no project context. It leads with the conclusion, then covers background, tradeoffs, options, evidence, risks, and unknowns in plain language.

What writing patterns does plain writing avoid?

It avoids jargon, puffery, em dashes, analogies, rhetorical questions, dramatic pivots, vague demonstrative pronouns, unattributed claims, and filler phrases. Each banned pattern has a concrete replacement rule, such as naming the source or stating the point directly.

Does plain writing apply to code or only to prose?

It applies only to prose written for the user, such as documents, summaries, and commit messages. Code itself is explicitly excluded, though the words around the code, like comments in explanations or PR descriptions, follow the rules.

When should I not use a plain writing style?

Skip it when the user explicitly requests a different style, such as marketing copy, academic register, or creative writing. The Skill defaults to plain style for prose but yields whenever the user asks for another voice.