url-access-check

Validate URL reachability and image content-type, size, and dimensions.

1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/talesofai/bot-agent --skill url-access-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: url-access-check
Source: https://github.com/talesofai/bot-agent/tree/main/configs/skills/url-access-check
Command: npx skills add https://github.com/talesofai/bot-agent --skill url-access-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, and includes scripts (resource) components.

What problem does it solve?

In responses that include URLs (especially image links), broken or inaccessible targets degrade user experience. This Skill validates that each URL is resolvable in the current runtime environment and accessible, preventing NXDOMAIN/403/404 errors and non-image links from appearing as usable content.

Core Features & Use Cases

  • URL reachability checks: Verifies that plain URLs return a successful HTTP status within allowed redirects.
  • Image URL validation: Ensures content-type is image/*, validates (when provided) minimum bytes and dimensions, and prevents thumbnails from known blocked hosts.
  • Safe data handling: Detects and avoids vulnerable redirects and SSRF-like paths, returning actionable failure reasons when checks fail.
  • Use Case: Before replying with a downloadable file or embedded image, run the script to confirm the link will load in a browser and meets size/dimension requirements.

Quick Start

Run the url-access-check script to verify a URL, e.g.:

  • bash configs/skills/url-access-check/scripts/check_url.sh <url>
  • bash configs/skills/url-access-check/scripts/check_url.sh --image <image_url>
  • Optional: bash configs/skills/url-access-check/scripts/check_url.sh --image --min-short-side 768 <image_url>

Frequently Asked Questions about url-access-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate URL reachability and check HTTP status before displaying links?

To validate URL reachability, use a script that verifies a URL returns a successful HTTP status within allowed redirects. This checks HTTP headers and prevents broken links by returning actionable failure messages for 403, 404, or NXDOMAIN errors.

How can I verify an image URL meets content-type and size requirements?

You can verify an image URL by running a validation script with the image flag to ensure the content-type is image/* and validate minimum byte sizes and dimensions. This prevents non-image links or thumbnails from known blocked hosts from appearing as usable visual content.

Does this URL validation script detect unsafe redirects and SSRF-like paths?

Yes, the URL validation script detects and avoids vulnerable redirects and SSRF-like paths. It ensures safe data handling by validating HTTP headers and redirect chains, returning actionable failure reasons when security checks fail.

Do I need Bun installed to run the URL access check script?

Yes, you need Bun installed because the implementation uses Bun-based helpers alongside a Bash driver to ensure deterministic validation. The Bash script orchestrates the checks while Bun handles the underlying HTTP and content-type processing.

How do I enforce minimum image dimensions when checking URL accessibility?

To enforce minimum image dimensions, run the check_url.sh script with the --image and --min-short-side flags followed by the image URL. This validates that the image meets your specified pixel threshold before allowing it in the output.

What is the best way to prevent broken image links from appearing in generated responses?

The best way to prevent broken image links is to validate URLs before replying by running a reachability script that checks HTTP status, content-type, and size requirements. This ensures embedded images will load correctly in a browser environment.