CtrlK
BlogDocsLog inGet started
Tessl Logo

web-to-markdown

웹페이지 URL을 입력받아 마크다운 형태로 변환하여 저장합니다. 웹 문서를 로컬 마크다운 파일로 아카이빙하거나 정리할 때 유용합니다.

54

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/web-to-markdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Weight 40%Scale 1-5

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

The body is action-oriented with concrete prompts, scripts, and a well-sequenced dynamic-content fallback, but it is markedly verbose — duplicating a long prompt template and padding marketing sections — and offers no progressive disclosure for a ~770-line skill. Batch and primary workflows also lack validation checkpoints.

Suggestions

Deduplicate the AI-optimized prompt template: define it once and reference it from both Step 4 and Dual Mode Step 3, and trim the marketing-style '듀얼 모드 장점/사용 시나리오' sections and the ⭐-rating comparison table that add no instructional value.

Add per-item validation to the batch '여러 URL 일괄 변환' flow (verify each converted markdown is non-empty, report failures per URL, continue or abort on error) so the workflow earns a validation checkpoint.

Move the detailed AI-optimized prompt template and the Playwright dynamic-content guide into separate reference files (e.g. references/ai-optimized-prompt.md, references/playwright-fallback.md) and have SKILL.md point to them one level deep, turning the file into an overview.

DimensionReasoningScore

Conciseness

The ~65-line AI-optimized prompt template is duplicated verbatim in Step 4 (lines 97-163) and Dual Mode Step 3 (lines 236-302), and padded marketing sections ('듀얼 모드 장점', '사용 시나리오', the ⭐-rating comparison table) add little instructional value — matching 'noticeably verbose; several unnecessary explanations or padded sections'; not 1 because it does not extensively explain concepts Claude already knows, and not 3 because the duplication and marketing padding are substantial, not minor.

2 / 5

Actionability

Provides copy-pasteable WebFetch prompt strings, a real executable Node Playwright script, and concrete AskUserQuestion/Write tool-call examples, fitting 'mostly executable guidance; concrete code or commands with minor gaps'; not 5 because the Playwright→markdown step is hand-waved ('WebFetch 프롬프트에 넣어') when WebFetch takes a URL not raw HTML, a real logic gap.

4 / 5

Workflow Clarity

Steps are clearly sequenced (Core Step 1-6, Dual Step 1-4, dynamic-content flow with a length-validation feedback loop), but the primary and batch-conversion workflows lack per-step validation checkpoints; per the rubric cap, batch operations without validation cannot score above 3 — matching 'steps listed but validation gaps; checkpoints missing or implicit'; not 4 because the batch '여러 URL 일괄 변환' flow has no per-item validation or error recovery.

3 / 5

Progressive Disclosure

The file has well-organized section headers, but at ~770 lines with no bundle files the detailed AI-optimized prompt template, dual-mode workflow, and Playwright fallback guide are all inlined rather than split into one-level-deep reference files — matching 'some structure but content that should be separate is inline'; not 2 because section headers and navigation are present (not minimal structure), and not 4 because there are zero external references for a large skill.

3 / 5

Total

12

/

20

Passed

Description

75%Weight 40%Scale 1-5

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, concrete, and covers both what the skill does and a usable when-context with natural Korean trigger terms. Its main weakness is omitting the AI-optimized and dual-conversion modes that dominate the body, and using a soft 'useful when' phrasing rather than an explicit 'Use when…' trigger.

DimensionReasoningScore

Specificity

Quotes '웹페이지 URL을 입력받아 마크다운 형태로 변환하여 저장합니다' — names the domain plus several concrete actions (receive URL, convert to markdown, save file), matching the 'lists several specific actions; minor gaps' anchor; not 5 because the prominent AI-optimized/dual modes are absent, and not 3 because the actions are concrete rather than generic.

4 / 5

Completeness

Has a clear 'what' ('마크다운 형태로 변환하여 저장합니다') and a stated 'when' ('웹 문서를 로컬 마크다운 파일로 아카이빙하거나 정리할 때 유용합니다'), fitting 'both what and when; when could be more explicit'; not 5 because the when is a soft 'useful when' rather than an explicit 'Use when…' trigger with concrete user-utterance phrases, and not 3 because the when-context is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

Contains natural terms a Korean user would say — '웹페이지', 'URL', '마크다운', '웹 문서', '아카이빙', '정리' — giving good keyword coverage per the anchor 4 example; not 5 because synonyms like '링크/웹사이트/블로그' and the '.md' extension are missing.

4 / 5

Distinctiveness Conflict Risk

The niche '웹페이지 URL → 로컬 마크다운 파일' is mostly distinct with only minor overlap risk against generic web-fetch/document skills, matching the anchor 4 example; not 5 because the trigger is not as crisply differentiated as the anchor 5 example which pairs the niche with an explicit 'Use when…' clause.

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (774 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 4 missing, 4 suspicious

Warning

Total

14

/

16

Passed

Repository
bear2u/my-skills
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.