article-format-adjustment

Adjust academic paper formatting and convert between DOCX/LaTeX/Markdown when you need to meet a journal or school template requirement.

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/article-format-adjustment/SKILL.md

Quality

Content

56%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 highly actionable with executable commands, a full Python example, and a validated processing pipeline. Its main weakness is verbosity from generic boilerplate sections and a monolithic structure that keeps detail inline instead of pointing to the bundle's reference files.

Suggestions

Remove or condense the generic boilerplate sections ('When Not to Use', 'Output Contract', 'Validation and Safety Rules', 'Deterministic Output Rules', 'Completion Checklist') to skill-specific essentials to improve conciseness.

Move the full configuration schema and per-module implementation details into a reference file (e.g., references/CONFIG.md) and link to it from SKILL.md to improve progressive disclosure.

Add a one-line index of the bundled assets/formats/*.json templates and scripts/*.py modules so users can navigate the bundle without scanning the directory.

Dimension	Reasoning	Score
Conciseness	The useful feature/example sections are efficient, but several generic boilerplate sections ('When Not to Use', 'Output Contract', 'Validation and Safety Rules', 'Deterministic Output Rules', 'Completion Checklist') pad the document without skill-specific value Claude doesn't already know.	2 / 5
Actionability	Provides concrete CLI commands and a complete, copy-paste-ready Python example with a realistic config dict; minor gaps remain around 'best-effort' template downloads and 'typical responsibilities' phrasing.	4 / 5
Workflow Clarity	The 'Processing pipeline' lists a clear 5-step sequence with an explicit validation step (4) and a failure feedback loop in the Python example, satisfying the validation requirement for batch/document operations.	4 / 5
Progressive Disclosure	Sections are well-headered and reference real bundle files (scripts/.py, assets/formats/.json) one level deep, but the SKILL.md is otherwise monolithic with config-schema and implementation detail inlined rather than offloaded to reference files.	3 / 5
	Total	13 / 20 Passed

Description

70%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 solid, third-person description that states concrete actions and an explicit trigger condition tied to journal/school template requirements. It could be strengthened by enumerating more trigger scenarios and a fuller action list to push specificity and completeness higher.

Suggestions

Add 1-2 more concrete actions (e.g., enforce citation styles, apply figure/table caption rules) to raise specificity toward comprehensive coverage.

Expand the 'when' clause with additional natural trigger phrases (e.g., 'Use when converting DOCX to LaTeX, applying IEEE/GB/T 7714 citation styles, or meeting a journal template') to improve completeness and trigger-term quality.

Mention format extensions explicitly (e.g., .docx, .tex, .md) to strengthen natural-term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and two concrete actions — 'Adjust academic paper formatting' and 'convert between DOCX/LaTeX/Markdown' — but stops at a couple of actions rather than comprehensive coverage.	3 / 5
Completeness	Answers both 'what' (adjust formatting + convert formats) and 'when' ('when you need to meet a journal or school template requirement'), but the trigger is a single scenario that could be more explicit with multiple trigger phrases.	4 / 5
Trigger Term Quality	Includes natural terms users would say ('academic paper', 'journal', 'school template') plus format/file-extension tokens (DOCX/LaTeX/Markdown), though a few synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	The academic-paper/journal-template niche is mostly distinct, with only minor overlap risk against a generic document-format-conversion skill.	4 / 5
	Total	15 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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/article-format-adjustment/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.