Why are absolute paths a problem for Claude Code skills?

Absolute repository paths like '/skills/my-skill' only exist on the developer's machine. They break when another user installs the skill in a different directory, making documentation inaccessible.

How do I execute the validation process?

Validation is triggered by running 'uv run scripts/validate_links.py' followed by the path to your specific skill or the entire plugin directory.

Can I use this for plugins with multiple skills?

Absolutely. The tool can scan a plugin root directory and group violations by skill, allowing you to fix documentation issues across your entire project at once.

Does this skill support external URLs and anchor links?

Yes, the validator is designed to ignore external URLs (http/https) and local anchors (#), focusing strictly on file system paths that affect portability.

Link Portability Validator

Name: Link Portability Validator
Author: terrylica

byterrylica

•

内容管理

Ensures markdown links within Claude Code skills and plugins remain functional across different installation environments by enforcing relative path patterns.

Link Portability Validator is a specialized utility designed to prevent broken documentation links when Claude Code skills are shared or distributed. By auditing markdown files for absolute repository paths—which fail when a skill is installed in a new local environment—this skill helps developers maintain cross-installation compatibility. It identifies specific violations, provides line-by-line reports, and suggests relative path fixes to ensure that internal references and guides work seamlessly for every end user regardless of their file structure.

主要功能

01Detects absolute repository paths that break upon skill distribution

02Provides actionable violation reports with suggested relative path fixes

038 GitHub stars

04Supports automated validation for both single skills and multi-skill plugins

05Enforces relative pathing for local and parent directory references

06Excludes external URLs and anchor links to minimize false positives

使用场景

01Verifying skill documentation portability before publishing to a marketplace

02Auditing and batch-fixing legacy absolute paths in existing plugins

03Automating link integrity checks within a CI/CD pipeline for DevOps workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills link-validator

For use in Claude.ai and ChatGPT

Download Skill