CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citation-management

Manage citations systematically throughout the research and writing process.

Quality

60%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/citation-management/SKILL.md

The canonical home for this skill is citation-management in administrakt0r/AI-Agents-Safe-Coding-Skills

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 body delivers highly concrete, well-sequenced guidance with strong validation feedback loops, but it is roughly twice as long as needed: every script's usage is duplicated verbatim, standard BibTeX/MeSH knowledge is re-explained, and an unrelated schematics section is bolted in. The reference-file architecture is named but not actually leveraged to keep SKILL.md lean.

Suggestions

Remove the 'Tools and Scripts' section's duplicated usage blocks — each script is already fully demonstrated in its phase workflow; keep only a one-line summary per script.

Move the Google Scholar/PubMed search-strategy details, venue-tier tables, and 'Best Practices'/'Common Pitfalls' lists into the corresponding references/ files and keep one-line pointers in SKILL.md.

Drop the 'Visual Enhancement with Scientific Schematics' section or reduce it to a single sentence linking the scientific-schematics skill; it is off-topic for citation management.

DimensionReasoningScore

Conciseness

The ~1,100-line body duplicates nearly every script's usage block verbatim (once in the phase workflows, again in 'Tools and Scripts'), explains concepts Claude already knows (standard BibTeX entry types @article/@book and their required fields, what MeSH controlled vocabulary is, E-utility names), and includes an off-topic 'Visual Enhancement with Scientific Schematics' section. This fits anchor 2 (noticeably verbose; several unnecessary explanations or padded sections); it stops short of anchor 1 only because the bulk is genuinely actionable command material rather than filler.

2 / 5

Actionability

Commands are concrete and copy-paste ready with flags, expected JSON validation output, and four worked end-to-end examples covering the common cases. However, the six scripts/*.py invocations cannot be verified against an actual bundle (no scripts/ directory exists here) and flag conventions vary slightly across examples (--format bibtex vs. bare .bib outputs), matching anchor 4 (mostly executable with minor gaps) rather than 5.

4 / 5

Workflow Clarity

The five-phase workflow is clearly sequenced with validation as an explicit Phase 4, feedback loops for error recovery (--auto-fix, 'Review validation report and fix any remaining issues', re-validate after edits), and a complete 7-step bibliography build with a validation checkpoint before use in LaTeX. This matches anchor 5 (clear sequence with explicit validation steps and feedback loops); anchor 4 is excluded because checkpoints are explicit, not implicit.

5 / 5

Progressive Disclosure

References are well signaled and one level deep ('see references/google_scholar_search.md', a Resources section listing 5 references, 6 scripts, 2 assets), but none of the referenced files exist in the bundle, and ~1,100 lines of search strategies, venue-tier tables, and best-practices content that belongs in those reference files are inlined in SKILL.md. This fits anchor 3 (some structure, content that should be separate is inline) rather than 4, because the split is described but not realized and the referenced paths cannot be verified.

3 / 5

Total

14

/

20

Passed

Description

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

The description names a clear domain but relies on a single generic verb ("manage") with no concrete capabilities and no 'Use when' trigger clause. Users asking for BibTeX help, bibliography formatting, or DOI conversion would not naturally match this phrasing. Adding explicit actions and trigger conditions would move it substantially.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. "Use when converting DOIs/PMIDs/arXiv IDs to BibTeX, validating references, or building a bibliography".

Replace the generic "Manage citations systematically" with the skill's actual concrete actions: searching Google Scholar/PubMed, extracting metadata via CrossRef/arXiv, validating and formatting BibTeX.

Include the natural keywords users actually say — BibTeX, bibliography, DOI, PMID, references, .bib — so the description triggers on those requests.

DimensionReasoningScore

Specificity

The description names the domain ("citations", "research and writing process") but the only action stated is the generic "Manage citations systematically" — no concrete actions like search, extract, validate, or format BibTeX appear. It matches anchor 2 (names the domain but actions are minimal or generic) rather than 3, which would require at least 1-2 concrete actions.

2 / 5

Completeness

The 'what' is stated ("Manage citations systematically throughout the research and writing process") but weak, and there is no 'Use when...' clause or equivalent trigger guidance at all. Anchor 3 applies ('what' present, 'when' missing), and the judging guideline explicitly caps completeness at 3 when trigger guidance is absent — so 4 is excluded.

3 / 5

Trigger Term Quality

"citations", "research", and "writing" are relevant keywords a user might say, but the most natural trigger terms for this skill — BibTeX, bibliography, DOI, references — are entirely missing. This fits anchor 3 (some relevant keywords but missing common variations or synonyms), not 4, since multiple high-value synonyms are absent.

3 / 5

Distinctiveness Conflict Risk

"Manage citations" carves out a citation niche but the phrase "throughout the research and writing process" overlaps heavily with literature-review and scientific-writing skills (which the body confirms as sibling skills). It fits anchor 3 (somewhat specific but could still overlap with similar skills) rather than 4, since no distinct trigger terms separate it from those neighbors.

3 / 5

Total

11

/

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 (1114 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 77 missing

Warning

Total

12

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/citation-management/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.