CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citation-crosscheck

Double-blind bibliographic cross-check: one agent extracts each cited entry verbatim from the local .bib, a second independently re-fetches the same paper's record from the web while blind to the .bib, and a third extractor emits a mechanical field-by-field delta to catch dropped/re-ordered authors, wrong years, wrong venues, and bad DOIs/arXiv ids. The main agent (never a shard) assigns the MATCH/MINOR/MISMATCH verdict per reference, and exports a side-by-side spreadsheet. Use when user says "citation crosscheck", "double-blind citation check", "verify bib against scholar", "bib field audit", "引用交叉核对", or before submission when bibliography FIELD accuracy (not just existence) must be certified.

Quality

82%

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

70%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 rigorous, fully executable multi-agent workflow with validation and fail-closed checkpoints at every stage. Its weaknesses are token efficiency — the trust-model and fabrication rules are each restated several times and repo-history meta-commentary is inlined — and bundle structure, since four referenced shared-reference documents are absent from the bundle and some content that belongs in reference files is inlined in SKILL.md.

Suggestions

State the blindness/trust-model and the non-arXiv-fabrication rules once each (e.g., in 'Key rules') and reference them from Steps 2-4 instead of restating them in the header note, Step 2 constants, Step 3, Step 3.5 prose/code/bullets, and Step 4.

Move the Step 2 tier/breadth philosophy, the acceptance-gate discourse, and the resolver note about `tools/` shims / 'Phase-3 moves' / 'Policy-A registration' into a reference file (or drop them) — they are design rationale, not execution instructions.

Ship or inline the content of the four `../shared-references/*.md` documents the body leans on (fan-out-pattern.md's 'requirement (4)', acceptance-gate.md, external-cadence.md, integration-contract.md) so the skill is self-contained when the shared directory is absent, and consider moving the ~100-line Step 1 harvest script into `scripts/` alongside cx_verify.py.

DimensionReasoningScore

Conciseness

The body is noticeably verbose in several sections. The same trust-model point is repeated three times (Step 3.5 prose, the in-code comments, and the bullets after: 'the gate RECOMPUTES the field diff ... C's flags are ADVISORY only ... fails closed'), the fabrication/non-arXiv rule appears in the header note, Step 2 constants, Step 3, Step 4, and Key rules, and non-operational meta-commentary is inlined (the tier/breadth philosophy in Step 2, and the resolver note about 'Phase-3 moves'/'Policy-A registration'/`tools/` shims — repo history irrelevant to executing the skill). This matches anchor 2 ('Noticeably verbose; several unnecessary explanations or padded sections') rather than anchor 3: the padding is not incidental but systematic, and a ~40% token cut is available without losing operational content.

2 / 5

Actionability

Fully executable, copy-paste-ready core: the Step 1 cite-harvest heredoc and the Step 3.5 gate invocation (with `--selftest`, `--build-manifest`, coverage flags, and a fail-closed resolution chain) are complete bash; A/B/C shard contracts are pinned with exact JSON envelopes and exact artifact paths (`/tmp/cx_A_ourbib.json` etc.); edge cases like `NOCITE_ALL`, a missing `.bbl`, and multiple `ibliography` resources are covered. This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'); the xlsx step is specified by column/color rather than code, which is still concrete and complete.

5 / 5

Workflow Clarity

Steps 1→2 (parallel A+B)→3 (C)→3.5 (deterministic gate)→4 (verdicts)→5 (spreadsheet + fixes) are clearly sequenced with validation pervasive for a batch operation: gate `--selftest` before use, `dedup_key` join as a fail-closed stop ('re-run the offending shard'), the `--expect-manifest` mapping check that catches drop-and-substitute, ESCALATE routing that mandates a primary-source fetch before any verdict, and the invariant 'Every entry leaves Step 4 with exactly one of the four labels'. This matches anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery; checklists').

5 / 5

Progressive Disclosure

The one in-bundle reference (`scripts/cx_verify.py`) exists, matches its description, and is well-signaled — but the body's load-bearing links to `../shared-references/external-cadence.md`, `fan-out-pattern.md`, `acceptance-gate.md`, and `integration-contract.md` do not resolve within the provided bundle, so the 'requirement (4)' / acceptance-gate material they govern is only partially self-contained. Additionally, that meta-material and the ~100-line Step 1 harvest script are inlined in SKILL.md rather than split out. This matches anchor 3 ('Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline') better than anchor 4, where referenced paths would mostly resolve and organization gaps would be minor.

3 / 5

Total

15

/

20

Passed

Description

92%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 dense, highly specific description that answers both 'what' and 'when' with concrete trigger phrases and an explicit scope boundary. The only minor gap is that a few everyday phrasings ('check my references') are absent from the trigger list. Third-person voice is used correctly throughout.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions with comprehensive coverage: 'extracts each cited entry verbatim from the local .bib', 're-fetches the same paper's record from the web while blind to the .bib', 'emits a mechanical field-by-field delta', 'assigns the MATCH/MINOR/MISMATCH verdict per reference', 'exports a side-by-side spreadsheet' — plus the concrete defect list 'dropped/re-ordered authors, wrong years, wrong venues, and bad DOIs/arXiv ids'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; score 4 would require minor coverage gaps, and none are evident.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is the full mechanism (double-blind extraction, field diff, verdict assignment, spreadsheet export) and the 'when' is a literal trigger clause — 'Use when user says "citation crosscheck", ... or before submission when bibliography FIELD accuracy (not just existence) must be certified.' This matches anchor 5 ('Clearly and explicitly answers both what AND when with concrete trigger phrases'); anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases and synonyms: 'citation crosscheck', 'double-blind citation check', 'verify bib against scholar', 'bib field audit', plus a non-English variant and the file format '.bib'. A few natural lay phrasings a user would plausibly say are missing (e.g., 'check my references', 'verify my bibliography'), so it falls just short of the anchor 'Comprehensive coverage of natural terms including synonyms and file extensions' — it is clearly above anchor 3's 'missing common variations or synonyms'.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: 'double-blind bibliographic cross-check', 'bib field audit', 'verify bib against scholar' are specialized phrases unlikely to fire a generic citation-checking or bibliography skill, and the description even scopes out adjacent functionality ('FIELD accuracy (not just existence)'). This matches anchor 5 'Clear niche with distinct triggers; minimal conflict risk'; anchor 4 would require notable overlap with a closely related skill, which the narrow field-level framing avoids.

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (532 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 5 suspicious

Warning

Total

12

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/citation-crosscheck/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.