오늘은 클로드 새로운 기능인"클로드 스킬(Claude Skills)"에 대해 써보려고 한다.
구글 오팔(Opal), 에이전트 빌더(Agent Builder) 등이 출시되었을때의 리뷰랑은 느낌이 좀 다르다.
사실 Opal, Agent Builder는 n8n을 대체하기엔 아직 갈길이 멀어 보였다. ( 각각의 장단점이 다르다. 대체제는 아닌것 같았다.)
그런데 클로드 스킬은 간만에 느껴보는 획기적인 기능으로 보여 리뷰를 진행해보려고 한다.
Claude Skills는 단순한 AI 기능이 아니다. 프롬프트를 매번 복붙할 필요 없이, 정해진 워크플로를 재사용 가능한 "스킬"로 만들어 두는 시스템이다. 이 글에서는 현재 사용 가능한 스킬들을 살펴보고, 실제 업무에 어떻게 적용하면 좋을지 예시를 통해 공유하려고 한다.
0. Claude Skills란?
Skills는 다음과 같은 특징을 가진다.
Skills의 작동 원리
Claude는 대화 시작 시 모든 Skills의 프론트매터(YAML)만 먼저 읽는다.
사용자 요청에 관련 스킬이 있다고 판단하면, 해당 스킬의 본문(마크다운)을 로딩한다.
본문에 참조 문서(스크립트, 예시 등)가 명시되어 있으면 필요한 것만 추가로 로딩한다.
이 "점진적 로딩" 방식 덕분에 컨텍스트 윈도우를 효율적으로 사용할 수 있다.
가장 중요한 건 일관성이다. 같은 프롬프트를 매번 조금씩 다르게 쓰면 결과물도 매번 달라진다. Skills는 "이 작업은 항상 이렇게 해"라는 규칙을 정해두는 것이라고 볼 수 있다.
1. Skills 설정 및 활성화 방법
필수 조건: "코드 실행 및 파일 생성" 기능 활성화
Skills를 사용하려면 반드시 "코드 실행 및 파일 생성" 기능이 먼저 켜져 있어야 한다. (클로드 Desktop에서 사용하는 경우)
활성화 방법:
1. Claude Desktop 설정 (⌘, 또는 Ctrl+,) 열기
2. 좌측 사이드바에서 기능 클릭
3. "코드 실행 및 파일 생성" 토글을 ON으로 설정 (보통은 기본적으로 활성화 되어 있다.)
4. 이후 같은 페이지에서 스킬 섹션이 나타남
claude desktop을 쓴다면 갑자기 이런 팝업이 노출되는걸 보신 분들도 있을 것 이다. 이 기능이다.
공식 문서 원문:
"This feature preview requires code execution to be enabled"
만약 Skills 섹션이 보이지 않는다면:
"코드 실행 및 파일 생성"이 꺼져 있는지 확인
Pro, Team, Enterprise 플랜인지 확인 (Free 플랜에서는 Skills 미지원)
Claude Desktop이 최신 버전인지 확인
Claude Desktop / 웹 에서 Skills 활성화하기
1단계: 설정 메뉴 진입
Claude Desktop 앱 실행
Claude 정보 메뉴 클릭 (macOS: 상단 메뉴바, Windows: 설정)
설정... 선택 (단축키: ⌘, 또는 Ctrl+,)
2단계: Skills 섹션 찾기
좌측 사이드바에서 기능 (Features) 섹션 클릭
스킬 (Skills) 항목 확인
3단계: 원하는 스킬 활성화
각 스킬 옆의 토글 스위치를 켜기 (ON)
필요한 스킬만 선택적으로 활성화 가능
활성화된 스킬은 Claude가 자동으로 상황에 맞게 사용
💡 Pro Tip: 모든 스킬을 다 켤 필요는 없습니다. 자주 사용하는 작업 유형에 맞는 스킬만 활성화하면 Claude의 응답 속도도 빨라지고 더 정확한 결과를 얻을 수 있다.
→ "Browse and install Plugins" 선택 → anthropic-agent-skills 확인
3. 스킬 설치
# Document Skills 설치 (DOCX, PDF, PPTX, XLSX)
/plugin install document-skills@anthropic-agent-skills
# Example Skills 설치 (11개 스킬)
/plugin install example-skills@anthropic-agent-skills
설치 후 Claude Code 재시작 필수!
4. 설치 확인
/plugin
5. 스킬 사용
"Use the PDF skill to extract tables from report.pdf"
"Use the XLSX skill to create a financial model"
"Use the PPTX skill to make a 5-slide roadmap presentation"
"Use the PDF skill to extract data from report.pdf,
then use the XLSX skill to create a summary with charts"
3. 재무 모델링 자동 색상 적용
XLSX 스킬은 Blue(입력), Black(수식), Green(내부링크), Red(외부링크), Yellow(가정) 색상을 자동 적용한다!
Skills vs MCP vs Sub-agents: 헷갈리는 세 가지 정리
Claude를 처음 접하면 Skills, MCP, Sub-agents가 뭐가 다른지 헷갈릴 것 이다. 나도 처음엔 "다 비슷한 거 아냐?"라고 생각했는데, 써보니 완전히 다른 역할이었다. 각각의 탄생 배경과 실전 활용법을 정리해봤다.
탄생 타임라인
2024년 11월: MCP (Model Context Protocol) 발표 - Anthropic이 외부 시스템 연결 표준 제시
2025년 7월 25일: Sub-agents 출시 - Claude Code에서 전문화된 AI 어시스턴트 등장
2025년 10월 16일: Skills 발표 - 재사용 가능한 워크플로우 패키지 시스템
Sub-agents가 먼저 나왔고, Skills가 약 3개월 후에 등장했다. Skills 등장 전까지는 Sub-agents가 비슷한 역할을 했다.
상세 비교표
항목
Skills
MCP
Sub-agents
정의
재사용 가능한 워크플로우 패키지
외부 시스템 연결 표준 프로토콜
전문화된 AI 어시스턴트
핵심 역할
전문 지식과 워크플로우 제공
데이터 소스/API 연결
병렬 작업 처리, 컨텍스트 절약
비유
📚 전문 레시피북
🔌 USB-C 커넥터
👥 전문 팀원
사용 예시
XLSX 스킬로 재무 모델 작성
BigQuery MCP로 데이터 조회
데이터 분석 서브 에이전트가 요약
활성화 방법
자동 (Claude가 필요시 로드)
MCP 서버 설치 + 설정
.claude/agents/ 폴더에 정의
컨텍스트
메인 세션과 공유
외부 시스템 연결
격리된 별도 컨텍스트
주요 장점
일관된 품질, 쉬운 사용
표준화된 연결, 재사용성
병렬 처리, 컨텍스트 보존
언제 무엇을 사용할까?
Skills만으로 충분한 경우:
문서 생성 (DOCX, PDF, PPTX, XLSX)
반복적인 워크플로우 자동화
표준화된 작업 (특정 문서 모델링, 프레젠테이션)
MCP가 필요한 경우:
외부 데이터베이스 연결 (BigQuery, PostgreSQL)
API 통합 (Slack, GitHub, Jira)
파일 시스템 접근
Sub-agents가 유용한 경우:
복잡한 작업을 병렬로 처리
특정 전문 분야 (보안, 성능 최적화, 데이터 분석)
메인 컨텍스트 절약 필요
2. Document Skills 4종 살펴보기
먼저 앤트로픽이 제공하는 4개의 Document Skills를 살펴보자. 이 스킬들은 document-skills 플러그인에 포함되어 있다.
Claude Desktop 사용자 참고사항 위에서도 얘기 했지만 Document Skills (DOCX, PDF, PPTX, XLSX)는 Claude Desktop의 기본 UI에 표시되지 않을 수 있다. 이는 point-in-time snapshots로 더 이상 적극적으로 유지보수되지 않기 때문으로 보인다.
Document Skills 제한사항
Document Skills (DOCX, PDF, PPTX, XLSX)는 다음 제한사항이 있다:
Point-in-time snapshots: 특정 시점의 스냅샷이며 적극적으로 유지보수되지 않음
참고용 예제: 주로 참고 및 학습 목적으로 제공
데모 목적: "demonstration and educational purposes only"
동작 차이 가능: 실제 Claude의 구현은 예제와 다를 수 있음
철저한 테스트 필수: 프로덕션 사용 전 반드시 테스트 필요
공식 문서 원문: "These document skills are point-in-time snapshots and are not actively maintained or updated. They are primarily intended as reference examples."
문서 생성은 Skills 없이도 가능합니다. "코드 실행 및 파일 생성" 기능만 켜져 있으면 Claude가 Python 라이브러리를 직접 사용하여 문서를 만들 수 있다. 그렇다면 Document Skills는 왜 필요할까요?
비교 항목
기본 Code Execution
Document Skills
작동 방식
매번 새로 코드 작성 (openpyxl, python-docx 등)
미리 정의된 워크플로와 가이드라인 사용
일관성
⚠️ 낮음 - 매번 결과 약간씩 다름
✅ 높음 - 동일한 규칙 적용
품질
⚠️ 기본적 - "폰트 너무 작아요" 피드백 필요
✅ 전문적 - 디자인 가이드라인 준수
XLSX 색상 규칙
❌ 없음
✅ 재무 모델링 표준 (Blue/Black/Green/Red/Yellow)
PPTX 디자인
❌ 기본 레이아웃
✅ 17개 컬러 팔레트, 여백/폰트 규칙
사용 난이도
쉬움 - 프롬프트만 작성
쉬움 - 프롬프트만 작성 (자동 적용)
권장 용도
간단한 일회성 문서
전문적인 반복 작업, 프로덕션 환경
요리 비유:
Code Execution = 요리 도구 (칼, 프라이팬, 냄비)
Skills = 전문 레시피 (미슐랭 셰프의 정확한 조리법)
도구만 있어도 요리할 수 있지만, 레시피가 있으면 매번 동일한 품질의 음식을 만들 수 있다.
팁: Document Skills가 Claude Desktop UI에 없더라도, "코드 실행 및 파일 생성" 기능만으로도 충분히 고품질 문서를 만들 수 있다. 다만 매번 "재무 모델링 색상 규칙 준수해줘", "PPTX는 16:9 비율로 여백 일관되게 해줘" 같은 지시를 명시적으로 해야 한다.
2.0 스킬 효과적으로 호출하는 방법
스킬을 설치했다고 끝이 아니다.어떻게 호출하느냐에 따라 효율이 크게 달라진다.
명령어와 함께 사용하면 좋아요!
스킬을 자동으로 활성화되길 기대하기보다는,명시적으로 스킬 이름을 언급하는 것이 훨씬 효과적이다. Claude가 문맥을 오해할 여지를 없애준다.
❌ 애매한 요청 (자동 활성화 기대)
"이 데이터를 분석해서 보고서 만들어줘"
→ Claude가 어떤 스킬을 써야 할지 헷갈릴 수 있음
✅ 명확한 요청 (명시적 스킬 호출)
"Use the XLSX skill to analyze this sales data and create a dashboard"
→ Claude가 정확히 XLSX 스킬을 로드하고 실행함
💡 Pro Tip:한국어로 요청할 때도 스킬 이름은 영어로 쓰는 것을 추천한다. "XLSX 스킬로 매출 데이터 분석해줘"처럼 섞어 쓰면 인식률이 더 높다.
# Project Proposal: AI-Powered Customer Support System
## Executive Summary
Implementing AI-powered customer support to reduce response times by 60%...
## Budget Breakdown
| Category | Cost | Timeline |
|----------|------|----------|
| AI Platform License | $80,000 | Annual |
테스트 명령어:
"Use the DOCX skill to convert document_template.md to a professional business proposal with table of contents"
ex) claude desktop / web
- 사용할 SKILL.md 확인 및 작업중인 내용
- 결과
팁 DOCX 스킬은 docx-js (신규 문서 생성)와 Document library (OOXML 조작)를 사용한다고 한다. 복잡한 템플릿을 사용할 때는 미리 서식을 만들어두고 업로드한 후 "이 템플릿의 특정 부분만 수정해줘" 방식이 가장 효율적일 것 이다.
2.2. PDF - PDF 조작의 달인
핵심 기능:
텍스트 및 테이블 추출
새 PDF 생성, 병합/분할
PDF 양식(Forms) 작성 - 세금 신고, 지원서 등
대규모 배치 처리 지원
주의사항:
⚠️ PDF 스킬은 pypdf 라이브러리를 기본으로 사용하며, 텍스트 및 테이블 추출에는 pdfplumber, PDF 생성에는 reportlab을 작업에 맞게 활용합니다.
PDF Skill 테스트: sample_report.md
Q4 2024 매출 보고서 (지역별/제품별 테이블 포함)
# Q4 2024 Sales Report
## Sales by Region
| Region | Q3 Revenue | Q4 Revenue | Growth |
|--------|-----------|-----------|--------|
| North America | $2,450,000 | $3,120,000 | 27.3% |
| Europe | $1,830,000 | $2,240,000 | 22.4% |
| Asia Pacific | $1,620,000 | $1,890,000 | 16.7% |
테스트 명령어:
"Use the PDF skill to convert sample_report.md to a professional PDF report with tables"
- 이번엔 클로드 코드로 진행
- pdf 생성 결과
- 한글로 결과물을 다시 만들어 달라고 해도 된다.
2.3. PPTX - 프레젠테이션
핵심 기능:
프레젠테이션 생성/편집/분석
슬라이드 레이아웃 자동 조정
발표자 노트 및 댓글 추가
애니메이션 및 디자인 요소 제어
가장 인상적이었던 부분:
PPTX 스킬은 디자인 가이드라인이 매우 상세하게 작성되어 있다. 폰트 크기, 여백, 색상 팔레트, 16:9 비율 준수 등이 모두 스킬 문서에 명시되어 있어서, OpenAI나 Gemini로 PPT를 만들 때처럼 "폰트가 너무 작아요", "여백이 이상해요" 같은 피드백 루프를 반복할 필요가 없다.
"Use the XLSX skill to create a financial model from financial_data.csv with:
- Monthly revenue trend chart
- Expense breakdown pie chart
- Color-coded cells (Blue for inputs, Black for formulas)"
결과 :
3. Example Skills 11종 둘러보기
Document Skills 외에 11개의 Example Skills가 있다. 이들은 example-skills 플러그인에 포함되어 있으며, 특정 도메인이나 전문 작업에 특화되어 있다. 필요에 따라 활성화하거나 커스터마이징할 수 있다.
물론 이를 사용한다기 보다는, 앞으로 우리가 skill을 어떻게 만들면 되는지 좋은 예시가 된다고 볼 수 있겠다.
모든 작업에 Skills를 쓸 필요는 없다. 다음 조건을 만족할 때 Skills를 고려하자.
Skills가 적합한 경우
반복성:같은 형태의 작업을 주기적으로 해야 할 때 (주간 보고서, 월간 분석 등)
일관성:결과물의 품질과 형식이 일관되어야 할 때
복잡성:여러 단계를 거쳐야 하는 워크플로 (데이터 → 엑셀 → PPT → PDF)
전문성:도메인 전문 지식이 필요한 작업 (재무 모델링, 생물정보학 분석 등)
❌ Skills가 과한 경우
일회성 작업:한 번만 할 작업이라면 스킬 만드는 게 오히려 비효율적
간단한 변환:"이 텍스트를 표로 만들어줘" 같은 단순 작업
창의적 작업:브레인스토밍, 아이디어 발산 등 자유로운 사고가 필요한 작업
4.2. 커스텀 스킬 작성의 3대 핵심 섹션
기본 스킬만으로는 활용하기에 당연히 부족할 것 이다. 이런 경우 직접 커스텀 스킬을 만들어 활용하면 된다.
커스텀 스킬을 만들 때 가장 중요한 것은SKILL.md 파일의 구조다. 크게 3가지 핵심 섹션으로 나뉜다: Metadata, Instructions, Examples. 각각의 역할과 작성법을 상세히 알아보자.
커스텀 스킬만들기 - 전체 구조
---
# 📌 섹션 1: Metadata (YAML Frontmatter)
# Claude가 이 스킬을 '언제' 로드할지 결정하는 핵심
name: My Custom Skill
description: 이 스킬이 무엇을 하는지, 언제 사용해야 하는지 명확하게 설명
---
# 📌 섹션 2: Instructions (지시사항)
# Claude가 '어떻게' 작업을 수행할지 정의
## When to Use
- 이런 상황에서 이 스킬을 사용하세요
- 이런 키워드가 나오면 활성화하세요
## Workflow
1. 첫 번째 단계
2. 두 번째 단계
3. 세 번째 단계
## Guidelines
- 중요한 규칙 1
- 중요한 규칙 2
# 📌 섹션 3: Examples (예시)
# Claude가 구체적으로 '무엇을' 만들어야 하는지 이해
## Example 1: 기본 사용
"이런 요청이 들어오면"
→ 이렇게 응답하세요
## Example 2: 고급 활용
"복잡한 요청이 들어오면"
→ 이렇게 단계별로 처리하세요
섹션1. Metadata 섹션 (YAML Frontmatter) - "언제" 로드할까?
YAML frontmatter는스킬의 얼굴이다. Claude는 대화 시작 시 모든 스킬의 metadata만 먼저 읽고, description을 보고 "이 스킬이 지금 필요한가?"를 판단한다.
필수 필드
필드설명제한
name
스킬의 이름 (소문자, 숫자, 하이픈만!)
최대 64자 ✗ 대문자 ✗ 공백 ✗ 특수문자
description
가장 중요! 스킬의 기능과 사용 시점
최대 1024자
⚠️ 중요:YAML frontmatter에는name과description두 필드만 지원됩니다.version,author등 다른 필드는 무시됩니다.
Description 작성 황금 법칙
❌ 나쁜 예시 (너무 모호함)
description: A skill for document processing
→ "document processing"이 뭔지 Claude가 판단하기 어려움
✅ 좋은 예시 (구체적이고 명확함) - code-review-assistant
description: Professional code-review-assistant that analyzes code quality, detects issues, and generates comprehensive review reports with actionable improvements. Automatically identifies code smells, security vulnerabilities, performance bottlenecks, and maintainability issues. Use when reviewing pull requests, conducting quality audits, or when user mentions "code review", "code quality", "refactoring suggestions", "security audit", or wants to improve code quality.
→ 무엇을 하는지 (코드 리뷰 및 품질 분석), 언제 사용하는지 (PR 리뷰, 품질 감사), 어떤 키워드에 반응하는지 (code review, security audit, refactoring) 명확함
Description 작성 템플릿
[동작] + [입력 형식] + [출력 형식]. Use when [키워드1], [키워드2], or [상황].
실전 예시 (code-review-assistant 기반):
name: code-review-assistant
description: Professional code-review-assistant that analyzes code quality, detects issues, and generates comprehensive review reports with actionable improvements. Use when "code review", "security audit", "refactoring", "code quality", "pull request review", or "quality audit" are mentioned.
💡 키워드 선정 팁:code review, security audit, refactoring, code quality처럼개발자들이 실제로 검색하는 용어를 넣어야 자동 활성화 확률이 높아진다. "코드 분석" 같은 모호한 용어는 피하자.
섹션2. Instructions 섹션 - "어떻게" 수행할까?
Instructions 섹션은 스킬의 본문이다. Claude가 실제로 작업을 수행할 때 참조하는 가이드라인이다.간결하면서도 명확해야 한다.
권장 하위 섹션 구조
섹션목적예시
## When to Use
활성화 조건 명시
파일 형식, 키워드, 상황
## Workflow
단계별 실행 절차
1, 2, 3 순서대로
## Guidelines
지켜야 할 규칙
포맷, 스타일, 제약사항
## Tools
사용할 라이브러리/도구
pandas, openpyxl 등
실전 예시: code-review-assistant 스킬 (모든 개발자용)
## When to Use
- User mentions "code review", "pull request review", "code quality"
- User wants to improve code quality or conduct quality audits
- User requests help with "refactoring", "security audit", "performance analysis"
- Questions about code smells, best practices, SOLID principles
- Needs to identify vulnerabilities or maintainability issues
## Workflow
1. Code Analysis:
- Language Detection (Python, JavaScript, Java, Go, TypeScript, etc.)
- Structure Parsing (functions, classes, modules, dependencies)
- Complexity Metrics (cyclomatic complexity, nesting depth, LOC)
2. Issue Detection:
- Code Smells: Duplicate code, long functions, God objects
- Security: SQL injection, XSS, CSRF, insecure dependencies
- Performance: N+1 queries, unnecessary loops, memory leaks
3. Severity Classification:
- Critical 🔴: Security vulnerabilities, system failure risks
- High 🟠: Performance degradation, difficult maintenance
- Medium 🟡: Readability issues, convention violations
- Low 🟢: Style inconsistencies, missing documentation
4. Refactoring Suggestions:
- Before/After code examples showing concrete improvements
- Specific fixes with exact changes needed
- Impact analysis (effort vs. benefit)
5. Prioritization:
- Impact × Severity Matrix for priority scoring
- Quick wins: easy fixes with high impact
- Long-term: architectural refactoring needs
## Guidelines
Review Categories:
- Code Structure & Design: SOLID principles, design patterns, modularity
- Performance & Efficiency: Algorithm complexity, memory usage, database queries
- Security & Safety: Input validation, SQL injection, XSS protection, auth/authz
- Code Quality: Readability, naming, documentation, DRY principle, testability
- Language-Specific: PEP 8 (Python), ESLint (JavaScript), Effective Java patterns
Review Workflow:
1. Start with critical issues (security and stability first)
2. Group related issues for efficient fixing
3. Provide context: explain WHY something is a problem
4. Suggest 2-3 alternatives when possible
Report Format:
- Executive Summary: Total issues, severity distribution, critical actions
- Detailed Findings: File-by-file, function-by-function breakdown
- Action Items: Prioritized list with estimated effort and impact
## Required Tools
Built-in Analysis:
- Uses Claude's native code understanding (no external tools required)
Optional Enhancements:
- Static analysis: ESLint, Pylint, SonarQube
- Security scanners: Snyk, Dependabot
- Complexity analyzers: radon (Python), complexity-report (JavaScript)
💡 작성 팁:Claude는 이미 매우 똑똑하다. 당연한 것은 쓰지 말고, Claude가 모를 수 있는도메인 특화 지식만 포함하자. "파일을 읽으세요" 같은 기본 지시는 불필요하다.
섹션3. Examples 섹션 - "무엇을" 만들까?
Examples는 선택사항이지만,있으면 스킬의 품질이 크게 향상된다. Claude가 구체적으로 무엇을 만들어야 하는지 이해하는 데 큰 도움이 된다.
좋은 예시의 3가지 요소
사용자 입력:실제 요청이 어떻게 들어오는지
기대 동작:Claude가 무엇을 해야 하는지
출력 형식:최종 결과물이 어떻게 생겼는지
실전 예시: Python 함수 코드 리뷰
## Example 1: Python Function Review
### User Request:
"Review this Python function for quality issues."
### Original Code:
def calc(a, b, c):
if a > 0:
if b > 0:
if c > 0:
return a + b + c
return 0
### Expected Claude Response:
## Issues Found
🔴 Critical: None
🟠 High:
1. Function naming unclear (Line 1)
- `calc` doesn't explain what calculation is performed
- Recommended: `calculate_positive_sum` or `sum_positive_numbers`
🟡 Medium:
2. Deep nesting (Lines 2-5)
- 3 levels of nested if statements reduce readability
- Cyclomatic complexity: 4 (threshold: 3)
3. Missing type hints (Line 1)
- Parameters and return type not specified
🟢 Low:
4. Missing docstring (Line 1)
- Function purpose not documented
### Refactored Version:
def calculate_positive_sum(num1: int, num2: int, num3: int) -> int:
"""
Calculate sum of three numbers if all are positive.
Args:
num1: First number
num2: Second number
num3: Third number
Returns:
Sum of numbers if all positive, otherwise 0
Examples:
>>> calculate_positive_sum(1, 2, 3)
6
>>> calculate_positive_sum(-1, 2, 3)
0
"""
if all(n > 0 for n in [num1, num2, num3]):
return sum([num1, num2, num3])
return 0
Improvements:
✅ Clear function name
✅ Type hints added
✅ Comprehensive docstring with examples
✅ Reduced nesting (cyclomatic complexity: 2)
✅ More Pythonic (using `all()` and `sum()`)
## Example 2: JavaScript Security Review
### User Request:
"Check this Express route for security issues."
### Original Code:
app.get('/user', (req, res) => {
const query = `SELECT * FROM users WHERE id = ${req.query.id}`;
db.query(query, (err, results) => {
if (err) throw err;
res.json(results);
});
});
### Security Issues Found:
🔴 Critical:
1. SQL Injection Vulnerability (Line 2)
- Risk: Attacker can execute arbitrary SQL commands
- Attack: `?id=1 OR 1=1--` returns all users
- Impact: Complete database compromise, data theft
🟠 High:
2. Error Information Leakage (Line 4)
- Throwing errors exposes database structure
3. Missing Input Validation (Line 2)
- No validation that `req.query.id` is valid number
### Secure Version:
const authenticate = require('./middleware/auth');
app.get('/user', authenticate, async (req, res) => {
try {
// Input validation
const userId = parseInt(req.query.id);
if (isNaN(userId) || userId < 1) {
return res.status(400).json({ error: 'Invalid user ID' });
}
// Parameterized query prevents SQL injection
const query = 'SELECT id, name, email FROM users WHERE id = ?';
const results = await db.query(query, [userId]);
res.json(results[0] || null);
} catch (error) {
// Secure error handling
console.error('Database error:', error);
res.status(500).json({ error: 'Internal server error' });
}
});
Security Improvements:
✅ Parameterized queries (SQL injection prevention)
✅ Input validation
✅ Authentication middleware
✅ Secure error handling
✅ Only returns necessary fields
💡 Pro Tip:예시는 2-3개 정도가 적당하다. 너무 많으면 토큰을 낭비하고, 너무 적으면 Claude가 패턴을 파악하기 어렵다.
4.3. 스킬 등록 방법
일단 먼저 상기 내용을 토대로 /SKILL.md 파일을 샘플로 정리해 봤다.
---
name: code-review-assistant
description: Professional code review assistant that analyzes code quality, detects issues, and generates comprehensive review reports with actionable improvements. Automatically identifies code smells, security vulnerabilities, performance bottlenecks, and maintainability issues. Use when reviewing pull requests, conducting quality audits, or when user mentions "code review", "code quality", "refactoring suggestions", "security audit", or wants to improve code quality.
---
# Code Review Assistant
Professional-grade code review tool that helps developers identify issues, improve code quality, and maintain best practices across multiple programming languages.
## When to Use
This skill activates when you need to:
- Review pull requests or code changes
- Conduct quality audits before production deployment
- Identify security vulnerabilities and performance issues
- Generate refactoring recommendations
- Ensure coding standards and best practices compliance
## Core Workflow
### Step 1: Code Analysis
- Language Detection: Automatically identify programming language
- Structure Parsing: Analyze functions, classes, modules, dependencies
- Complexity Metrics: Calculate cyclomatic complexity, nesting depth, LOC
### Step 2: Issue Detection
- Code Smells: Duplicate code, long functions, God objects
- Security: SQL injection, XSS, CSRF, insecure dependencies
- Performance: N+1 queries, unnecessary loops, memory leaks
- Maintainability: Poor naming, missing documentation, high coupling
### Step 3: Severity Classification
- Critical 🔴: Security vulnerabilities, system failure risks
- High 🟠: Performance degradation, difficult maintenance
- Medium 🟡: Readability issues, convention violations
- Low 🟢: Style inconsistencies, missing documentation
### Step 4: Refactoring Suggestions
- Before/After Examples: Show concrete code improvements
- Specific Fixes: Provide exact changes needed
- Impact Analysis: Estimate effort and benefit
### Step 5: Report Generation
- Executive Summary: Total issues, severity distribution
- Detailed Findings: File-by-file breakdown
- Action Items: Prioritized list with effort estimates
## Review Categories
### 1. Code Structure & Design
- SOLID principles adherence
- Design patterns appropriate usage
- Modularity and reusability
### 2. Security & Safety
- Input validation and sanitization
- SQL injection prevention (parameterized queries)
- XSS protection, Authentication/Authorization
### 3. Performance & Efficiency
- Algorithm complexity (O(n), O(n²), O(log n))
- Database query efficiency (N+1 problem)
- Memory usage optimization
## Guidelines
### Review Workflow
1. Start with critical issues (security and stability first)
2. Group related issues for efficient fixing
3. Provide context: explain WHY something is a problem
4. Suggest 2-3 alternatives when possible
### Communication Best Practices
- Be Constructive: Focus on improving code, not criticizing developer
- Be Specific: Point to exact lines and suggest concrete fixes
- Be Educational: Explain principles behind suggestions
- Be Pragmatic: Balance ideal solutions with project constraints
## Required Tools
# Built-in Analysis
This skill uses Claude's native code understanding
No external tools required!
# Optional Enhancements
pip install pylint # Python static analysis
pip install eslint # JavaScript/TypeScript linting
pip install snyk # Security vulnerability scanning
pip install radon # Python complexity analyzer
스킬을 등록하는 방법은 다양하다.
방법
난이도
장점
추천 대상
방법 0: 자연어 생성
⭐⭐⭐ 가장 쉬움!
완전 자동화, 대화형 생성
Claude Code 사용자
방법 1: ZIP 업로드
⭐⭐ 쉬움
브라우저만 필요
Claude.ai 사용자
방법 2: 로컬 파일
⭐ 보통
빠른 수정, 버전 관리
개발자
방법 3: Claude Code 플러그인
⭐ 보통
코드 작업 중 사용
Claude Code 사용자
방법 0: Claude Code에서 자연어로 생성
파일 작업 필요 없음! Claude가 대화형으로 모든 것을 처리한다.
전제 조건
Claude Code 설치
skill-creator 플러그인 활성화 (기본 포함)
Step 1: 자연어로 요청
Claude Code에서 다음처럼 말하기:
"I want to create a skill for code review"
또는 명시적으로: /skill skill-creator
Step 2-6: Claude가 자동 처리
구체적 예시 수집 (대화형 질문)
필요한 리소스 분석
스킬 템플릿 자동 생성 (init_skill.py)
SKILL.md 자동 작성
자동 검증 및 ZIP 패키징 (package_skill.py)
즉시 사용 가능!
방법 1: Claude Desktop/웹 에서 ZIP 업로드
웹 브라우저만 있으면 되는 가장 간단한 방법이다. 터미널이나 파일 시스템을 건드릴 필요가 없다.
Step 1: 파일 준비
메모장이나 텍스트 에디터에서 위의 SKILL.md 내용을 복사하여 SKILL.md 이름으로 저장
(선택) resources 폴더를 만들고 examples.md 파일도 추가
SKILL.md 파일 (또는 폴더 전체)를 ZIP으로 압축
Step 2: Claude.ai (claude dosktop) 업로드
1. Claude.ai 웹사이트 접속 및 로그인 (https://claude.ai)
2. 우측 상단 설정(Settings) 클릭
3. Features → Skills 메뉴 선택
4. "Upload Skill" 버튼 클릭
5. 준비한 ZIP 파일 업로드 후 확인.
Claude Skills의 YAML frontmatter에서 name 필드는 소문자, 숫자, 하이픈만 허용된다. 대문자와 공백이 있으면 안 된다.
Step 3: 스킬 활성화 확인
Claude.ai 채팅에서 테스트:
"Review this code for quality issues"
→ 스킬이 자동으로 로드되어야 함!
방법 2: Claude Code 사용시
파일 시스템에 직접 복사하는 방법으로 적용해보자. 개발자에게 익숙한 방식이다.
macOS/Linux
# 1. 스킬 디렉토리 생성
mkdir -p ~/.claude/skills/code-review-assistant
# 2. SKILL.md 파일 생성 (위 내용 복사)
nano ~/.claude/skills/code-review-assistant/SKILL.md
# 또는 텍스트 에디터로 위 SKILL.md 내용을 복사하여 저장
# 3. (선택) resources 폴더 및 examples.md 추가
mkdir -p ~/.claude/skills/code-review-assistant/resources
nano ~/.claude/skills/code-review-assistant/resources/examples.md
# 4. Claude Desktop 재시작
# 완전히 종료 후 다시 실행
Windows (PowerShell)
# 1. 스킬 디렉토리 생성
New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude\skills\code-review-assistant"
# 2. SKILL.md 파일 생성
notepad "$env:USERPROFILE\.claude\skills\code-review-assistant\SKILL.md"
# 메모장에서 위 SKILL.md 내용 복사 후 저장
# 3. Claude Desktop 재시작
다음과 같이 적용 확인해보면 잘 적용된것을 볼 수 있다.
"What Skills are available?"
"List all available Skills"
"사용할 수 있는 스킬 리스트를 보여줘"
사용 예시 및 결과
> ./orchestration-server/services/kb_ client.py 파일을 code-review-assistant 를 사용해서 리뷰해줘 .
⏺ 코드 리뷰 보고서: KB API 클라이언트
종합 요약
전체 품질: 🟡 중간 (68/100)
심각한 이슈: 0개 | 높은 우선순위: 3개 | 중간 우선순위: 4개 | 낮은 우선순위:
2개
kb_client.py 모듈은 Knowledge Base API를 위한 HTTP 클라이언트 기능을
제공합니다. 기본 구현은 작동하지만, 에러 처리, 리소스 관리, 유지보수성, 관찰성
측면에서 개선이 필요합니다.
---
심각한 이슈 🔴
발견되지 않음 ✅
---
높은 우선순위 이슈 🟠
1. 경로 조작 보안 위험 (5-7번째 줄)
심각도: 🟠 높음 | 분류: 보안 & 유지보수성
중략 ............
---
점수 분류 요약
| 카테고리 | 점수 | 가중치 | 가중 점수 |
|-------|--------|-----|-----------|
| 보안 | 65/100 | 25% | 16.25 |
| 성능 | 60/100 | 20% | 12.00 |
| 안정성 | 70/100 | 20% | 14.00 |
| 유지보수성 | 75/100 | 15% | 11.25 |
| 관찰성 | 60/100 | 10% | 6.00 |
| 코드 품질 | 80/100 | 10% | 8.00 |
| 합계 | | | 67.50/100 |
---
우선순위 실행 계획
1주차 (긴급):
- sys.path 조작 수정 → orchestration-server/services/kb_client.py:5-7
- 커넥션 풀링 구현 → orchestration-server/services/kb_client.py:28-32
2주차 (높음):
- 컨텍스트를 포함한 강화된 에러 처리 →
orchestration-server/services/kb_client.py:53-58,79-84
- 재시도 로직 추가 → orchestration-server/services/kb_client.py:34-84
3주차 (중간):
- 세분화된 타임아웃 설정 → orchestration-server/services/kb_client.py:31
- 응답 검증 → orchestration-server/services/kb_client.py:51,77
향후 반복:
- 서킷 브레이커 패턴
- 성능 모니터링
- 속도 제한
4.4. 스킬 등록 문제 해결
- 만약 정상 등록이 안되었다면 다음과 같은 내용을 확인해보자.
문제
원인
해결책
스킬이 목록에 없음
파일 경로 오류, YAML 문법 오류
ls ~/.claude/skills/code-review-assistant/SKILL.md 확인
자동 활성화 안 됨
Description 키워드 부족
명시적 호출: "Use the code-review-assistant skill"
코드 실행 에러
라이브러리 미설치 (선택사항)
pip install pylint eslint radon
5. 스킬 관련 문제 상황
스킬이 예상대로 작동하지 않을 때, 단계별로 문제를 진단하고 해결하는 방법을 정리했다. 대부분의 문제는 아래 체크리스트로 해결된다.
문제 1: 스킬이 전혀 활성화되지 않음
단계별 체크리스트
순서
확인 항목
해결 방법
1
코드 실행 기능이 켜져 있는가?
설정 > 기능 > "코드 실행 및 파일 생성" ON
2
스킬 토글이 활성화되어 있는가?
설정 > 기능 > 스킬 > 해당 스킬 ON
3
플랜이 Pro/Team/Enterprise인가?
Free 플랜에서는 Skills 미지원, 업그레이드 필요
4
Claude Desktop/Code가 최신 버전인가?
앱을 최신 버전으로 업데이트
5
Claude Code 플러그인 설치 확인
/plugin 명령어로 설치 확인
💡 Quick Fix: 대부분의 경우 Claude Desktop/Code를 재시작하면 해결된다. 설정 변경 후에는 항상 재시작해야된다!
문제 2: 스킬은 로드되는데 제대로 작동하지 않음
원인별 해결 방법
증상
원인
해결책
파일이 생성되지 않음
출력 경로 권한 문제
/mnt/user-data/outputs/ 경로 사용
에러 메시지: "Module not found"
필요한 Python 패키지 미설치
스킬 내에서 !pip install 명시
결과물이 매번 다름
스킬 지시사항이 모호함
더 구체적인 Guidelines 추가
원하는 기능만 부분 실행됨
Workflow 단계가 불명확
단계별로 번호 매기고 순서 명시
디버깅 명령어
# 스킬 로딩 확인
"사용 가능한 스킬 목록 보여줘"
"현재 로드된 스킬이 뭐야?"
# 명시적 스킬 호출로 테스트
"Use the XLSX skill to create a test file"
# 에러 로그 확인 (Claude Code)
# Claude가 자동으로 에러 메시지를 보여줍니다
문제 3: 커스텀 스킬이 자동으로 활성화되지 않음
Description 최적화 체크리스트
명확한 동작 동사 사용: "Analyzes", "Creates", "Converts" 등
구체적인 입력/출력 형식: "CSV files", "XLSX reports" 등
키워드 명시: "Use when 'sales report', 'revenue', 'quarterly analysis'"
사용 상황 설명: "When user provides financial data" 등
❌ 피해야 할 것: 모호한 표현 ("helps with", "assists"), 너무 긴 설명 (1024자 넘김)
테스트 방법
# 1. 명시적 호출로 먼저 테스트
"Use the [스킬 이름] skill to [작업 내용]"
# 2. 자동 활성화 테스트 (description에 명시한 키워드 사용)
"[키워드1]을 사용해서 [작업 내용]"
# 3. Claude에게 직접 물어보기
"내 요청에 어떤 스킬이 적합해?"
문제 4: 복잡한 워크플로우에서 중간에 실패함
해결 전략
단계별로 쪼개서 실행: 한 번에 모든 것을 요청하지 말고, 단계별로 나눠서 각각 확인
"데이터 분석해서 XLSX 만들고 PPT 만들고 PDF로 저장해줘" ❌
"먼저 XLSX로 분석 결과 만들어줘" → 확인 → "이제 이걸로 PPT 만들어줘" ✅ 단계별로 요청
중간 결과 파일 저장: 각 단계마다 파일을 저장해서 문제 발생 시 복구 가능
타임아웃 대비: 복잡한 작업은 리소스를 많이 쓰므로 간단한 버전부터 테스트
에러 핸들링 명시: 스킬 내에 "파일이 없으면 사용자에게 요청" 같은 예외 처리 로직 추가
6. 마무리
워낙 최근에 나온 기능 중 중요하다고 생각되다보니 글이 너무 길어져서 여기까지 못오신 분들이 많을 것 같다.
너무 많은 정보가 쏟아지는 AI 시대에 다같이 힘내서 극복해 나가보자 .. ㅠㅠ
etc... 꼭 개발영역이 아니더라도 편하게 스킬을 만들어 써보기도 하고 있다. 재미로 보셔도 좋을 것 같다.
ex) 나의 경우 은퇴후 어떤 직업을 하나더 가지면 좋을지 고민이 많이 있다. 그리고 인테리어에 관심이 많다보니 다음과 같이 직업 탐구에 활용 하고 있다.
career-explorer 스킬을 사용해서 도배사가 되려면 어떤 준비과정이 필요하고 직업의 장단점이 궁금해 신중히 생각해줘 use sequntialThinking
도배사 직업 정보 제공을 위해 스킬 활용 계획 수립했습니다.
도배사 직업에 대해 자세히 알아보겠습니다. 먼저 career-explorer 스킬을 확인하겠습니다.
career-explorer 스킬 문서 읽기
도배사 직업 분석을 위해 체계적 프레임워크 구성했습니다.
네, 도배사 직업에 대해 신중하게 분석해드리겠습니다. 먼저 필요한 참고 자료들을 확인하겠습니다.
8 단계
도배사 직업 장단점 근무환경 힘든점
결과 10개
도배사 직업을 체계적으로 분석하고 준비과정, 장단점을 종합했습니다.
13초
수집한 정보를 바탕으로 도배사 직업에 대해 체계적으로 분석해드리겠습니다.
도배사 직업 완전 분석
📋 직업 개요
도배사는 건축물의 천장, 벽, 바닥, 창호 주위 등에 벽지와 장판지를 재단하고 풀 또는 접착제를 사용하여 부착하는 전문 기술자입니다. 공간의 미관과 기능성을 동시에 책임지는 인테리어 마감 전문가입니다.
주요 업무
시공 면적 측정 및 자재 산출
바탕 작업 (벽면 평탄화, 보수)
도배지 재단 및 풀질
초배지, 정배지 부착
마무리 작업 및 품질 확인
🎓 도배사가 되기 위한 준비 과정
1단계: 기초 학습 (1-2개월)
학원 교육 방식
속성반: 2주 과정, 시험 포인트 중심 (약 100-150만원)
기본반: 1-2개월, 기초부터 체계적 학습 (약 200-300만원)
주말반: 직장인 대상 2-3개월 과정
국비지원: 내일배움카드 활용 가능
현장 도제 방식
지물포(벽지 판매점)나 숙련공 밑에서 조공으로 시작
실전 경험 중심, 장기적으로 더 체계적 학습 가능
초기 수입은 적지만(일당 7-10만원) 중도 포기율 낮음
2단계: 자격증 취득 (선택사항)
도배기능사 자격증
시험 특징: 필기 없이 실기만 (3시간 작업형)
시험 일정: 연 4회 정기시험 (Q-net 확인)
응시료: 70,400원 (2024년 기준)
합격 기준: 100점 만점 중 60점 이상
필요성: 필수는 아니지만 관공서 공사, 신뢰도 상승, 취업 유리
3단계: 현장 경력 쌓기 (2-5년)
경력 발전 단계
조공 단계 (0-6개월): 일당 7-10만원
자재 운반, 벽면 청소, 기초 작업 보조
준기술자 (6개월-2년): 일당 12-18만원
기본 도배 작업 가능, 풀기계 다룰 수 있음
기술자 (2-3년 이상): 일당 20-25만원
독립 작업 가능, 복잡한 패턴 시공
숙련공 (5년 이상): 일당 25만원 이상
고난이도 작업, 팀 리더, 독립 영업 가능
💰 수입 현황 (2025년 기준)
경력별 월 수입 (월 20-22일 근무 기준)
초보 도배사: 월 200-250만원
3-5년차: 월 350-450만원
숙련공 (5년 이상): 월 500-600만원
독립 영업: 월 400-700만원 (실력과 영업력에 따라 변동)
⚠️ 현실적 고려사항
수입의 변동성
부동산 경기에 직접적 영향: 이사가 줄면 일감 급감
최근(2023-2024) 부동산 침체로 일감 감소
과거 월 20일 근무 → 현재 10-15일로 감소한 경우 많음
비수기(여름/겨울) vs 성수기(봄/가을) 수입 차이 큼
프로젝트별 단가 (참고)
아파트 1세대 (32평 기준): 80-150만원
작업 시간: 반나절~하루
하루 2-3건 소화 시 일당 40-50만원도 가능 (성수기)
🏢 근무 환경 및 조건
근무 시간
표준: 오전 8시 ~ 오후 5시 (점심 1시간)
실제: 작업량에 따라 오후 3-4시 종료도 가능
워라밸: 다른 건설 기술직 대비 양호한 편
주말: 대부분 휴무 (긴급 작업 제외)
물리적 환경
장점
실내 작업 위주 (날씨 영향 적음)
비교적 깨끗한 작업 환경
소음 수준 낮음
단점
팔, 어깨 사용 많아 체력 소모 큼
높은 곳 작업 시 안전사고 위험
무거운 자재 운반 (벽지, 풀 등)
좁은 공간, 먼지 발생
현장마다 이동 필요 (차량 필수)
고용 형태
프리랜서/일당제: 가장 일반적
월급제: 일부 인테리어 업체 (월 250-400만원)
독립 영업: 경력 쌓은 후 가능
4대 보험: 프리랜서는 개인 가입 필요
👍 도배사 직업의 장점
1. 빠른 기술 습득과 진입
2-3년이면 독립 가능한 숙련도 확보
다른 전문직 대비 짧은 준비 기간
학력 제한 없음
2. 정년이 없는 직업
체력만 받쳐준다면 60-70대까지 활동 가능
실제로 60-70대 현역 도배사 많음
3. 상대적으로 높은 수입
숙련되면 일반 사무직보다 높은 수입
개인 능력에 따라 수입 증대 가능
성수기엔 월 600만원 이상도 가능
4. 자유로운 근무 형태
프리랜서로 일정 조절 가능
조직 생활 스트레스 적음
실력 중심, 학벌/스펙 무관
5. 직업 만족도
눈에 보이는 성과물로 보람
손으로 만드는 일의 즐거움
창의적 디자인 감각 발휘 가능
👎 도배사 직업의 단점
1. 체력적 부담
하루 종일 팔을 들고 작업
무거운 자재 운반
높은 곳 작업으로 인한 피로
나이 들면 체력 한계 명확
2. 수입 불안정성
부동산 경기에 직접적 영향
비수기와 성수기 수입 차이 큼
일감 없으면 수입 제로
최근 부동산 침체로 일감 급감 (2023-2024)
3. 초기 진입 장벽
처음 1-2년은 낮은 수입 (월 150-250만원)
기술 습득 기간 필요
좋은 스승(반장) 만나는 것이 중요
4. 열악한 근로 환경
주휴수당, 연차 등 근로기준법 적용 어려움
현장 화장실, 휴게실 부족
일부 현장의 강압적 분위기
안전사고 위험
5. 사회적 인식
여전히 남아있는 '3D 직종' 편견
기술직에 대한 낮은 사회적 평가
가족, 지인들의 우려
📊 미래 전망
긍정적 요인
✅ 고령화로 인한 인력 부족
기존 도배사들의 평균 연령 상승
젊은 기술자 유입 부족
수요 대비 공급 부족으로 단가 상승 여지
✅ 리모델링 시장 성장
노후 아파트 증가로 리모델링 수요 지속
인테리어에 대한 관심 증가
✅ 절대 사라지지 않을 직업
AI/자동화 대체 어려움
손기술과 경험 중요
부정적 요인
⚠️ 신축 건설 감소
저출산, 고령화로 신규 주택 수요 감소
100% 이상 주택보급률
⚠️ 대체 공법 등장
친환경 페인트, 시트지 등 대체재 증가
고품질 벽지로 교체 주기 증가
⚠️ 부동산 경기 침체
최근 거래 감소로 일감 급감
전월세 시장 위축
종합 전망
"현 상태 유지 또는 소폭 감소" 수준으로 예상됩니다. 한국고용정보원에 따르면 2025년까지 연평균 0.7% 감소하여 약 5만 8,700명 수준이 될 것으로 전망됩니다.
✅ 이런 분께 추천합니다
적합한 성향
손으로 무언가 만드는 일을 좋아하는 사람
꼼꼼하고 섬세한 성격
체력이 좋고 건강한 사람
조직 생활보다 자유로운 근무 선호
단기간에 기술 습득하고 싶은 사람
부적합한 성향
체력이 약하거나 건강이 좋지 않은 사람
안정적이고 예측 가능한 수입 원하는 사람
높은 곳을 극도로 무서워하는 사람
사회적 인식에 민감한 사람
🎯 도배사 되기 위한 실전 액션 플랜
📅 단기 (1-3개월)
정보 수집 및 체험
도배 학원 방문 상담 (2-3곳 비교)
현역 도배사 인터뷰 (지인 찾기)
유튜브 도배 영상 시청
도배 도구, 자재 가격 조사
기초 체력 준비
팔, 어깨 근력 운동 시작
기초 체력 관리
경제적 준비
초기 6개월~1년 생활비 확보
도구 구입 비용 준비 (50-100만원)
📅 중기 (3-12개월)
교육 이수
도배 학원 등록 (국비지원 활용)
도배기능사 자격증 취득 도전
현장 투입
학원 연계 또는 직접 구직
조공으로 시작, 실전 경험 쌓기
좋은 스승(반장) 만나기 위해 노력
차량 준비
중고차라도 필수 (자재, 도구 운반)
📅 장기 (1-3년)
기술 숙련
다양한 벽지 종류, 패턴 익히기
문제 해결 능력 키우기
속도와 품질 동시 향상
네트워크 구축
인테리어 업체와 관계 형성
고객 확보 (입소문, SNS 활용)
독립 준비
3년 이상 경력 쌓은 후 독립 검토
영업 능력, 견적 능력 키우기
💡 현직자 조언
"자격증은 출발선, 현장이 진짜 학교"
자격증만으로는 바로 일하기 어려움
최소 2년 경력 필요
"체력 관리가 생명"
스트레칭, 근력 운동 필수
몸이 자본인 직업
"좋은 반장 만나는 게 중요"
기술과 일당이 스승에 따라 천차만별
인간관계, 배움의 속도 모두 영향
"부동산 경기 체크는 필수"
최근처럼 경기 나쁠 때는 진입 신중히
일감 확보가 수입 좌우
🎓 종합 평가
진입 난이도: ⭐⭐☆☆☆ (중하)
학력 제한 없고 빠른 습득 가능하나, 초기 낮은 수입과 체력 요구
수입 수준: ⭐⭐⭐⭐☆ (중상)
숙련되면 높은 수입, 하지만 변동성 큼
워라밸: ⭐⭐⭐⭐☆ (상)
다른 건설직 대비 양호, 주말 대부분 휴무
직업 안정성: ⭐⭐⭐☆☆ (중)
부동산 경기 영향 큼, 장기 전망 불확실
사회적 인식: ⭐⭐☆☆☆ (하)
여전히 편견 존재, 하지만 개선 중
발전 가능성: ⭐⭐⭐☆☆ (중)
독립, 창업 가능하나 시장 성장 제한적
도배사는 빠르게 기술을 습득하고 자유롭게 일하며 적정한 수입을 원하는 사람에게 좋은 선택이 될 수 있습니다. 하지만 체력적 부담과 수입 변동성, 현재의 부동산 경기 침체를 신중히 고려해야 합니다.
최근 20-30대 청년들 사이에서 도배사에 대한 관심이 높아지고 있지만, 미디어에 나온 성공 사례만 보고 결정하기보다는 실제 현장을 체험해보고 현실적인 판단을 하시길 권장합니다. 🔨
자주 묻는 질문 ❓
Q: Skills는 무료 플랜에서도 사용할 수 있나요?
A: 아니요. Skills는 Pro 플랜 이상에서만 사용 가능합니다. 무료 플랜에서는 기본 Chat 기능만 사용할 수 있습니다.
Q: Document Skills는 어디서 활성화하나요?
A: Document Skills 4개(DOCX, PDF, PPTX, XLSX)는 document-skills 플러그인을 설치하면 사용할 수 있습니다. Claude Code에서는 /plugin install document-skills@anthropic-agent-skills 명령으로 설치하고, Claude.ai에서는 Settings > Capabilities에서 활성화할 수 있습니다. 단, Document Skills는 point-in-time snapshots이며 프로덕션 사용 전 철저한 테스트가 필요합니다.
Q: Example Skills는 어떻게 사용하나요?
A: Example Skills 11개는 example-skills 플러그인에 포함되어 있습니다. Claude Code에서는 /plugin install example-skills@anthropic-agent-skills 명령으로 설치할 수 있습니다. 또는 GitHub (anthropics/skills)에서 직접 다운로드하여 ~/.claude/skills/ 또는 .claude/skills/ 디렉토리에 배치할 수도 있습니다.
Q: 커스텀 스킬을 만들 때 가장 중요한 부분은?
A: 프론트매터의 description입니다. Claude는 이것을 보고 "이 스킬을 로딩할지 말지"를 판단합니다. 명확하고 구체적으로 작성해야 합니다. 예: "마케팅 캠페인 데이터를 분석하고 경영진용 보고서를 생성하는 스킬"
Q: Skills와 프로젝트 시스템 프롬프트의 차이는?
A: 프로젝트 시스템 프롬프트는 해당 프로젝트에서만 유효하지만, Skills는 프로젝트 독립적입니다. 또한 여러 스킬을 동시에 조합할 수 있고, 점진적 로딩으로 컨텍스트를 효율적으로 사용합니다.
Q: MCP 없이 Skills만 써도 되나요?
A: 네, 가능합니다. 문서 작업(엑셀, PPT, PDF)은 Skills만으로도 충분합니다. 하지만 외부 API나 데이터베이스 연동이 필요하다면 MCP를 함께 사용하는 것이 좋습니다.
Q: Skills를 ZIP으로 압축해서 공유할 수 있나요?
A: 네! 스킬 폴더를 ZIP으로 압축해서 "Settings > Features > Upload Skill" 메뉴에서 업로드할 수 있습니다. 팀원들과 스킬을 공유할 때 유용합니다.
