CtrlK
BlogDocsLog inGet started
Tessl Logo

citation-verification

This skill provides reference guidance for citation verification in academic writing. Use when the user asks about "citation verification best practices", "how to verify references", "preventing fake citations", or needs guidance on citation accuracy. This skill supports ml-paper-writing by providing detailed verification principles and common error patterns.

52

Quality

58%

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

Quality

Content

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a monolithic, repetitive reference that ignores its own bundled references and scripts and contradicts its stated canonical-source-first principle by repeatedly routing verification through Google Scholar. It is structured with clear sections and a concrete example, but fails on token efficiency and progressive disclosure.

Suggestions

Collapse the duplicated Verification Principles, Best Practices, Common Pitfalls, and Summary into a single concise section, dropping concepts Claude already knows (what citation errors are, consequences of retraction) to cut the body substantially.

Resolve the Google Scholar contradiction: either make canonical-source verification (DOI/arXiv/CrossRef/Semantic Scholar/Zotero) the actual workflow the example follows, or stop claiming Google Scholar is non-authoritative while instructing readers to copy BibTeX from it.

Turn SKILL.md into an overview that links to the bundle — e.g., point to references/verification-rules.md for the rule list, references/common-errors.md for pitfalls, and scripts/verify-citations.py for programmatic checking — instead of inlining all of that content.

DimensionReasoningScore

Conciseness

The ~200-line body restates material Claude already knows ("Citation issues in academic papers seriously impact research integrity", "Paper rejection or retraction", "Damage to academic reputation") and repeats the same points across Verification Principles, Best Practices, Common Pitfalls, and Summary (e.g., the "40% error rate" claim appears twice), matching anchor 1 ("Verbose; explains concepts Claude knows; padded with unnecessary context").

1 / 3

Actionability

Concrete elements exist — the Transformer example with real queries ("Attention is All You Need Vaswani 2017") and explicit fields to match — but the guidance is incomplete: it never references the bundled scripts (verify-citations.py, api-clients.py, format-checker.py) that would be the most actionable tooling, and it contradicts itself on Google Scholar, fitting anchor 2 ("Some concrete guidance but incomplete... missing key details") rather than fully executable anchor 3.

2 / 3

Workflow Clarity

A sequence exists (the flow diagram from "Need a citation" to "Add to bibliography") plus a failure-handling loop (try alternatives, mark `[CITATION NEEDED]`, notify user), but the stated workflow says to verify via canonical sources (CrossRef/arXiv/Semantic Scholar) while the worked example and Best Practices revert to Google Scholar, creating ambiguity about the actual decision logic per anchor 2 ("sequence present but checkpoints missing or implicit").

2 / 3

Progressive Disclosure

Eight bundle files exist (references/{verification-rules,common-errors,api-usage}.md and scripts/{verify-citations,api-clients,format-checker}.py plus READMEs), yet the body references none of them and instead inlines ~200 lines of verification rules, common errors, and workflow material, matching anchor 1 ("Monolithic wall of text... poor organization") rather than an overview that signals one-level-deep references.

1 / 3

Total

6

/

12

Passed

Description

90%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it answers both what and when with explicit, natural-language triggers in third person, and occupies a distinct niche. Its only weakness is specificity, describing the kind of content it offers rather than enumerating concrete verification actions.

DimensionReasoningScore

Specificity

Phrases like "provides reference guidance for citation verification" and "providing detailed verification principles and common error patterns" name the domain and some activities, but describe content type rather than multiple concrete actions (e.g., verify metadata, fetch BibTeX), matching anchor 2 ("Names domain and some actions, but not comprehensive") rather than the multi-action anchor 3.

2 / 3

Completeness

"This skill provides reference guidance for citation verification in academic writing" answers what, and the explicit "Use when the user asks about..." clause answers when, satisfying anchor 3 ("Clearly answers both what AND when with explicit triggers"); it is not capped at 2 because the Use-when trigger guidance is explicit, not merely implied.

3 / 3

Trigger Term Quality

The quoted triggers — "citation verification best practices", "how to verify references", "preventing fake citations", and "citation accuracy" — are natural phrases a user would actually say, giving good coverage per anchor 3 ("Good coverage of natural terms users would say").

3 / 3

Distinctiveness Conflict Risk

The niche is clearly scoped to citation verification in academic writing with distinct triggers ("preventing fake citations", "how to verify references"), and the "supports ml-paper-writing" note describes a relationship rather than a conflict, fitting anchor 3 ("Clear niche with distinct triggers; unlikely to conflict").

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.