Baoyu format markdown

--- 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 . version: 1.57.0 metadata: openclaw: homepage:https://github.com/JimLiu/baoyu-skills#baoyu-format-markdown requires: anyBins : - bun - npx --- # 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 thisskill prompts the user, follow this tool-selection rule (in order of priority): 1. Prefer built-in user-input tools provided by the currentagent runtime:e.g.,AskUserQuestion ,request_user_input ,clarify ,ask_user , or any equivalent. 2. Fallback: If no such tool exists, send a numbered plain-text message and ask the user to reply with the chosen number or answer for each question. 3. Batching: If the tool supports multiple questions per call, combine all applicable questions into a single call; if it supports only a single question, ask them one at a time in order of priority. The specificAskUserQuestion references below are examples:substitute the local equivalent in other runtimes. ## Script Directory Scripts in thescripts/ subdirectory.{baseDir} = the directory path of thisSKILL.md . Resolve${BUN_X} runtime: ifbun is installed →bun ; ifnpx is available →npx -y bun ; otherwise, suggest installing bun. Replace{baseDir} and${BUN_X} with actual values. | Script | Purpose | |--------|---------| |scripts/main.ts | Main entry point withCLI 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 ) CheckEXTEND.md in order of priority:the first one found takes precedence: | Priority | Path | Scope | |----------|------|-------| | 1 |.baoyu-skills/baoyu-format-markdown/EXTEND.md | Project | | 2 |${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md | XDG | | 3 |$HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md | User home | If none are found, use the defaults:no initial setup is required for thisskill . TheEXTEND.md supports: | Setting | Values | Default | Description | |---------|--------|---------|-------------| |auto_select |true /false |false | Skip both title and summary selection; automatically select the best | |auto_select_title |true /false |false | Skip title selection only | |auto_select_summary |true /false |false | Skip summary selection only | | Other | : | : | Default formatting options, typography preferences | ## Usage workflow s has two phases: Analyze (understand the content) and Format (apply formatting).Claude performs content analysis and formatting (Steps 1:5), then runs the script to correct typography (Step 6). ## Workflow ### Step 1: Read & Detect Content Type Read the user-specified file, then detect the content type: | Indicator | Classification | |-----------|----------------| | Has--- YAML frontmatter | Markdown | | Has# ,## ,### headings | Markdown | | Has**bold** ,*italic* , lists, code blocks, blockquotes | Markdown | | None of the above | Plain text | **If Markdown is detected, useAskUserQuestion to ask:** `` Detected existing markdown formatting. What would you like to do? 1. Optimize formatting (Recommended) - Analyze content, improve headings, bold, lists for readability - Run typography script (spacing, emphasis fixes) - Output: {filename}-formatted.md 2. Keep original formatting - Preserve existing markdown structure - Run typography script only - Output: {filename}-formatted.md 3. Typography fixes only - Run typography script on original file in-place - No copy created, modifies original file directly `` **