aiskillstore/marketplace / skills/89jobrien/url-analysis
url-analysis
VerifiedURL validation and contextual analysis specialist. Use when validating links, analyzing URL context, extracting links from content, or ensuring link appropriateness. Combines technical validation with content analysis.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
| scripts/validate-urls.pyexecutable | script | 3.1 KB |
| skill-report.json | config | 31.8 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T14:11:47.063Z",
"slug": "89jobrien-url-analysis",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/url-analysis",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "30f59aed87f1c9a83b910338a958d5ba70f52bf7af53af7b2790806db266b75f",
"tree_hash": "3fa46b9b440d227ef16b3642c396ac02600ce544ae4fc65e7dc99334b582656c",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "url-analysis",
"description": "Validate URLs, redirects, and contextual link quality in documents or single URLs using a Python helper and guided review.",
"summary": "Checks link health, redirects, and relevance for content review workflows.",
"icon": "📦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"tags": [
"url-validation",
"link-audit",
"redirect-analysis",
"documentation",
"seo"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"scripts",
"network",
"external_commands"
],
"category": "security"
},
"security_audit": {
"risk_level": "medium",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Most SKILL.md findings are false positives from Markdown code fences and example URLs. The helper does perform real outbound URL checks, and unrestricted user-controlled destinations create a moderate internal network probing risk.",
"remediation": [
{
"issue": "Unrestricted outbound URL validation",
"suggestion": "Block loopback, link-local, private, metadata service, and non-HTTP(S) targets before sending requests. Ask for confirmation before live network checks.",
"severity": "medium"
},
{
"issue": "Network behavior may surprise users",
"suggestion": "State that technical validation sends HEAD requests to each checked URL and may reveal that a link was checked.",
"severity": "low"
},
{
"issue": "Helper script path is documented inconsistently",
"suggestion": "Update the Markdown examples to use scripts/validate-urls.py so users run the included file.",
"severity": "low"
}
],
"risk_factor_evidence": [
{
"factor": "scripts",
"evidence": [
{
"file": "scripts/validate-urls.py",
"line_start": 13,
"line_end": 16
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "scripts/validate-urls.py",
"line_start": 13,
"line_end": 13
},
{
"file": "scripts/validate-urls.py",
"line_start": 60,
"line_end": 60
},
{
"file": "SKILL.md",
"line_start": 47,
"line_end": 47
},
{
"file": "SKILL.md",
"line_start": 81,
"line_end": 81
},
{
"file": "SKILL.md",
"line_start": 124,
"line_end": 124
},
{
"file": "SKILL.md",
"line_start": 130,
"line_end": 130
},
{
"file": "SKILL.md",
"line_start": 131,
"line_end": 131
},
{
"file": "SKILL.md",
"line_start": 135,
"line_end": 135
},
{
"file": "SKILL.md",
"line_start": 142,
"line_end": 142
},
{
"file": "SKILL.md",
"line_start": 148,
"line_end": 148
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 38,
"line_end": 38
},
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 40
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 48
},
{
"file": "SKILL.md",
"line_start": 48,
"line_end": 54
},
{
"file": "SKILL.md",
"line_start": 54,
"line_end": 56
},
{
"file": "SKILL.md",
"line_start": 56,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 60
},
{
"file": "SKILL.md",
"line_start": 60,
"line_end": 64
},
{
"file": "SKILL.md",
"line_start": 64,
"line_end": 66
},
{
"file": "SKILL.md",
"line_start": 66,
"line_end": 76
},
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 82
},
{
"file": "SKILL.md",
"line_start": 82,
"line_end": 119
},
{
"file": "SKILL.md",
"line_start": 119,
"line_end": 154
}
]
}
],
"static_findings": [
{
"id": "scripts:scripts/validate-urls.py:13:dynamic-import-expression",
"category": "scripts",
"severity": "medium",
"pattern": "Dynamic import() expression",
"file": "scripts/validate-urls.py",
"line_start": 13,
"line_end": 16,
"snippet": "from requests.exceptions import ( # type: ignore[import-untyped]"
},
{
"id": "network:scripts/validate-urls.py:13:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "scripts/validate-urls.py",
"line_start": 13,
"line_end": 13,
"snippet": "from requests.exceptions import ( # type: ignore[import-untyped]"
},
{
"id": "network:scripts/validate-urls.py:60:python-http-libraries",
"category": "network",
"severity": "low",
"pattern": "Python HTTP libraries",
"file": "scripts/validate-urls.py",
"line_start": 60,
"line_end": 60,
"snippet": "response = requests.head(url, timeout=timeout, allow_redirects=True)"
},
{
"id": "blocker:scripts/validate-urls.py:52:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "scripts/validate-urls.py",
"line_start": 52,
"line_end": 52,
"snippet": "result[\"error\"] = \"Invalid URL syntax\""
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 38,
"line_end": 38,
"snippet": "This skill includes Python helper scripts in `scripts/`:"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 40,
"snippet": "- **`validate_urls.py`**: Validates URLs from files or command line. Checks HTTP status codes, redir"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 48,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 48,
"line_end": 54,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 54,
"line_end": 56,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 56,
"line_end": 58,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 60,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 60,
"line_end": 64,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 64,
"line_end": 66,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 66,
"line_end": 76,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 76,
"line_end": 82,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 82,
"line_end": 119,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 119,
"line_end": 154,
"snippet": "```markdown"
},
{
"id": "network:SKILL.md:47:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 47,
"line_end": 47,
"snippet": "python scripts/validate_urls.py --url https://example.com"
},
{
"id": "network:SKILL.md:81:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 81,
"line_end": 81,
"snippet": "python scripts/validate_urls.py --url https://example.com"
},
{
"id": "network:SKILL.md:124:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 124,
"line_end": 124,
"snippet": "**1. https://example.com/article**"
},
{
"id": "network:SKILL.md:130:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 130,
"line_end": 130,
"snippet": "**2. https://old-site.com/page**"
},
{
"id": "network:SKILL.md:131:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 131,
"line_end": 131,
"snippet": "- **Status**: 301 → https://new-site.com/page"
},
{
"id": "network:SKILL.md:135:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 135,
"line_end": 135,
"snippet": "**3. https://broken-link.com**"
},
{
"id": "network:SKILL.md:142:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 142,
"line_end": 142,
"snippet": "**4. https://example.com/article**"
},
{
"id": "network:SKILL.md:148:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "SKILL.md",
"line_start": 148,
"line_end": 148,
"snippet": "**5. https://example.com/homepage**"
},
{
"id": "blocker:SKILL.md:127:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 127,
"line_end": 128,
"snippet": "- **SSL**: Valid"
},
{
"id": "blocker:SKILL.md:21:network-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "Network reconnaissance",
"file": "SKILL.md",
"line_start": 21,
"line_end": 22,
"snippet": "- When analyzing link context and appropriateness"
}
],
"finding_verdicts": [
{
"id": "scripts:scripts/validate-urls.py:13:dynamic-import-expression",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "Line 13 is a static import of requests exception classes, not runtime code loading. No dynamic import or plugin execution path is present."
},
{
"id": "network:scripts/validate-urls.py:13:python-http-libraries",
"verdict": "confirmed",
"confidence": 0.88,
"reason": "The import is part of a helper that performs outbound URL validation with requests. It is expected behavior, but it confirms real network capability.",
"severity": "low"
},
{
"id": "network:scripts/validate-urls.py:60:python-http-libraries",
"verdict": "confirmed",
"confidence": 0.92,
"reason": "requests.head sends an outbound request to the supplied URL without host filtering. This is legitimate for validation, but it can contact untrusted or internal destinations.",
"severity": "medium"
},
{
"id": "blocker:scripts/validate-urls.py:52:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Line 52 only records the string Invalid URL syntax after parsing fails. It does not inspect system configuration, users, files, or network interfaces."
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line describes the scripts directory in Markdown. It contains inline code formatting, not shell execution or Ruby backticks."
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This is a Markdown bullet describing the helper script and its output. It does not execute commands or interpolate user input into a shell."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This starts a fenced bash example in documentation. The example shows fixed helper invocations and is not executable code inside the skill."
},
{
"id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This is the closing Markdown fence for an example block. It is not a shell command, Ruby backtick expression, or execution primitive."
},
{
"id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line opens a plain prompt example block. It contains natural language usage text, not an external command."
},
{
"id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This is a Markdown code fence delimiter after a prompt example. It does not cause command execution."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line opens another natural language prompt example. It is documentation text and has no executable shell behavior."
},
{
"id": "external_commands:SKILL.md:60:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This is a Markdown fence delimiter, not a command. No process spawning or shell parsing appears at this location."
},
{
"id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line opens a documented prompt example for link extraction. It is not executable code and does not invoke a shell."
},
{
"id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This is a Markdown closing fence after a prompt example. It has no external command execution semantics."
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "This starts another bash example block in the skill documentation. The command shown is a fixed optional helper invocation, not hidden execution."
},
{
"id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This closes the documented bash example. The Markdown delimiter itself is not a Ruby backtick or shell execution feature."
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This starts a Markdown-formatted output example. It is sample report text, not executable code."
},
{
"id": "network:SKILL.md:47:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "https://example.com appears in a documented example command. It is not a hardcoded destination used by executable code."
},
{
"id": "network:SKILL.md:81:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "https://example.com appears in a repeated usage example. The helper does not force requests to this domain."
},
{
"id": "network:SKILL.md:124:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "This URL is part of sample output in the README-style skill text. It is documentation, not an embedded network target."
},
{
"id": "network:SKILL.md:130:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "https://old-site.com/page is a sample URL used to illustrate redirects. No code automatically contacts this domain."
},
{
"id": "network:SKILL.md:131:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "https://new-site.com/page appears only as a sample redirect target. It is not a configured endpoint or exfiltration destination."
},
{
"id": "network:SKILL.md:135:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "https://broken-link.com is sample output for a broken link scenario. It is not referenced by the helper code."
},
{
"id": "network:SKILL.md:142:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "This example.com URL is part of illustrative report content. The executable script uses caller-provided URLs instead."
},
{
"id": "network:SKILL.md:148:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "This example.com homepage URL appears in sample contextual analysis. It is not a hardcoded live endpoint in code."
},
{
"id": "blocker:SKILL.md:127:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The SSL line is sample report text describing a URL result. It does not gather system information or enumerate local resources."
},
{
"id": "blocker:SKILL.md:21:network-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line describes analyzing link context and appropriateness. It does not instruct scanning networks, discovering hosts, or enumerating services."
}
],
"semantic_findings": [
{
"title": "Unrestricted URL Fetching Can Probe Internal Network",
"description": "The helper accepts URLs from files or command line arguments and sends HEAD requests without private address, loopback, or metadata service filtering. A document with internal URLs could cause network probes from the agent environment.",
"severity": "medium",
"locations": [
{
"file": "scripts/validate-urls.py",
"line_start": 60,
"line_end": 60
},
{
"file": "scripts/validate-urls.py",
"line_start": 77,
"line_end": 84
},
{
"file": "scripts/validate-urls.py",
"line_start": 100,
"line_end": 107
}
],
"confidence": 0.9,
"confidence_reasoning": "The URL is taken directly from user-controlled inputs and passed to requests.head. The risk depends on execution context, but the unrestricted outbound behavior is clear."
}
],
"critical_findings": [],
"high_findings": [],
"medium_findings": [
{
"title": "Python HTTP libraries",
"description": "response = requests.head(url, timeout=timeout, allow_redirects=True)",
"locations": [
{
"file": "scripts/validate-urls.py",
"line_start": 60,
"line_end": 60
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.92,
"confidence_reasoning": "requests.head sends an outbound request to the supplied URL without host filtering. This is legitimate for validation, but it can contact untrusted or internal destinations."
},
{
"title": "Unrestricted URL Fetching Can Probe Internal Network",
"description": "The helper accepts URLs from files or command line arguments and sends HEAD requests without private address, loopback, or metadata service filtering. A document with internal URLs could cause network probes from the agent environment.",
"locations": [
{
"file": "scripts/validate-urls.py",
"line_start": 60,
"line_end": 60
},
{
"file": "scripts/validate-urls.py",
"line_start": 77,
"line_end": 84
},
{
"file": "scripts/validate-urls.py",
"line_start": 100,
"line_end": 107
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "medium",
"confidence": 0.9,
"confidence_reasoning": "The URL is taken directly from user-controlled inputs and passed to requests.head. The risk depends on execution context, but the unrestricted outbound behavior is clear."
}
],
"low_findings": [
{
"title": "Python HTTP libraries",
"description": "from requests.exceptions import ( # type: ignore[import-untyped]",
"locations": [
{
"file": "scripts/validate-urls.py",
"line_start": 13,
"line_end": 13
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "low",
"confidence": 0.88,
"confidence_reasoning": "The import is part of a helper that performs outbound URL validation with requests. It is expected behavior, but it confirms real network capability."
}
],
"dangerous_patterns": [],
"files_scanned": 2,
"total_lines": 295,
"audit_model": "codex",
"audited_at": "2026-07-05T14:11:47.063Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Validate URLs with Context",
"value_statement": "Broken, stale, or mismatched links reduce trust and waste review time. This skill checks link status, redirects, context fit, and quality signals for documents or single URLs.",
"seo_keywords": [
"Claude URL validation",
"Codex URL analysis",
"Claude Code link audit",
"URL validator",
"link checker",
"broken link audit",
"redirect analysis",
"contextual link review",
"SEO link quality",
"documentation link validation"
],
"actual_capabilities": [
"Extracts HTTP and HTTPS links from provided text files.",
"Checks URL syntax before making a request.",
"Sends HEAD requests to measure accessibility and status codes.",
"Reports redirect targets and redirect chain length.",
"Guides contextual review of link text, relevance, source authority, and reader value."
],
"limitations": [
"Network validation contacts each checked URL and depends on remote server behavior.",
"The helper does not block private, loopback, or metadata service addresses.",
"SSL validity is inferred through the HTTP client, not reported as certificate metadata.",
"The documented helper path uses underscores, while the included file name uses hyphens."
],
"use_cases": [
{
"title": "Documentation link review",
"description": "Technical writers can identify broken links, redirects, and link text mismatches before publishing.",
"target_user": "Technical writers"
},
{
"title": "SEO quality audit",
"description": "Content marketers can find outdated destinations, weak landing pages, and redirects that affect search quality.",
"target_user": "Content marketers"
},
{
"title": "Release checklist validation",
"description": "Developer advocates can check launch notes, examples, and reference links before a release.",
"target_user": "Developer advocates"
}
],
"prompt_templates": [
{
"title": "Check a Single Link",
"scenario": "Beginner single URL validation",
"prompt": "Validate this URL for syntax, accessibility, redirects, and likely context fit: [URL]."
},
{
"title": "Review a Document",
"scenario": "Find and validate links in a file",
"prompt": "Extract all URLs from [file or pasted content], validate them, and summarize broken links, redirects, and high priority fixes."
},
{
"title": "Assess Context Fit",
"scenario": "Evaluate link text and destination relevance",
"prompt": "Analyze the links in this article. Compare each link text with its destination purpose and flag mismatches or outdated sources."
},
{
"title": "Run a Publication Audit",
"scenario": "Advanced pre-publish link quality review",
"prompt": "Audit [document] for link health, redirects, HTTPS use, source authority, and reader value. Rank fixes by publication risk."
}
],
"output_examples": [
{
"input": "Validate a blog draft with product documentation links.",
"output": [
"The report identifies two redirects, one broken link, and one vague homepage destination.",
"It recommends updating redirect targets and replacing the broken reference."
]
},
{
"input": "Check whether a tutorial link matches its anchor text.",
"output": "The link is reachable, but the destination is a homepage instead of a React patterns article. The report recommends a specific article URL."
},
{
"input": "Audit release notes before publishing.",
"output": "The audit groups links by status, notes external domains, and ranks fixes by reader impact."
}
],
"best_practices": [
"Ask before running live network validation on private, sensitive, or unreleased documents.",
"Review redirects manually before updating important canonical URLs.",
"Pair technical status checks with human review of link relevance and authority."
],
"anti_patterns": [
"Do not treat a 200 status as proof that the destination is relevant.",
"Do not validate private intranet or localhost links without explicit permission.",
"Do not paste secrets into URLs or query strings for validation."
],
"faq": [
{
"question": "Does this skill make network requests?",
"answer": "Yes. The helper sends HEAD requests to URLs being validated when technical checks are used."
},
{
"question": "Can it validate URLs inside a document?",
"answer": "Yes. The helper extracts HTTP and HTTPS links from a text file and validates each one."
},
{
"question": "Does it judge link relevance?",
"answer": "It can guide contextual analysis, but final relevance decisions need human review."
},
{
"question": "Can it replace SEO tools?",
"answer": "No. It supports link quality review, but it does not crawl full sites or measure rankings."
},
{
"question": "Does it verify SSL certificates?",
"answer": "The HTTP client verifies TLS during HTTPS requests, but the helper does not return certificate details."
},
{
"question": "What should users check before running it?",
"answer": "Users should confirm that outbound requests are allowed and that the document does not contain sensitive internal URLs."
}
]
},
"file_structure": [
{
"name": "scripts",
"type": "dir",
"path": "scripts",
"children": [
{
"name": "validate-urls.py",
"type": "file",
"path": "scripts/validate-urls.py",
"lines": 122
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 173
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |