CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citation-audit

Zero-context verification that every bibliographic entry in the paper is real, correctly attributed, and used in a context the cited paper actually supports — catching hallucinated authors, wrong years, fabricated venues, version mismatches, and wrong-context citations. Use when user says "审查引用", "check citations", "citation audit", "verify references", "引用核对", or before submission to ensure bibliography integrity.

Quality

79%

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 ./skills/citation-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body delivers a genuinely rigorous, well-sequenced audit workflow with strong validation and concrete templates, but it is bloated: the two optional-flag specifications and their invariants are repeated across at least five sections each, and material that belongs in separate reference files is inlined, producing a 515-line monolith.

Suggestions

State each invariant once (e.g., 'uncited entries are detect-only and never alter the verdict' and 'no .bib mutation under --soft-only') in Key Rules, and have other sections reference it instead of restating it — this alone would remove ~100 lines.

Move the full soft-only mode spec (translation table, augmented JSON/MD schemas, guarantees) and the uncited-detection spec into separate reference files (e.g., references/soft-only-mode.md, references/uncited-detection.md), keeping only a short summary and trigger flags in SKILL.md.

Define the undefined `AUTO_APPLY` constant alongside the other Constants (including how it is set) and either document the `--apply` flag in the Workflow/Output Contract consistently or remove it.

DimensionReasoningScore

Conciseness

The 515-line body restates the same invariants many times — "uncited entries never alter the top-level verdict / are not blocking" appears in Step 2, Step 5, 'Why opt-in', 'Effect when enabled', Key Rules, and Submission Artifact Emission, and the --soft-only no-bib-mutation invariant is repeated across Constants, Key Rules, and a ~95-line dedicated section. That is noticeably verbose even though most content is accurate operational contract rather than concepts Claude already knows.

2 / 5

Actionability

Concrete, mostly executable guidance throughout: a copy-paste-ready mcp__codex__codex prompt template with model/config/sandbox, executable `latexmk -C && latexmk -pdf ...` command, full JSON artifact schemas, and an explicit verdict decision table. Minor gaps: `AUTO_APPLY` is referenced in Step 6 but never defined in Constants, `--apply` appears only in the Output Contract, and cite-context extraction (Step 2) has no concrete command.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with explicit validation checkpoints: per-entry reviewer verdicts (KEEP/FIX/REPLACE/REMOVE), an aggregation step with a decision table, human-approval gating for destructive REPLACE/REMOVE changes, a recompile-and-check-warnings verification step, and defined error-recovery fallbacks (bib enumeration failure → 'unavailable', unreadable bib → BLOCKED, reviewer failure → ERROR).

5 / 5

Progressive Disclosure

References to shared files (reviewer-backends.md, review-tracing.md, assurance-contract.md, citation-discipline.md, etc.) are one level deep and clearly signaled, but none of them exist in this skill's bundle (no references/, scripts/, or assets/ directories, and ../shared-references/ does not resolve). Additionally, large self-contained feature specs — the ~95-line soft-only mode section and the ~60-line uncited-detection section — are inlined in SKILL.md where they clearly belong in separate reference files.

3 / 5

Total

14

/

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.

An excellent description: it states concrete three-layer verification capabilities, an explicit trigger clause with multiple natural (and bilingual) trigger phrases, and a submission-gating 'when', all in a distinct niche. The only weakness is a handful of missing natural synonyms like 'bibliography' and 'bibtex'.

DimensionReasoningScore

Specificity

The description lists multiple concrete verification actions — entries are 'real, correctly attributed, and used in a context the cited paper actually supports' — plus a comprehensive failure catalogue ('hallucinated authors, wrong years, fabricated venues, version mismatches, and wrong-context citations'). This matches the anchor for multiple specific concrete actions with comprehensive coverage.

5 / 5

Completeness

Both 'what' (three-layer verification: existence, attribution correctness, context appropriateness) and 'when' are explicitly and concretely answered — 'Use when user says ... or before submission to ensure bibliography integrity' — with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural-phrase coverage with synonyms and bilingual variants ('"check citations", "citation audit", "verify references", "审查引用", "引用核对", or before submission'), but a few natural terms a user would plausibly say are missing — 'bibliography', 'bibtex', and the '.bib' file extension. This fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-with-extensions anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche (bibliographic/bibliography integrity) with distinct triggers that do not overlap the sibling audits' domains (evaluation code, numerical claims). Minimal conflict risk with other skills.

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 (516 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: 2 suspicious

Warning

Total

12

/

16

Passed

Repository

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

Path

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