Tooluck logoTooluck
SKILL.md

baoyu-format-markdown

Agent skill fromJimLiu/baoyu-skills

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.

How to install baoyu-format-markdown

install baoyu-format-markdown
# install the baoyu-skills pack with the skills CLI
npx skills add JimLiu/baoyu-skills

# or add only this skill to Claude Code: copy the folder

skills/baoyu-format-markdown/

# into

~/.claude/skills/baoyu-format-markdown/ (all projects)

.claude/skills/baoyu-format-markdown/ (one project)

skills/baoyu-format-markdown/SKILL.md

MITFull file
1# Markdown Formatter
2
3Make plain text or markdown scannable so readers grasp key points and structure fast.
4
5**Core principle**: Only adjust formatting and fix obvious typos. Never add, delete, or rewrite content.
6
7## User Input Tools
8
9When this skill prompts the user, follow this tool-selection rule (priority order):
10
111. **Prefer built-in user-input tools** exposed by the current agent runtime — e.g., `AskUserQuestion`, `request_user_input`, `clarify`, `ask_user`, or any equivalent.
122. **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.
133. **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.
14
15Concrete `AskUserQuestion` references below are examples — substitute the local equivalent in other runtimes.
16
17## Script Directory
18
19`{baseDir}` = this SKILL.md's directory. `${BUN_X}` = `bun` if installed; else `npx -y bun` if `npx` available; else suggest installing bun. Replace `{baseDir}` and `${BUN_X}` with actual values.
20
21| Script | Purpose |
22|--------|---------|
23| `scripts/main.ts` | Main entry point with CLI options (uses remark-cjk-friendly for CJK emphasis) |
24| `scripts/quotes.ts` | Replace ASCII quotes with fullwidth quotes |
25| `scripts/autocorrect.ts` | Add CJK/English spacing via autocorrect |
26
27## Preferences (EXTEND.md)
28
29First one found wins:
30…

Excerpt shown under the repository's MIT license.

More skills in baoyu-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates