[Claude-Code] 클로드 코드 Skills: 그냥 폴더 하나면 끝

설정 필요 없습니다

툴에서 세팅하고 뭐 해야 할 거 같죠? 그냥 폴더 만들고 문서 넣으면 끝입니다.

개인 프로젝트로 이동 → .claude/skills 폴더 생성 → 끝.

진짜로 이게 전부예요. 이 폴더 안에 마크다운 파일 몇 개 넣으면 됩니다.

최종 형태

이게 최종 형태예요. 이렇게만 하면 알아서 실행됩니다.

작동 방식:

당신: "클로드야 이런 A기능 만들어줘~"
클로드가 스스로 판단, A기능을 개발할 때 무슨 skills이 필요한지 생각
필요하다면 알아서 문서를 참고
필요없으면 알아서 참고 안 함!

5초 만에 시작하기

# 프로젝트 루트에서
mkdir -p .claude/skills

끝났습니다. 이제 Skills 쓸 준비 완료.

어떻게 만들지? 뭐지 생각드시나요?

skills 아래 폴더명은 여러분이 원하는 스킬 폴더명 마음대로 만드는 겁니다.
그 하위에 파일은? 👇

Claude한테 시키세요 (핵심)

Skills 문서는 절대 직접 만들지 마세요.

왜? Claude가 수십만 배는 더 잘 씁니다.

Claude는 수천 개의 프로젝트 패턴을 학습했습니다.

✅ 어떤 키워드를 써야 잘 감지되는지
✅ 어떤 구조가 가장 효과적인지
✅ 어떤 예시가 명확한지

전부 압니다.

당신이 30분 고민해서 쓴 문서 < Claude가 10초에 쓴 문서

실전: 10초 만에 Skill 만들기

You: .claude/skills/ddd-pattern 하위에 DDD 패턴 스킬 만들어줘.

- Entity는 ID 값 객체로
- Repository는 인터페이스 먼저
- Domain 로직은 Entity 안에
- 여러분이 지향하는 내용

끝.

Claude가 알아서:

✅ SKILL.md 파일 생성
✅ 완벽한 description 작성 (키워드 최적화)
✅ 구체적인 예시 추가
✅ 좋은 예/나쁜 예 비교

그럼 어떻게 작동하나?

만들고 나면 자동으로 작동합니다.

You: "유저 Entity 만들어줘"

Claude의 동작:
  [작업 시작]
  [Entity 키워드 감지]
  [ddd-pattern skill 자동 로드]
  [skill 가이드 따라서 코드 생성]

생성 결과:

class UserId {
  constructor(private readonly value: string) {}
}

class User {
  constructor(
    private readonly id: UserId,
    private name: string
  ) {}
  
  changeName(newName: string) {
    // 비즈니스 로직
    this.name = newName;
  }
}

명령어에 ddd 가이드는 입력 안 했죠?
그냥 "Entity 만들어줘" 했을 뿐인데, Claude가 알아서 DDD 패턴 적용했습니다.

다른 예시: 테스트 코드 스킬

You: .claude/skills/test-pattern에 테스트 스킬 만들어줘.

- Jest 사용
- given-when-then 패턴
- describe/it 구조

10초 후 완성.

이제 코드 작성할 때:

You: "유저 서비스 테스트 코드 짜줘"

Claude의 동작:
  [테스트 키워드 감지]
  [test-pattern skill 자동 로드]
  [패턴 따라서 생성]

생성 결과:

describe('UserService', () => {
  describe('createUser', () => {
    it('should create user with valid data', () => {
      // given
      const userData = { name: 'John', email: 'john@example.com' };
      
      // when
      const user = userService.createUser(userData);
      
      // then
      expect(user.name).toBe('John');
      expect(user.email).toBe('john@example.com');
    });
  });
});

자동으로 given-when-then 패턴 적용.

Skill이 많아지면? 여러 Skill이 동시에 작동

You: "주문 API 만들어줘"

Claude의 동작:
  [API 키워드 감지]
  [ddd-pattern skill 로드] → Entity 설계
  [api-design skill 로드] → REST API 구조
  [test-pattern skill 로드] → 테스트 코드
  [error-handling skill 로드] → 에러 처리
  
  [전부 자동으로 조합해서 완성]

🔥 여기서 중요한 게 필요 없는 건 안 가져옵니다!
필요한 거만! 알아서!!

최종 결과:

✅ DDD 패턴 따른 Entity
✅ REST 규칙 따른 엔드포인트
✅ given-when-then 테스트
✅ 적절한 에러 핸들링

당신이 한 일: "주문 API 만들어줘" (5글자)

팀과 공유하기

이제 팀과 공유를 원한다? 그냥 git에 올리면 됩니다.

git add .claude/skills/
git commit -m "Add team skills"
git push

팀원이 clone 받으면 끝.

별도 설정 없이 바로 같은 패턴으로 개발 시작.

마치며

공식문서도 굉장히 친절합니다.

그리고 예시는 개인 프로젝트에만 해당하지만, 전역에 적용하는 구조도 있으니 공식문서를 확인해보세요!

https://code.claude.com/docs/ko/skills

코딩보따리