Generate graphical abstract layout recommendations based on paper abstracts
Install with Tessl CLI
npx tessl i github:aipoch/medical-research-skills --skill graphical-abstract-wizardOverall
score
61%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
33%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 identifies a specific niche (graphical abstracts for papers) but is incomplete due to missing explicit trigger guidance. It provides minimal detail about what 'layout recommendations' actually include and lacks natural keyword variations that users might employ.
Suggestions
Add a 'Use when...' clause with trigger terms like 'graphical abstract', 'visual summary', 'TOC graphic', 'journal figure', or 'paper visualization'
Expand the capabilities to specify what recommendations include (e.g., 'suggests panel arrangements, visual hierarchy, icon placement, and color schemes')
Include file type or context triggers such as 'when preparing manuscript submissions' or 'when working with scientific papers'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (graphical abstracts) and one action (generate layout recommendations), but lacks detail on what specific recommendations entail or what outputs are produced. | 2 / 3 |
Completeness | Describes what it does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'graphical abstract' and 'paper abstracts' which are relevant terms, but misses common variations like 'visual abstract', 'figure summary', 'journal graphic', or 'TOC graphic'. | 2 / 3 |
Distinctiveness Conflict Risk | The term 'graphical abstract' is fairly specific to academic publishing, but could overlap with general graphic design or layout skills without clearer boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides good actionable guidance with executable CLI examples and detailed output format documentation. However, it suffers from significant boilerplate bloat (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status) that consumes tokens without aiding Claude's execution. The core functionality is well-documented but buried among template sections.
Suggestions
Remove or drastically reduce boilerplate sections (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status) that don't help Claude execute the skill
Move the detailed example output to a separate EXAMPLES.md file and reference it from the main skill
Remove the 'Technical Details' section explaining NLP techniques - Claude doesn't need to know implementation details to use the CLI tool
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains significant boilerplate (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status) that adds little value for Claude. The core functionality is reasonably documented but padded with template sections that don't aid execution. | 2 / 3 |
Actionability | Provides fully executable CLI commands with clear parameter documentation, concrete examples with actual abstract text, and detailed output format specifications including example markdown output with AI prompts. | 3 / 3 |
Workflow Clarity | The usage is clear for a single-step tool invocation, but the 'Technical Details' section describes NLP steps without validation checkpoints. The evaluation criteria checklist at the end is generic boilerplate rather than actionable workflow guidance. | 2 / 3 |
Progressive Disclosure | Content is reasonably structured with clear sections, but everything is in one monolithic file. The extensive example output and boilerplate sections could be split into separate reference files. No external file references are provided. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
91%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 | |
Table of Contents
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.