Repair Broken References
Find and fix broken internal links, dead external URLs, stale imports, missing cross-references, and orphaned files. Ensures all project references remain valid and up-to-date. Use when documentation contains broken internal links, external URLs return 404 errors, import statements reference moved or deleted modules, cross-references between files are out of sync, or files exist but are never referenced anywhere in the project.
Install
npx skills add pjt222/agent-almanac --skill repair-broken-referencesgit clone --depth 1 https://github.com/pjt222/agent-almanac.git /tmp/agent-almanac
mkdir -p ~/.claude/skills
cp -r /tmp/agent-almanac/i18n/caveman-lite/skills/repair-broken-references ~/.claude/skills/repair-broken-referencesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# repair-broken-references ## When to Use Use this skill when project references have become stale: - Documentation contains broken internal links - External URLs return 404 errors - Import statements reference moved or deleted modules - Cross-references between files are out of sync - Files exist but are never referenced anywhere **Do NOT use** for refactoring module dependencies or redesigning information architecture. This skill repairs existing references, not restructures them. ## Inputs | Parameter | Type | Required | Description | |---|---|---|---| | `project_path` | string | Yes | Absolute path to project root | | `check_external` | boolean | No | Verify external URLs (default: true, slow) | | `fix_mode` | enum | No | `auto` (fix obvious), `report` (document only), `interactive` (prompt) | | `orphan_threshold` | integer | No | Days since last modified to flag as orphan (default: 180) | ## Procedure ### Step 1: Scan for Broken Internal Links Find all markdown links pointing to non-existent files.
Details
- Skill name
repair-broken-references- Repository
- pjt222/agent-almanac
- Path
i18n/caveman-lite/skills/repair-broken-references/SKILL.md- License
- MIT
- Repo updated
- 18 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Repair Broken References skill do?
Find and fix broken internal links, dead external URLs, stale imports, missing cross-references, and orphaned files. Ensures all project references remain valid and up-to-date. Use when documentation contains broken internal links, external URLs return 404 errors, import statements reference moved or deleted modules, cross-references between files are out of sync, or files exist but are never referenced anywhere in the project.
How do I install the Repair Broken References skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add pjt222/agent-almanac --skill repair-broken-references. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Repair Broken References popular?
It lives in pjt222/agent-almanac, which has 45 GitHub stars and 4 forks, and is included in 1 curated skill list.
Related skills
Adapt Architecture
45pjt222/agent-almanac
Execute structural metamorphosis using strangler fig migration, chrysalis phases, and interface preservation. Covers transformation planning, parallel running, progressive cutover, rollback design, and post-metamorphosis stabilization for system architecture evolution. Use when assess-form has classified the system as READY for transformation, when migrating from monolith to microservices, when replacing a core subsystem while dependents continue operating, or when any architectural change must be gradual rather than big-bang.
Adaptic
45pjt222/agent-almanac
Master skill composing the 5-step synoptic cycle for panoramic synthesis across multiple domains. Orchestrates meditate, expand-awareness, observe, awareness, integrate-gestalt, and express-insight into a coherent process that produces unified understanding rather than sequential compromise. Use when a problem genuinely spans 3+ domains and the interactions between domains matter more than depth in any one, when sequential analysis feels like compromise rather than integration, or before major architectural decisions affecting multiple stakeholders.
Add Puzzle Type
45pjt222/agent-almanac
Scaffold a new puzzle type across all 10+ pipeline integration points in jigsawR. Creates the core puzzle module, wires it into the unified pipeline (generation, positioning, rendering, adjacency), adds ggpuzzle geom/stat layers, updates DESCRIPTION and config.yml, extends the Shiny app, and creates a comprehensive test suite. Use when adding a completely new puzzle type to the package or following the 10-point integration checklist to ensure nothing is missed end-to-end.
Tender Documentation Review
43AlsKozlov/ru-legal
Killer skill для public-procurement. Анализ тендерной документации (44-ФЗ / 223-ФЗ) перед подачей заявки. Сections: техническое задание, требования к участникам, обеспечение, форма заявки, проект контракта, ценовая часть. Flags: "заточенность", нарушения 44-ФЗ, риски штрафов / РНП.
Render Puzzle Docs
45pjt222/agent-almanac
Render the jigsawR Quarto documentation site for GitHub Pages. Supports fresh renders (clearing cache), cached renders (faster), and single-page renders. Uses the bundled render script or direct quarto.exe invocation from WSL. Use when building the full site after content changes, rendering a single page during iterative editing, preparing documentation for a release or PR, or debugging render errors in Quarto .qmd files.
Tidy Project Structure
45pjt222/agent-almanac
Organize project files into conventional directories, update stale READMEs, clean configuration drift, and archive deprecated items without changing code logic. Use when files are scattered without clear organization, READMEs are outdated or contain broken examples, configuration files have multiplied across dev/staging/prod, deprecated files remain in the project root, or naming conventions are inconsistent across directories.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.