md-report-summary

md-report-summary is a skill for Claude Code, Codex from xstongxue/best-skills. It costs 70 tokens per session (1,166 once invoked), scanned A, original, Apache-2.0.

A guide for producing Markdown weekly reports, work updates, summaries, project reviews, and introductions. With no draft it uses web research; with a draft it organizes and polishes the supplied material while preserving tables, data, quotes, and image paths.

In plain words
What is it for?
Use it to write or revise weekly reports, status updates, project summaries, retrospectives, and introductions.
Why use it?
It helps turn rough information into a clear report while reducing the risk of losing important source details.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to write or revise weekly reports, status updates, project summaries, retrospectives, and introductions.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xstongxue/best-skills/md-report-summary
About the project

best-skills is a collection of reusable skills for coding agents, including tools for writing papers, creating diagrams and presentations, generating code documentation, and other tasks. Users install its skills into agents such as Cursor, Claude Code, Codex, or OpenClaw so those agents can recognize relevant requests and run the corresponding workflows. The catalogue entries are examples of the skills included in the collection.

xstongxue/best-skills · 2,814 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 xstongxue/best-skills --skill md-report-summary
Clone the repo
git clone --depth 1 https://github.com/xstongxue/best-skills

Made for: Claude Code, Codex.

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 md-report-summary

README.md
[![agentmods](https://agentmods.dev/badge/skills/xstongxue/best-skills/md-report-summary/github.svg)](https://agentmods.dev/skills/xstongxue/best-skills/md-report-summary)
Your own site
<a href="https://agentmods.dev/skills/xstongxue/best-skills/md-report-summary"><img src="https://agentmods.dev/badge/skills/xstongxue/best-skills/md-report-summary/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 md-report-summary

Your own site · 80×15
<a href="https://agentmods.dev/skills/xstongxue/best-skills/md-report-summary"><img src="https://agentmods.dev/badge/skills/xstongxue/best-skills/md-report-summary.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,166 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
  • NVIDIA SkillSpector pass 7 Sept 2026
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.00070 $0.01166
Opus 5 $0.00035 $0.00583
Sonnet 5 $0.00014 $0.00233
Haiku 4.5 $0.00007 $0.00117

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

Security

Grade A, and why

md-report-summary 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 13d ago.

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.

skills/md-report-summary/SKILL.md · 90 lines

What it actually says

Markdown 周报 / 汇报 / 总结 / 介绍

一、任务识别

文档类型 触发词
周报 周报、本周总结、weekly report
工作汇报 工作汇报、汇报材料、进度汇报
总结 总结、复盘、阶段总结、项目总结
介绍 介绍、简介、项目介绍、个人介绍

周报类型选择

识别到「周报」类任务后,先询问用户选择周报类型,再继续后续流程:

请选择周报类型(默认:结果导向周报):

  1. 结果导向周报 — APB(默认)— Accomplishments · Plans · Blockers,量化结果 / 下步方向 / 需要的资源与协助,适合向上汇报或跨团队对齐
  2. 标准周报 — 3P Report — Progress · Plans · Problems,本周完成 / 进行中 / 下周计划 / 问题与风险,适合团队内部同步

用户未指定类型时,默认使用结果导向周报。用户选定后,按对应模板执行后续流程。

二、流程分支

情况 执行
未提供草稿 执行「三、无草稿流程」
已提供草稿 执行「四、有草稿流程」

三、无草稿流程

  1. 确认信息:向用户确认主题、时间范围、受众、重点方向
  2. Web 搜索:用 WebSearch 搜索相关背景、行业进展、最佳实践(搜索结果仅作参考,不可直接照抄)
  3. 选模板:按 reference/templates.md 选择对应模板
  4. 撰写:按「六、写作质量标准」填充内容并输出

四、有草稿流程

  1. 读取草稿:读取用户粘贴的内容或文件路径中的草稿
  2. 分析草稿:识别结构完整性、遗漏点、可优化表述
  3. 整理输出
  • 表格、列表、引用块、数据、图片全部原样保留,不删减、不概括
  • 图片引用 ![描述](路径) 路径不可修改,原样保留
  • 润色语句、理顺段落逻辑、补充过渡语
  • 缺失章节可用 WebSearch 补充,但需注明为补充内容
  1. 输出:整理后的完整 Markdown

五、通用原则

  • 不省略:有草稿时,原内容(表格、数据、图片、引用块)全部保留
  • 不编造:不虚构草稿中不存在的事实;搜索补充内容需概括性表述,不夸大
  • 图片原样![描述](路径) 中的路径绝对不能修改
  • 格式统一:标题层级清晰,列表、表格按需使用,不滥用加粗

六、写作质量标准

高质量输出需满足以下要求:

内容层面

  • 有结论,不只有陈述:每个工作项应写清楚"做了什么 → 结果/进展如何",而非只罗列动作
    • 🚫 差:完成了模型测试
    • 👍 好:完成 Qwen3.5-122B-A10B-AWQ 在 4×24G NVIDIA 环境下的高考模拟卷测试,错题率降至 1/18,推荐作为 NVIDIA 多卡方案首选
  • 数据具体:尽可能保留时间、数量、百分比等量化信息
  • 问题定位清晰:问题描述需包含"现象 → 根因 → 影响范围"三要素
  • 计划可执行:下周计划要具体,写清楚目标和预计时间,不写"继续推进"类空话

结构层面

  • 小标题区分不同业务模块,避免将所有内容塞进一个列表
  • 多项工作优先用表格呈现对比(如模型测试结果),清晰直观
  • 重要结论或推荐可用**引用块(>)**突出

语言层面

  • 主动语态,简洁直接
  • 专业术语保留(如模型名称、参数名、配置规格),不转译成模糊表述
  • 同一事物前后用词一致

七、参考资源

Files

What ships with it

1 file 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. 13d ago First seen · 90 lines · 70 tokens per session scan A a51471766c9c

Subscribe to this mod's changes

md-report-summary is a skill published in the GitHub repository xstongxue/best-skills (2,814 stars, last pushed 18d ago), licensed Apache-2.0. It adds 70 tokens to every session and 1,166 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

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

CherryHQ/cherry-studio · 64 tokens

gh-pr-review

Automated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks…

CherryHQ/cherry-studio · 147 tokens

prepare-release

Prepare a new release by collecting commits, generating bilingual release notes, updating version files, and creating a release branch. Use when asked to prepare/create a release, bump version, or run /prepare-release.

CherryHQ/cherry-studio · 44 tokens

claude-automation-recommender

Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, plugins, MCP servers). Use when user asks for automation recommendations, wants to optimize their Claude Code setup, mentions improving Claude Code workflows, asks how to first set up Claude Code for a project, or wants to know what…

CherryHQ/cherry-studio · 77 tokens

gh-create-issue

Use when user wants to create a GitHub issue for the current repository. Must read and follow the repository's issue template format.

CherryHQ/cherry-studio · 31 tokens

gh-create-pr

Create or update GitHub pull requests using the repository-required workflow and template compliance. Use when asked to create/open/update a PR so the assistant reads .github/pullrequesttemplate.md, fills every template section, preserves markdown structure exactly, and marks missing data as N/A or None instead of…

CherryHQ/cherry-studio · 65 tokens