К основному содержанию
скилл CX Codex

pr-gfm-validator — скилл для Claude Code: чинит GFM-ссылки в PR

Скилл pr-gfm-validator переписывает относительные ссылки в описании пул-реквеста в абсолютные blob-URL с вашей ветки, чтобы ревьюеры не упирались в 404.

MIT 123 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill pr-gfm-validator -a claude-code
Открыть на GitHub

Что делает pr-gfm-validator

Скилл берёт тело pull request и заменяет относительные ссылки на абсолютные blob-URL с именем текущей ветки. Причина простая: GitHub разрешает такие пути от базовой ветки, поэтому [ADR](/docs/adr/file.md) из фича-ветки ведёт на main и отдаёт 404.

Контекст собирается через gh и git: gh repo view даёт owner/repo, git rev-parse --abbrev-ref HEAD — ветку. Дальше поиск по трём шаблонам: путь от корня репозитория, от текущей и от родительской папки. Внешние URL, якоря #... и mailto: остаются как были. На main и master конвертация пропускается: там относительные ссылки и так работают.

Перед созданием PR убедитесь, что файлы уже в удалённой ветке. Адрес соберётся правильный, но без пуша он всё равно отдаст 404. В имени ветки со слешами нужна URL-кодировка, иначе ссылка развалится.

Какие задачи решает

  • поймать битые ссылки в описании PR до того, как их увидит ревьюер
  • переписать /docs/... в полный blob-URL с фича-ветки
  • сохранить внешние ссылки и якоря при массовой замене путей
  • собрать тело PR через gh pr create без ручной правки каждой ссылки
  • пропустить конвертацию, когда правки идут прямо в main

Примеры запросов агенту

  • Создай PR из текущей ветки и проверь, что ни одна ссылка в описании не ведёт на 404.
  • Прогони GFM-валидацию по телу пул-реквеста: относительные пути замени на абсолютные.
  • Поправь ссылку [ADR](/docs/adr/file.md) в описании PR, чтобы она открывалась с моей ветки, а не с main.

Как установить pr-gfm-validator

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill pr-gfm-validator -a claude-code

2Вручную: положить файлы

~/.claude/skills/pr-gfm-validator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pr-gfm-validator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pr-gfm-validator

Как установить pr-gfm-validator в Claude Code?

Выполните npx skills add terrylica/cc-skills --skill pr-gfm-validator -a claude-code. Файл скилла окажется по пути ~/.claude/skills/pr-gfm-validator/SKILL.md.

Что делает pr-gfm-validator?

Ищет в описании pull request ссылки, начинающиеся с /, ./ или ../, и превращает их в абсолютные blob-URL с именем рабочей ветки. Остальные ссылки не трогает.

Почему ссылка на файл из фича-ветки отдаёт 404 в описании PR?

GitHub разрешает относительные пути от базовой ветки. Если файл есть только в вашей ветке, он ищется в main и не находится. Абсолютный blob-URL с нужной веткой решает это.

Исходный текст

SKILL.md · MIT
---
name: pr-gfm-validator
description: Validate and fix GFM links in PR descriptions. TRIGGERS - PR links, gh pr create, GFM validation, broken PR links.
allowed-tools: Bash, Read, Grep
---

# PR GFM Link Validator

Validate and auto-convert GFM links in pull request descriptions to prevent 404 errors.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

This skill triggers when:

- Creating a pull request from a feature branch
- Discussing PR descriptions or body content
- Mentioning GFM links, PR links, or link validation
- Using `gh pr create` or `gh pr edit`

## The Problem

Repository-relative links in PR descriptions resolve to the **base branch** (main), not the feature branch:

| Link in PR Body            | GitHub Resolves To            | Result                            |
| -------------------------- | ----------------------------- | --------------------------------- |
| `[ADR](/docs/adr/file.md)` | `/blob/main/docs/adr/file.md` | 404 (file only on feature branch) |

## The Solution

Convert repo-relative links to absolute blob URLs with the correct branch:

```
/docs/adr/file.md
    ↓
https://github.com/{owner}/{repo}/blob/{branch}/docs/adr/file.md
```

---

## Workflow

### Step 1: Detect Context

Before any PR operation, gather repository context:

```bash
/usr/bin/env bash << 'PREFLIGHT_EOF'
# Get repo owner and name
gh repo view --json nameWithOwner --jq '.nameWithOwner'

# Get current branch
git rev-parse --abbrev-ref HEAD

# Check if on feature branch (not main/master)
BRANCH=$(git rev-parse --abbrev-ref HEAD)
if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
  echo "On default branch - no conversion needed"
  exit 0
fi
PREFLIGHT_EOF
```

