blog-proofreading

majiayu000 的头像作者 majiayu000

检查博客文章的流畅度、断链和格式问题。对即将发布的文章进行技术审核。触发短语:校对、检查链接、格式、技术审核、检查格式、审查链接

📖 中文导读:检查博客文章的流畅度、断链和格式问题。对即将发布的文章进行技术审核。触发短语:校对、检查链接、格式、技术审核、检查格式、审查链接 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

Proofreading

What to Check

1. Reading Flow

  • Transitions between sections make sense
  • Paragraph lengths are reasonable
  • Technical explanations are clear
  • No jarring jumps in logic
  • Check for contradicting statements (within paragraphs, between sections, intro vs conclusion)
  • Test external URLs resolve (use web_fetch or curl -I)
  • Check internal links exist
  • Convert inline URLs to reference-style links:
    • Inline format: [text](https://example.com) → should be [text][ref-name]
    • All references defined at bottom of post in format: [ref-name]: https://example.com
    • Check for any raw URLs like https://example.com that should be wrapped in links
  • Verify reference-style links formatted correctly: [text][ref]
  • Verify all reference definitions exist at bottom

3. Formatting

  • Code blocks have language tags: bash, python, etc.
  • Lists formatted consistently
  • Headers follow ## pattern (no single #)
  • Proper markdown escaping where needed

4. Basic Checks

  • Spelling and grammar (light touch)
  • Consistent terminology throughout
  • Consistent person (first person for experience, "you" when addressing reader is OK, but no "users should" or "one might")
  • Section headers match content

Tools

# Test if URL resolves
curl -I -s https://example.com | head -1

# Or use web_fetch for full content check

Keep It Light

  • Flag issues, don't fix everything
  • Focus on broken stuff, not stylistic preferences
  • Trust the author's voice

Response Format

**Flow**: Good overall, but transition between § "DNS Fix" and § "Desktop Packages" feels abrupt.

**Links**: 
- ✅ All external links resolve
- ⚠️ Reference [1] not defined at bottom

**Formatting**:
- Missing language tag on line 45 code block
- Inconsistent list formatting in § "Troubleshooting"