클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

스킬 개발 가이드 (Skill Development)

Claude Code 스킬·플러그인을 제대로 설계·작성·검증하도록 단계별 규칙과 체크리스트를 제공하는 메타 스킬입니다.

개발·코딩중급★ 549⑂ 48AI 점수 7/10마지막 업데이트: 2026. 9. 16.

무엇을 해주나

  • 스킬 구조 설계: SKILL.md + references/, examples/, scripts/, assets/ 를 어떤 기준으로 나눌지 알려줍니다.
  • 트리거 문장 작성: frontmatter description을 3인칭 + 실제 사용자 발화 문구("create a hook" 등)로 쓰도록 좋은 예/나쁜 예와 함께 교정해 줍니다.
  • 점진적 공개(Progressive Disclosure): 메타데이터 → 본문(1,500~2,000단어 권장) → 번들 리소스 3단 로딩 원칙에 맞춰 긴 내용을 references로 분리하도록 유도합니다.
  • 문체 규칙: 2인칭("당신은~") 금지, 명령형/부정사형으로 쓰도록 강제합니다.
  • 6단계 제작 프로세스 + 최종 검증 체크리스트: 사용 예시 수집 → 리소스 계획 → 디렉터리 생성 → 작성 → 검증/테스트 → 반복.

이런 분께 추천

  • 사내용/개인용 Claude Code 스킬을 처음 만드는 개발자
  • 스킬이 원하는 순간에 발동하지 않아 고민 중인 분 (트리거 문구 개선)
  • 플러그인에 여러 스킬을 담아 배포하려는 도구 제작자
  • 기존 스킬이 너무 길어져 컨텍스트를 낭비하고 있다고 느끼는 분

활용 예시

  1. "PDF 회전·병합을 도와주는 스킬을 새로 만들어줘" → 사용 예시 질문 → scripts/rotate_pdf.py 같은 번들 리소스 계획 → 디렉터리 생성 → SKILL.md 작성까지 진행.
  2. "내 스킬 description이 약한 것 같아, 발동이 안 돼" → 3인칭 + 구체적 트리거 문구 형태로 다시 써 줍니다.
  3. "SKILL.md가 8,000단어가 넘었어" → 핵심 절차만 남기고 상세 패턴을 references/patterns.md, references/advanced.md로 분리하는 리팩터링 안을 제시합니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/tzachbon/smart-ralph/HEAD/.agents/skills/Skill Development/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 tzachbon/smart-ralph 의 .agents/skills/Skill Development 폴더를 내 ~/.claude/skills/skill-development/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph && mkdir -p ~/.claude/skills/skill-development && cp -r "/tmp/smart-ralph/.agents/skills/Skill Development/." ~/.claude/skills/skill-development/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 임시 폴더에 복제합니다: git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills/skill-development
  4. 스킬 파일을 복사합니다: cp -r "/tmp/smart-ralph/.agents/skills/Skill Development/." ~/.claude/skills/skill-development/
  5. ls ~/.claude/skills/skill-development 로 SKILL.md가 있는지 확인합니다.
  6. Claude Code를 다시 시작한 뒤 "새 스킬을 만들어줘" 또는 "내 스킬 description을 개선해줘" 라고 요청해 스킬이 발동하는지 확인합니다.
  7. (선택) 특정 프로젝트에만 쓰려면 ~/.claude/skills 대신 프로젝트 내 .claude/skills/ 로 복사하세요.
GitHub에서 원본 보기 ↗라이선스: MIT