### Step 2: Identify Links to Convert

Scan PR body for GFM links matching these patterns:

**CONVERT these patterns:**

- `/path/to/file.md` - Repo-root relative
- `./relative/path.md` - Current-directory relative
- `../parent/path.md` - Parent-directory relative

**SKIP these patterns:**

- `https://...` - Already absolute URLs
- `http://...` - Already absolute URLs
- `#anchor` - In-page anchors
- `mailto:...` - Email links

### Step 3: Construct Blob URLs

For each link to convert:

```python
# Pattern
f"https://github.com/{owner}/{repo}/blob/{branch}/{path}"

# Example
owner = "example-org"
repo = "research-repo"
branch = "feat/2025-12-01-eth-block-metrics"
path = "docs/adr/2025-12-01-file.md"

# Result
"https://github.com/example-org/research-repo/blob/feat/2025-12-01-eth-block-metrics/docs/adr/2025-12-01-file.md"
```

### Step 4: Apply Conversions

Replace all identified links in the PR body:

```markdown
# Before

[Plugin Design](/docs/adr/2025-12-01-slug.md)

# After

[Plugin Design](https://github.com/example-org/research-repo/blob/feat/branch/docs/adr/2025-12-01-slug.md)
```

### Step 5: Validate Result

After conversion, verify:

1. All repo-relative links are now absolute blob URLs
2. External links remain unchanged
3. Anchor links remain unchanged

---

## Integration with gh pr create

When creating a PR, apply this workflow automatically:

```bash
/usr/bin/env bash << 'GIT_EOF'
# 1. Get context
REPO_INFO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
OWNER=$(echo "$REPO_INFO" | cut -d'/' -f1)
REPO=$(echo "$REPO_INFO" | cut -d'/' -f2)
BRANCH=$(git rev-parse --abbrev-ref HEAD)

# 2. Process PR body (convert links)
# ... link conversion logic ...

# 3. Create PR with converted body
gh pr create --title "..." --body "$CONVERTED_BODY"
GIT_EOF
```

---

## Link Detection Regex

Use this regex pattern to find GFM links:

```regex
\[([^\]]+)\]\((/[^)]+|\.\.?/[^)]+)\)
```

Breakdown:

- `\[([^\]]+)\]` - Capture link text
- `\(` - Opening parenthesis
- `(/[^)]+|\.\.?/[^)]+)` - Capture path starting with `/`, `./`, or `../`
- `\)` - Closing parenthesis

---

## Examples

### Example 1: Simple Repo-Relative Link

**Input:**

```markdown
See the [ADR](/docs/adr/2025-12-01-eth-block-metrics.md) for details.
```

**Context:**

- Owner: `example-org`
- Repo: `research-repo`
- Branch: `feat/2025-12-01-eth-block-metrics-data-plugin`

**Output:**

```markdown
See the [ADR](https://github.com/example-org/research-repo/blob/feat/2025-12-01-eth-block-metrics-data-plugin/docs/adr/2025-12-01-eth-block-metrics.md) for details.
```

### Example 2: Multiple Links

**Input:**

```markdown
## References

- [Plugin Design](/docs/adr/2025-12-01-slug.md)
- [Probe Integration](/docs/adr/2025-12-02-slug.md)
- [External Guide](https://example.com/guide)
```

**Output:**

```markdown
## References

- [Plugin Design](https://github.com/example-org/research-repo/blob/feat/branch/docs/adr/2025-12-01-slug.md)
- [Probe Integration](https://github.com/example-org/research-repo/blob/feat/branch/docs/adr/2025-12-02-slug.md)
- [External Guide](https://example.com/guide)
```

Note: External link unchanged.

### Example 3: Credential File Link

**Input:**

```markdown
**See [`.env.clickhouse`](/.env.clickhouse)** for credentials.
```

**Output:**

```markdown
**See [`.env.clickhouse`](https://github.com/example-org/research-repo/blob/feat/branch/.env.clickhouse)** for credentials.
```

---

## Edge Cases

### Already on main/master

- Skip conversion entirely
- Repo-relative links will work correctly

### Empty PR Body

- Nothing to convert
- Proceed with PR creation

### No GFM Links Found

- Nothing to convert
- Proceed with PR creation

### Mixed Link Types

- Convert only repo-relative links
- Preserve external URLs, anchors, mailto links

