AgentSkillsCN

Markdown Polish Kit

提升 Markdown 文档的清晰度、一致性与可读性。

SKILL.md
--- frontmatter
name: "Markdown Polish Kit"
description: "Elevate Markdown docs for clarity, consistency, and readability."
tags:
  - documentation
  - style

Checklist

  • Ensure headings follow a logical information hierarchy.
  • Use tables, callouts, or code blocks when they improve scannability.
  • Normalize terminology, tense, and labeling conventions.
  • Add cross-links to related guides, references, or runbooks.
  • Confirm docs include verification steps and ownership metadata.

Prompts

  • "Rewrite this section for a first-time contributor to follow."
  • "Suggest visuals or snippets that reduce reliance on prose."

Resources

  • Internal style guide.
  • Markdown lint configuration.