md-report-summary
This skill produces polished Markdown documents for weekly reports, work summaries, project recaps, and introductions. It handles two workflows: when you provide a draft, it refines structure, language, and completeness while preserving all tables, data, and images; when starting fresh, it searches for context and applies templates. Output follows quality standards emphasizing concrete results, quantified metrics, and actionable next steps over generic statements.
md-report-summary generates polished Markdown weekly reports, work summaries, and project recaps from your notes or web research.
AI-generated summary based on this skill's SKILL.md
Install
xstongxue/best-skills/md-report-summary · repository language: JavaScript
git clone https://github.com/xstongxue/best-skills
cp -r best-skills/skills/md-report-summary ~/.claude/skills/md-report-summaryFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does md-report-summary generate weekly report markdown?
md-report-summary produces polished Markdown documents for weekly reports by refining structure, language, and completeness. When you provide a draft, it preserves all tables, data, and images while enhancing clarity. When starting fresh, it searches for context and applies templates. Output emphasizes concrete results, quantified metrics, and actionable next steps over generic statements.
Can md-report-summary create a work summary document?
Yes. md-report-summary generates work summary documents in Markdown format tailored to your needs. It handles project recaps, retrospectives, and performance reviews with structured formatting. The skill applies quality standards that prioritize concrete results and measurable outcomes, ensuring your summary communicates impact clearly to your intended audience.
What should I do to write a weekly status update with this skill?
md-report-summary helps you write weekly status updates by either polishing an existing draft or creating one from scratch. Provide your raw notes or accomplishments, and the skill refines them into a well-structured Markdown document. It emphasizes quantified metrics and actionable next steps, transforming informal updates into professional reports.
Does md-report-summary offer different report templates?
md-report-summary supports multiple template options, including APB (Accomplishments, Plans, Blockers) and 3P formats designed for different audiences. Choose the template that best fits your reporting context—whether for team status updates, individual performance summaries, or project retrospectives—and the skill applies it consistently.
How does md-report-summary polish an existing draft?
When you provide a draft, md-report-summary enhances structure and clarity while preserving all your original tables, data, and images. It refines language, improves organization, and ensures completeness without altering your core content. This approach maintains your voice while elevating presentation quality.
What output quality standards does md-report-summary follow?
md-report-summary emphasizes concrete results, quantified metrics, and actionable next steps over generic statements. Every report prioritizes clarity and impact, ensuring readers understand what was accomplished, what's planned, and what obstacles need attention. This focus on specificity makes reports more useful for decision-making and accountability.
SKILL.md
rendered from the published skill — quoted content, verbatim
Markdown 周报 / 汇报 / 总结 / 介绍
一、任务识别
| 文档类型 | 触发词 |
|---|---|
| 周报 | 周报、本周总结、weekly report |
| 工作汇报 | 工作汇报、汇报材料、进度汇报 |
| 总结 | 总结、复盘、阶段总结、项目总结 |
| 介绍 | 介绍、简介、项目介绍、个人介绍 |
周报类型选择
识别到「周报」类任务后，先询问用户选择周报类型，再继续后续流程：
> 请选择周报类型（默认：结果导向周报）： > 1. 结果导向周报 — APB（默认）— Accomplishments · Plans · Blockers，量化结果 / 下步方向 / 需要的资源与协助，适合向上汇报或跨团队对齐 > 2. 标准周报 — 3P Report — Progress · Plans · Problems，本周完成 / 进行中 / 下周计划 / 问题与风险，适合团队内部同步
用户未指定类型时，默认使用结果导向周报。用户选定后，按对应模板执行后续流程。
二、流程分支
| 情况 | 执行 |
|---|---|
| 未提供草稿 | 执行「三、无草稿流程」 |
| 已提供草稿 | 执行「四、有草稿流程」 |
三、无草稿流程
- 确认信息：向用户确认主题、时间范围、受众、重点方向
- Web 搜索：用
WebSearch搜索相关背景、行业进展、最佳实践（搜索结果仅作参考，不可直接照抄） - 选模板：按 reference/templates.md 选择对应模板
- 撰写：按「六、写作质量标准」填充内容并输出
四、有草稿流程
- 读取草稿：读取用户粘贴的内容或文件路径中的草稿
- 分析草稿：识别结构完整性、遗漏点、可优化表述
- 整理输出：
- 表格、列表、引用块、数据、图片全部原样保留，不删减、不概括
- 图片引用
路径不可修改，原样保留 - 润色语句、理顺段落逻辑、补充过渡语
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
skills/md-report-summary/SKILL.md
skills/md-report-summary/reference/templates.md