CtrlK
BlogDocsLog inGet started
Tessl Logo

md-report-summary

生成高质量 Markdown 周报、工作汇报、总结、介绍等文档。无草稿时从 Web 搜索并总结;有草稿时结合草稿整理、润色、补充。当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用。

64

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/md-report-summary/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, mostly lean instruction skill with clear branching flows and a strong good/bad writing example. Its main weaknesses are a missing templates.md bundle file that the core flow depends on, no explicit output-validation checkpoint, and some duplicated preservation rules.

Suggestions

Ship the missing reference/templates.md bundle file (or inline the APB / 3P template structures directly in SKILL.md), since both the no-draft and with-draft flows rely on it but the file is absent from the bundle.

Add an explicit validation checkpoint before output — e.g., verify the result satisfies 六、写作质量标准 (conclusion-driven items, quantified data, 现象→根因→影响范围 problem framing) before returning it to the user.

De-duplicate the content/image preservation rules: 不省略 and 图片原样 are stated in both 四、有草稿流程 and 五、通用原则; consolidate into a single location to trim tokens.

DimensionReasoningScore

Conciseness

Mostly lean and well-organized with tables for task recognition and flow branches and no basic-concept padding; minor redundancy (图片原样/不省略 restated in both 四 and 五) could be trimmed, keeping it just below 5.

4 / 5

Actionability

Concrete flows, a useful 🚫/👍 example, and clear preservation rules are present, but the central executable step '按 reference/templates.md 选择对应模板' defers to a template file that is absent from the bundle, leaving a key gap.

3 / 5

Workflow Clarity

Clear sequenced flow (识别 → 询问类型 → 分支 → 撰写/整理 → 输出) with an explicit user-decision checkpoint and a default; lacks an explicit output-validation checkpoint, so it is below 5.

4 / 5

Progressive Disclosure

Good section structure with a clearly signaled one-level reference to reference/templates.md, but scoring against the actual (empty) bundle the referenced file does not exist, breaking navigation — a real gap that pulls it to 3.

3 / 5

Total

14

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states capabilities, branches on draft availability, and provides an explicit, keyword-rich 'use when' trigger clause in third-person voice. Minor gaps in action specificity and slight overlap risk with general writing skills keep it just short of a perfect score.

DimensionReasoningScore

Specificity

Names the domain (Markdown 周报/汇报/总结/介绍) and several concrete actions across two branches — '从 Web 搜索并总结' and '结合草稿整理、润色、补充' — covering search, organize, polish, and supplement, with only minor gaps.

4 / 5

Completeness

Explicitly answers both 'what' (生成高质量 Markdown 文档; no-draft vs with-draft handling) and 'when' with a concrete trigger clause '当用户提到周报、工作汇报、总结、介绍、述职、复盘时使用', matching the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms and variations users actually say: 周报、工作汇报、总结、介绍、述职、复盘 plus 'weekly report'; the synonym variants (述职/复盘) match the anchor for full coverage.

5 / 5

Distinctiveness Conflict Risk

Clear niche (structured Markdown report/summary generation) with distinct triggers and minimal conflict risk; only minor overlap possible with a generic writing/drafting skill, so it sits just below a perfect 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository
xstongxue/best-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.