A specialized technical writing assistant for Openclaw Skills that produces concise, high-force prose for documentation, APIs, and reports.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clear-writing
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clear-writing using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Clear Writing?
The Clear Writing skill is a comprehensive toolkit designed to help developers and technical writers produce prose that is both clear and impactful. By integrating the foundational principles of Strunk's The Elements of Style with modern documentation frameworks like Divio, this skill ensures that your technical communication is optimized for human readers rather than search engine algorithms. It is a vital asset within the Openclaw Skills library for anyone needing to translate complex technical concepts into accessible READMEs, API guides, and architectural explanations.
Beyond simple grammar checks, this skill addresses the specific challenges of the modern era by identifying and stripping away AI-generated anti-patterns. It replaces generic puffery and overused LLM vocabulary with active voice, concrete language, and specific, actionable information. Whether you are drafting a quick commit message or a deep-dive tutorial, this skill provides the structure and checklists necessary to maintain professional standards across all project communications.
Clear Writing Use Cases
- Creating high-quality README files and project overviews that provide immediate value.
- Drafting precise API documentation, endpoint references, and integration guides.
- Writing clear, actionable error messages and UI copy for better user experiences.
- Developing step-by-step tutorials and technical how-to guides following the Divio framework.
- Refining AI-generated drafts to remove repetitive patterns and technical puffery.
How Clear Writing Works
- Draft your initial technical content or documentation using your preferred Openclaw Skills agent.
- Identify the specific documentation type required, such as a Tutorial, Reference, or Explanation.
- Utilize a subagent strategy by loading specific reference files (like elementary principles of composition) to minimize token usage while maintaining high quality.
- Apply the inverted pyramid or problem-solution structural patterns to organize information logically.
- Execute a final pass using the built-in review checklist to ensure every code example is runnable and every sentence is concise.
Clear Writing Setup
To integrate this skill into your environment, ensure the skill files are present in your agent's library and reference them in your system prompt.
# Example of how to reference the skill in an Openclaw Skills configuration
openclaw-agent include clear-writing --reference-path ./references/elements-of-style/
Clear Writing Data Schema & Taxonomy
The skill utilizes a structured taxonomy of reference files and templates to guide the writing process:
| Data Component | Format | Description |
|---|---|---|
| Style References | Markdown | Includes grammar, punctuation, and composition rules based on Strunk's principles. |
| Pattern Templates | Markdown Blocks | Pre-defined structures for READMEs, API docs, and architecture descriptions. |
| Anti-Pattern Guide | List | Documented signs of AI writing and 'puffery' words to be avoided. |
| Review Checklist | Boolean Checklist | A 10-point verification list for accuracy, scannability, and readability. |
Clear Writing Advanced Features
- Context-optimized subagent workflows for efficient copyediting without consuming full skill context.
- Integration of the Divio documentation framework for distinct content archetypes (Tutorials, How-to, Reference, Explanation).
- Specialized 'AI Writing Signs' detection based on Wikipedia field-tested patterns to ensure human-sounding prose.
- Automated enforcement of code example standards, ensuring all snippets are complete, minimal, and language-tagged.
SKILL.md
Loading
Related Openclaw Skills
Clean Code
A pragmatic framework for writing maintainable code through strict naming conventions, small functions, and architectural safety checks.
Caching Strategies & Patterns
A comprehensive technical framework for implementing multi-layer caching architectures, from browser headers to distributed Redis clusters.
Uniswap V4 Hook Builder
An automated development assistant for generating production-ready Uniswap V4 hooks, tests, and deployment scripts.
Bridge Tokens
A streamlined cross-chain utility for moving identical tokens between different blockchain networks without the need for swapping.
Code Review Checklist
A multi-dimensional framework for AI agents to conduct rigorous code reviews covering security, performance, correctness, and maintainability.
Command Creator
A developer-focused utility for generating reusable slash commands and structured markdown workflows for AI coding agents.
Featured*
