CtrlK
BlogDocsLog inGet started
Tessl Logo

nature-ref-verifier

对学术文献逐条执行多源交叉验证,逐字段对比作者、标题、年份、卷期、页码, 标记卷年/DOI年冲突、作者顺序异常、页码偏差等问题,输出结构化验证报告。 可批量处理整篇论文/开题报告的参考文献列表,也可单条校验,支持与 Zotero 同步修正。

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/nature-ref-verifier/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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, empirically grounded workflow document: severity-tiered check matrices with real cases, a cheapest-first verification step, explicit degradation paths per source, and honest operational caveats about Zotero write channels. The main improvements are removing the redundant ASCII diagram, adding example commands for the recommended tools, and fixing the dangling manifest.yaml reference.

Suggestions

Add a post-correction verification step (re-query Zotero after writing to confirm the fix landed) to close the feedback loop on the Zotero update path.

Include one concrete pyzotero CLI example and one full curl command with --max-time so the recommended channels are copy-paste executable.

Either create the referenced manifest.yaml or remove the sentence citing it, since the file does not exist in the bundle.

DimensionReasoningScore

Conciseness

The body is dense and tabular with no explanations of concepts Claude already knows — every table row encodes hard-won empirical knowledge (e.g., 'SPIE 101880T 误作 1018807', 'Zotero 7 本地 HTTP API(localhost:23119)只读'). Anchor 4 rather than 5 because the ~30-line ASCII diagram ('多来源交叉验证策略') visually restates Steps 2–4 already covered by the tables and could be trimmed, and the time-sensitive '2026 年实测' note is not in a deprecated/old-patterns section.

4 / 5

Actionability

Strong executable guidance: a copy-paste-ready Crossref endpoint ('https://api.crossref.org/works/<DOI>') with explicit 404/200 decision logic, numeric thresholds ('页码差异 ≥5' critical vs '≤4' warning), concrete batching rules ('超过 20 条时按 10–15 条一组拆给并行子代理'), and a filled-in output report template. Anchor 4 rather than 5 due to minor gaps: the pyzotero CLI is recommended ('pyzotero[cli]:推荐的 Zotero 读写通道') without a single example command, and the curl probe is described ('直连 curl 加 --max-time 探测') rather than given verbatim.

4 / 5

Workflow Clarity

A clearly sequenced 5-step workflow (parse → parallel query → field compare → confidence rating → report) where the skill's core IS validation: Step 2.0 front-loads the cheapest check (DOI resolvability), the severity-tiered comparison matrix acts as a checklist, and Step 4 assigns explicit confidence levels — so the batch-operation cap does not apply. Anchor 4 rather than 5 because a post-correction feedback loop is missing: the Zotero write path has a pre-check ('修正前先确认条目在库') but no verify-the-fix-applied step.

4 / 5

Progressive Disclosure

Exemplary on-demand routing: the body states precise load conditions ('需要处理批量差异…时,读取 references/common-patterns.md。其他任务不要预加载该文件') and the reference file exists, is one level deep, and covers complementary material. Anchor 4 rather than 5 because the body cites 'manifest.yaml 记录了同一按需路由' but no manifest.yaml exists anywhere in the bundle — a dangling reference that breaks navigation.

4 / 5

Total

16

/

20

Passed

Description

71%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 highly specific, information-dense description that clearly communicates what the skill does at the field level and in what output format. Its main weakness is the missing explicit 'Use when...' trigger clause, which leaves the 'when' only weakly implied and caps completeness. Adding English trigger words would broaden natural activation.

Suggestions

Add an explicit trigger clause equivalent to 'Use when the user mentions 校验文献, verify references, check citations, or asks to validate a bibliography/参考文献列表' to raise completeness.

Include English trigger terms ('verify references', 'check citations', 'BibTeX', '.bib') since reference-checking requests often arrive in English.

Mention supported input formats (BibTeX/.bib, Zotero item key) in the description so users searching by format can find the skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: '逐字段对比作者、标题、年份、卷期、页码' (field-by-field comparison of author/title/year/volume/pages), flags specific error classes ('标记卷年/DOI年冲突、作者顺序异常、页码偏差'), '输出结构化验证报告', plus batch processing, single-entry verification, and Zotero sync correction. It clearly matches the 5 anchor ('multiple specific concrete actions; comprehensive coverage'), not the 4 anchor which implies coverage gaps.

5 / 5

Completeness

The 'what' is clearly and specifically answered (multi-source cross-validation, field-level comparison, structured report). Per the guideline, a missing 'Use when...' clause caps completeness at 3: 'when' is only weakly implied through capability statements ('可批量处理整篇论文/开题报告的参考文献列表,也可单条校验') which describe what it can do, not when to invoke it. Not a 2 because the 'what' is explicit and detailed; not a 4 because no explicit trigger guidance exists.

3 / 5

Trigger Term Quality

Good keyword coverage: '参考文献' (references), '校验' (verify), '验证' (validation), '学术文献' (academic literature), 'Zotero' — natural terms a user would say. It sits at anchor 4 rather than 5 because common variations are missing: English users would say 'check citations' / 'verify references' (no English trigger words), and '.bib' / 'BibTeX' / '引用' are absent even though the body supports them.

4 / 5

Distinctiveness Conflict Risk

A clear niche (field-level academic reference cross-validation against multiple bibliographic sources) with distinctive capabilities like DOI-resolvability checks and Zotero correction. It lands at 4 rather than 5 because the Zotero sync mention ('支持与 Zotero 同步修正') creates minor overlap risk with generic Zotero library-management skills, and without explicit triggers, routing relies on capability keywords.

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
Yuan1z0825/nature-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.