웹페이지 URL을 입력받아 마크다운 형태로 변환하여 저장합니다. 웹 문서를 로컬 마크다운 파일로 아카이빙하거나 정리할 때 유용합니다.
53
42%
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 ./.claude/skills/web-to-markdown/SKILL.mdQuality
Discovery
57%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 description adequately conveys the core functionality of converting web pages to markdown files, with a reasonably distinct purpose. However, it lacks explicit trigger guidance ('Use when...') and could benefit from more specific action verbs and natural user keywords to improve skill selection accuracy.
Suggestions
Add an explicit 'Use when...' clause with trigger terms like 'save webpage', 'convert URL to markdown', 'archive website', 'download page as markdown'
Include common variations and file-related terms users might mention: '.md', 'web scraping', 'page content', 'website to text'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (web pages, URLs) and describes the core action (convert to markdown and save), but doesn't list multiple specific concrete actions like extracting specific elements, handling images, or preserving formatting. | 2 / 3 |
Completeness | Clearly describes WHAT it does (converts webpage URLs to markdown and saves them), and implies WHEN (archiving/organizing web documents), but lacks an explicit 'Use when...' clause with specific trigger scenarios. | 2 / 3 |
Trigger Term Quality | Includes relevant terms like 'URL', '웹페이지' (webpage), '마크다운' (markdown), '아카이빙' (archiving), but missing common variations users might say like 'save webpage', 'download page', 'convert website', or file extensions. | 2 / 3 |
Distinctiveness Conflict Risk | Has a clear niche combining URL input, markdown conversion, and local file saving - this specific combination is unlikely to conflict with other skills like general markdown editing or web scraping tools. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is extremely verbose and repetitive, with the same AI optimization prompt appearing multiple times in full. While it covers many scenarios comprehensively, it violates token efficiency principles severely - the content could be reduced by 60-70% without losing functionality. The lack of progressive disclosure (everything inline) and weak validation checkpoints further reduce its effectiveness.
Suggestions
Extract the AI optimization prompt template to a separate file (e.g., PROMPTS.md) and reference it once instead of repeating it 3 times
Move the Dual Mode and Dynamic Content Handling sections to separate reference files (DUAL-MODE.md, PLAYWRIGHT.md) with brief summaries in the main skill
Add explicit validation step after WebFetch: 'If content length < 500 chars OR contains only navigation elements, prompt for Playwright fallback'
Remove explanatory content Claude already knows (what markdown is, how caching works, what HTTP/HTTPS means) to reduce token usage by ~40%
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with massive repetition - the AI optimization prompt appears 3 times in full, the dual mode workflow repeats nearly identical content to the core workflow, and there's excessive explanation of concepts Claude already knows (what markdown is, how caching works, etc.). | 1 / 3 |
Actionability | Contains some concrete code examples and tool invocations (WebFetch, Write, AskUserQuestion), but much of it is pseudocode or placeholder patterns rather than truly executable code. The Playwright examples mix approaches without clear executable paths. | 2 / 3 |
Workflow Clarity | Steps are clearly numbered and sequenced, but validation checkpoints are weak - there's no explicit verification that WebFetch returned valid content before proceeding, and the 'content length < 500' check is mentioned but not integrated into a proper validation loop. | 2 / 3 |
Progressive Disclosure | Monolithic wall of text at ~600+ lines with no references to external files. Content that should be separate (AI optimization prompts, Playwright setup, dual mode details) is all inline, making the skill overwhelming and difficult to navigate. | 1 / 3 |
Total | 6 / 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 |
|---|---|---|
skill_md_line_count | SKILL.md is long (774 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
1be5394
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.