url-analysis_skill

Overview

This skill validates URLs both technically and contextually to ensure links are functional, secure, and appropriate for their placement. It combines HTTP/SSL checks, redirect analysis, link extraction, and content-alignment scoring to produce actionable reports. Use it to find broken links, identify risky destinations, and improve link relevance and SEO value.

How this skill works

The skill performs technical validation (HTTP status, redirects, response time, SSL validity, and syntax checks) and extracts links from provided content, categorizing them as internal, external, anchor, download, or API endpoints. It runs contextual analysis comparing link text to destination content, assesses source authority and publication relevance, and assigns quality scores with suggested fixes. Outputs include JSON summaries and human-readable reports highlighting issues and recommended actions.

When to use it

• Validating all links in an article, documentation, or site export
• Extracting and categorizing links from markdown or HTML content
• Auditing link quality and SEO impact before publication
• Finding broken or redirected links for maintenance
• Checking links for security risks or inappropriate destinations

Best practices

• Run both technical and contextual checks; a 200 status doesn’t guarantee relevance
• Prefer final destination URLs over redirect chains and update links accordingly
• Favor HTTPS and verify SSL certificates to protect readers
• Match link text to destination content; ambiguous anchors reduce trust and SEO value
• Prioritize high-traffic pages and external links for regular audits

Example use cases

• Validate and fix links in a blog post before publishing
• Audit documentation to remove broken links and update redirects
• Extract all external references from a research report and assess their authority
• Run a security sweep to flag links pointing to suspicious domains
• Generate a link-quality report for SEO and content teams