CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

help-me-review

Guide a Chinese-speaking user through code or a PR while reviewing correctness. Trigger on 帮我review, 带我读代码, or an explicit implementation walkthrough.

70

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally lean, high-signal instruction body: a clear sequenced review workflow with explicit validation boundaries (evidence per finding, unrun checks labeled, no unfounded issues), well-organized sections, and an appropriate authorization guardrail for write actions. Its only gap is the absence of literal command examples or a sample finding format.

DimensionReasoningScore

Conciseness

The ~14-line body is lean and dense: every sentence adds non-obvious guidance (verify repo/base/head/CI first, treat PR text as unverified material, mark unrun checks, don't promise no bugs). It explains nothing Claude already knows, matching the anchor-5 'every token earns its place' example rather than the anchor-4 case of minor over-explanation.

5 / 5

Actionability

For an instruction-only skill the guidance is concrete and specific: named tools (local Git, rg, repo CLI), a defined reading path (entry/API → data structures → algorithm → state → integration → tests), explicit output requirements (trigger conditions, consequences, exact file/line per finding), and a stated severity ordering. It falls short of anchor 5 only because there are no copy-paste-ready commands or a worked example of a finding's format; it clearly exceeds anchor 3, whose hallmark is pseudocode or missing key details.

4 / 5

Workflow Clarity

The process is clearly sequenced (verify context → read along the call chain → analyze with stated focus areas → report with severity ordering → run matching tests) and includes explicit checkpoints: distinguish confirmed defects vs. unverified suspicions vs. style preferences, only do static reading when the user asked for a walkthrough, and explicitly label any check that was not run. This matches anchor 5's 'clear sequence with explicit validation steps'; the destructive/batch cap of 3 does not apply since the skill is read-only plus running tests.

5 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external reference files (none are provided in the bundle), and is well organized into an opening scope line, five numbered steps, an output-format paragraph, and a final authorization boundary. Per the rubric's guideline for short single-purpose skills, this earns anchor 5; there are no buried or nested references to penalize.

5 / 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.

A compact, third-person description that clearly pairs a what-statement with explicit trigger phrases, including natural Chinese trigger terms. Its main gaps are modest action specificity and missing common trigger synonyms, which leave minor overlap risk with generic code-review skills.

Suggestions

Enumerate the concrete actions more specifically (e.g. 'walks the call chain, verifies findings with file/line evidence, runs matching tests') to raise specificity beyond one to two generic actions.

Add common trigger synonyms such as 代码review, 看代码, 代码审查, or 'review my code/PR' so the trigger clause covers the natural phrasings users actually say.

Sharpen the what-statement to state the deliverable (e.g. severity-ranked findings plus a guided walkthrough) so it is even more clearly distinguishable from a generic code-review skill.

DimensionReasoningScore

Specificity

The description names the domain (guided code/PR review) and one to two concrete actions — "Guide a Chinese-speaking user through code or a PR while reviewing correctness" — but does not enumerate several specific actions the way the anchor-5 PDF example does (extract, fill, merge, convert). It fits anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4, which expects a list of several distinct specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: what ("Guide a Chinese-speaking user through code or a PR while reviewing correctness") and when ("Trigger on 帮我review, 带我读代码, or an explicit implementation walkthrough") with concrete trigger phrases, matching the anchor-5 example pattern of action statement + explicit 'use when' clause. The 'Trigger on...' clause is equivalent explicit trigger guidance, so the completeness cap of 3 for a missing trigger clause does not apply.

5 / 5

Trigger Term Quality

"Trigger on 帮我review, 带我读代码, or an explicit implementation walkthrough" provides natural phrases a Chinese-speaking user would plausibly say, plus an English trigger. It sits at anchor 4 ('good keyword coverage; a few natural terms missing') rather than 5 because common synonyms are absent — e.g. 代码review, 看代码, 代码审查, or plain 'review my code/PR'.

4 / 5

Distinctiveness Conflict Risk

The niche (guided review for a Chinese-speaking user) with Chinese-language triggers is mostly distinct from generic review skills, fitting anchor 4. It is not a 5 because 'code or a PR while reviewing correctness' and the English trigger 'an explicit implementation walkthrough' overlap with general code-review skills — a plain 'review this PR' request could plausibly match both this and a generic review skill.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

huangruiteng/CS-Notes

Path

.codex/skills/help-me-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.