# Common Skills

이 폴더는 팀 공통으로 사용할 Claude **skill** 들을 모아두는 공간입니다.
각 프로젝트는 submodule 로 이 저장소를 가져온 뒤, `.claude/common/skills/*` 를
`.claude/skills/*` 로 **심볼릭 링크**하여 사용합니다.

## Skill 구조

각 skill 은 하나의 폴더이며, 루트에 `SKILL.md` 를 가집니다.

```
skills/
└── <skill-name>/
    ├── SKILL.md         # YAML frontmatter (name, description) + 지시문
    └── (선택) 추가 자료 — 예시 파일, 템플릿, 스크립트 등
```

`SKILL.md` 예시:

```markdown
---
name: <skill-name>
description: <Claude 가 이 skill 을 언제 써야 하는지 한 줄로>
---

# <스킬 제목>

## 언제 사용하는가
...

## 작업 순서
...
```

## 프로젝트에 연결하기

```bash
# 공통 저장소의 skill 을 .claude/skills/ 로 전부 링크
bash .claude/common/scripts/link-skills.sh

# 차이 확인
bash .claude/common/scripts/link-skills.sh --dry-run

# 특정 skill 만 링크
bash .claude/common/scripts/link-skills.sh vue-component-review
```

## 새 skill 추가 프로세스

1. 이 저장소에서 `skills/<skill-name>/SKILL.md` 를 작성
2. PR 을 올리고 팀 리뷰
3. 머지 후 각 프로젝트에서 `git submodule update --remote` → `link-skills.sh` 실행