cs-link-sync

Detect and repair broken Markdown links in CS documentation repositories.

Updated Dec 5, 2025
Ready to run
npx skills add https://github.com/younwony/TIL --skill cs-link-sync
πŸ’¬ Prompt for ChatGPT / Claude Chatβ–Ό
Please help me install this Agent Skill.
Skill: cs-link-sync
Source: https://github.com/younwony/TIL/tree/main/.claude/skills/cs-link-sync
Command: npx skills add https://github.com/younwony/TIL --skill cs-link-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CS λ¬Έμ„œμ˜ 폴더 ꡬ쑰 λ³€κ²½μ΄λ‚˜ 파일λͺ… μˆ˜μ •μœΌλ‘œ 인해 λ°œμƒν•˜λŠ” κΉ¨μ§„ λ§ˆν¬λ‹€μš΄ 링크λ₯Ό μ°Ύμ•„ μˆ˜μ •ν•©λ‹ˆλ‹€. 이 μŠ€ν‚¬μ€ λ¬Έμ„œμ˜ 연결성을 μœ μ§€ν•˜κ³  μˆ˜λ™ μˆ˜μ • μ‹œκ°„μ„ λŒ€ν­ μ€„μ—¬μ€λ‹ˆλ‹€.

Core Features & Use Cases

  • 링크 검증 및 μˆ˜μ • μžλ™ν™”: λ¬Έμ„œμ˜ μƒλŒ€ 경둜 및 README 링크λ₯Ό μžλ™μœΌλ‘œ ν™•μΈν•˜κ³ , ν•„μš”μ‹œ μˆ˜μ • μ œμ•ˆμ„ μ μš©ν•©λ‹ˆλ‹€.
  • 링크 동기화: "링크 동기화" μš”μ²­μ— 따라 λ¬Έμ„œ κ°„ 링크 경둜λ₯Ό μΌκ΄€λ˜κ²Œ 맞μΆ₯λ‹ˆλ‹€.
  • Use Case: μΉ΄ν…Œκ³ λ¦¬/폴더 ꡬ쑰λ₯Ό λ³€κ²½ν•œ CS ν”„λ‘œμ νŠΈμ—μ„œ μˆ˜μ‹­ 개의 λ§ˆν¬λ‹€μš΄ 파일의 κΉ¨μ§„ 링크λ₯Ό ν•œ λ²ˆμ— μ°Ύμ•„ μˆ˜μ •ν•©λ‹ˆλ‹€.

Quick Start

CS λ¬Έμ„œμ˜ μƒλŒ€ 경둜 링크λ₯Ό μŠ€μΊ”ν•˜κ³  μžλ™μœΌλ‘œ μˆ˜μ •ν•©λ‹ˆλ‹€. μ˜ˆμ‹œ: cs-link-sync 첨뢀 λ¬Έμ„œλ“€μ˜ κΉ¨μ§„ 링크λ₯Ό κ²€μ‚¬ν•˜κ³  μˆ˜μ •ν•©λ‹ˆλ‹€.

Frequently Asked Questions about cs-link-sync

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

FAQPage Schema
How do I fix broken Markdown links when renaming files or folders in documentation?β–Ό

Broken Markdown links occur when file paths change due to renames or folder restructuring. This Skill scans your documentation repository, detects broken relative and cross-directory links, classifies failures by file changes or deletions, and proposes or applies fixes automatically, eliminating manual link repairs across dozens of files.

Can I automatically validate and repair relative links in Markdown README files?β–Ό

Yes. This Skill validates relative path links in Markdown files including README sections, checks path existence, detects typos through similarity analysis, and generates batch repair suggestions. It then applies fixes and produces a diagnostic report showing all changes.

What happens when I move or delete files in a documentation repository?β–Ό

File moves and deletions break existing Markdown links pointing to those paths. This Skill identifies which links fail due to relocations versus deletions versus typos, then suggests corrected paths based on current file structure, or applies fixes directly to keep documentation interconnected.

How do I sync links across multiple Markdown files when documentation structure changes?β–Ό

Link synchronization enforces consistent relative paths across your documentation after structural changes. This Skill scans all Markdown files, detects path mismatches, and updates links uniformly so cross-file references remain valid, reducing manual coordination work.

Can this work with large CS documentation projects with many nested directories?β–Ό

Yes. This Skill handles batch updates across entire documentation repositories with complex folder hierarchies. It processes multiple Markdown files simultaneously, applies path resolution for nested directories, and generates a change log showing all repairs, making it suitable for large-scale documentation maintenance.

What does the diagnostic report include after link repairs?β–Ό

The diagnostic report documents all detected broken links, their failure classifications (file renamed, relocated, deleted, or typo), proposed fixes, applied changes, and a summary changelog. This output enables you to verify repairs and audit documentation consistency.