Baoyu Format Markdown
Normalize and fix Markdown files—GFM, frontmatter, and CJK-friendly spacing—before you publish or commit agent-written docs.
Overview
baoyu-format-markdown is an agent skill for the Build phase that formats Markdown files with remark (GFM, frontmatter, CJK-friendly) and optional autocorrect for publishing-ready docs.
Install
npx skills add https://github.com/ideacco/baoyu-skills-openclaw --skill baoyu-format-markdownWhat is this skill?
- Unified/remark pipeline with GFM, frontmatter parsing, and remark-cjk-friendly for mixed Chinese–English prose
- Optional npx autocorrect-node --fix pass for punctuation and spacing in CJK Markdown
- Batch-friendly file-path workflow suitable for agent-generated docs before PR or ship
- Targets consistency in headings, lists, and YAML frontmatter without hand-editing every file
Adoption & trust: 1 installs on skills.sh; 12 GitHub stars; 1/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
Agent-generated or mixed-language Markdown often has broken GFM, sloppy CJK spacing, and inconsistent frontmatter that slows reviews and publishing.
Who is it for?
Indie builders maintaining bilingual docs, skill repos, or content sites who want a scripted format pass on specific file paths.
Skip if: Teams that only need one-off rewrites in chat with no repo files, or projects with no Node toolchain when you cannot run npx remark/autocorrect locally.
When should I use this skill?
Before committing or publishing Markdown that mixes CJK and English, uses frontmatter, or needs GFM-normalized lists and headings.
What do I get? / Deliverables
You get normalized, review-ready Markdown files that pass common lint and readability expectations before commit or release notes go out.
- Formatted Markdown files in place on disk
- Consistent GFM and frontmatter structure
Recommended Skills
Journey fit
Formatted Markdown is a Build-phase deliverable; this skill sits on the docs shelf where solo builders polish READMEs, blogs, and skill files. Docs subphase covers authoring hygiene and publishing-ready structure, which is exactly what remark-based formatting and autocorrect enforce.
How it compares
Use as a focused docs formatter—not a full static-site generator or SEO content skill.
Common Questions / FAQ
Who is baoyu-format-markdown for?
Solo and indie builders using Claude Code, Cursor, or Codex who commit Markdown daily and need GFM, frontmatter, and CJK spacing fixed in the actual files.
When should I use baoyu-format-markdown?
During Build docs work before opening a PR, after an agent drafts a README or skill.md, or when polishing launch/growth content that lives in the repo as Markdown.
Is baoyu-format-markdown safe to install?
Treat it like any skill that runs local CLI (npx) on filesystem paths—review the Security Audits panel on this page and run it on copies or branches first.
SKILL.md
READMESKILL.md - Baoyu Format Markdown
import { execSync } from "child_process"; export function applyAutocorrect(filePath: string): boolean { try { execSync(`npx autocorrect-node --fix "${filePath}"`, { stdio: "inherit" }); return true; } catch { return false; } } { "lockfileVersion": 1, "configVersion": 0, "workspaces": { "": { "dependencies": { "remark-cjk-friendly": "^1.1.0", "remark-frontmatter": "^5.0.0", "remark-gfm": "^4.0.1", "remark-parse": "^11.0.0", "remark-stringify": "^11.0.0", "unified": "^11.0.5", "unist-util-visit": "^5.1.0", "yaml": "^2.8.2", }, }, }, "packages": { "@types/debug": ["@types/debug@4.1.12", "", { "dependencies": { "@types/ms": "*" } }, "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ=="], "@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="], "@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="], "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="], "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="], "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="], "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="], "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], "decode-named-character-reference": ["decode-named-character-reference@1.3.0", "", { "dependencies": { "character-entities": "^2.0.0" } }, "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q=="], "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="], "devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="], "escape-string-regexp": ["escape-string-regexp@5.0.0", "", {}, "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw=="], "extend": ["extend@3.0.2", "", {}, "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="], "fault": ["fault@2.0.1", "", { "dependencies": { "format": "^0.2.0" } }, "sha512-WtySTkS4OKev5JtpHXnib4Gxiurzh5NCGvWrFaZ34m6JehfTUhKZvn9njTfw48t6JumVQOmrKqpmGcdwxnhqBQ=="], "format": ["format@0.2.2", "", {}, "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww=="], "get-east-asian-width": ["get-east-asian-width@1.5.0", "", {}, "sha512-CQ+bEO+Tva/qlmw24dCejulK5pMzVnUOFOijVogd3KQs07HnRIgp8TGipvCCRT06xeYEbpbgwaCxglFyiuIcmA=="], "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="], "longest-streak": ["longest-streak@3.1.0", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="], "markdown-table": ["markdown-table@3.0.4", "", {}, "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw=="], "mdast-util-find-and-replace": ["mdast-util-find-and-replace@3.0.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "escape-string-regexp": "^5.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.