baoyu-format-markdown skill: format drafts with titles, summaries and headings

Baoyu's skill that makes your agent format a plain-text or Markdown article with a title, summary, headings, bold and lists, without rewriting your words.

Installs: 28.3K; on skills.sh
Stars: 27.2K; on GitHub
Files: 7; besides SKILL.md
Updated: Nov 2026; last repo commit

baoyu-format-markdown loads when you ask to format Markdown, beautify an article or improve its layout. Your agent analyzes the text, offers 4 to 5 title choices, writes a summary and description, then adds headings, bold, lists, tables and code markers. Its rule is to only adjust formatting and fix obvious typos, never to add, delete or rewrite content.

The result is saved as {filename}-formatted.md, next to a {filename}-analysis.md file. A final script then fixes CJK and English spacing and emphasis punctuation. It needs bun or npx, and the script downloads packages through npx.

Good for

Writers who paste rough drafts and want a clean, scannable article
Chinese and bilingual writers who need CJK and English spacing fixed
Bloggers who want title options and a summary for the front matter

Install baoyu-format-markdown

Claude Code

Copy this prompt.

Install the baoyu-format-markdown skill in Claude Code. Run this command:

npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-format-markdown

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

User Input Tools
Script Directory
Preferences (EXTEND.md)
Usage
Workflow
Step 1: Read & Detect Content Type
Step 2: Analyze Content (Reader's Perspective)
Highlights & Key Insights
Structure Assessment
Reader-Important Information
Formatting Issues
Typos Found
Step 3: Check/Create Frontmatter, Title & Summary
Step 4: Format Content
Step 5: Save Formatted File
Step 6: Execute Typography Script

Key facts

Author: Jim Liu (Baoyu), in the JimLiu/baoyu-skills repo
Installs on skills.sh: 28,285 as of 2026-11-02
GitHub stars: 27,159 for the whole baoyu-skills repo, 2026-11-02
License: MIT, unless otherwise noted in the repo (README)
Version: 1.57.0 in SKILL.md frontmatter
Last repo commit: 2026-11-01
Files: 8 files including SKILL.md: references/title-formulas.md and 6 files in scripts/ (main.ts, autocorrect.ts, quotes.ts, package.json, and two lockfiles)
Needs: bun (or npx)
Part of: The baoyu-skills plugin (20+ skills)

What it includes

Plain text or Markdown; asks which of three modes to use
For existing Markdown it asks: optimize formatting, keep original formatting, or typography fixes only on the original file.
Try: “Format article.md for my blog.”
Read · Step 1: detect content type
Saves {name}-analysis.md with highlights, issues and typos
Write · Step 2: content analysis
4 to 5 title choices; summary and description generated
Titles use hook formulas from references/title-formulas.md plus straightforward ones. With auto_select set in EXTEND.md it picks the top title itself.
Read · Step 3: frontmatter, title, summary
Headings, bold, lists, tables, blockquotes, code languages
Write · Step 4: format content
Moves an existing -formatted.md to a timestamped backup
Runs code · Step 5: save {name}-formatted.md
CJK spacing, emphasis fixes, optional fullwidth quotes
Options --quotes, --spacing and --emphasis (spacing and emphasis on by default). Spacing runs npx autocorrect-node --fix on the file.
Runs code · Step 6: scripts/main.ts typography
Lists files and the changes applied
Read · Step 7: completion report
auto_select, auto_select_title, auto_select_summary
Files · EXTEND.md preferences

From the official docs

Permissions

Low risk

It writes files next to your draft and runs a script that fetches a package through npx. Keep a copy of drafts you care about.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

One mode edits your original file
"Typography fixes only" runs the script on the original, with no copy. Keep a backup or use the other modes. github.com
It runs a package through npx
Spacing fixes call npx autocorrect-node --fix on your file. Approve the command and run it on drafts, not on files you cannot recover. github.com

Technical details

Talks to	npx fetches autocorrect-node (and bun if missing) from the npm registry
Scopes	Writes {name}-analysis.md and {name}-formatted.md next to your draft Moves an existing -formatted.md to a backup file The typography script rewrites the output file in place; one mode rewrites your original

Questions

What does baoyu-format-markdown do?

It turns a plain-text or Markdown draft into a scannable article with front matter, headings, bold key points and lists. SKILL.md says it only adjusts formatting and obvious typos and never rewrites your content.

How do I install it in Claude Code, the Claude app or Codex?

Use the install box at the top of this page. You also need bun or npx for the typography script.

Where does the output go?

To {filename}-formatted.md, with a {filename}-analysis.md next to it. An existing formatted file is moved to a timestamped backup first. Choosing "typography fixes only" edits the original file in place.

Does it need an API key?

No key appears in SKILL.md or the scripts. The typography step runs npx autocorrect-node.

Is it safe?

It writes new files next to your draft and runs a script that fetches a package through npx. One mode edits your original in place, so keep a copy if the draft matters.

Does it work for English text?

Yes for the structure, title and summary steps. The typography script focuses on CJK and English spacing and emphasis, so its fixes mostly matter for Chinese, Japanese or Korean text.

Information

updated Nov 2, 2026

Repository: jimliu/baoyu-skills
Folder: skills/baoyu-format-markdown

jimliu/baoyu-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

baoyu-format-markdown SKILL.md · github.com
scripts/main.ts · github.com
scripts/autocorrect.ts · github.com
baoyu-skills README · github.com
skills.sh listing · skills.sh
references/title-formulas.md · github.com