cs-link-sync

Detect and repair broken Markdown links in CS documentation repositories.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/younwony/TIL --skill cs-link-sync
Or copy as Structured Prompt for Agent
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.