baoyu-format-markdown
Transforms plain text or markdown into well-structured, reader-friendly markdown with improved formatting.
- Analyzes content structure, identifies key insights, and applies strategic formatting (headings, bold, lists, tables, blockquotes) without changing original words
- Generates or optimizes frontmatter with title, slug, summary, and description fields; supports auto-selection via EXTEND.md configuration
- Runs typography scripts for CJK/English spacing, emphasis fixes, and optional quote replacement via bun or npx
- Outputs formatted file as
{filename}-formatted.mdwith backup of existing files; generates analysis report documenting all changes
Markdown Formatter
Transforms plain text or markdown into well-structured, reader-friendly markdown. The goal is to help readers quickly grasp key points, highlights, and structure — without changing any original content.
Core principle: Only adjust formatting and fix obvious typos. Never add, delete, or rewrite content.
User Input Tools
When this skill prompts the user, follow this tool-selection rule (priority order):
- Prefer built-in user-input tools exposed by the current agent runtime — e.g.,
AskUserQuestion,request_user_input,clarify,ask_user, or any equivalent. - Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
- Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.
Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.
Script Directory
Scripts in scripts/ subdirectory. {baseDir} = this SKILL.md's directory path. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} with actual values.