pr-gfm-validator

Convert repo-relative GitHub Flavored Markdown links in PR descriptions to branch-specific blob URLs.

62|10|Updated Dec 4, 2025
Search Tags:#validation#PR#GFM
One-click install
npx skills add https://github.com/terrylica/cc-skills --skill pr-gfm-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-gfm-validator
Source: https://github.com/terrylica/cc-skills/tree/main/plugins/gh-tools/skills/pr-gfm-validator
Command: npx skills add https://github.com/terrylica/cc-skills --skill pr-gfm-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates and auto-fixes GitHub Flavored Markdown links in PR descriptions to prevent 404s.

Core Features & Use Cases

  • Detects repo-root and relative links that break on PRs
  • Suggests conversions to branch-aware blob URLs
  • Ready-to-run preflight validation for PR bodies

Quick Start

Validate PR body with pr-gfm-validator on the current branch

Frequently Asked Questions about pr-gfm-validator

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

FAQPage Schema
How do I fix GitHub Flavored Markdown links that break in pull requests?

GitHub Flavored Markdown links break on feature branches because repo-relative paths like /path/to/file.md don't resolve correctly. This Skill converts those links to branch-specific blob URLs, preventing 404 errors when reviewers visit the PR page.

What types of links does the PR validator handle?

The validator detects repo-root links (/path/to/file.md), relative paths (./relative/path.md and ../parent/path.md), and converts them to branch-aware blob URLs. It skips absolute URLs, in-page anchors, and mailto links to preserve their original behavior.

When should I validate PR descriptions for broken markdown links?

Run validation during PR creation and editing workflows—before running gh pr create or gh pr edit—to catch repo-relative links on your current branch and fix them automatically before submission.

Can I validate markdown links without manual review?

Yes, the Skill provides ready-to-run preflight validation that scans PR bodies, identifies repo-relative links, and applies fixes automatically while preserving external links and other link types unchanged.

What information does the validator need to convert links correctly?

The Skill gathers repository context—owner, repo name, and current branch—to construct accurate blob URLs and replace matched repo-relative links with branch-specific paths that resolve correctly in PRs.