CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-review

仅当用户明确手动指定使用 pr-review skill 时触发;不要因为用户传入 PR 链接、要求 review 或要求代码审查而自动触发。

56

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/system/pr-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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-engineered review workflow: concrete commands, explicit stage gating, parallelizable phases, and a ready-to-use report template. Its main defects are a missing reference bundle (all checklist links dangle) and one dense inline spec section that should live in its own file.

Suggestions

Ship the referenced checklist files (backend-quality/, frontend-quality/, style/) or inline their key checks — currently every '- []' checklist item links to a nonexistent file.

Move the long inline i18n static-key rule into a dedicated reference file (e.g. style/i18n.md) and keep only a one-line pointer in the phase checklist.

Fix or drop out-of-bundle relative links like '../../../design/api/index.md' and '../../../code/syntax.md', which point outside the skill directory.

DimensionReasoningScore

Conciseness

The body is lean and command-driven — 'gh pr view <number> --json ...', worktree setup, and the report template all carry actionable content with minimal padding. It only slips slightly toward over-explanation in places like '# 进入该目录安装依赖、运行测试' repeating what the commands below already show.

4 / 5

Actionability

Nearly everything is copy-paste ready: concrete gh/git commands, a complete JSON payload for line-level review comments, pnpm tsc/test invocations, and a command reference table. The gap is that several checklist items point to files that do not exist in the bundle (e.g. './backend-quality/security.md', './style/db.md'), leaving those steps non-executable.

4 / 5

Workflow Clarity

The sequence is explicit and gated: '步骤 0:拉取代码' → phase 1 (requirement understanding + test-case reasoning) → phases 2–6 explicitly marked '可以并行执行' → final report. It contains a real feedback loop in the '阶段门控' ('立即跳过后续阶段... 请求作者澄清或修复后再继续审查') plus validation via 'gh pr checks', 'pnpm tsc --noEmit' and 'pnpm test'.

5 / 5

Progressive Disclosure

The body itself is well structured with clearly signaled one-level checklist links ('[后端安全](./backend-quality/security.md)', '[前端组件规范](./style/front.md)'), but no bundle files exist — references/, scripts/, assets/ are all absent, so every linked checklist is a dead end. The dense inline i18n rule ('禁止 t(`ns:key_${value}`)...') is also content that belongs in a separate reference file.

3 / 5

Total

16

/

20

Passed

Description

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

This is a deliberately scoped anti-trigger description: it is unambiguous about when the skill may fire and explicitly guards against conflicts with generic review requests. However, it never says what the skill does, so a reader cannot tell its capabilities from the description alone.

Suggestions

Add a capability clause, e.g. '对 Pull Request 进行分阶段系统性代码审查(需求理解、后端/前端质量、规范、测试覆盖、回归风险),并提交行级评论与分级审查报告。'

Keep the manual-only trigger constraint but append it after the 'what' statement so the description answers both halves of the completeness question.

Optionally include a couple of additional natural trigger phrasings (审查、diff、PR diff) in the do-not-auto-trigger list so coverage of user phrasings is comprehensive.

DimensionReasoningScore

Specificity

The description names the domain via the skill name ('pr-review skill') but describes zero concrete actions — phrases like '仅当用户明确手动指定使用 pr-review skill 时触发' are purely about triggering. Nothing states what the skill actually does (staged PR review, line-level comments, report generation).

2 / 5

Completeness

Only the 'when' half is present: '仅当用户明确手动指定使用 pr-review skill 时触发;不要因为用户传入 PR 链接...自动触发'. The 'what' is entirely missing — matching the anchor for 'when' present without 'what' ('Use when working with documents').

2 / 5

Trigger Term Quality

It contains the natural phrases users actually say — 'PR 链接', 'review', '代码审查', '使用 pr-review skill', '$pr-review' — with good keyword coverage. A few variations (diff, 审查, merge request) are absent, and the terms appear as anti-triggers rather than positive triggers.

4 / 5

Distinctiveness Conflict Risk

The explicit-only trigger design ('仅当用户明确手动指定') with a list of phrases that must NOT auto-trigger ('PR 链接、要求 review、要求代码审查') makes accidental triggering against generic review requests essentially impossible — minimal conflict risk by construction.

5 / 5

Total

13

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 11 missing, 2 suspicious

Warning

Total

15

/

16

Passed

Repository

labring/FastGPT

Path

.agents/skills/system/pr-review/SKILL.md

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.