Faigy-RosenfeldClaude Code
curl -fsSL https://raw.githubusercontent.com/vibe-md/vibe.md/7cb0620fbd80f9829155d8866328b58cd18d5aa7/scripts/install.sh \
| bash -s -- --skill readability \
--agent claude-code --ref 7cb0620fbd80f9829155d8866328b58cd18d5aa7Readability
AvailableImproves the readability, formatting, and structure of text, documentation, and markdown files. Use when the user asks to clean up text, improve clarity, or structure documentation.
Takes dense, raw or messy text and turns it into clear, well-organised writing. It adds headings and lists, fixes flow and grammar, and keeps one consistent tone, while leaving code, commands and links exactly as they were.
Documentation
- Claude Code
- Codex CLI
- GitHub Copilot
- Cursor
- Gemini CLI
Maintained by
The problem
Notes, transcripts and quickly written docs are hard to read and easy to skip. Asking an AI agent to "clean this up" can also change a command, a config value or a link along the way, which turns a nicer-looking document into a wrong one.
What it does
Clear structure
Breaks long text into sections with headings, subheadings and bullet points.
Better flow
Improves grammar, sentence structure and the order of ideas so the text reads naturally.
Consistent tone
Keeps a professional, objective voice from the first line to the last.
Technical content stays intact
Code snippets, configuration blocks, commands and links are preserved exactly.
Installation
One command
Install directly into your project.
Open Terminal in your project folder, then run this command. No ZIP, moving files, or prompt needed.
- 1Open your project folder in Terminal
- 2Run the command above
- 3Reload your agent and ask to use Readability
Works on macOS, Linux, and Windows through WSL or Git Bash. The installer checks destinations and stops if existing files conflict.
Usage examples
Type these to your agent in plain language. Here's what to expect.
you › Can you clean up these raw notes and make them a readable guide?
Expected workflow
- 01Reviews the notes for flow, grammar and logical order.
- 02Organises them under markdown headings and formats the lists.
- 03Keeps every technical detail and code snippet unchanged.
- 04Hands back a polished guide.
How it works
The skill gives your agent four steps: analyse the text, restructure it, fix the tone, and preserve technical accuracy. The last step is a rule, not a suggestion: code, commands and links must not be altered.
Safety and limitations
Required permissions
- Read and edit the text or markdown files you point it at.
Limitations
- It improves how text reads. It does not check whether the content is true.
- It edits your files, so review the result or keep the original saved first.