Claude Skills를 이용해 간단한 블로그 글 작성 스킬 만들기 (초급)

초급 튜토리얼: 간단한 블로그 글 작성 스킬 만들기

목표

이 튜토리얼에서는 블로그 글을 일관된 형식으로 작성하도록 돕는 간단한 스킬을 만들어봅니다.

난이도

⭐ 초급 - 코드 없음, 순수 마크다운 지침만 사용

소요 시간

약 15-20분

---

단계 1: 문제 정의하기

시나리오

여러분은 기술 블로그를 운영하고 있습니다. 매번 블로그 글을 쓸 때마다 다음과 같은 지침을 Claude에게 반복해서 말하고 있습니다:

• "독자를 '여러분'이라고 칭해줘"
• "각 섹션은 명확한 소제목으로 시작해줘"
• "코드 예시는 항상 설명을 먼저 하고 그 다음에 보여줘"
• "마지막에 핵심 요약을 3개 bullet point로 정리해줘"

이런 지침을 스킬로 만들면 매번 반복하지 않아도 됩니다!

---

단계 2: 스킬 디렉토리 생성하기

먼저 스킬을 저장할 폴더를 만듭니다:

blog-writing/
└── SKILL.md

---

단계 3: 기본 구조 작성하기

SKILL.md 파일을 만들고 다음 내용을 작성합니다:

---
name: Writing tech blogs
description: 일관된 형식과 스타일로 기술 블로그 글을 작성합니다
---

# 기술 블로그 작성 가이드

이 스킬은 독자 친화적이고 일관된 형식의 기술 블로그 글을 작성하는 데 도움을 줍니다.

설명

• name: 동명사 형태(verb + -ing)로 작성
• description: 무엇을 하는지 + 언제 사용하는지를 명확하게

---

단계 4: 스타일 가이드 추가하기

이제 본문에 구체적인 지침을 추가합니다:

---
name: Writing tech blogs
description: 일관된 형식과 스타일로 기술 블로그 글을 작성합니다
---

# 기술 블로그 작성 가이드

## 어조와 톤
- 독자를 '여러분'으로 칭합니다
- 친근하고 대화하는 듯한 어조를 사용합니다
- 전문 용어는 사용하되, 처음 나올 때 간단히 설명합니다

## 구조
모든 블로그 글은 다음 구조를 따릅니다:

1. **도입부**: 이 글에서 다룰 내용과 독자가 얻을 수 있는 것을 명확히 설명
2. **본문**: 명확한 소제목으로 구분된 섹션들
3. **결론**: 핵심 내용을 3개 bullet point로 요약

## 코드 예시 작성 규칙
- 코드를 보여주기 전에 항상 무엇을 하는 코드인지 설명합니다
- 코드 블록 후에는 주요 부분을 간단히 설명합니다
- 주석은 한국어로 작성합니다

---

단계 5: 구체적인 예시 추가하기

Claude가 더 잘 이해할 수 있도록 예시를 추가합니다:

## 예시: 코드 설명 방식

**좋은 예:**

useState Hook을 사용하여 카운터 상태를 관리할 수 있습니다:

```javascript // 카운터 상태 생성 const [count, setCount] = useState(0);

// 카운터 증가 함수 const increment = () => setCount(count + 1); ```

여기서 count는 현재 값을, setCount는 값을 업데이트하는 함수를 나타냅니다.

**피해야 할 예:**

```javascript const [count, setCount] = useState(0); ```

---

단계 6: 워크플로우 추가하기

블로그 글을 작성하는 단계별 프로세스를 추가합니다:

## 작성 워크플로우

블로그 글을 작성할 때 다음 순서를 따르세요:

1. **주제 명확화**: 사용자가 원하는 주제와 대상 독자를 확인
2. **개요 작성**: 주요 섹션과 다룰 내용을 bullet point로 정리
3. **초안 작성**: 각 섹션을 위 가이드에 따라 작성
4. **코드 예시 추가**: 필요한 곳에 설명과 함께 코드 삽입
5. **결론 작성**: 핵심 내용 3가지를 bullet point로 요약
6. **최종 검토**: 어조, 구조, 코드 설명이 가이드를 따르는지 확인

---

단계 7: 완성된 스킬

전체 SKILL.md 파일:

---
name: Writing tech blogs
description: 일관된 형식과 스타일로 기술 블로그 글을 작성합니다
---

# 기술 블로그 작성 가이드

이 스킬은 독자 친화적이고 일관된 형식의 기술 블로그 글을 작성하는 데 도움을 줍니다.

## 어조와 톤
- 독자를 '여러분'으로 칭합니다
- 친근하고 대화하는 듯한 어조를 사용합니다
- 전문 용어는 사용하되, 처음 나올 때 간단히 설명합니다

## 구조
모든 블로그 글은 다음 구조를 따릅니다:

1. **도입부**: 이 글에서 다룰 내용과 독자가 얻을 수 있는 것을 명확히 설명
2. **본문**: 명확한 소제목으로 구분된 섹션들
3. **결론**: 핵심 내용을 3개 bullet point로 요약

## 코드 예시 작성 규칙
- 코드를 보여주기 전에 항상 무엇을 하는 코드인지 설명합니다
- 코드 블록 후에는 주요 부분을 간단히 설명합니다
- 주석은 한국어로 작성합니다

## 예시: 코드 설명 방식

**좋은 예:**

useState Hook을 사용하여 카운터 상태를 관리할 수 있습니다:

