Clear Writing
Use Clear Writing to revise a draft, write documentation, compare options, or turn work notes into a concise update. Tell the agent what you need and provide the material it should use. The skill removes generic disclaimers, redundant contextual caveats, repetition, and writing-process narration, with exceptions for purpose-built text such as LICENSE notices. It presents enumerated items as lists or comparison tables and preserves limitations that affect the reader's decision.
Install from a marketplace
This repository hosts the clear-writing marketplace for Claude Code, Copilot CLI, Codex CLI, and Cursor.
Choose your client below.
Claude Code
Run these commands in a terminal:
claude plugin marketplace add ririnto/clear-writing
claude plugin install clear-writing@clear-writing
Start a new session with claude, then use /clear-writing:write-clearly in your prompt.
GitHub Copilot CLI
Run these commands in a terminal:
copilot plugin marketplace add ririnto/clear-writing
copilot plugin install clear-writing@clear-writing
Start a new session with copilot, then use /write-clearly in your prompt.
Codex CLI
Run these commands in a terminal:
codex plugin marketplace add ririnto/clear-writing
codex plugin add clear-writing@clear-writing
Start a new session with codex, then use $write-clearly in your prompt.
To install through the interactive browser, register the marketplace with the first command, open /plugins in Codex, and select Clear Writing from the clear-writing marketplace.
Start a new session after installation.
Cursor
- Open Customize in Cursor's sidebar.
- Select From GitHub Repository and enter
https://github.com/ririnto/clear-writing. - Select Clear Writing, choose Install, and choose user or project scope.
- In Agent chat, type
/and select write-clearly.
ChatGPT
- If Clear Writing is available to your account, open Clear Writing in ChatGPT or find it in Plugins, then select the plus button to install it.
- Start a new chat.
- Type
@and select Clear Writing or its write-clearly skill.
Use Clear Writing
Select the skill using your client's invocation method above, then send a request with your draft, notes, or source material:
Revise this draft for clarity and easy reading.
Keep its meaning, qualifications, values, and units.
Return the revised text in English.
<paste your draft>
Tip
Include the intended reader and output format when they matter.
For example: Write a Korean update for the team, under 150 words.
Example requests
Select the skill using your agent's invocation method, then adapt one of these requests. Replace the bracketed material with your own input.
Write a README
Write a README for new users of this project.
Lead with a working quick start, then cover common tasks and configuration.
Use these project details and commands:
<purpose, prerequisites, installation command, minimal example, options>
Compare options
Recommend an option using the requirements and measurements below.
Lead with the recommendation, then show a compact comparison table.
Express the acceptance conditions in LaTeX and define the symbols.
<options, measurements, units, measurement conditions, requirements>
Explain dependencies
Turn these work items into an implementation guide.
Show prerequisites in a Mermaid dependency graph.
Explain which tasks can run in parallel and what each task needs to begin.
<tasks and their prerequisites>
Report completed work
Turn these work notes into a short completion update for the team.
Lead with the delivered result and describe its effect on users.
Include the supporting check results and the next action that matters.
<changes, observed results, relevant next action>
Prepare a handoff
Write a handoff another agent can use to continue this task.
Include the current state, decisions, relevant files, and next action.
Write in English.
<task notes, decisions, paths, and next action>
Local packages
To work from a local checkout, clone the repository:
git clone https://github.com/ririnto/clear-writing.git
Replace /absolute/path/to/clear-writing below with the checkout's absolute path.
- Claude Code: Run
claude --plugin-dir /absolute/path/to/clear-writing, then invoke/clear-writing:write-clearly. - Copilot CLI: Run
copilot plugin install /absolute/path/to/clear-writing, start a newcopilotsession, then invoke/write-clearly. - Codex CLI: Run
codex plugin marketplace add /absolute/path/to/clear-writing, thencodex plugin add clear-writing@clear-writing. Start a newcodexsession and invoke$write-clearly. - Cursor: Copy the package contents to
~/.cursor/plugins/local/clear-writing/, withplugin.jsondirectly inside that directory. Run Developer: Reload Window, then type/in Agent chat and select write-clearly. Managed workspaces must allow local plugin imports.
Adjust the result
Give a direct follow-up instruction to refine the same draft:
- Shorten this to three paragraphs.
- Keep the technical detail and make it easier to scan.
- Put the alternatives in a table.
- Make the README focus on installation and everyday use.
Name the target audience, language, and length whenever they affect the result. Read the skill for the core rules and links to task-specific examples.
Skill structure
skills/write-clearly/SKILL.md contains the core rules and states when to read each optional file under references/.
The package works without another writing skill or external reading.