---

## Post-Change Checklist

After modifying this skill:

1. [ ] Regex patterns still match intended link formats
2. [ ] Examples reflect current behavior
3. [ ] Edge cases documented
4. [ ] Workflow steps are executable

---

## References

- [GitHub Blob URLs](https://docs.github.com/en/repositories/working-with-files/using-files/getting-permanent-links-to-files)
- [GFM Link Syntax](https://github.github.com/gfm/#links)
- [gh CLI Documentation](https://cli.github.com/manual/gh_pr_create)

---

## Troubleshooting

| Issue                    | Cause                          | Solution                                          |
| ------------------------ | ------------------------------ | ------------------------------------------------- |
| Links still 404 after PR | File not pushed to branch yet  | Push commits before creating PR                   |
| Regex not matching links | Escaped parentheses in content | Use raw string regex pattern                      |
| Branch name has slashes  | URL encoding needed            | Encode branch name for URL construction           |
| External links converted | Pattern too broad              | Check link starts with `/`, `./`, or `../` only   |
| gh repo view fails       | Not in a git repository        | Run from repository root directory                |
| Anchor links broken      | Incorrectly included in scan   | Skip links starting with `#`                      |
| Wrong repo detected      | Remote not set correctly       | Check `git remote -v` output                      |
| Conversion duplicated    | Running validator twice        | Check if links already absolute before converting |

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
describe-pr parcadei Скилл describe-pr готовит описание PR по локальному шаблону, изучая изменения и проверки. Нужен перед обновлением текста pull request через GitHub CLI. CX Codex +1 504установок gh-stack официальный github Управляет цепочками связанных пулл-реквестов через расширение gh stack. Помогает агенту делить крупные задачи на слои и не зависать в интерактивном TUI. CX Codex +1 21 500установок gh-issues openclaw Скилл gh-issues находит GitHub issues, запускает фоновых агентов для исправлений и открывает PR. Подходит для потока от issue до готового pull request. CX Codex +1 5 000установок pr-writer getsentry Скилл pr-writer для Claude Code пишет и обновляет заголовки и описания pull request для ревью. Он включается при создании PR, правке его текста или подготовке изменений ветки. CX Codex +1 4 700установок yeet официальный openai Скилл yeet проводит весь путь от git add до черновика пул-реквеста через gh. Вызывается только тогда, когда вы прямо об этом попросите. CX Codex +1 3 700установок pr-babysitter mblode Скилл pr-babysitter отслеживает открытый пуллреквест на GitHub: устраняет конфликты слияния, чинит упавший CI и разбирает замечания ревьюеров. CX Codex +1 604установок

Из того же набора79

Весь набор →
booking-notify Скилл booking-notify отправляет уведомления о новых бронированиях, отменах и переносах через Telegram и Pushover. Синхронизация каждые 6 часов, вебхук для срочных событий. CX Codex +1 125установок implement-plan-preflight Скилл implement-plan-preflight запускает подготовительный этап ITP: создаёт ADR в формате MADR 4.0, спецификацию архитектуры и связывает их перекрёстными ссылками. CX Codex +1 125установок issues-workflow Скилл issues-workflow держит план, иерархию и статус в GitHub Issues: подзадачи под родителем, связка issue с веткой и PR, автозакрытие после мержа. CX Codex +1 124установок ml-failfast-validation Скилл ml-failfast-validation для Claude Code запускает быстрые проверки ML-экспериментов перед долгим обучением на GPU и выявляет ошибки данных и градиентов. CX Codex +1 124установок pypi-doppler Скилл pypi-doppler для Claude Code и пяти других платформ: публикует Python-пакет в PyPI с токеном из Doppler — только с локальной машины. CI/CD намеренно заблокирован: скрипт проверяет окружение и останавливается при обнаружении пайплайна. CX Codex +1 123установок schema-e2e-validation Скилл schema-e2e-validation запускает генерацию и E2E-проверку YAML-схемы через Earthly. Пригодится перед коммитом или для сверки схемы с ClickHouse Cloud. CX Codex +1 123установок plugin-validator Скилл plugin-validator проверяет структуру плагинов перед релизом и находит скрытые ошибки в хуках — команды без обработки исключений, которые молча падают. Нужен перед публикацией в маркетплейс. CX Codex +1 122установок evolutionary-metric-ranking Скилл evolutionary-metric-ranking находит лучшие конфигурации моделей и стратегий через процентильные пороги, пересечение метрик и эволюционный поиск. CX Codex +1 121установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой