Santiago Valdarrama가 Claude Code로 한 일 — "2침실 매물 50개를 5개 사이트에서 한 번에 긁어 정리된 스프레드시트로 받았다." 코드 한 줄 안 짰다.
비결은 Skill이라는 새 형식이다. Claude Code에 markdown 파일 한 장만 넣으면 "웹에서 라이브 데이터 긁기"가 자동 능력이 된다. 2026년 봄 들어 Claude·ChatGPT·Gemini가 동시에 채택한 패턴인데, 진짜 효용은 코딩 도구로 쓸 때 나온다.
이게 뭔데?
Claude Code Skill은 YAML 프론트매터 + markdown 본문으로 된 파일 하나다. 파일 위치는 ~/.claude/skills/{이름}/SKILL.md. Claude는 사용자 요청을 듣고 description 필드를 보고 자동으로 어떤 Skill을 쓸지 결정한다. 사용자가 "/web-scrape" 같은 명령을 입력하지 않아도 된다 — 컨텍스트로 트리거된다.
Santiago의 LinkedIn 포스트가 화제가 된 이유는 단순하다. "You can use Claude Code to pull live, structured data from any website... organized in tables you can work with immediately. Not a wall of text." 그가 든 예시 — 특정 지역 2침실 매물, 48시간 내 등록, 가격·면적 추출, 여러 플랫폼 정규화. 이걸 하나의 자연어 요청으로 처리한다.
이게 Cursor·Windsurf 같은 IDE 기반 도구와 다른 지점이다. Skill은 도구 호출의 추상화 단위다. 한 번 SKILL.md를 짜두면 그 능력이 모든 프로젝트에서 자동으로 가용해진다. 매번 프롬프트에 같은 지시사항을 붙여넣을 필요가 없어진다는 의미다.
- SKILL.md 구조
YAML 프론트매터 (name, description, allowed-tools) + markdown 본문 (워크플로우 설명). - description 필드가 핵심
Claude가 이 한 문장으로 트리거 여부를 결정한다. "Use when user asks for live web data extraction" 같은 구체 표현 필요. - 도구 명시
Firecrawl·Nimble·Zyte 같은 외부 API를 allowed-tools에 명시. 인증 키는 환경변수. - 출력 포맷 지시
"항상 markdown 테이블로 반환" 같은 결정론적 지시를 본문에 박아둔다.
Cursor로 하던 거랑 뭐가 다른데?
| 접근 | Cursor / 일반 IDE | Claude Code Skill |
|---|---|---|
| 능력 지속성 | 프로젝트마다 프롬프트 재작성 | SKILL.md 1회 작성 → 모든 곳에서 작동 |
| 트리거 | 슬래시 명령·명시 호출 | 컨텍스트 자동 매칭 |
| 출력 | Markdown 텍스트 | 구조화 데이터 (JSON·CSV·테이블) |
| 외부 API 연결 | 매 호출마다 키 주입 | SKILL.md에 1회 명시 |
| 공유 | 코드베이스 종속 | 파일 1개로 팀에 배포 |
Zyte도 같은 문법으로 Claude Skill을 출시했다 — HTML fetching → AI parsing → selector generation → structured extraction까지 4단계가 한 Skill 안에 들어 있다. Firecrawl도 SKILL 작성 튜토리얼을 공식 블로그에 올렸다. Nimble은 Santiago가 추천한 "10/10" 도구로 평가받았다.
중요한 건 이게 "스크래핑 자동화"가 아니라 "능력의 패키징"이라는 점이다. 같은 패턴으로 — DB 쿼리, PDF 파싱, API 통합, 회의록 정리 — 어떤 반복 작업이든 SKILL.md로 추출 가능하다.
핵심만 정리: 시작하는 법
- Claude Code 최신 버전 확인
Skill은 Claude Code 1.0+ 필수.claude --version로 확인. - Skill 디렉토리 생성
mkdir -p ~/.claude/skills/web-scraper. 이름은 케밥-케이스. - SKILL.md 작성
YAML 프론트매터에 name·description·allowed-tools (curl·Firecrawl 등). 본문에 워크플로우 단계 명시. - 외부 도구 등록
Firecrawl·Nimble 같은 API 키를.env에 넣고 SKILL.md에서 참조.FIRECRAWL_API_KEY환경변수 권장. - 자연어로 호출
"Get all 2-bedroom apartments posted in last 48h in [지역]" 같은 한 줄 요청. Claude가 SKILL을 자동 트리거.
자주 묻는 질문
(FAQSection 자동 렌더링 — content에는 포함하지 않음)
