multiplatform-skill-template skill

---
name: multiplatform-skill-template
description: 이 스킬의 목적과 언제 사용하는지 간단히 설명합니다. 주요 기술과 시나리오를 포함하세요.
tags: [tag1, tag2, tag3]
platforms: [Claude, ChatGPT, Gemini]
---

# 스킬 이름


## When to use this skill

이 스킬을 트리거해야 하는 구체적인 상황을 나열합니다:

- **시나리오 1**: 사용자가 [특정 요청]을 할 때
- **시나리오 2**: [특정 상황]에서 작업이 필요할 때
- **시나리오 3**: [특정 유형]의 결과물을 요구할 때
- **시나리오 4**: [특정 문제]를 해결해야 할 때

## 입력 형식 (Input Format)

사용자로부터 받아야 할 입력의 형식과 필수/선택 정보:

### 필수 정보
- **항목 1**: 설명
- **항목 2**: 설명
- **항목 3**: 설명

### 선택 정보
- **항목 4**: 설명 (기본값: ...)
- **항목 5**: 설명 (선택)

### 입력 예시

```
[사용자 입력 예시]
```

## Instructions

단계별로 정확하게 따라야 할 작업 순서를 명시합니다.

### Step 1: [작업 이름]

무엇을 해야 하는지 구체적으로 설명합니다.

**작업 내용**:
- 세부 작업 1
- 세부 작업 2
- 세부 작업 3

**예시**:
```language
# 코드 예시 (필요한 경우)
def step_1_example():
    """1단계 작업의 예시"""
    pass
```

### Step 2: [작업 이름]

다음 단계로 진행합니다.

**작업 내용**:
- 세부 작업 1
- 세부 작업 2

**판단 기준**:
- 조건 A이면 → 동작 X
- 조건 B이면 → 동작 Y

### Step 3: [작업 이름]

마지막 단계를 완료합니다.

**확인 사항**:
- [ ] 체크포인트 1
- [ ] 체크포인트 2
- [ ] 체크포인트 3

## Output format

결과물이 따라야 할 정확한 형식을 정의합니다.

### 기본 구조

```
[결과물의 구조를 여기에 명시]

제목: [제목 형식]

개요:
- [개요 항목 1]
- [개요 항목 2]

본문:
[본문 구조]

결론:
[결론 형식]
```

### 포맷 규칙

1. **제목**: 명확하고 간결하게 (최대 10단어)
2. **개요**: 3-5개 항목의 bullet point
3. **본문**: 섹션별로 구분, 각 섹션은 2-3개 단락
4. **결론**: 핵심 요약 및 다음 단계 제시

### 출력 예시

```
[구체적인 출력 예시를 여기에 포함]
```

## Constraints

반드시 지켜야 할 규칙과 금지 사항을 명시합니다.

### 필수 규칙 (MUST)

1. **규칙 1**: [반드시 해야 하는 것]
   - 구체적인 내용
   - 예시 또는 이유

2. **규칙 2**: [반드시 해야 하는 것]
   - 구체적인 내용
   - 예시 또는 이유

3. **규칙 3**: [반드시 해야 하는 것]
   - 구체적인 내용
   - 예시 또는 이유

### 금지 사항 (MUST NOT)

1. **금지 1**: [절대 하지 말아야 하는 것]
   - 이유 및 위험성

2. **금지 2**: [절대 하지 말아야 하는 것]
   - 이유 및 위험성

3. **금지 3**: [절대 하지 말아야 하는 것]
   - 이유 및 위험성

### 보안 규칙

- **민감정보**: API 키, 비밀번호, 개인정보는 절대 하드코딩하지 않음
- **데이터 노출**: 구체적인 수치 대신 범위/서술형으로 표현
- **추측 금지**: 확실하지 않은 정보는 추가하지 않음
- **환경변수**: 민감한 설정은 환경변수로만 관리

## Examples

실제 사용 사례를 통해 스킬의 적용 방법을 보여줍니다.

### 예시 1: [시나리오 이름]

**상황**: [구체적인 상황 설명]

**사용자 요청**:
```
[사용자가 실제로 입력할 내용]
```

**스킬 적용 과정**:

1. 1단계 실행:
   ```
   [1단계 결과]
   ```

