스킬 만들기와 수정

skills/
├── sync/
│   └── SKILL.md              # 동기화 스킬
├── security-scan/
│   └── SKILL.md              # 보안 검사 스킬
├── meeting-facilitation/
│   └── SKILL.md              # 회의 진행 스킬
├── research/
│   └── SKILL.md              # 리서치 스킬
└── my-reviewer/              # ★ 우리가 만들 스킬
    └── SKILL.md

---
name: my-reviewer
status: active
description: Reviews document quality and provides structured feedback. Checks readability, consistency, and completeness of markdown documents.
owner: pm
version: "1.0.0"
metadata:
  type: quality
  triggers:
    - "review document"
    - "check quality"
    - "quality review"
---

## Overview

이 스킬은 마크다운 문서의 품질을 종합적으로 검토합니다.
가독성, 일관성, 완성도 세 가지 관점에서 문서를 평가하고,
구조화된 피드백을 제공합니다.

## When to Use

사용자가 다음과 같은 요청을 할 때 활성화됩니다:
- "문서를 검토해 줘"
- "문서 품질을 확인해 줘"
- "품질 리뷰를 해 줘"

또한 다른 에이전트가 문서 완성 후 품질 검토가 필요할 때
PM이 자동으로 디스패치할 수 있습니다.

## Steps

1. **대상 파일 확인** — 검토할 문서 파일의 경로를 확인합니다.
2. **문서 읽기** — 대상 파일을 읽고 내용을 분석합니다.
3. **가독성 검토** — 문장 길이, 단락 구성, 제목 계층을 검토합니다.
4. **일관성 검토** — 용어 사용, 서식 스타일, 날짜 형식을 검토합니다.
5. **완성도 검토** — 누락된 섹션, 불완전한 문장을 확인합니다.
6. **피드백 작성** — 검토 결과를 구조화된 형식으로 정리합니다.

## Expected Outputs

- 검토 보고서 (stdout 또는 파일 출력)
- 문제 목록 (항목별 심각도: 경고/수정 권장/오류)
- 개선 제안 목록

## Examples

**예시 1:** 사용자가 "이 문서를 검토해 줘"라고 요청
→ 대상 문서를 읽고, 5가지 항목을 점검한 뒤,
  구조화된 피드백을 제공합니다.

**예시 2:** PM이 핸드북 작성 완료 후 자동 디스패치
→ 완성된 HTML 파일의 마크다운 소스를 검토하고,
  저자 가이드라인 준수 여부를 보고합니다.

| my-reviewer | `skills/my-reviewer/SKILL.md` | quality | Checks readability, consistency, completeness | active | 1.0.0 |

- **name:** my-reviewer
  **path:** skills/my-reviewer/SKILL.md
  **version:** 1.0.0
  **status:** active
  **owner:** pm
  **type:** quality

# 스킬 동기화 스크립트 실행
bun scripts/sync-skills.ts

---
name: my-reviewer
status: active
description: >
  Reviews document quality and provides structured feedback.
  Checks readability, consistency, and completeness of
  markdown documents. Outputs a structured review report
  with severity levels and improvement suggestions.
owner: pm
version: "1.0.0"
metadata:
  type: quality
  triggers:
    - "review document"
    - "check quality"
    - "quality review"
    - "문서 검토"
    - "품질 확인"
---

## Overview

This skill performs a comprehensive quality review of
markdown documents. It evaluates documents from three
perspectives: readability, consistency, and completeness,
then provides structured feedback with actionable suggestions.

Scope: markdown (.md) files in the project workspace.

## When to Use

Activate this skill when:
- The user requests a document review
- A document has been newly created or significantly revised
- PM dispatches quality review as part of a pipeline gate
- The user asks to "check quality" or "review document"

## Steps

1. **Identify target file** — Confirm the file path of the
   document to review. If not specified, ask the user.
2. **Read the document** — Load the full content of the
   target file.
3. **Readability check** — Evaluate sentence length,
   paragraph structure, heading hierarchy, and overall
   flow. Flag sections that are hard to follow.
4. **Consistency check** — Verify terminology usage, format
   style, date format, heading capitalization, and list
   formatting across the entire document.
5. **Completeness check** — Identify missing sections,
   incomplete sentences, broken references, and unresolved
   TODO markers.
6. **Generate review report** — Compile findings into a
   structured report with severity levels:
   - INFO: minor suggestions
   - WARNING: recommended improvements
   - ERROR: issues that must be fixed

## Expected Outputs

- Structured review report (stdout)
- Issue count by severity (INFO / WARNING / ERROR)
- Prioritized improvement suggestions

## Examples

**Example 1:** User says "review document"
→ Read the specified file, run all 3 checks,
  output a structured review report.

**Example 2:** PM dispatches after handbook chapter
  completion
→ Review the chapter HTML source, check authoring
  guideline compliance, report findings.