CtrlK
BlogDocsLog inGet started
Tessl Logo

pr

用于撰写 PR 正文。适用于用户要求起草、改写或改进 PR 正文,或希望 PR 更便于审阅时。

70

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

The body is a strong example of skill writing: a concrete fill-in template, one worked example per diagram form, and terse per-section rules with zero filler. The only structural question is that the sizable example gallery is fully inlined rather than split into a reference file, and one component-tree example appears mangled.

DimensionReasoningScore

Conciseness

Lean and efficient: no explaining what a PR is or why reviews matter; every example block demonstrates a concrete format choice (pseudocode, call tree, file tree, mermaid, diff, full code) and each earns its place, with guidance like "保持文字简短" and "不要让用户承受过多信息".

5 / 5

Actionability

Provides a copy-paste-ready template with placeholders and one concrete worked example for every visualization form, so the common cases are fully covered; the only blemish is the slightly garbled component-tree example, which is too minor to drop below the anchor.

5 / 5

Workflow Clarity

A single, unambiguous action — fill in the given template — with explicit per-section rules for Summary, Evidence, and Merge Danger; it involves no destructive or batch operations, so no validation checkpoints are needed and the simple-skill condition for a 5 applies.

5 / 5

Progressive Disclosure

Sections are well organized with no external references (none exist, which is appropriate), but the ~155-line body keeps everything inline — the gallery of seven visualization examples and four diff variants could plausibly live in a reference file, which is the minor organization gap that keeps it at anchor 4.

4 / 5

Total

19

/

20

Passed

Description

78%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.

The description is compact and complete, explicitly stating both what the skill does and concrete conditions for use, with mostly natural trigger phrasing. It is held back from a top score mainly by a thin 'what' — it names only the single action of writing PR bodies without hinting at the template or structure the skill provides.

Suggestions

Enumerate what the skill actually delivers in the 'what' clause, e.g. "按照 Summary/Evidence/Merge Danger 模板撰写 PR 正文,并选用 diff、调用树或文件树等图示" — this would lift specificity from anchor 3 toward 4-5.

Add common synonyms users might say, such as "PR 描述"、"pull request description"、"修改 PR 文案", to broaden trigger-term coverage.

Clarify the deliverable boundary (only the PR body text, not the code changes) to further reduce overlap risk with general writing or review skills.

DimensionReasoningScore

Specificity

Names the domain ("PR 正文") and the core action ("撰写"), with "起草、改写或改进" as near-synonymous variants of that one action; it does not enumerate what the skill actually produces (the template sections, diagrams, evidence format), so it matches anchor 3 rather than 4.

3 / 5

Completeness

Explicitly answers both: what ("用于撰写 PR 正文") and when ("适用于用户要求起草、改写或改进 PR 正文,或希望 PR 更便于审阅时") with concrete trigger scenarios, matching the anchor-5 pattern.

5 / 5

Trigger Term Quality

Contains natural phrases users would actually say — "起草" (draft), "改写" (rewrite), "改进" (improve), "更便于审阅" (easier to review), "PR 正文" — which is good keyword coverage, though common synonyms such as "PR 描述", "pull request", or "edit" are missing.

4 / 5

Distinctiveness Conflict Risk

A clear niche (writing PR bodies) with PR-specific triggers; only minor overlap risk with closely related skills such as commit-message writing or general document editing, matching anchor 4.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
vinvcn/mattpocock-skills-zh-CN
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.