القائمة
Validates markdown internal links, anchor links, and TOC completeness. Use after creating or modifying any .md file to verify link integrity and heading numbering.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Defines the mandatory footer template for all .md files — GitHub badges, dates, and license. Use when creating or modifying any markdown document.
Defines operating rules for all agents. Use when executing any task — confirms before action, requires rollback plans for dangerous operations, enforces naming conventions and credential placeholders.
Bash 스크립트 작성 시 표준 로깅 함수와 에러 처리 패턴을 적용합니다. 새 스크립트 생성 또는 기존 스크립트 개선 시 사용합니다. 이 skill을 참조할 때 응답 첫 줄에 "🟡 참조: skill://bash-script-template" 를 출력합니다.
Guides test writing with AAA pattern, BVA, EP, and edge case analysis. Use when writing unit tests, integration tests, or infrastructure validation tests.
Provides a structured code review checklist. Use when reviewing code, scripts, or IaC files. Covers correctness, security, error handling, performance, and infrastructure as code.
Guides systematic infrastructure troubleshooting. Use when services fail, builds break, deployments go wrong, or infrastructure behaves unexpectedly. Use when you need root-cause analysis rather than guessing.
| name | md-link-check |
| description | Validates markdown internal links, anchor links, and TOC completeness. Use after creating or modifying any .md file to verify link integrity and heading numbering. |
.md 파일 작성/수정 후 다음 세 가지를 반드시 검증합니다.
[텍스트](경로.md)) — 파일 존재 여부#섹션명) — 실제 H2 섹션과 일치 여부헤딩 텍스트 → 앵커 변환 시 적용되는 규칙:
- 변환 (연속 공백도 각각 -로, 축약 없음)특수문자 제거로 인한 이중 하이픈 발생 예시:
| 헤딩 | 앵커 | 이유 |
|---|---|---|
컨텍스트 / 도구 상세 | #컨텍스트--도구-상세 | / 제거 → 양쪽 공백이 각각 - |
토큰 절약 & 성능 최적화 | #토큰-절약--성능-최적화 | & 제거 → 이중 하이픈 |
`@` 참조 기능 | #--참조-기능 | 백틱·@ 제거 → 앞 공백 - |
Plan — 에이전트 | #plan--에이전트 | — 제거 → 이중 하이픈 |
CI/CD 비대화형 | #cicd-비대화형 | / 제거, 양쪽 공백 없으면 단순 제거 |
import re
def github_anchor(heading):
s = re.sub(r'^#+\s*', '', heading.strip())
s = s.lower()
s = re.sub(r'[^\w\s\-\uAC00-\uD7A3]', '', s)
s = re.sub(r' ', '-', s)
return s
``` 안의 ## 헤딩은 실제 섹션이 아닙니다.
목차 링크 대상은 코드블록 밖의 H2만 해당합니다.
목차, 참고 자료, 통계, 참고 URLgithub_anchor() 함수 사용)# 특정 파일의 내부 링크 검사
BASE=/path/to/repo
grep -oP '\[.*?\]\(\K[^)#]+\.md' FILE.md | while read link; do
[ -f "$BASE/$link" ] && echo "OK $link" || echo "❌ $link"
done
../ 사용목차가 있는 문서의 H2 섹션은 번호를 부여합니다.
# ❌ 번호 없음
## 개요
## 설치
## 사용법
# ✅ 번호 있음
## 1. 개요
## 2. 설치
## 3. 사용법
아래 섹션은 번호를 붙이지 않습니다.
| 섹션 | 이유 |
|---|---|
목차, 참고 자료, 통계 | 고정 푸터 섹션 |
문서 목록, 문서 트리 | README 인덱스 구조 |
| OS별/레이어별/연차별 분류 섹션 | 번호보다 분류 체계가 우선 |
단계 번호가 이미 있는 섹션 (1단계:, Phase 1 등) | 중복 번호 방지 |
아래 유형의 문서는 H2 전체에 번호를 붙이지 않습니다.
| 유형 | 예시 |
|---|---|
| OS/버전별 분류 문서 | root_password_recovery.md — CentOS 7, Rocky Linux 9 등 |
| 레이어/프로토콜별 분류 | ddos_attacks_*.md — Layer 3, Layer 4, Layer 7 |
| 섹션명에 번호 포함 | 1단계:, 2단계:, Phase 1 등이 이미 섹션명에 있는 경우 |
| 비교/분석 문서 | *_comparison.md, ansible_vs_jenkins.md |
| README 인덱스 | 문서 목록 나열이 주목적인 파일 |
| 영문 기능 목록 | vim_airline.md 등 원문 유지 필요 |
H2 번호는 1.부터 시작하여 빠짐없이 연속되어야 합니다.
번호 제외 대상 섹션은 카운트에서 제외합니다.
**...(영문)**한글 패턴은 일부 마크다운 파서에서 닫힘 **를 인식하지 못해 bold가 깨집니다.
# ❌ 깨짐
**가상 테이블(Virtual Table)**이다.
**GC(Garbage Collection)**로 인한
# ✅ 정상 — ** 뒤 공백 1칸 추가
**가상 테이블(Virtual Table)** 이다.
**GC(Garbage Collection)** 로 인한
규칙: ** 닫힘 태그 바로 뒤에 한글이 오면 반드시 공백 1칸 삽입.
문서를 새로 작성하거나 H2 섹션을 추가/수정/삭제한 경우 반드시 확인합니다.
github_anchor() 규칙으로 계산했는가## 헤딩을 목차에 포함하지 않았는가1.부터 순차 번호가 붙어 있는가 (번호 제외 대상 섹션 제외)/, &, —, @, 백틱 등) 포함 헤딩의 앵커에 이중 하이픈(--)을 적용했는가**...(영문)**한글 패턴이 없는가 — 있으면 ** 뒤 공백 추가