CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reference-integrity-checker

Checks whether manuscript references are accurately matched to claims, appropriately scoped, and not overextended, misquoted, or second-hand cited.

Quality

66%

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 ./awesome-med-research-skills/Academic Writing/reference-integrity-checker/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 has a clear sequenced workflow, a concrete mandatory output template, and well-signaled one-level-deep references that all exist on disk. Its main weakness is heavy redundancy — the same failure modes and rules are restated in four or more sections and duplicated from the reference files — which roughly doubles the token cost without adding guidance.

Suggestions

Collapse the redundant sections — 'Task', 'Core Function', 'Hard Rules', 'What This Skill Should Not Do', and 'Quality Standard' restate the same mismatch/overextension/second-hand/quote-drift list; keep one canonical statement and point to the reference files for the rest.

Remove the inline 'Hard Rules' section (or reduce it to a one-line pointer) since references/hard-rules.md already carries those rules, and likewise the severity-level list duplicated in severity-classification-rules.md.

Add one brief worked example — a claim-reference pair showing an overextension and how it would be reported under the A-H output structure — to lift actionability without much token cost.

DimensionReasoningScore

Conciseness

The body repeatedly restates the same failure-mode list — mismatch, overextension, second-hand citation, quote drift — across the intro bullets, 'Task', 'Important Distinctions', 'Core Function', Steps 3-5, 'Hard Rules', 'What This Skill Should Not Do', and 'Quality Standard'; 'Input Validation' duplicates 'Step 1', and 'Hard Rules' duplicates references/hard-rules.md nearly verbatim. Several sections are pure padding that could be cut by half without losing guidance, matching the 'noticeably verbose; several padded sections' anchor rather than the mostly-efficient one.

2 / 5

Actionability

For an instruction-only skill the guidance is concrete and specific: a mandatory eight-part output template (A-H), explicit matching criteria ('same population... same intervention/exposure/context... same evidence level... same direction of claim'), a named severity taxonomy, and concrete correction actions ('replacement citation, softer wording, narrower claim language, citation relocation'). It misses a 5 because there are no worked examples — no sample claim-reference pair showing a mismatch or a sample structured output, which the rubric's good examples treat as covering common cases.

4 / 5

Workflow Clarity

Nine explicitly sequenced steps with a validation gate up front (Step 1 plus output section 'A. Input Match Check') and a mandatory output structure acting as a checklist. It does not reach 5 because there is no explicit feedback loop for what to do after requesting missing material or re-checking after user response — the recovery path is only implied by section H.

4 / 5

Progressive Disclosure

Seven reference files all exist in references/ and are each one level deep with no nested references, and the 'Reference Module Integration' section clearly signals each file's purpose and when to apply it ('Use before any long-form integrity review', 'Apply throughout the entire response'). It stays below 5 because the body inlines content duplicated in those files (the ten 'Hard Rules' vs references/hard-rules.md, the severity levels vs severity-classification-rules.md), so the split is not fully clean.

4 / 5

Total

14

/

20

Passed

Description

58%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 clear, moderately specific description with a distinct niche, but it lacks any explicit 'when to use' trigger guidance and misses the natural term 'citations' alongside synonyms users would actually say. Adding a trigger clause would substantially raise the score.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to check citations or references against manuscript claims, review for citation mismatch, overextension, or second-hand citing, or prepare a manuscript for submission.'

Include the term 'citations' and common synonyms such as 'citation mismatch', 'quote drift', and 'citation accuracy' so the description matches natural user phrasing.

Optionally mention severity classification or prioritized correction guidance to round out the capability coverage.

DimensionReasoningScore

Specificity

The description lists several concrete checking actions — 'accurately matched to claims, appropriately scoped, and not overextended, misquoted, or second-hand cited' — naming specific failure modes rather than vague capabilities. It falls short of a 5 because it omits parts of the skill's stated scope such as severity classification and correction prioritization, and stays above a 3 because it goes well beyond naming 1-2 actions.

4 / 5

Completeness

The 'what' is clear and concrete (checking claim-reference matching, scoping, overextension, misquoting, second-hand citation), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

It contains relevant domain keywords ('manuscript references', 'claims', 'overextended', 'misquoted', 'second-hand cited'), but misses the most natural user phrasing: 'citations', 'citation mismatch', 'do my references support this', and 'quote drift'. Common variations and synonyms are absent, matching the anchor for some relevant keywords with missing variations, not the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — reference integrity auditing with named failure modes (overextension, misquoting, second-hand citing) — and unlikely to trigger for formatting or writing skills. Minor overlap risk remains with closely related literature-review or citation-accuracy skills, so it does not reach the clear-niche anchor at 5.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

awesome-med-research-skills/Academic Writing/reference-integrity-checker/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.