2. 2단계 실행:
   ```
   [2단계 결과]
   ```

3. 3단계 실행:
   ```
   [3단계 결과]
   ```

**최종 결과**:
```
[완성된 결과물 전체를 보여줌]
```

### 예시 2: [다른 시나리오]

**상황**: [구체적인 상황 설명]

**사용자 요청**:
```
[사용자가 실제로 입력할 내용]
```

**최종 결과**:
```
[완성된 결과물]
```

## Best practices

효과적으로 이 스킬을 사용하기 위한 권장사항입니다.

### 품질 향상

1. **방법 1**: [구체적인 방법]
   - 왜 중요한지
   - 어떻게 적용하는지
   - 예상 효과

2. **방법 2**: [구체적인 방법]
   - 적용 시점
   - 주의사항

3. **방법 3**: [구체적인 방법]
   - 실무 고려사항
   - 성능/보안 영향

### 효율성 개선

- **팁 1**: [실용적인 조언]
- **팁 2**: [시간 절약 방법]
- **팁 3**: [일반적인 실수 방지]

## 자주 발생하는 문제 (Common Issues)

흔히 발생하는 문제와 해결 방법입니다.

### 문제 1: [문제 설명]

**증상**:
- 관찰되는 현상 1
- 관찰되는 현상 2

**원인**:
왜 이 문제가 발생하는지 설명

**해결방법**:
1. 단계 1
2. 단계 2
3. 단계 3

### 문제 2: [문제 설명]

**증상**: [증상 설명]

**원인**: [원인 설명]

**해결방법**:
```
[해결 코드 또는 명령어]
```

## 변형 및 확장 (Variations)

이 스킬을 다른 상황에 맞게 조정하는 방법입니다.

### 변형 1: [변형 이름]

**언제 사용**: [사용 시점]

**절차 변경사항**:
- 기본 절차와의 차이점
- 추가/생략되는 단계

### 변형 2: [변형 이름]

**언제 사용**: [사용 시점]

**절차 변경사항**:
- 기본 절차와의 차이점
- 추가/생략되는 단계

## 지원 파일 (Supporting Files)

이 스킬과 함께 사용할 수 있는 추가 리소스입니다.

### 템플릿
- [template.md](templates/template.md): 작업 템플릿
- [config.yaml](templates/config.yaml): 설정 템플릿

### 예시
- [example1.md](examples/example1.md): 기본 예시
- [example2.md](examples/example2.md): 고급 예시

### 스크립트
- [setup.sh](scripts/setup.sh): 초기 설정 스크립트
- [validate.py](scripts/validate.py): 결과 검증 스크립트

### 참조 문서
- [REFERENCE.md](REFERENCE.md): 상세 레퍼런스
- [FAQ.md](FAQ.md): 자주 묻는 질문

## References

추가 학습을 위한 외부 자료입니다.

### 공식 문서
- [Official Documentation](https://example.com/docs)
- [API Reference](https://example.com/api)

### 튜토리얼
- [Getting Started Guide](https://example.com/guide)
- [Advanced Tutorial](https://example.com/tutorial)

### 커뮤니티
- [GitHub Repository](https://github.com/example/repo)
- [Community Forum](https://forum.example.com)

## Metadata

### 버전
- **현재 버전**: 1.0.0
- **최종 업데이트**: 2025-01-01
- **호환 플랫폼**: Claude, ChatGPT, Gemini

### 관련 스킬
- [related-skill-1](../related-skill-1/SKILL.md): 연관된 다른 스킬
- [related-skill-2](../related-skill-2/SKILL.md): 함께 사용할 수 있는 스킬

### 태그
`#태그1` `#태그2` `#태그3` `#카테고리`

---

## 플랫폼별 참고사항

### Claude
이 스킬은 Claude에서 자동으로 인식되며, `.claude/skills/` 폴더에서 사용됩니다.

### ChatGPT
Custom GPT의 Knowledge 섹션에 업로드하여 사용합니다. Instructions에 스킬 시스템 사용 규칙을 추가하세요.

### Gemini
프로젝트 루트의 `GEMINI.md`에서 이 스킬을 참조합니다. Gemini CLI 또는 Code Assist에서 사용 가능합니다.