skills.rest
mintuz
mintuzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

clarity

Draft, rewrite, and review prose to remove generic AI-style writing while preserving facts and author voice.

3|Updated Nov 8, 2014
Search Tags:#writing#editing#prose#review#authorship#rewrite#ai-slop
One-click install
npx skills add https://github.com/mintuz/.dotfiles --skill clarity-mintuz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clarity
Source: https://github.com/mintuz/.dotfiles/tree/main/agents/.agents/skills/clarity
Command: npx skills add https://github.com/mintuz/.dotfiles --skill clarity-mintuz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI-assisted writing often reads as fluent but hollow: no specific source, judgment, or experience behind it. This Skill fixes substance before style, ensuring prose carries a real point of view without inventing facts or performing fake humanness. ## Core Features & Use Cases - Four modes: interview (co-write from the author's own answers), rewrite (edit an existing draft), review (critique without changing files), and lint (diagnostic prose statistics with no composite score). - Fidelity safeguards: preserves facts, attributions, quotations, links, and uncertainty; marks missing specifics with [TK] questions instead of fabricating details. - Medium awareness: adapts rules for essays, documentation, academic papers, emails, UI text, talks, and fiction rather than applying blanket bans. - Use Case: Paste a generic AI-generated blog draft and ask for a rewrite; the Skill diagnoses missing substance first, then edits while keeping every claim grounded in the source. ## Quick Start Ask the agent to use the clarity skill in rewrite mode on your draft file, or say "/clarity review draft.md" to get a critique without modifying anything.

Frequently Asked Questions about clarity

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

FAQPage Schema
How do I rewrite an AI-generated draft to sound less generic?▼

Use rewrite mode on your draft file. The Skill diagnoses missing substance, wrong register, weak development, and surface patterning in that order, then edits while preserving every fact, attribution, and link from the original.

How does the interview mode work for writing from scratch?▼

Interview mode asks you to talk in one untidied take about your topic, reader, examples, and doubts before drafting anything. It builds the piece from your supplied language and marks gaps with [TK] questions instead of inventing details.

Can I get a critique without the tool changing my file?▼

Yes, review mode produces a piece-level diagnosis and line-by-line verdicts (keep, revise, ask-author, cut) without rewriting the draft or modifying any files. It distinguishes material errors from matters of taste.

Does this work for documentation and academic writing?▼

Yes, medium-specific rules preserve operational structure in docs, calibrated hedging in academic prose, and required notices in legal or safety text. Explicit user requirements and venue rules outrank the Skill's defaults.

Will this help my text pass AI detectors?▼

No, and it does not try to. The Skill explicitly refuses to optimize for detector scores or manufacture typos and slang; its goal is better writing with honest provenance, not evading detection.

Related Skills

Explore More Content & Communication Skills→
babuallybabually
1

writing-fragments

Collect raw writing fragments via interview and append them to a markdown document.

Community
Intermediate
mengblommengblom

every-style-editor

Audit prose against Every's grammar, punctuation, mechanics, and style guide standards.

Community
Intermediate
Azeem-2Azeem-2
1

content-editing

Run a six-pass editorial workflow covering grammar, citations, consistency, formatting, readability, and factual accuracy.

Community
Advanced
EdgeHuntEdgeHunt

ck:copywriting

Generate copy for headlines, emails, landing pages, CTAs, and social using formulas and templates.

Official
Advanced