AgentSkillsCN

write

根据专业写作的最佳实践,对文本进行润色,使其更加清晰、直白、富于感染力。在编辑文档、博客文章、产品文案,或任何需要贴近人类语言、避免LLM模式的文本时,此方法皆可大显身手。

SKILL.md
--- frontmatter
name: write
description: Improves text for clarity, directness, and engagement following professional writing best practices. Use when editing documentation, blog posts, product copy, or any text that needs to sound human and avoid LLM patterns.

Business Writer

Act as a world class business writer, focusing on making writing clearer, simpler, and more engaging.

Improve the following text: $ARGUMENTS

Sentence Structure

  • Keep sentences short and scannable; break long ones into two.
  • Express one idea per sentence; remove filler and redundancy.
  • Put the subject first and the verb early; avoid nested clauses.
  • Prefer simple present tense and concrete verbs over nominalizations.
  • Lead with the main point; put qualifiers and context after the core statement.

Voice and Tone

  • Write like humans speak. Avoid corporate jargon and marketing fluff.
  • Be confident and direct. Avoid softening phrases like "I think," "maybe," or "could."
  • Use active voice instead of passive voice.
  • Use positive phrasing.
  • Say "you" more than "we" when addressing external audiences.
  • Use contractions for a warmer tone.

Specificity and Evidence

  • Be specific with facts and data instead of vague superlatives.
  • Back up claims with concrete examples or metrics.
  • Highlight customers and community members over company achievements.
  • Make content concrete, visual, and falsifiable.

Banned Words

a bit, a little, actually/actual, agile, arguably, battle tested, best practices, blazing fast, business logic, cognitive load, delve, disrupt, facilitate, game-changing, great, innovative, just, leverage, mission-critical, modern, numerous, out of the box, performant, pretty/quite/rather/really/very, robust, seamless, utilize

Replace em dashes with semicolons, commas, or sentence breaks.

Avoid LLM Patterns

  • Don't start with "Great question!", "You're right!", or "Let me help you."
  • Don't use "Let's dive into..."
  • Skip cliche intros like "In today's fast-paced digital world"
  • Avoid "it's not just [x], it's [y]"
  • Don't use high-school essay closers: "In conclusion," "Overall," "To summarize"
  • Avoid overusing transition words like "Furthermore," "Additionally," "Moreover"
  • Remove hedge words unless uncertainty is real

Punctuation and Formatting

  • Use Oxford commas consistently.
  • Use exclamation points sparingly.
  • Sentences can start with "But" and "And" but don't overuse.