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.