CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-guide-updater

当用户明确要求"更新项目指南""同步指南""沉淀洞见到指南",或要求使用旧名 guide-updater skill 时使用。将对话中新产生的可复用写作洞见实时沉淀到项目指南文件,保持术语口径一致、结构稳定、可检验与可复现。调用时必须指定指南文件路径。

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/research-guide-updater/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, largely actionable instruction skill with a real validation script and one-level-deep bundle references that check out on disk. Its main costs are token weight from repeated mission text, generic boilerplate constraints, and off-task bug-reporting policy mixed into the execution steps, plus a few template-filler sections.

Suggestions

Conciseness: delete the verbatim re-statement of the description's mission sentence in the body, and move the 公共硬约束 boilerplate and the bensz-collect-bugs reporting policy into a separate reference file, keeping only a one-line pointer in SKILL.md.

Actionability: replace the circular template line "输出 Skill description 所承诺的交付物…" with a concrete output spec, e.g., the exact summary format to report (sections touched, bullets added, validation result).

Progressive disclosure / workflow: drop the inlined insight→section mapping in favor of the existing guide-structure-map.md reference (or trim the reference to avoid duplication), and number the actual edit steps (decompose → assign purpose → place → patch → validate) separately from the bug-policy bullets.

DimensionReasoningScore

Conciseness

The body is mostly tight, bullet-style guidance, but it pads in several places: the description's mission statement is repeated verbatim ("将对话中新产生的可复用写作洞见实时沉淀到项目指南文件…"), a large boilerplate 公共硬约束 block covers generic security/BAC/task-dir policy only tangentially related to this skill, and the 执行步骤 section opens with three bullets of bensz bug-reporting infrastructure policy before any actual task steps. This is 'mostly efficient but includes some unnecessary explanation' (anchor 3), not the lean anchor-4/5 profile.

3 / 5

Actionability

Concrete, executable guidance dominates: the exact invocation `/research-guide-updater --guide-path <路径>` with natural-language examples, an explicit insight-type → target-section mapping ("术语、缩写… → ## 命名与术语" etc.), a real validation command `python skills/research-guide-updater/scripts/validate_guide.py <指南文件路径>`, and concrete patch rules ("新增 1--3 条 bullet"). It falls short of anchor 5 only because a few sections are template filler — e.g., "输出 Skill description 所承诺的交付物" is circular and gives no concrete output format.

4 / 5

Workflow Clarity

The 输入 → 执行步骤 → 输出 → 校验 → 失败与恢复 skeleton is clear, and validation is explicit (run the validate script, then search for accidentally added `##` headings), with a stated recovery policy of retrying from the nearest failed step. It matches anchor 4 rather than 5 because the checkpoints lack a validate → fix → re-validate feedback loop and the actual edit steps inside 执行步骤 are unordered loose bullets interleaved with bug-policy content.

4 / 5

Progressive Disclosure

The bundle structure matches the body's references: `references/guide-structure-map.md` and `scripts/validate_guide.py` both exist, are one level deep, and are invoked with explicit read/run commands, plus a table explaining each bundle directory's purpose. It is not anchor 5 because the insight→section mapping inlined in the body substantially duplicates the placement rules in guide-structure-map.md, and the referenced paths use the `skills/research-guide-updater/...` prefix rather than the skill-relative layout of the actual bundle.

4 / 5

Total

15

/

20

Passed

Description

82%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: it explicitly answers both 'what' and 'when' with quoted natural trigger phrases, includes the legacy-name alias, and states a required invocation parameter. Its only weakness is that the capability list stays at the level of one distilled action rather than enumerating the concrete update operations the body actually performs.

DimensionReasoningScore

Specificity

The description names the domain and one core action — "将对话中新产生的可复用写作洞见实时沉淀到项目指南文件" — plus quality properties ("术语口径一致、结构稳定、可检验与可复现"), but does not enumerate the several concrete operations the skill actually performs (incremental bullet insertion, section-placement mapping, structure validation). This matches anchor 3 (1-2 concrete actions, not comprehensive) rather than anchor 4, which requires a list of several specific actions.

3 / 5

Completeness

Both halves are explicit: 'when' via "当用户明确要求…时使用" with concrete quoted trigger phrases, and 'what' via the distillation action with its guarantees, plus the invocation requirement "调用时必须指定指南文件路径". This clearly matches the anchor-5 example that states what and when with concrete trigger phrases; it is above anchor 4 because the 'when' clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

It quotes natural user phrases users would actually say — "更新项目指南", "同步指南", "沉淀洞见到指南" — and even covers the legacy alias "guide-updater". Coverage is good but a few natural variants are missing (e.g., English phrasings like "update the guide" or path-only invocations), so it sits at anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (incrementally updating a project writing-guide file) with distinctive triggers tied to specific Chinese phrases and a named legacy alias, so conflict risk with other skills is minimal. It matches anchor 5; anchor 4 would require some noticeable overlap with closely related skills, which is not the case here.

5 / 5

Total

17

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

huangwb8/ChineseResearchLaTeX

Path

skills/research-guide-updater/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.