Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结；有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。
Install Md Report Summary
$ npx skills add xstongxue/best-skills --skill md-report-summary -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install xstongxue/best-skills md-report-summary --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/md-report-summary .claude/skills/md-report-summary && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .claude/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summaryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add xstongxue/best-skills --skill md-report-summary -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install xstongxue/best-skills md-report-summary --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/md-report-summary .agents/skills/md-report-summary && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .agents/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add xstongxue/best-skills --skill md-report-summary -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install xstongxue/best-skills md-report-summary --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/md-report-summary .cursor/skills/md-report-summary && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .cursor/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/xstongxue/best-skills.git --path skills/md-report-summary--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add xstongxue/best-skills --skill md-report-summary -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install xstongxue/best-skills md-report-summary --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/md-report-summary .gemini/skills/md-report-summary && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .gemini/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install xstongxue/best-skills md-report-summaryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add xstongxue/best-skills --skill md-report-summary -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/md-report-summary .github/skills/md-report-summary && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .github/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add xstongxue/best-skills --skill md-report-summary -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install xstongxue/best-skills md-report-summary --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xstongxue/best-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/md-report-summary .opencode/skills/md-report-summary && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "md-report-summary" agent skill from https://github.com/xstongxue/best-skills/tree/main/skills/md-report-summary into .opencode/skills/md-report-summary/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "md-report-summary", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
md-report-summary- GitHub stars
- 3k
- Token cost
- ~495 tokens
- SKILL.md length
- 114 words
- Files
- 2
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结；有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。
- Works in 4 steps: 确认信息：向用户确认主题、时间范围、受众、重点方向 → Web 搜索：用 WebSearch… → 选模板：按 reference/templates.md 选择对应模板 → …
- Tasks that involve Markdown
- SKILL.md covers 一、任务识别, 二、流程分支, 三、无草稿流程 and 四、有草稿流程, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Md Report Summary is an agent skill from xstongxue/best-skills. 生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结；有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。
Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `reference/templates.md`).
It sits in Documents & Office, covering Markdown. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Markdown
Example prompts
- “/md-report-summary”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- 确认信息：向用户确认主题、时间范围、受众、重点方向
- Web 搜索：用 WebSearch 搜索相关背景、行业进展、最佳实践（搜索结果仅作参考，不可直接照抄）
- 选模板：按 reference/templates.md 选择对应模板
- 撰写：按「六、写作质量标准」填充内容并输出
What it can do on your machine
Read from SKILL.md and the folder at commit 9aa4e55. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Md Report Summary loads about 495 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 114 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from xstongxue/best-skills at commit 9aa4e55, republished under its Apache-2.0 licence (© xstongxue). 114 words, ~495 tokens.
Download SKILL.mdSave it as
.claude/skills/md-report-summary/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- md-report-summary
- description
- 生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结；有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。
Markdown 周报 / 汇报 / 总结 / 介绍
一、任务识别
| 文档类型 | 触发词 |
|---|---|
| 周报 | 周报、本周总结、weekly report |
| 工作汇报 | 工作汇报、汇报材料、进度汇报 |
| 总结 | 总结、复盘、阶段总结、项目总结 |
| 介绍 | 介绍、简介、项目介绍、个人介绍 |
周报类型选择
识别到「周报」类任务后，先询问用户选择周报类型，再继续后续流程：
请选择周报类型（默认：结果导向周报）：
- 结果导向周报 — APB（默认）— Accomplishments · Plans · Blockers，量化结果 / 下步方向 / 需要的资源与协助，适合向上汇报或跨团队对齐
- 标准周报 — 3P Report — Progress · Plans · Problems，本周完成 / 进行中 / 下周计划 / 问题与风险，适合团队内部同步
用户未指定类型时，默认使用结果导向周报。用户选定后，按对应模板执行后续流程。
二、流程分支
| 情况 | 执行 |
|---|---|
| 未提供草稿 | 执行「三、无草稿流程」 |
| 已提供草稿 | 执行「四、有草稿流程」 |
三、无草稿流程
- 确认信息：向用户确认主题、时间范围、受众、重点方向
- Web 搜索：用
WebSearch搜索相关背景、行业进展、最佳实践（搜索结果仅作参考，不可直接照抄） - 选模板：按 reference/templates.md 选择对应模板
- 撰写：按「六、写作质量标准」填充内容并输出
四、有草稿流程
- 读取草稿：读取用户粘贴的内容或文件路径中的草稿
- 分析草稿：识别结构完整性、遗漏点、可优化表述
- 整理输出：
- 表格、列表、引用块、数据、图片全部原样保留，不删减、不概括
- 图片引用
路径不可修改，原样保留 - 润色语句、理顺段落逻辑、补充过渡语
- 缺失章节可用
WebSearch补充，但需注明为补充内容
- 输出：整理后的完整 Markdown
五、通用原则
- 不省略：有草稿时，原内容（表格、数据、图片、引用块）全部保留
- 不编造：不虚构草稿中不存在的事实；搜索补充内容需概括性表述，不夸大
- 图片原样：
中的路径绝对不能修改 - 格式统一：标题层级清晰，列表、表格按需使用，不滥用加粗
六、写作质量标准
高质量输出需满足以下要求：
内容层面
- 有结论，不只有陈述：每个工作项应写清楚"做了什么 → 结果/进展如何"，而非只罗列动作
- 🚫 差：
完成了模型测试 - 👍 好：
完成 Qwen3.5-122B-A10B-AWQ 在 4×24G NVIDIA 环境下的高考模拟卷测试，错题率降至 1/18，推荐作为 NVIDIA 多卡方案首选
- 🚫 差：
- 数据具体：尽可能保留时间、数量、百分比等量化信息
- 问题定位清晰：问题描述需包含"现象 → 根因 → 影响范围"三要素
- 计划可执行：下周计划要具体，写清楚目标和预计时间，不写"继续推进"类空话
结构层面
- 用小标题区分不同业务模块，避免将所有内容塞进一个列表
- 多项工作优先用表格呈现对比（如模型测试结果），清晰直观
- 重要结论或推荐可用**引用块（
>）**突出
语言层面
- 主动语态，简洁直接
- 专业术语保留（如模型名称、参数名、配置规格），不转译成模糊表述
- 同一事物前后用词一致
七、参考资源
© xstongxue, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in skills/md-report-summary of xstongxue/best-skills.
- SKILL.md
- reference/templates.md
Open the folder on GitHubat commit 9aa4e55
Compare with similar skills
Md Report Summary next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Md Report Summary this skillxstongxue/best-skills | 3k | — | ~495 | Automated safety check: Pass | Apache-2.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 27k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Crosspostingwasp-lang/wasp | 19k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Gzh Designisjiamu/gzh-design-skill | 4k | — | ~2.2k | Automated safety check: Pass | AGPL-3.0 |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
Crossposting
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
- Official
Review The Docs
supabase/supabase
Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).
More from xstongxue/best-skills
All 15 skills in this repoCreate Skill
xstongxue/best-skills
Guides users through creating effective Agent Skills for Cursor.
Office File Process
xstongxue/best-skills
处理 Office 文档的一站式 skill：Word(.doc/.docx/.dotx)、Excel(.xls/.xlsx/.xlsm/.csv)、PowerPoint(.ppt/.pptx/.potx) 的创建、读取、编辑、提取、转换、校验。触发：『读取 word 文档』『提取 excel 内容』『看 ppt 讲了什么』、.doc 老格式打不开、生成/编辑 Word…
Pptgen Drawio
xstongxue/best-skills
根据论文或汇报内容生成多页 Draw.io 格式 PPT，支持论文答辩与通用汇报两种模式，自动导出为 .pptx。当用户提到论文答辩 PPT、答辩幻灯片、通用 PPT、汇报 PPT、根据模板生成 PPT、drawio2pptx 时使用。
Wechat Article Writer
xstongxue/best-skills
公众号/自媒体全流程。根据用户表述自动匹配：撰写文章、封面图、正文插图、风格提取。支持多种写作风格。当用户提到写公众号、技术博客、公众号封面、正文插图、步骤图、演示图、流程示意、分析写作风格、克隆文风、模仿爆款、提取风格时使用。详见 reference 目录。
Drawio Diagram
xstongxue/best-skills
为深度学习模型、网络架构、算法流程等生成标准 Draw.io (.drawio) 格式的可视化图表；支持从零生成与风格迁移两种模式。从零生成：模型架构图、流程图、感受野示意图等；风格迁移：参考图 + 内容描述/项目 → 按参考图风格生成新图。确保 XML 格式正确，可直接在 Draw.io 中打开编辑。
Project Docs
xstongxue/best-skills
对任意代码项目生成一套面向新人的循序渐进文档集，输出到 docs/ 目录。含架构、设计思想、语言特性、代码导读、运行时模型、构建、对接、调试、设计规范共 9 篇，支持全部生成 / 只写几篇 / 更新已有文档。当用户提到"生成项目文档"、"新人文档"、"上手文档"、"架构文档"、"代码导读"、"项目理解"、"深入理解项目"、"onboarding…
Related
Categories
Questions about Md Report Summary
What does Md Report Summary do?
生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结；有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。. Md Report Summary is an agent skill from xstongxue/best-skills.
When should I use Md Report Summary?
Md Report Summary fits situations like: tasks that involve Markdown.
How do I install Md Report Summary in Claude Code?
Run `npx skills add xstongxue/best-skills --skill md-report-summary -a claude-code`. Or copy the skill folder (skills/md-report-summary in xstongxue/best-skills) into .claude/skills/md-report-summary in your project. Claude Code loads it when a task matches its description.
How do I install Md Report Summary in Codex?
Run `npx skills add xstongxue/best-skills --skill md-report-summary -a codex`. Or copy the skill folder (skills/md-report-summary in xstongxue/best-skills) into .agents/skills/md-report-summary in your project. Codex loads it when a task matches its description.
Can I use Md Report Summary in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xstongxue/best-skills --skill md-report-summary -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/md-report-summary, .gemini/skills/md-report-summary, .github/skills/md-report-summary and .opencode/skills/md-report-summary in your project.
What does Md Report Summary need to run?
SKILL.md names no scripts, command-line tools or credentials: Md Report Summary is instructions for the agent only.
Does Md Report Summary access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Md Report Summary safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Md Report Summary use?
Md Report Summary is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Md Report Summary use?
About 495 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Md Report Summary?
Skills that share tags, products or a category with Md Report Summary: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Crossposting (wasp-lang/wasp, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Md Report Summary?
xstongxue (a GitHub user) maintains it in xstongxue/best-skills, which has 2,966 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 13, 2026.
Source: xstongxue/best-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.