polish

Identify typos, grammar issues, and phrasing improvements in documentation.

1|Updated Jul 17, 2025
One-click install
npx skills add https://github.com/whatsper/texterdocs --skill polish-whatsper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polish
Source: https://github.com/whatsper/texterdocs/tree/main/.claude/skills/polish
Command: npx skills add https://github.com/whatsper/texterdocs --skill polish-whatsper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read a doc or set of docs and propose small edits — typos, phrasing, conciseness, layout consistency with the rest of the project — as suggestions, not auto-applied

Core Features & Use Cases

  • Thorough proofreading to catch typos and layout inconsistencies.
  • Phrasing and conciseness improvements aligned with the project voice.
  • Considerations for tone and style consistency with reference docs.

Quick Start

Polish the target document by highlighting typos, tightening phrasing, and preserving the intended voice.

Frequently Asked Questions about polish

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

FAQPage Schema
How do I proofread documentation for typos and phrasing without losing the original voice?

Proofreading documentation for typos and phrasing without losing the original voice requires conservative edits that suggest improvements rather than auto-applying changes. This approach highlights redundancy and conciseness issues while preserving the project's intended tone and domain vocabulary.

What's the best way to ensure style-guide consistency across a set of project docs?

Ensuring style-guide consistency across project docs requires aligning tone with reference documents and checking layout consistency. This process identifies phrasing improvements and redundancy while maintaining the established voice, proposing changes as suggestions for user approval.

Can documentation edits fix grammar issues without altering domain vocabulary or code blocks?

Documentation edits can fix grammar issues without altering domain vocabulary or code blocks by scoping changes to non-destructive suggestions. This method catches typos and improves conciseness while explicitly avoiding modifications to code blocks and domain-specific terms.

How do I tighten phrasing and improve conciseness in technical documentation?

Tightening phrasing and improving conciseness in technical documentation involves identifying redundancy and suggesting layout consistency with the rest of the project. These conservative edits preserve the project voice and require user approval for substantive changes.

Does this approach auto-apply corrections or require manual approval for substantive edits?

This approach requires manual approval for substantive edits, proposing small changes as suggestions rather than auto-applying them. It ensures non-destructive modifications by catching typos and grammar issues while keeping domain vocabulary and code blocks intact.

When should I avoid using automated tools for documentation polishing?

You should avoid using automated tools for documentation polishing when changes need to be non-destructive and preserve the project voice. Conservative suggestion-based editing prevents unintended alterations to domain vocabulary, code blocks, and established reference doc tone.