citation-formatter

Use when formatting references for journal submission, converting between citation styles (APA, MLA, Vancouver, Chicago), generating bibliographies for manuscripts, or ensuring consistent reference formatting. Automatically formats citations and bibliographies in 1000+ academi...

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/citation-formatter/SKILL.md

Quality

Content

38%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 is padded with triple-repeated description text, empty capability code blocks, and generic boilerplate, while its actionable code is undermined by contradictory imports and a copy-pasted medical-audit example. Referenced bundle files do not exist, so the progressive-disclosure promise is unfulfilled.

Suggestions

Remove the three verbatim repetitions of the description (in 'When to Use', 'Key Features', and 'When to Use This Skill') and the empty `result = tool.execute(data)` 'Core Capabilities' blocks — they are pure padding.

Fix the contradictory imports (`scripts.main` vs `scripts.citation_formatter`) and replace the copy-pasted medical-audit input string in the Audit-Ready Commands example with an actual citation input (e.g., a .bib file).

Either provide the referenced bundle files (`scripts/main.py`, `references/guide.md`, `references/examples/`, `references/api-docs/`) and move the inlined API/capability detail into them, or remove the dangling references.

Dimension	Reasoning	Score
Conciseness	The frontmatter description is repeated verbatim three times (in 'When to Use', 'Key Features', and 'When to Use This Skill'), the 'Core Capabilities' blocks are empty filler (`result = tool.execute(data)`), and generic checklists/templates pad the body — noticeably verbose with several unnecessary sections.	2 / 5
Actionability	The Quick Start gives concrete method calls and a real CLI command, but the two contradictory imports (`scripts.main` vs `scripts.citation_formatter`), a copy-pasted medical-audit input string in a citation skill, and empty pseudocode capability blocks leave the guidance incomplete.	3 / 5
Workflow Clarity	A generic 5-step process template is present with some fallback/error handling, but it is not citation-specific and the batch formatting workflow has no concrete validation checkpoint, capping a batch operation at 3.	3 / 5
Progressive Disclosure	The body signals references to `scripts/main.py`, `references/guide.md`, `references/examples/`, and `references/api-docs/`, but none of these bundle files exist, and API/capability detail is inlined rather than split into them — minimal effective structure with broken navigation.	2 / 5
	Total	10 / 20 Passed

Description

96%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, specific description that clearly states both capabilities and trigger conditions with natural user terminology. Minor redundancy ('formatting references' / 'reference formatting') and slight overlap risk with general academic-writing skills keep it just below a perfect mark on distinctiveness.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — formatting references, converting between named styles (APA/MLA/Vancouver/Chicago), generating bibliographies, batch conversion, and reference-manager integration — matching the comprehensive-coverage anchor.	5 / 5
Completeness	Explicitly answers both 'what' ('Automatically formats citations and bibliographies in 1000+ academic styles…') and 'when' ('Use when formatting references for journal submission…') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Covers the natural phrases users say ('formatting references', 'journal submission', 'citation styles', 'bibliographies') plus specific style names as domain synonyms, satisfying comprehensive natural-term coverage.	5 / 5
Distinctiveness Conflict Risk	Has a clear citation/bibliography niche with distinct triggers, but carries minor overlap risk with broader academic-writing or manuscript-formatting skills rather than minimal conflict risk.	4 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 14 missing	Warning

	Total	14 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Academic Writing/citation-formatter/SKILL.md
Commit: 63c61d3

Reviewed: 3 hours ago

Table of Contents

Discovery Implementation Validation

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.