querypie · jk-kim0 · Jun 17, 2026 · Jun 17, 2026
@@ -1,3 +1,8 @@
+---
+name: code-review
+description: "querypie-docs 변경 사항을 검토하고 위험, 누락된 검증, 개선점을 찾을 때 사용합니다."
+---
+
 # 코드 리뷰 가이드라인
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: commit
+description: "querypie-docs 커밋 메시지와 PR 제목 및 본문을 저장소 규칙에 맞게 작성할 때 사용합니다."
+---
+
 # Commit Log 작성 Skill
 
 querypie-docs 저장소의 commit 관습에 맞게 commit message를 작성합니다.

@@ -1,3 +1,8 @@
+---
+name: confluence-mdx-testcase
+description: "Confluence XHTML 변환 로직의 재현 테스트케이스를 추가하거나 갱신할 때 사용합니다."
+---
+
 # Confluence XHTML 변환 테스트케이스 추가 가이드
 
 ## 개요
@@ -96,4 +101,4 @@ testcases/<page-id>/
 1. **설명적인 이름 사용**: 합성 테스트케이스는 테스트 목적을 설명하는 이름 사용
 2. **최소한의 XHTML**: 테스트하려는 기능만 포함하는 간결한 XHTML 작성
 3. **출력 검토**: `expected.mdx`로 저장하기 전에 `output.mdx`를 반드시 검토
-4. **회귀 테스트**: 버그 수정 시 해당 케이스를 테스트케이스로 추가
+4. **회귀 테스트**: 버그 수정 시 해당 케이스를 테스트케이스로 추가
@@ -1,3 +1,8 @@
+---
+name: confluence-mdx
+description: "Confluence 문서를 QueryPie MDX 콘텐츠로 변환하거나 변환 결과를 검증할 때 사용합니다."
+---
+
 # Confluence에서 MDX로 변환 가이드라인
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: confluence-pr-update
+description: "Confluence 자동 동기화 PR을 점검하고 누락 이미지, 번역, skeleton 검증을 처리할 때 사용합니다."
+---
+
 # Confluence MDX PR 수정 가이드라인
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: mdx-skeleton-comparison
+description: "한국어, 영어, 일본어 MDX 문서의 구조 일관성을 skeleton 비교로 검증할 때 사용합니다."
+---
+
 # MDX 스켈레톤 비교 가이드라인
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: openspec-authoring
+description: "QueryPie 문서 저장소의 OpenSpec spec, proposal, design, tasks를 새로 작성하거나 크게 갱신할 때 사용합니다."
+---
+
 # OpenSpec Authoring
 
 QueryPie 문서 저장소에서 OpenSpec spec, proposal, design, tasks를 새로 작성하거나 크게 갱신할 때 사용합니다.

@@ -1,3 +1,8 @@
+---
+name: openspec-doc-maintenance
+description: "구현, 리뷰, 계획, 디버깅 중 OpenSpec drift, 모순, 누락된 contract를 유지보수할 때 사용합니다."
+---
+
 # OpenSpec 문서 유지보수
 
 QueryPie 문서 저장소에서 구현, 리뷰, 계획, 디버깅 중 OpenSpec 문서와 실제 계약 사이의 차이를 발견했을 때 사용합니다.

@@ -1,3 +1,8 @@
+---
+name: openspec-task-execution
+description: "OpenSpec tasks.md의 남은 구현, 검증 보강, PR-sized 후속 작업을 수행할 때 사용합니다."
+---
+
 # OpenSpec Task Execution
 
 QueryPie 문서 저장소에서 OpenSpec changes/specs에 남은 `tasks.md` 항목, 후속 구현, verification 보강, PR-sized 작업 수행을 요청받았을 때 사용합니다.

@@ -1,3 +1,8 @@
+---
+name: proofread
+description: "QueryPie 문서 콘텐츠를 교정하고 API 명칭, 표현, Markdown 형식을 점검할 때 사용합니다."
+---
+
 # 문서 교정/교열 Skill
 
 Markdown으로 작성된 컨텐츠 문서를 교정, 교열합니다.

@@ -1,3 +1,8 @@
+---
+name: reverse-sync-debugging
+description: "reverse-sync verify 실패 원인을 분석하고 MDX-to-XHTML 역반영 문제를 디버깅할 때 사용합니다."
+---
+
 # Reverse Sync 디버깅 가이드
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: reverse-sync
+description: "MDX 변경을 Confluence XHTML로 역반영하는 reverse-sync 작업을 수행하거나 검증할 때 사용합니다."
+---
+
 # Reverse Sync 사용 가이드
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: sync-confluence-url
+description: "한국어 MDX의 confluenceUrl frontmatter를 영어와 일본어 문서에 동기화할 때 사용합니다."
+---
+
 # sync_confluence_url 사용 가이드
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: sync-ko-to-en-ja
+description: "한국어 MDX 변경사항을 대응하는 영어와 일본어 문서에 번역 및 동기화할 때 사용합니다."
+---
+
 # 한국어 MDX 변경사항을 영어/일본어에 동기화
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: translation
+description: "한국어 QueryPie 문서를 영어 또는 일본어로 번역하고 다국어 콘텐츠 규칙을 적용할 때 사용합니다."
+---
+
 # 번역 가이드라인
 
 ## 개요

@@ -1,3 +1,8 @@
+---
+name: xhtml-beautify-diff
+description: "Confluence XHTML 파일의 의미적 차이를 beautify diff로 비교하고 reverse-sync 결과를 분석할 때 사용합니다."
+---
+
 # XHTML Beautify-Diff Viewer 사용 가이드
 
 ## 개요