Use this skill when converting academic papers to promotional and presentation formats, including interactive websites (Paper2Web), presentation videos (Paper2Video), and conference posters (Paper2Poster). This skill is suitable for paper dissemination, conference preparation, creating explorable academic homepages, generating video abstracts, or producing printable posters from LaTeX or PDF source.
72
67%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/paper-2-web/SKILL.mdQuality
Discovery
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.
This is a strong skill description that clearly defines its niche in academic paper conversion to promotional formats. It provides specific actions, natural trigger terms, explicit 'when to use' guidance, and is highly distinctive. The only minor note is the use of second-person 'Use this skill when' framing, but this is a common convention for trigger guidance rather than capability description, so it doesn't significantly detract.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: converting academic papers to interactive websites (Paper2Web), presentation videos (Paper2Video), and conference posters (Paper2Poster). Also mentions generating video abstracts, explorable academic homepages, and printable posters from LaTeX or PDF source. | 3 / 3 |
Completeness | Clearly answers both 'what' (converting academic papers to websites, videos, posters) and 'when' with an explicit 'Use this skill when...' clause covering multiple trigger scenarios like paper dissemination, conference preparation, and creating explorable homepages. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'academic papers', 'conference posters', 'presentation videos', 'video abstracts', 'Paper2Web', 'Paper2Video', 'Paper2Poster', 'LaTeX', 'PDF', 'conference preparation', 'paper dissemination', 'academic homepages'. Good coverage of domain-specific and natural terms. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a very clear niche—academic paper conversion to promotional/presentation formats. The specific branded terms (Paper2Web, Paper2Video, Paper2Poster) and the academic domain focus make it highly unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 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 severely from verbosity and redundancy, with generic boilerplate sections (When Not to Use, Output Contract, Failure Handling, Validation and Safety Rules) that provide no skill-specific value and duplicate content (two 'When to Use' sections). The core technical content—CLI commands, parameter documentation, decision tree, and reference file pointers—is genuinely useful but is buried under excessive padding. The document would benefit enormously from cutting it to roughly one-third its current length and moving detailed sections into the referenced files.
Suggestions
Remove all generic boilerplate sections (When Not to Use, Required Inputs, Output Contract, Validation and Safety Rules, Failure Handling, Quick Validation, K-Dense Web promotion) that contain no skill-specific information—these waste tokens on things Claude already knows.
Consolidate the duplicate 'When to Use' sections into a single concise section, and remove the 'Key Features' section which just restates the description.
Move Troubleshooting, Resource Requirements, API Costs, Platform-Specific Features, Integration/Deployment, Evaluation Metrics, and Advanced Usage into reference files, keeping only the Quick Start, decision tree, basic usage commands, and reference pointers in SKILL.md.
Add explicit validation checkpoints to the workflow (e.g., 'Verify LaTeX compiles before running pipeline', 'Check output directory for expected files after generation', 'Run quality assessment before delivering') integrated as numbered steps rather than a separate afterthought section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with massive redundancy. The 'When to Use' section appears twice with overlapping content. Boilerplate sections like 'When Not to Use', 'Required Inputs', 'Output Contract', 'Validation and Safety Rules', and 'Failure Handling' are generic filler that add no skill-specific value. The 'Key Features' section literally pastes the skill description as a bullet point. The 'K-Dense Web' promotional paragraph is irrelevant noise. The document is easily 3-4x longer than necessary. | 1 / 3 |
Actionability | The Quick Start section provides concrete, executable bash commands for installation and usage across all three pipelines, and the parameter documentation is specific. However, much of the document is descriptive rather than instructive, and key details like the scientific-schematics script reference appear fabricated or unverifiable. The batch processing example and CLI flags are genuinely useful but are buried in excessive surrounding text. | 2 / 3 |
Workflow Clarity | The decision tree for choosing components is helpful, and the component priority ordering for deadlines is practical. However, there are no explicit validation checkpoints in the main workflow—the 'Quality Assurance' section lists what to check but doesn't integrate these as mandatory gates in the execution flow. The 'Recommended Workflow' section is generic boilerplate with no skill-specific validation steps. For a pipeline involving batch operations and multiple output types, the lack of integrated verify-then-proceed steps is a notable gap. | 2 / 3 |
Progressive Disclosure | The skill does reference external files (references/paper2web.md, references/paper2video.md, etc.) which is good progressive disclosure. However, the SKILL.md itself is monolithic—it includes extensive troubleshooting, resource requirements, API costs, platform-specific features, deployment guidance, evaluation metrics, and promotional content that should be in reference files. The core document tries to be both an overview and a comprehensive guide, defeating the purpose of the reference structure. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (599 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
8277276
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.