skills.rest
terrylica
terrylicaCOMMUNITY
Explore all skills by this author →
GitHub

link-validation

Scan markdown files with lychee to detect broken links and path policy violations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lychee, and includes references (resource) components.

What problem does it solve?

Validates and lint markdown links using lychee, focusing on PR descriptions and cross-repo portability.

Core Features & Use Cases

  • End-of-session validation for PR descriptions
  • Detects absolute paths and risky link patterns
  • Outputs JSON or markdown reports for CI/pipeline usage

Quick Start

Validate PR body with lychee-based checks: uv run scripts/validate_links.py .

Frequently Asked Questions about link-validation

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

FAQPage Schema
How do I validate broken links in markdown files during PR reviews?▼

Link validation scans markdown files for broken URLs and policy violations using lychee. Run the Skill at session end to detect broken links, enforce path rules (no absolute paths, no parent escapes, marketplace-relative only), and output JSON results for CI pipeline integration.

What path rules does lychee-based link validation enforce?▼

The Skill enforces three path policies: NO_ABSOLUTE_PATHS prevents hardcoded full URLs, NO_PARENT_ESCAPES blocks directory traversal attempts, and MARKETPLACE_RELATIVE ensures links stay within repo scope. Violations appear in the markdown report alongside broken links.

Can I use link validation for cross-repository portability in PRs?▼

Yes. The Skill focuses on PR descriptions and cross-repo portability by linting markdown links against marketplace-relative path rules. It outputs JSON and markdown reports suitable for CI/pipeline usage, catching absolute paths and risky patterns that break portability.

What are the environment requirements to run link validation?▼

Link validation requires lychee installed, Python 3.11 or higher, and the uv package manager. Run validation with `uv run scripts/validate_links.py .` to scan workspace markdown files and generate results in .link-check-results.md.

How does link validation output results for CI integration?▼

The Skill outputs both JSON and markdown formats to .link-check-results.md, making results machine-readable for CI systems and human-readable for PR reviews. JSON structure contains broken link details and path policy violation locations.

Related Skills

Explore More Software Engineering Skills→
SpineEventEngineSpineEventEngine
2

check-links

Validate Hugo documentation links by rendering the site and scanning HTML with Lychee.

Official
Advanced
BennettPhilBennettPhil

md-link-checker

Validate local file references and remote URLs in Markdown files.

Community
Intermediate
johan-Rmjohan-Rm

create-pr

Automate commit linting, quality gates, and Pull Request creation via GitHub CLI.

Community
Advanced
nq-rdlnq-rdl

lychee

Identify and report broken links in Markdown, HTML, YAML, and text files.

Official
Intermediate