Claude Skills는 '하나의 Skill에 하나의 작업'으로 만듭니다: 일일 보고서(日報)를 예로 든 설계 메모

Claude의 'Skills'는 SKILL.md라는 절차서를 담은 폴더를 등록하여, 정해진 작업을 정해진 형태로 처리하게 하는 시스템입니다. 직접 만들어 보면 '어디까지를 하나의 Skill로 할 것인가'에서 고민이 생깁니다. 이 글에서는 일일 보고서(日報)를 예로 들어, Skill을 작게 나누는 설계의 사고방식을 정리합니다. 내용은 Anthropic 공식 문서(Create custom skills)에 따릅니다.

결론: 하나의 Skill에는 하나의 작업만 담는다.

공식적인 모범 사례에서는 서로 다른 작업은 각각 별도의 Skill로 만드는 것이 좋다고 합니다. 작게 나눈 Skill들은 조합하기 쉽고, Claude가 필요한 것을 선택하기 용이합니다.

예를 들어, 다음 세 가지는 비슷해 보이지만, 분리하여 Skill로 만드는 것이 다루기 더 편리합니다.

• 일일 보고서 작성 (日報を作る)
• 일일 보고서에서 주간 보고서 작성 (日報から週報を作る)
• 주간 보고서를 이메일로 보내는 문안 작성 (週報をメールで送る文面を作る)

이것들을 하나로 합치면, description이 길어져 어떤 상황에 사용할지 모호해집니다. 또한, 절차를 수정하고 싶을 때 다른 부분이 손상되기 쉽습니다.

작업 메모를 받으면 다음 순서대로 일일 보고서로 정리합니다.

• 메모를 '수행한 내용(やったこと)', '성과(成果)', '과제/어려움(課題・困りごと)', '내일 할 일(明日やること)'로 분류합니다.
• '수행한 내용'은 무엇을, 얼마나, 어디까지 완료했는지 알 수 있도록 작성합니다. 숫자(건수, 시간)가 있다면 남깁니다.
• '성과'는 메모에 근거가 있는 것만 작성합니다. 성과를 읽어낼 수 없다면 억지로 만들지 않고 '없음(特になし)'으로 합니다.
• '과제/어려움'은 누구에게 무엇을 해달라고 요청할지까지 작성합니다. 메모에 없는 내용은 '없음(特になし)'으로 합니다.
• 전체 내용을 읽고 1분 이내로 끝낼 수 있는 길이로 만듭니다.

# 일일 보고서 [날짜]
## 오늘 수행한 내용
- 
...

• 메모에 없는 작업, 숫자, 성과는 추가하지 않습니다.
• 느낀 점이나 반성은 메모에 기록되어 있을 때만 1줄로 요약합니다.
• 문체는 간결한 명사형(体言止め)으로 합니다.

이 Skill을 설계하며 의식했던 점들

• description에 요청 시 사용할 단어를 넣습니다. '일일 보고서'뿐만 아니라 '오늘의 보고'도 포함했습니다.
• 성과는 근거가 있는 것만 작성합니다. 아무것도 지정하지 않으면 성과가 부풀려질 수 있습니다. '읽어낼 수 없으면