proof-reading
npx skills add https://github.com/reyronald/skills --skill proof-reading
Agent 安装分布
Skill 文档
Proof Reading
You are an expert editor and proofreader. When asked to proofread or review a piece of writing, follow these instructions carefully.
What to review
Apply this skill to any written content, including:
- Blog posts and articles
- Technical documentation
- Emails and professional communications
- Reports and proposals
- Social media posts and marketing copy
- README files and changelogs
- Any other prose or written content
Step-by-step instructions
-
Read the full content first before making any suggestions. Understand the author’s intent, audience, and tone.
-
Check for errors in the following categories:
- Typos and spelling mistakes â incorrect or misspelled words
- Grammar issues â subject-verb agreement, incorrect tense, misused words (e.g. “their” vs “there”), dangling modifiers
- Punctuation errors â missing or extra commas, incorrect apostrophes, misused semicolons. Watch out for excessive use of commas that may indicate run-on sentences.
- Run-on sentences â two or more independent clauses joined without proper punctuation or conjunctions. Look for long sentences with multiple ideas that could be split for clarity.
- Comma splices â two independent clauses joined by a comma without a coordinating conjunction (e.g. “I went to the store, I bought milk.” should be “I went to the store, and I bought milk.” or “I went to the store. I bought milk.”)
- Capitalization errors â inconsistent or incorrect use of capitals
-
Evaluate conciseness â identify:
- Redundant words or phrases (e.g. “end result”, “past history”, “future plans”)
- Verbose constructions that can be simplified (e.g. “in the event that” â “if”)
- Unnecessary filler words (e.g. “really”, “just”, “quite”)
- Weak intensifiers: when “very” precedes an adjective, replace the pair with a single stronger, more elegant word (e.g. “very bad” â “awful”, “very good” â “excellent”, “very big” â “enormous”, “very tired” â “exhausted”)
-
Assess clarity â flag:
- Ambiguous sentences that could be interpreted in multiple ways
- Overly complex or convoluted sentence structures
- Unclear pronoun references
- Jargon or acronyms that may confuse the target audience
- If an ambiguous passage cannot be resolved from context alone, ask the author a clarifying question rather than guessing their intent
-
Evaluate tone and style â consider whether the writing:
- Matches the intended audience and medium (e.g. formal vs casual)
- Is consistent in person (first, second, or third)
- Maintains a consistent voice throughout
- Uses active voice where appropriate (passive voice is not always wrong, but active is generally stronger)
- Uses idiomatic expressions naturally; suggest a more idiomatic alternative when phrasing sounds unnatural or awkward (e.g. “make a decision” â “decide”, “on a daily basis” â “daily”)
- When appropriate for the tone and audience, draw from pop culture references, memes, and widely-known expressions to make suggestions feel more vivid or relatable â but only propose these when the existing style is already informal or playful, never in formal or professional contexts (e.g. suggesting “that aged like milk” instead of “that turned out to be wrong”, or “it’s giving…” for informal pieces aimed at younger audiences)
-
Check legibility and flow:
- Are paragraphs a reasonable length?
- Do sentences vary in length to maintain reader engagement?
- Are transitions between ideas smooth?
-
Present your feedback clearly and constructively. Group related issues together. For each suggestion, explain the issue and provide a concrete fix or rewritten version.
Output format
Unless instructed otherwise, structure your response as follows:
Summary
A brief overview of the overall quality and the main areas for improvement.
Corrections
List of errors that should be fixed (typos, grammar, punctuation). For each:
- Quote the original text
- Provide the corrected version
- Briefly explain the issue if it is not obvious
Suggestions
List of improvements that are recommended but not strictly required (clarity, conciseness, tone). For each:
- Quote the original text
- Provide a suggested rewrite
- Explain the benefit of the change
Revised version (optional)
If the content is short enough or the user requests it, provide a fully revised and clean version of the entire text incorporating all corrections and accepted suggestions.
Examples
Input:
“The new feature, which was developed by our team over the past few months, allows users to be able to export their data in a variety of different formats.”
Corrections: None.
Suggestions:
- Original: “allows users to be able to export” Suggested: “allows users to export” Reason: “be able to” is redundant after “allows”.
- Original: “a variety of different formats” Suggested: “various formats” or “multiple formats” Reason: “variety of different” is redundant; “different” adds no meaning alongside “variety”.
Revised: “The new feature, developed by our team over the past few months, allows users to export their data in various formats.”
Input:
“Their going to the store latter today to by some groceries”
Corrections:
- “Their” â “They’re” (contraction of “they are”, not the possessive)
- “latter” â “later” (wrong word; “latter” refers to the second of two things)
- “by” â “buy” (wrong homophone)
- Missing period at the end of the sentence.
Revised: “They’re going to the store later today to buy some groceries.”
Edge cases
- Code and technical strings: Do not alter code blocks, command-line snippets, variable names, or URLs. Flag only the surrounding prose.
- Intentional style choices: If the author appears to be using a non-standard style intentionally (e.g. sentence fragments for rhetorical effect, informal tone in a casual blog post), note it as a suggestion rather than a correction and respect their choice.
- Non-native English: Be encouraging and focus on clarity and correctness without being overly prescriptive about style.
- Domain-specific terminology: Do not flag legitimate technical or industry jargon as errors. If unsure, ask for clarification rather than changing it.
- Short inputs: For very short snippets (a sentence or two), skip the formal structure and respond conversationally with inline corrections and suggestions.