Baoyu format markdown
/SKILLFormats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks.
--- name: baoyu-format-markdown description: Formats plain text or Markdown files with frontmatter, titles, summaries, headings, bold text, lists, and code blocks. Use when a user asks to “format Markdown,” “beautify an article,” “add formatting,” or improve an article’s layout. Outputs to {filename}-formatted.md --- # Markdown Formatter Transforms plain text or Markdown files into well-structured Markdown with proper frontmatter, formatting, and typography. ## Script Directory Scripts are located in the scripts/ subdirectory. Replace ${SKILL_DIR} with the directory path for this SKILL.md. | Script | Purpose | |--------|---------| | scripts/main.ts | Main entry point with CLI options (uses remark-cjk-friendly for CJK emphasis) | | scripts/quotes.ts | Replace ASCII quotes with full-width quotes | | scripts/autocorrect.ts | Add CJK/English spacing via autocorrect | ## Preferences (EXTEND.md) Use Bash to check for the existence of EXTEND.md (in order of priority): ``bash # Check project-level first test -f .baoyu-skills/baoyu-format-markdown/EXTEND.md && echo "project" # Then user-level (cross-platform: $HOME works on macOS/Linux/WSL) test -f "$HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md" && echo "user" ` ┌──────────────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├──────────────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-format-markdown/EXTEND.md │ Project directory │ ├──────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md │ User home │ └──────────────────────────────────────────────────────────┴───────────────────┘ ┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ Result │ Action │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Found │ Read, parse, apply settings │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Not found │ Use defaults │ └───────────┴───────────────────────────────────────────────────────────────────────────┘ **EXTEND.md Supports**: Default formatting options | Summary length preferences ## Usage Claude performs content analysis and formatting (Steps 1-6), then runs the script for typography fixes (Step 7). ## Workflow ### Step 1: Read Source File Read the user-specified markdown or plain text file. ### Step 1.5: Detect Content Type & Confirm **Content Type Detection:** | Indicator | Classification | |-----------|----------------| | Has --- YAML frontmatter | Markdown | | Has # , ## , ### headings | Markdown | | Has bold, italic | Markdown | | Has - or 1. lists | Markdown | | Has ` code blocks | Markdown | | Has > blockquotes | Markdown | | None of above | Plain text | **Decision Flow:** ┌─────────────────┬────────────────────────────────────────────────┐ │ Content Type │ Action │ ├─────────────────┼────────────────────────────────────────────────┤ │ Plain text │ Proceed to Step 2 (format to markdown) │ ├─────────────────┼────────────────────────────────────────────────┤ │ Markdown │ Use AskUserQuestion to confirm optimization │ └─────────────────┴────────────────────────────────────────────────┘ **If Markdown detected, ask user:** ` Detected existing markdown formatting. What would you like to do? 1. Optimize formatting (Recommended) - Add/improve frontmatter, headings, bold, lists - Run typography script (spacing, emphasis fixes) - Output: {filename}-formatted.md 2. Keep original formatting - Preserve existing markdown structure - Run typography script (spacing, emphasis fixes) - Output: {filename}-formatted.md 3. Typography fixes only - Run typography script on original file in-place - No copy created, modifies original file directly `` **Ba
