Agent skill · writing content · aiskillstore
baoyu-format-markdown
Formats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or improve article layout. Outputs to {filename}-formatted.md.
Why this skill is useful
Adds specific formatting scripts and workflows for markdown files that the AI wouldn't reliably generate on its own.
What it needs
Requires bash installed locally. About 8k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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): 1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, requestuserinput, clarify, askuser, or any equivalent. 2. 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. 3. 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 ${BUNX} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUNX} with actual values. 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 fullwidth quotes scripts/autocorrect.ts Add CJK/English spacing via autocorrect Preferences (EXTEND.md) Check EXTEND.md in priority order — the first one found wins: Priority Path Scope ---------- ------ ------- 1 .baoyu-skills/baoyu-format-markdown/EXTEND.md Project 2 ${XDGCONFIGHOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md XDG 3 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md User home If none found, use defaults — no first-time setup required for this skill. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/baoyu-format-markdown