writing-doc-summaries

What problem does it solve?

This Skill helps maintain accurate and consistent YAML front matter by creating or updating the 115–145 character summary for Markdown docs in pingcap/docs and pingcap/docs-cn, ensuring discoverability and compliance with documentation guidelines.

Core Features & Use Cases

• Generates compliant 115–145 character summaries that pass length requirements and opening-verb guidance.
• Updates existing summaries to reflect the document scope and tone, without repeating the title.
• Applies to files missing a summary or with low-quality or outdated summaries across docs and docs-cn.

Quick Start

Target a Markdown document and the skill will generate and insert a compliant summary into its front matter.