\`\`\`javascript
// 카운터 상태 생성
const [count, setCount] = useState(0);

// 카운터 증가 함수
const increment = () => setCount(count + 1);
\`\`\`

여기서 `count`는 현재 값을, `setCount`는 값을 업데이트하는 함수를 나타냅니다.

---

**피해야 할 예:**

\`\`\`javascript
const [count, setCount] = useState(0);
\`\`\`

(설명 없이 코드만 제시하는 것은 피합니다)

## 작성 워크플로우

블로그 글을 작성할 때 다음 순서를 따르세요:

1. **주제 명확화**: 사용자가 원하는 주제와 대상 독자를 확인
2. **개요 작성**: 주요 섹션과 다룰 내용을 bullet point로 정리
3. **초안 작성**: 각 섹션을 위 가이드에 따라 작성
4. **코드 예시 추가**: 필요한 곳에 설명과 함께 코드 삽입
5. **결론 작성**: 핵심 내용 3가지를 bullet point로 요약
6. **최종 검토**: 어조, 구조, 코드 설명이 가이드를 따르는지 확인

---

단계 8: 스킬 테스트하기

테스트 방법

1. 스킬을 업로드하거나 활성화합니다
2. Claude에게 다음과 같이 요청해봅니다:

"React의 useEffect Hook에 대한 블로그 글을 작성해줘"

1. 결과를 확인합니다:
   • ✅ 독자를 '여러분'으로 칭하는가?
   • ✅ 명확한 소제목이 있는가?
   • ✅ 코드 전에 설명이 있는가?
   • ✅ 마지막에 3개의 bullet point 요약이 있는가?

예상되는 출력 구조

# React의 useEffect Hook 완벽 가이드

## 도입부
이번 글에서는 React의 useEffect Hook에 대해 알아봅니다...

## useEffect란 무엇인가요?
useEffect는 함수형 컴포넌트에서 사이드 이펙트를 수행할 수 있게 해주는 Hook입니다...

## 기본 사용법
가장 간단한 useEffect 사용 예시를 살펴보겠습니다:

\`\`\`javascript
// 컴포넌트가 렌더링될 때마다 실행
useEffect(() => {
  console.log('컴포넌트가 렌더링되었습니다');
});
\`\`\`

이 코드는 컴포넌트가 렌더링될 때마다 콘솔에 메시지를 출력합니다...

## 핵심 요약
- useEffect는 React 컴포넌트에서 사이드 이펙트를 처리하는 Hook입니다
- 의존성 배열을 통해 실행 조건을 제어할 수 있습니다
- cleanup 함수로 메모리 누수를 방지할 수 있습니다

---

단계 9: 개선하기

테스트 중에 발견한 문제를 개선합니다.

예시: Claude가 결론에 4개의 bullet point를 작성한 경우

수정 전:

3. **결론**: 핵심 내용을 3개 bullet point로 요약

수정 후:

3. **결론**: 핵심 내용을 **정확히 3개의** bullet point로 요약합니다. 
   더 많지도, 더 적지도 않게 3개를 유지하세요.

예시: 코드 주석이 영어로 작성된 경우

추가:

## 중요 규칙
- 모든 코드 주석은 반드시 한국어로 작성합니다
- 변수명은 영어를 사용해도 좋지만, 설명은 한국어로 합니다

---

체크리스트

스킬을 완성했다면 다음을 확인하세요:

• [ ] YAML 프론트매터에 name과 description이 있는가?
• [ ] description이 "무엇을 하는지"를 명확히 설명하는가?
• [ ] 구체적인 지침이 포함되어 있는가?
• [ ] 좋은 예/나쁜 예가 제공되어 있는가?
• [ ] 실제로 테스트해봤는가?
• [ ] 테스트 결과를 바탕으로 개선했는가?

---

다음 단계

이제 초급 스킬을 만들 수 있게 되었습니다!

배운 내용

• ✅ 기본 스킬 구조 (YAML 프론트매터 + 본문)
• ✅ 명확한 지침 작성
• ✅ 예시 제공 방법
• ✅ 워크플로우 정의
• ✅ 테스트와 개선

더 나아가기

• 다른 작업을 위한 스킬 만들어보기 (예: 이메일 작성, 회의록 정리)
• 중급 튜토리얼로 진행하여 참조 파일 사용법 배우기
• 팀원들과 스킬 공유하고 피드백 받기

---

자주 묻는 질문

Q: 스킬이 너무 길어지는 것 같아요

A: 초급 단계에서는 모든 내용을 SKILL.md 하나에 넣어도 괜찮습니다. 500줄을 넘어가면 중급 튜토리얼에서 배울 "점진적 공개" 패턴을 사용하세요.

Q: Claude가 가끔 지침을 무시하는 것 같아요

A: 지침을 더 명확하고 구체적으로 만들어보세요. "간단하게 써줘" 대신 "300단어 이내로 작성해줘"처럼 측정 가능한 기준을 제시하세요.

Q: 여러 개의 스킬을 동시에 사용할 수 있나요?

A: 네! Claude는 여러 스킬을 동시에 활용할 수 있습니다. 각 스킬은 독립적으로 작동하면서도 함께 사용될 수 있습니다.

---

실습 과제

직접 스킬을 만들어보세요!

과제 1: 이메일 작성 스킬

다음 요구사항을 가진 이메일 작성 스킬을 만들어보세요:

• 존댓말 사용
• 인사말 → 본문 → 맺음말 구조
• 항상 발신자 이름 포함

과제 2: 회의록 정리 스킬

회의 내용을 정리하는 스킬을 만들어보세요:

• 참석자, 날짜, 주제를 먼저 정리
• 논의 사항을 bullet point로
• 액션 아이템을 표로 정리 (담당자, 기한 포함)

중급 튜토리얼에서는 참조 파일을 사용한 더 복잡한 스킬 구조를 배워봅니다.