markdown-url

Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing

Quality

—

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Quality

Content

85%

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

The body is actionable and well-sequenced with concrete examples and a real bundled helper, and progressive disclosure is appropriate for a simple skill. Its main weakness is redundancy: fallback behavior is explained several times across sections.

Suggestions

Consolidate the fallback guidance into one section; reference it from the workflow instead of restating it in Policy, Block/Failure Signals, Fallback Behavior, and Notes.

Dimension	Reasoning	Score
Conciseness	The body is directive and avoids explaining concepts Claude already knows, but the fallback-to-original-URL behavior is restated across the Agent Workflow, Policy, Block/Failure Signals, Fallback Behavior, and Notes sections, so it could be tightened.	2 / 3
Actionability	Provides concrete rewrite examples, explicit block/failure signals, and a copy-paste-ready CLI command (`node skills/markdown-url/scripts/markdown-url.js ...`) backed by a real, executable script.	3 / 3
Workflow Clarity	Sequences rewrite → visit → extract → use, and pairs it with explicit validation signals plus a clear feedback loop (attempt markdown.new → on block/failure fall back to the original URL).	3 / 3
Progressive Disclosure	A simple single-purpose skill with well-organized sections and a single one-level-deep reference to the bundled script, which the scoring notes allow to score 3 for simple skills.	3 / 3
	Total	11 / 12 Passed

Description

90%

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 clearly communicates a single concrete capability with explicit use-when triggers and natural vocabulary, using third-person voice. It is strong overall; the only soft spot is specificity, since it names one action rather than enumerating several.

Suggestions

Add one or two more concrete verbs (e.g. "extract", "summarize", "copy") in the opening line to lift specificity from a single action to multiple concrete actions.

Dimension	Reasoning	Score
Specificity	Names the domain and a concrete action — "Route any website you need to visit through markdown.new by prefixing the URL" — but describes a single action rather than listing multiple specific concrete actions, so it does not reach the comprehensive level.	2 / 3
Completeness	Explicitly states what it does (route URLs through markdown.new) and when to use it via a dedicated "WHEN TO USE:" block with concrete triggers, satisfying both halves.	3 / 3
Trigger Term Quality	Covers natural terms a user would say — "website", "read content", "docs, blog posts, changelogs, GitHub issues", "copying notes", "summarizing" — giving good coverage of how the need actually surfaces.	3 / 3
Distinctiveness Conflict Risk	The markdown.new routing niche and its read-only-content triggers are distinct enough that this is unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

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: am-will/codex-skills
Commit: e343715

Reviewed: 14 days ago

Table of Contents

Discovery Implementation Validation

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.