Tuzi Format Markdown

This formats markdown files by adding frontmatter, generating titles from content, and applying typographic fixes for CJK text. It detects whether your file is plain text or already markdown and asks how aggressive you want to be with formatting (optimize everything, keep structure but fix typography, or just run spacing fixes in place). The script handles the fiddly stuff like adding spaces between Chinese and English text, fixing emphasis punctuation with remark-cjk-friendly, and optionally converting straight quotes to fullwidth. It saves to a new file with `-formatted` appended unless you choose the in-place option. You can set preferences in EXTEND.md at project or user level. Useful when you have drafts that need consistent structure or CJK content that looks awkward without proper spacing.

skills.sh installs: 165
GitHub stars: 39
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tuziapi/tuzi-skills --skill tuzi-format-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

Markdown Formatter

Transforms plain text or markdown files into well-structured markdown with proper frontmatter, formatting, and typography.

Script Directory

Scripts in scripts/ subdirectory. Replace ${SKILL_DIR} with this SKILL.md's directory path.

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)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .tuzi-skills/tuzi-format-markdown/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.tuzi-skills/tuzi-format-markdown/EXTEND.md" && echo "user"

SKILL.md on GitHub