CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bib-formatter

Convert reference lists and in-text citations between RIS, BibTeX, plain text, and CSL-JSON, triggered when you need to unify bibliography/citation styles before journal submission or compare before/after formatting differences.

Quality

85%

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

73%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 content is well-structured with concrete commands, a clear validated workflow, and appropriate use of a reference file for parsing details. Its main weaknesses are generic template boilerplate inflating the body and small gaps in example coverage (plain-text input, sample comparison table, unlinked csl-styles.md reference).

Suggestions

Remove or collapse the generic template sections ('Required Inputs', 'Output Contract', 'Failure Handling', 'User Checkpoints', 'Input Validation', 'Quick Validation') into a short, skill-specific note — they mostly duplicate 'When Not to Use' and pad the body without task-relevant detail.

Add an example for the 'plain' input format and a small sample Markdown Before/After comparison table so examples cover all four input formats and demonstrate the required output artifact.

Link references/csl-styles.md from SKILL.md (e.g., in Implementation Details or Dependencies) so all bundle files are discoverable from the overview.

DimensionReasoningScore

Conciseness

The core sections (When to Use, Key Features, Example Usage, Implementation Details) are efficient, but roughly a third of the body is generic template boilerplate — 'Required Inputs', 'Output Contract', 'Failure Handling', 'User Checkpoints', 'Input Validation', 'Quick Validation' — that largely restates 'When Not to Use' and adds no skill-specific information (e.g., 'User task description: Research question, writing goal, analysis objective' is not about bibliography formatting). This fits 'mostly efficient but could be tightened'; it does not reach score 4 because the boilerplate padding is more than minor over-explanation.

3 / 5

Actionability

Four copy-paste-ready bash commands with real flags (--input, --input-format, --journal, --style, --mode, --cite-keys) cover bibtex, RIS, CSL-JSON, journal auto-retrieval, and in-text citation mode, plus a concrete field-validation list. It is not score 5 because the 'plain' input format lacks any example and the mandatory Before/After comparison table is described but never shown, leaving minor gaps.

4 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with an explicit validation feedback loop ('Validate completeness of critical fields and rerun after fixing missing metadata'), a quality checklist, and error-recovery handling for unparseable entries — satisfying the score-5 anchor for a batch operation. The batch-operation cap does not apply since validation with rerun is explicitly present.

5 / 5

Progressive Disclosure

The body cleanly delegates parsing/field-mapping detail to references/input-formats.md (which exists and is one level deep, with no nested references), keeping the overview lean. However, the bundled references/csl-styles.md is never linked or signaled from SKILL.md, leaving an orphaned bundle file — a minor organization gap that fits score 4 rather than the fully navigable score 5.

4 / 5

Total

16

/

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 strong description that clearly states both capabilities and trigger conditions with concrete, domain-specific terminology. Minor room to improve keyword coverage with common synonyms and file extensions.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Convert reference lists and in-text citations between RIS, BibTeX, plain text, and CSL-JSON', 'unify bibliography/citation styles', 'compare before/after formatting differences' — naming all four supported formats, which comprehensively covers the skill's scope. It is not score 4 because coverage is not merely 'several specific actions with minor gaps'; the action set (convert lists, convert citations, unify, compare) plus the enumerated formats spans the skill's full capability.

5 / 5

Completeness

Both 'what' and 'when' are explicit: what — convert reference lists and in-text citations between the four named formats; when — 'triggered when you need to unify bibliography/citation styles before journal submission or compare before/after formatting differences'. These are concrete trigger phrases, matching the score-5 anchor; score 4 would require the 'when' to be less explicit or specific, which is not the case.

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: 'RIS', 'BibTeX', 'plain text', 'CSL-JSON', 'bibliography/citation styles', 'journal submission'. A few common variations are missing (e.g., '.bib', 'reference manager', 'CSL styles'), so it does not reach the comprehensive-with-synonyms bar of score 5, but it clearly exceeds the 'some relevant keywords' level of score 3.

4 / 5

Distinctiveness Conflict Risk

The niche (bibliography/citation reformatting for journal submission across RIS/BibTeX/CSL-JSON) is distinct with format-specific triggers, giving minimal overlap risk with other skills. It is not score 4 because the named formats and journal-submission context leave little ambiguity about which skill applies.

5 / 5

Total

19

/

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

scientific-skills/Other/bib-formatter/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.