--- name: fix-broken-links description: 'Scan web files for broken hyperlinks and weak SEO anchor text, then interactively replace, strip, or skip each dead URL. Use when asked to find or fix broken links, check for dead links or 404s, audit hyperlinks, validate URLs, or flag generic anchor text ("click here", "read more") in HTML, Markdown, JS/TS, JSON, CSS, SQL, or template files.' metadata: tags: 'links, seo, html, markdown, url-validation' --- # Fix Broken Links Scans web files for broken hyperlinks and reports them. For each broken URL the skill tries common spelling variations, optionally hands the link to the GitHub Copilot CLI for suggested replacements, and presents an interactive fix menu. Generic anchor text (`click here`, `read more`, etc.) is flagged as an SEO issue. ## When to Use This Skill - User asks to "find broken links", "fix broken links", or "check for dead links / 404s" - User wants to audit or validate the hyperlinks in edited or changed files - User wants generic anchor text (`click here`, `here`, `read more`) flagged for SEO - User wants link checking across HTML, Markdown, JS/TS, JSON, CSS, SQL, or templates ## Prerequisites - `curl` — HTTP status checks (the script exits quietly if absent) - `grep`, `sed` — link extraction (standard on any POSIX system) - Bash 4+ for `scripts/link-fix.sh`; on Windows use Git Bash or WSL, or run the PowerShell 7+ port `scripts/link-fix.ps1` - `jq` — optional; lets the bash script parse a JSON payload piped on stdin - `git` — optional; used to discover changed files when no paths are passed (falls back to a full repo scan) - `copilot` (GitHub Copilot CLI) — optional; powers agent-suggested replacements. Without it, only verified spelling variations are offered. ## How It Works The script has two modes: - **With file paths** (passed as command-line arguments): it checks each link, looks up replacement candidates, and presents the interactive fix menu. - **With no file arguments**: it discovers changed files via `git` (or scans the repo) and simply lists the broken links — no replacement lookups and no prompts. Links are found by scanning each file for `http(s)://` URLs, so the same logic covers every format that embeds absolute URLs. ## Step-by-Step Workflow ### 1. Choose the script for the platform | Platform | Command | | --- | --- | | POSIX / Git Bash / WSL | `bash scripts/link-fix.sh ` | | Windows PowerShell 7+ | `pwsh scripts/link-fix.ps1 ` | ### 2. Run against the target files Pass one or more web files to get the full repair flow (lookup + interactive menu): ```bash bash scripts/link-fix.sh docs/guide.md index.html ``` ```powershell pwsh scripts/link-fix.ps1 docs/guide.md index.html ``` Run with no arguments to report broken links in changed files only (no prompts): ```bash bash scripts/link-fix.sh ``` ### 3. Resolve each broken link For each broken URL the interactive menu offers: | Key | Action | | --- | --- | | `r` | Replace with the suggested URL (a working variation, or an agent-proposed alternative) | | `1`–`9` | Replace with a numbered alternative | | `d` | Strip the link wrapper, keeping the visible text as plain text | | `c` | Enter a custom replacement URL | | `s` | Skip | ## Supported Source Types | Source | Examples matched | | --- | --- | | HTML | ``, ``, `

Fix Broken Links

Description

Latest Changes

Install Fix Broken Links with One Click