CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-dot-new

Retrieve the Markdown version of a public web page from a URL using the agent's built-in URL fetch capability and markdown.new. Use when a user asks for page content in Markdown, cleaner extracted page content for LLM use, or URL-to-Markdown conversion.

69

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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.

A well-structured, actionable skill body for a simple task: clear trigger/anti-trigger sections, a sequenced workflow with retry feedback loops, and an explicit failure policy. The only meaningful improvement is stating the default method value and trimming the small overlap between the Failure Policy and workflow steps.

DimensionReasoningScore

Conciseness

The body is efficient and free of concept over-explanation, but the Failure Policy section restates stop conditions already covered in the Workflow steps, a minor duplication that could be trimmed — matching the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Guidance is concrete and executable — build `https://markdown.new/<target-url>`, a full copy-paste example with parameters, and specific retry conditions (`method=browser`, `retain_images=true`) — but it stops just short of fully executable because the default method value is never stated and parameter values are listed without any indication of what each does, matching the 'mostly executable with minor gaps' anchor.

4 / 5

Workflow Clarity

The four-step workflow is clearly sequenced with explicit validation checkpoints (URL validation, tool-availability check) and genuine feedback loops (empty/protected-page result → retry with `method=browser`, error response → report and stop), and the operation is neither destructive nor batch, matching the top anchor.

5 / 5

Progressive Disclosure

This is a simple single-purpose skill that needs no external references, and the body is compact with well-organized sections (use/don't-use, workflow, parameters, examples, failure policy), which per the simple-skill note earns the top anchor; not below 5 because there is no inlined content that belongs in separate files.

5 / 5

Total

18

/

20

Passed

Description

82%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.

A strong description: third person, concise, with an explicit 'Use when' clause carrying multiple concrete trigger phrases and a clearly distinct niche. The only notable gap is capability breadth — it describes a single retrieval action rather than a fuller set of specific actions.

Suggestions

Broaden the specificity of capabilities by naming one or two additional concrete actions the skill performs (e.g. optional parameter selection such as browser-based rendering for JavaScript-heavy pages or image retention).

Add a couple of natural user phrasings or synonyms (e.g. 'scrape page as text', 'clean page content for LLM context') to widen trigger-term coverage.

DimensionReasoningScore

Specificity

The description names one concrete action ("Retrieve the Markdown version of a public web page from a URL") plus its mechanism, but does not enumerate several distinct capabilities, matching the '1-2 concrete actions, not comprehensive' anchor rather than the 'several specific actions' anchor above.

3 / 5

Completeness

It explicitly answers both what ("Retrieve the Markdown version of a public web page from a URL using... markdown.new") and when ("Use when a user asks for page content in Markdown, cleaner extracted page content for LLM use, or URL-to-Markdown conversion") with three concrete trigger phrases, matching the top anchor; not 4 because the 'when' clause is fully explicit, not merely adequate.

5 / 5

Trigger Term Quality

Natural phrases like "page content in Markdown", "cleaner extracted page content for LLM use", and "URL-to-Markdown conversion" give good keyword coverage, but common synonyms users might say (e.g. scrape, clean page text, .md export) are missing, so it sits at the 'good coverage, a few natural terms missing' anchor rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The markdown.new URL-to-Markdown niche with Markdown-specific triggers is clearly distinguishable from generic fetch/browse skills and unlikely to fire for the wrong skill, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ceshine/ceshine-agent-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.