baoyu-format-markdown

baoyu-format-markdown is a skill for Claude Code from JimLiu/baoyu-skills. It costs 61 tokens per session (3,297 once invoked), scanned A, original, MIT.

A Markdown formatting tool that improves the layout of plain text or Markdown files without changing their content. It can add front matter, titles, summaries, headings, bold text, lists and code blocks, while fixing obvious typos.

In plain words
What is it for?
Use it to format articles, notes and documentation, add clear sections, or prepare a Markdown file for readers.
Why use it?
It makes an unstructured document easier to read while keeping the original information intact. This is useful when the content is written but its presentation is inconsistent.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: names the AskUserQuestion tool; built for openclaw.

Part of the baoyu-skills plugin — 21 skills shipped together

not rated 26krepo +149 2d ago A scan Socket: passSnyk: warnSkillSpector: warn 61 tokens original MIT

Good fit Use it to format articles, notes and documentation, add clear sections, or prepare a Markdown file for readers.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jimliu/baoyu-skills/baoyu-format-markdown
About the project

baoyu-skills is a collection of reusable skills that give AI coding agents instructions for tasks such as preparing and publishing content. It supports agents including Claude Code, Codex, and OpenClaw, with users installing only the workflows they need. The catalogue contains selected skills from this collection.

JimLiu/baoyu-skills · 25,803 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add JimLiu/baoyu-skills --skill baoyu-format-markdown
Clone the repo
git clone --depth 1 https://github.com/JimLiu/baoyu-skills

Made for: Claude Code.

Or install baoyu-skills, the plugin that ships this one along with the rest of its 21 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for baoyu-format-markdown

README.md
[![agentmods](https://agentmods.dev/badge/skills/jimliu/baoyu-skills/baoyu-format-markdown/github.svg)](https://agentmods.dev/skills/jimliu/baoyu-skills/baoyu-format-markdown)
Your own site
<a href="https://agentmods.dev/skills/jimliu/baoyu-skills/baoyu-format-markdown"><img src="https://agentmods.dev/badge/skills/jimliu/baoyu-skills/baoyu-format-markdown/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for baoyu-format-markdown

Your own site · 80×15
<a href="https://agentmods.dev/skills/jimliu/baoyu-skills/baoyu-format-markdown"><img src="https://agentmods.dev/badge/skills/jimliu/baoyu-skills/baoyu-format-markdown.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,297 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 20 Apr 2026
  • Snyk warn 20 Apr 2026
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium MCP Rug Pull · line 32
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.03297
Opus 5 $0.00030 $0.01648
Sonnet 5 $0.00012 $0.00659
Haiku 4.5 $0.00006 $0.00330

Measured 12d ago against content hash 39bd9eeb5373, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

baoyu-format-markdown scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 3 executable files (scripts/autocorrect.ts, scripts/main.ts, scripts/quotes.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

3 near-identical copies found in the catalogue:

skills/baoyu-format-markdown/SKILL.md · 356 lines

How it starts

The opening of the file, as written. The whole thing — 356 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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, request_user_input, clarify, ask_user, 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 ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun. Replace {baseDir} and ${BUN_X} 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 ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md XDG
3 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md User home

Read the full file on GitHub · 356 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 356 lines · 61 tokens per session scan A 39bd9eeb5373

Subscribe to this mod's changes

baoyu-format-markdown is a skill published in the GitHub repository JimLiu/baoyu-skills (25,803 stars, last pushed 2d ago), licensed MIT. It adds 61 tokens to every session and 3,297 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

sync-claude-accounts

Distribute full OAuth Claude Code credentials (claude-accounts.json) from a single designated refresh-authority Mac to the rest of a fleet, and operate the scheduled automation that does it — the com.claude.fleet-refresh and com.claude.fleet-health LaunchAgents, their logs, and the proactive refresh that keeps…

soulmachine/skills · 195 tokens

swe-workflow

Orchestrates the full five-stage flow from raw idea to shipped PR — grill-with-docs → to-prd → to-issues → triage → worktree+planning-with-files. Each stage answers one question (What do I want? / What does done look like? / What are the units of work? / What's actionable? / Build it). Use when the user has an idea…

soulmachine/skills · 126 tokens

affix-domains

Attach popular brand prefixes/suffixes to a seed word and check availability against the authoritative registry. Starts at .com; if the seed word's own .com is taken, escalates the whole sweep to .com/.net/.org/.ai/.io/.co/.app/.cc. Use when the user names a word and asks for prefix/suffix domain variants, or wants…

soulmachine/skills · 127 tokens

llm-inference-benchmark

Benchmark OpenAI-compatible LLM inference servers (vLLM, SGLang, or anything serving /v1/completions; local, cross-host via TARGETHOST= , or behind a TLS+Bearer proxy via --base-url + OPENAIAPIKEY) with sglang.benchserving run as a standalone dockerized client — one engine-agnostic script (scripts/benchsweep.sh)…

soulmachine/skills · 0 tokens

cua-macos-lume-sandbox

Provision a macOS VM as a cua computer-use sandbox with lume on Apple Silicon — pull or APFS-clone an image, size it, ensure autologin, install cua-driver plus a LaunchAgent, grant TCC unattended when SIP is off, set the guest resolution, and verify with a real screen capture. Use when asked to set up, rebuild, or…

soulmachine/skills · 128 tokens

ssh-claude-auth

Fix Claude Code appearing logged-out over SSH on a headless macOS machine — its credentials sit in the login keychain, which stays locked in SSH/headless sessions. Offers two fixes and asks the user to choose: a keychain-free long-lived setup-token, or auto-unlocking the login keychain with a stored password (required…

soulmachine/skills · 0 tokens