journal-cover-prompter

Use when creating journal cover images, generating scientific artwork prompts, or designing graphical abstracts. Creates detailed prompts for AI image generators to produce publication-quality scientific visuals.

Quality

78%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/journal-cover-prompter/SKILL.md

Quality

Content

57%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured with real bundle references, but it is undermined by non-executable code examples that reference classes/methods/files absent from the bundle and by substantial generic boilerplate. Fixing the code examples to match scripts/main.py and trimming the templated process sections would markedly improve it.

Suggestions

Replace the Quick Start / Core Capabilities / CLI Usage examples with the actual scripts/main.py API (class JournalCoverPrompter, method generate_prompt) so the code is executable and copy-paste ready.

Remove or condense the generic Output Requirements, Response Template, Input Validation, and Error Handling boilerplate, and fix the broken "When to Use" line that repeats the description with a doubled "Use when."

Add skill-specific validation/feedback steps to the Workflow (e.g., verify the generated prompt covers the requested style/mood/colors before returning it) instead of abstract process steps.

Dimension	Reasoning	Score
Conciseness	The body is padded with generic boilerplate (Output Requirements, a 7-item Response Template, Input Validation, Error Handling) and a broken "When to Use" that repeats the description with a doubled "Use when," so it is mostly efficient but includes unnecessary content.	2 / 3
Actionability	Valid audit commands exist (py_compile, --help), but the Quick Start and Core Capabilities examples import a non-existent scripts.cover_prompter / CoverPrompter and call create_prompt/generate/select_style/get_specs that do not match the actual JournalCoverPrompter.generate_prompt, and CLI Usage points to a missing cover_prompter.py.	2 / 3
Workflow Clarity	A 5-step workflow and a py_compile quick check are present, but the steps are abstract templated process language with no skill-specific validation checkpoints or feedback loops.	2 / 3
Progressive Disclosure	References to references/audit-reference.md and scripts/main.py are real, one level deep, and clearly signaled in a References section, with reasonably organized sections.	3 / 3
	Total	9 / 12 Passed

Description

100%

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 is concise, third-person, and clearly states both what the skill does and when to use it with natural trigger terms. It is a strong, well-targeted description with no notable weaknesses.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions across "creating journal cover images, generating scientific artwork prompts, or designing graphical abstracts" and "Creates detailed prompts for AI image generators to produce publication-quality scientific visuals," matching the multi-action anchor.	3 / 3
Completeness	Explicitly answers both what ("Creates detailed prompts for AI image generators to produce publication-quality scientific visuals") and when ("Use when creating journal cover images, generating scientific artwork prompts, or designing graphical abstracts").	3 / 3
Trigger Term Quality	Natural user-facing terms like "journal cover images," "scientific artwork prompts," and "graphical abstracts" give good coverage of phrases a user would actually say.	3 / 3
Distinctiveness Conflict Risk	The journal-cover / graphical-abstract niche is specific with distinct triggers, making it unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 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: 1 missing	Warning

	Total	14 / 16 Passed

Repository: aipoch/medical-research-skills
Commit: 7cc5680

Reviewed: 3 days 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.