# Validate URLs with Context

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.

## Install

```bash
npx skillstore add joseph obrien/89jobrien-url-analysis
```

## Metadata

- Status: approved
- Slug: 89jobrien-url-analysis
- Version: 1.0.1
- Author version: 1.0.1
- Skillstore revision: r1
- Version status: valid
- Tree hash: 3fa46b9b440d227ef16b3642c396ac02600ce544ae4fc65e7dc99334b582656c
- Author: Joseph OBrien
- GitHub username: 89jobrien
- License: MIT
- Repository: https://github.com/89jobrien/steve/tree/main/steve/skills/url-analysis
- Ref: c4037264bbd363c572662d6154a3ab28f5ca4f53
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: scripts, network, external\_commands
- Quality score: 71
- Public page: https://skillstore.pages.dev/skills/89jobrien-url-analysis
- Manifest: https://skillstore.pages.dev/api/skills/89jobrien-url-analysis/manifest

## 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.

## Use Cases

- Documentation link review: Technical writers can identify broken links, redirects, and link text mismatches before publishing.
- SEO quality audit: Content marketers can find outdated destinations, weak landing pages, and redirects that affect search quality.
- Release checklist validation: Developer advocates can check launch notes, examples, and reference links before a release.

## Prompt Templates

### Check a Single Link

```
Validate this URL for syntax, accessibility, redirects, and likely context fit: [URL].
```

### Review a Document

```
Extract all URLs from [file or pasted content], validate them, and summarize broken links, redirects, and high priority fixes.
```

### Assess Context Fit

```
Analyze the links in this article. Compare each link text with its destination purpose and flag mismatches or outdated sources.
```

### Run a Publication Audit

```
Audit [document] for link health, redirects, HTTPS use, source authority, and reader value. Rank fixes by publication risk.
```

## 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.

## 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.

## Security Audit

- Audited at: 2026-07-05T14:11:47.063\+00:00
- 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.

## Stats

- Views: 144
- Downloads: 11
- Favorites: 0
- Popularity score: 0