Refine AI-generated text into natural human speech
AI-written text often loses reader trust due to its distinct rhythm and repetitive phrasing. This repository contains a skill file with rules for identifying and removing such patterns. Applying this file to Claude or other language models automates the process of filtering out mechanical tones and polishing sentences into natural language.
How it identifies AI writing traces
This tool focuses on three types of problems commonly found in AI writing. First, it removes prohibited phrases such as 'voice-like' openings, adverbs for emphasis, business jargon, and vague declarations. Second, it instructs the model to avoid structural clichés like binary contrasts, negative lists, dramatic breaks, and passive voice. Third, it applies sentence-level rules, including banning sentences that start with 'what', prohibiting the use of em dashes (—), and preventing excessive lists of short sentences. These rules are specifically detailed in the files within the references folder.
Application methods and structure
This repository includes a core instruction file named SKILL.md and reference materials. If you are using Claude Code, you can add this folder as a skill. For Claude Projects, upload SKILL.md and the reference files as project knowledge. If you are calling the API directly, include the content of SKILL.md in the system prompt and configure it to load reference files when needed. If you use custom instructions, you can simply copy and paste the core rules from SKILL.md.
Criteria for measuring writing quality
Scores are assigned based on directness (whether it is a declaration or an announcement), rhythm (whether it varies or is monotonous), trust (whether it respects the reader's intelligence), authenticity (whether it sounds like a human), and density (whether there is content to cut). If the total score is below 35 out of 50, the text is considered in need of revision. This allows for an objective check on whether AI-generated text is close to the level of human-written text.
Pre-use considerations
This tool is released under the MIT license, allowing free use and sharing. However, since this skill operates by being applied to Claude or other LLMs, an environment using such an AI model is required. Additionally, this tool does not perfectly resolve all issues with AI writing styles, and final sentence polishing may require human judgment. Particular care must be taken with professional content or writing that requires specific styles to ensure these rules are not applied excessively in a way that damages the intent of the text.