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.
69
62%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/journal-cover-prompter/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-structured description with explicit 'Use when' triggers and a clear scientific publication niche. The main weakness is moderate specificity - it could benefit from listing more concrete actions like 'generates prompts with composition guidelines, color schemes, and scientific accuracy requirements'. Overall, it effectively communicates when Claude should select this skill.
Suggestions
Add more specific concrete actions to improve specificity, e.g., 'Creates detailed prompts including composition, color palette, scientific accuracy guidelines, and style specifications for AI image generators'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (scientific visuals/journal covers) and some actions (creating prompts, designing graphical abstracts), but doesn't list comprehensive specific actions like what elements are included in prompts or what types of scientific artwork. | 2 / 3 |
Completeness | Clearly 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') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'journal cover images', 'scientific artwork', 'graphical abstracts', 'AI image generators', 'publication-quality'. These are terms researchers and scientists would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on scientific/academic visual content for publications. The combination of 'journal cover', 'graphical abstracts', and 'publication-quality' creates a distinct trigger profile unlikely to conflict with general image generation skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill suffers from severe template bloat - approximately 60% of the content is generic boilerplate about error handling, input validation, and response templates that provide no value for journal cover image generation. The actual useful content (prompt structure, style selection, technical specs) is buried and inconsistent, with conflicting script paths and import statements. The skill would benefit greatly from stripping boilerplate and focusing on the creative aspects of scientific image prompt generation.
Suggestions
Remove all generic boilerplate sections (Error Handling, Input Validation, Response Template, Output Requirements) that don't add skill-specific value - Claude already knows these patterns
Consolidate the duplicate sections (Example Usage/CLI Usage, Quick Start/Core Capabilities) and fix the inconsistent script paths (main.py vs cover_prompter.py)
Add concrete examples of actual generated prompts showing input research topic → output AI image prompt, demonstrating the transformation
Focus content on the creative workflow: how to translate scientific concepts into visual metaphors, what makes effective journal cover imagery, and specific prompt engineering techniques for scientific visuals
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with significant redundancy - the description is repeated multiple times, there are duplicate sections (Example Usage and CLI Usage, Quick Start and Core Capabilities), and extensive boilerplate about error handling, input validation, and response templates that Claude already knows. The skill could be reduced to ~30% of its current size. | 1 / 3 |
Actionability | Contains some executable Python code examples and CLI commands, but there's confusion between two different entry points (scripts/main.py vs scripts/cover_prompter.py) and the CoverPrompter class import path doesn't match the CLI script. The core prompt generation examples are concrete but incomplete. | 2 / 3 |
Workflow Clarity | Multiple workflow sections exist but they're generic boilerplate rather than specific to journal cover image generation. The actual creative workflow for generating good prompts (understanding research, selecting visual metaphors, composing elements) is not clearly sequenced. No validation steps for prompt quality. | 2 / 3 |
Progressive Disclosure | References external files (references/audit-reference.md) but the main content is a monolithic wall mixing generic boilerplate with actual skill content. The structure exists but content that should be in the main skill (prompt structure, style guides) is mixed with templated sections that add no value. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- aipoch/medical-research-skills
- Commit
4a48721
- 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.