Does this skill work with the GitHub CLI?

Yes, it is specifically designed to integrate with 'gh pr create' and 'gh pr edit' workflows to automate the link correction process during PR lifecycle events.

Why do links in my PR description often return a 404 error?

GitHub resolves relative links in PR descriptions against the base branch (usually main). If your linked file only exists on your feature branch, the link will break until the PR is merged.

Will it modify my external URLs or anchor tags?

No, the validator uses a specific regex pattern to target only relative file paths, ensuring that external HTTPS links, anchors, and email links remain untouched.

What happens if I'm already on the main branch?

The skill identifies your current git context; if you are on a default branch like 'main' or 'master', it skips conversion as relative links resolve correctly in that context.

GitHub PR Link Validator

Name: GitHub PR Link Validator
Author: terrylica

byterrylica

•

生产力与工作流

Validates and auto-fixes broken repository links in GitHub Pull Request descriptions to ensure seamless documentation previews.

关于

The GitHub PR Link Validator is a specialized Claude Code skill that solves the common '404 error' problem in Pull Request descriptions. When developers use repository-relative links in a PR, GitHub default behavior resolves those links against the base branch (usually main), leading to broken links for files that only exist on the feature branch. This skill identifies these relative paths and automatically converts them into absolute blob URLs specific to the current feature branch, ensuring reviewers can access ADRs, documentation, and configuration files without encountering dead links.

主要功能

Smart conversion to branch-specific GitHub absolute blob URLs
Seamless integration with GitHub CLI commands like gh pr create and gh pr edit
Automatic detection of repo-root, current-directory, and parent-directory relative links
Intelligent filtering to preserve external URLs, anchors, and mailto links
2 GitHub stars
Context-aware logic that skips conversion when working on default branches

使用场景

Fixing broken links in existing PR descriptions reported by reviewers
Automating documentation-heavy DevOps workflows to ensure link integrity
Creating new Pull Requests that reference newly added documentation or ADRs

关于

主要功能

Smart conversion to branch-specific GitHub absolute blob URLs
Seamless integration with GitHub CLI commands like gh pr create and gh pr edit
Automatic detection of repo-root, current-directory, and parent-directory relative links
Intelligent filtering to preserve external URLs, anchors, and mailto links
2 GitHub stars
Context-aware logic that skips conversion when working on default branches

使用场景

Fixing broken links in existing PR descriptions reported by reviewers
Automating documentation-heavy DevOps workflows to ensure link integrity
Creating new Pull Requests that reference newly added documentation or ADRs