skilld
All skills
jimliu avatar

/baoyu-format-markdown

@2c800c6 official
by Jim Liu 宝玉jimliu/baoyu-skills26k stars
2,896

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/jimliu/baoyu-skills/baoyu-format-markdown

This session only. Nothing lands on disk.

referencestitle-formulas.md

≈733 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Title Formulas Reference

8 hook formulas + straightforward style for balanced title generation.

Hook Formulas

# Formula Characteristics Example
1 Subversive Deny common belief, create cognitive conflict "All de-AI-flavor prompts are wrong"
2 Solution Give the answer directly, promise concrete value "One recipe to make AI write in your voice"
3 Suspense Reveal half, spark a curiosity gap "It took me six months to find how to remove AI flavor"
4 Concrete Number Use specific numbers for credibility and impact "150 lines of docs taught AI my writing style"
5 Contrast Small cause → big result, or expectation vs reality "One doc replaced three months of AI tuning"
6 Result First Lead with a surprising outcome, hook reader to find out why "After using this method, nobody could tell it was AI"
7 Rhetorical Question Ask a question that creates an unfinished feeling "Why can people spot your AI writing at a glance?"
8 Empathy Touch pain points, trigger shared frustration or relief "Three months fighting AI flavor — I finally broke free"

When to pick each formula

Formula Best for
Subversive Articles that challenge mainstream advice or debunk myths
Solution How-to guides, tutorials, actionable advice pieces
Suspense Personal stories, case studies, journey narratives
Concrete Number Data-driven articles, benchmarks, step-by-step guides
Contrast Before/after stories, unexpected discoveries, comparisons
Result First Success stories, transformation pieces, "I tried X" articles
Rhetorical Question Problem-awareness pieces, diagnostic/explainer content
Empathy Struggle narratives, community pain points, relatable experiences

Straightforward Style

Not every title needs a hook. Straightforward titles work well as alternatives:

  • Descriptive: clearly state the topic and scope
  • Declarative: state the main conclusion or thesis directly

These provide balance — readers who prefer clarity over curiosity will appreciate them.

Title Principles

  • Hook in first 5 characters: create information gap or cognitive conflict
  • Specific > abstract: "150 lines" beats "a document"
  • Negation > affirmation: "you're doing it wrong" beats "the right way"
  • Conversational: like chatting with a friend, not an academic paper
  • Max ~30 characters: longer titles get truncated in feeds
  • Accurate, not clickbait: the article must deliver what the title promises — titles can be bold but the content must back them up

Prohibited Patterns

  • Vague academic-style: "On XX", "Thoughts on XX", "Exploration and Practice of XX"
  • Pure shock bait: "Shocking!", "10,000-word essay", "Must bookmark"
  • Directionless questions: "Where is the future of AI writing?"

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is functional and generally safe, but it contains an indirect prompt injection surface because it reads and processes arbitrary user-supplied documents without explicit boundary delimiters or content isolation.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    1/7 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 2c800c6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 6 months ago

Capability

version
1.57.0
Other metadata
metadata
{
  "openclaw": {
    "homepage": "https://github.com/JimLiu/baoyu-skills#baoyu-format-markdown",
    "requires": {
      "anyBins": [
        "bun",
        "npx"
      ]
    }
  }
}

Topics

  • markdown
  • formatting
  • typography
  • cjk
  • remark
  • frontmatter
  • content-structure

README badge

README badge for jimliu/baoyu-skills/baoyu-format-markdown

What it does

Formats plain text and markdown files into reader-friendly layouts with improved headings, bold, lists, and code blocks—without altering content. Runs typography fixes for CJK/English spacing and quote normalization via a bundled script.

Generated from the current SKILL.md.

Frequently asked

Does this skill modify my original file?
No. The skill outputs to a new file named `{filename}-formatted.md`. Your original file is never changed unless you explicitly choose the 'Typography fixes only' option, which modifies the original in place.
What happens if my file already has markdown formatting?
The skill detects existing markdown and offers three choices: optimize formatting (analyze and improve structure), keep original formatting (run typography fixes only), or typography fixes only (no copy created). You control what happens.
Does this skill add, delete, or rewrite content?
No. The skill only adjusts formatting and fixes obvious typos. It preserves every word, the author's voice, and all original content.
What does the typography script do?
It replaces ASCII quotes with fullwidth quotes, adds CJK/English spacing, and fixes CJK emphasis punctuation. These are optional transformations controlled by command-line flags.
Can I customize formatting behavior?
Yes. Create an EXTEND.md file in `.baoyu-skills/baoyu-format-markdown/` (project scope), your XDG config directory, or home directory to set `auto_select`, `auto_select_title`, `auto_select_summary`, and other typography preferences.

Generated from the current SKILL.md. These answers refresh after source changes.