rewrite-doc

Rewrite documentation for a target audience while preserving technical terms and structure.

8|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/OiAnthony/.agents --skill rewrite-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rewrite-doc
Source: https://github.com/OiAnthony/.agents/tree/main/skills/rewrite-doc
Command: npx skills add https://github.com/OiAnthony/.agents --skill rewrite-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill rewrites documentation so it reads naturally for a chosen audience and language without losing technical meaning or structure.

Core Features & Use Cases

  • Audience Adaptation: Adjust tone and wording for senior engineers, junior engineers, PMs, or end users.
  • Localization: Rewrite docs into native-sounding Chinese, English, or other target languages while preserving domain terminology.
  • Documentation Polish: Improve READMEs, specs, design docs, guides, and changelogs that feel machine-translated, stiff, or unclear.
  • Structure Preservation: Keep code blocks, YAML frontmatter, tables, and identifiers intact while refining surrounding prose.

Quick Start

Rewrite this document for senior engineers in natural Chinese while preserving all technical terms, code, tables, and headings.

Frequently Asked Questions about rewrite-doc

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

FAQPage Schema
How do I rewrite a README for a different audience without losing technical precision?

To rewrite a README for a different audience without losing technical precision, provide the document and specify the target audience. The Skill adjusts tone and wording for senior engineers, junior engineers, PMs, or end users while preserving technical terms, code blocks, and identifiers.

Can I localize documentation into natural Chinese while keeping code blocks and YAML frontmatter intact?

Yes, you can localize documentation into natural Chinese while keeping code blocks and YAML frontmatter intact. The Skill preserves structural elements like YAML frontmatter, tables, and identifiers, ensuring only the surrounding prose is translated into native-sounding text.

What is the best way to fix machine-translated design docs that feel stiff and unclear?

The best way to fix machine-translated design docs that feel stiff and unclear is to apply documentation polish. The Skill refines rigid prose into natural language for your chosen audience while maintaining the original technical meaning and document structure.

Does this documentation rewriting approach preserve tables and identifiers in product specs?

Yes, this documentation rewriting approach preserves tables and identifiers in product specs. It keeps code blocks, YAML frontmatter, tables, and identifiers completely intact, refining only the surrounding explanatory prose to match the requested tone and language.

How do I adapt a changelog's tone for end users instead of senior engineers?

To adapt a changelog's tone for end users instead of senior engineers, specify the target audience during the rewrite. The Skill adjusts the wording and tone to suit end users while ensuring technical precision and structural elements remain unchanged.