Windsurf Skills가 뭔지 처음 봤을 때 생긴 의문

Windsurf를 쓰다 보면 Cascade 패널 오른쪽 위에 점 세 개 메뉴가 있고, 거기에 Skills 항목이 있습니다. 2026년 1월 공식 지원이 시작됐는데, “이게 Rules랑 뭐가 다르지?”라는 의문이 먼저 들었습니다.

결론부터 말씀드리면, Skills는 AI가 알아서 꺼내 쓰는 다단계 절차 묶음입니다. 단순한 행동 지침(Rules)이나 수동으로 부르는 템플릿(Workflows)과 다르게, 대화 맥락을 보고 Cascade가 스스로 판단해서 불러옵니다. 배포 스크립트, 코드 리뷰 체크리스트, 테스트 절차처럼 여러 파일과 단계가 얽힌 작업에 쓰기 좋습니다.

한국어로 정리된 글이 없어서 직접 공식 문서(docs.windsurf.com/windsurf/cascade/skills)를 읽고 실제로 만들어보면서 적었습니다. 중간에 3월 19일 요금 개편도 Skills 활용 방식에 영향을 줘서 그 부분도 같이 다룹니다.

▲ 목차로 돌아가기

자동 호출 구조 — 공식 문서에 딱 이렇게 나옵니다

대부분의 사람들이 Skills를 “프롬프트에 붙이는 추가 지시문” 정도로 생각합니다. 실제는 다릅니다. Skills는 progressive disclosure 방식으로 작동합니다. 공식 문서에는 이렇게 나옵니다.

“only the skills name and description are shown to the model by default. The full SKILL.md content and supporting files are loaded only when Cascade decides to invoke the skill“
(출처: docs.windsurf.com/windsurf/cascade/skills, 2026.03.22 기준)

즉, Skills 파일이 10개 있어도 평소엔 이름과 설명 한 줄만 컨텍스트 창에 올라갑니다. Cascade가 “지금 이 요청에 이 Skill이 필요하다”고 판단하는 순간에만 전체 내용이 로드됩니다. 덕분에 여러 개의 Skills를 만들어도 컨텍스트 창이 낭비되지 않습니다.

수동으로 부를 수도 있습니다. Cascade 입력창에 @skill-name 형식으로 직접 호출하면 됩니다. 자동 호출이 확실하지 않은 상황에서 쓰기 좋습니다.

▲ 목차로 돌아가기

Skills 만드는 법 — 폴더 하나면 됩니다

공식 문서 기준으로 Skills를 만드는 방법은 두 가지입니다. UI에서 만들거나, 폴더를 직접 만드는 방법입니다.

UI에서 만들기 (가장 쉬운 방법)

1. Cascade 패널 오른쪽 위 점 세 개(⋯) 클릭
2. 커스터마이제이션 메뉴에서 Skills 클릭
3. + Workspace(현재 프로젝트 전용) 또는 + Global(모든 프로젝트 공통) 선택
4. 이름 입력 — 영소문자·숫자·하이픈만 가능 (예: deploy-to-staging)

폴더 직접 생성

스코프에 따라 경로가 다릅니다.

폴더 안에 SKILL.md 파일을 만들고, YAML 프론트매터에 name과 description을 반드시 적어야 합니다. description을 얼마나 잘 쓰느냐가 자동 호출 품질을 결정합니다. Cascade는 이 설명을 보고 “지금 이 Skill을 써야 하나” 판단하기 때문입니다.

---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables

지원 파일(체크리스트, 스크립트, 설정 템플릿 등)은 같은 폴더 안에 자유롭게 넣을 수 있습니다. Skill이 호출될 때 같이 로드됩니다.

▲ 목차로 돌아가기

Skills·Rules·Workflows 세 가지, 어떻게 다른가

Windsurf에는 Cascade 동작을 커스터마이징하는 방법이 세 가지 있습니다. Skills만 있는 줄 알고 쓰다 보면 Rules나 Workflows가 더 맞는 상황도 있어서 미리 알아두면 좋습니다.

공식 문서에 나온 판단 기준은 간단합니다. “Cascade가 자동으로 집어야 하고 지원 파일이 필요하다면 Skills, 짧은 행동 제약이라면 Rules, 직접 실행하고 싶다면 Workflows”입니다. (출처: docs.windsurf.com/windsurf/cascade/skills, 2026.03.22 기준)

▲ 목차로 돌아가기

3월 19일 요금 개편이 Skills 활용에 불리한 진짜 이유

Windsurf가 2026년 3월 18일 공식 발표한 요금 개편은 Skills를 적극적으로 쓰는 사람에게 특히 주의가 필요한 변화입니다. 바뀐 핵심은 월별 크레딧 제도 폐지 → 일·주간 쿼터 제도 전환입니다. (출처: windsurf.com 공식 발표, 2026.03.18)

Skills가 자동 호출될 때 Cascade는 SKILL.md 전체와 지원 파일을 로드하는데, 이 과정에서 토큰 소비가 일반 대화보다 많습니다. 배포 스크립트나 코드 리뷰 체크리스트처럼 파일이 붙은 Skills는 한 세션에서 여러 번 호출되면 쿼터 소진 속도가 빨라집니다.

Reddit r/windsurf 스레드(2026.03.18, 257개 댓글)에서 사용자 반응을 확인하니, 가장 많은 지지를 받은 댓글은 “크레딧 시스템이 Windsurf의 유일한 경쟁 우위였는데 스스로 없앴다”는 내용이었습니다. Cursor에서 넘어온 사용자들이 직접 비용 비교를 남겼는데, 주말에 몰아서 쓰는 패턴이라면 일·주간 한도에 걸릴 가능성이 높다는 지적이 반복됐습니다.

▲ 목차로 돌아가기

실제로 쓸 때 막히는 부분 — 공식 문서가 말하지 않은 것들

공식 문서가 구조를 잘 설명하지만, 실사용에서 생기는 문제는 다로 있습니다. 직접 확인하거나 커뮤니티 사례에서 반복적으로 나온 부분을 정리했습니다.

① description 설계가 자동 호출 품질을 결정합니다

Cascade는 description을 보고 호출 여부를 결정합니다. description이 너무 짧거나(“배포용”), 너무 광범위하면(“코드 관련 모든 작업”) 엉뚱한 시점에 호출되거나 아예 호출되지 않습니다. 공식 문서가 권장하는 방식은 “이 Skill이 무엇을 하고 언제 써야 하는지”를 한 문장으로 담는 것입니다.

② Workspace Skills는 Git에 올라갑니다

.windsurf/skills/ 경로에 만든 Skills는 리포지토리에 커밋됩니다. 팀 프로젝트에서 표준 배포 절차를 공유하기 좋지만, 개인 API 키나 민감한 환경 변수를 지원 파일에 넣으면 그대로 Git에 올라갑니다. 민감한 내용은 Global Skill로 분리하거나 .gitignore를 설정해야 합니다.

③ 컨텍스트 창 한도 표시기가 Wave 13에 추가됐습니다

2026년 3월 Wave 13 업데이트에서 컨텍스트 창 사용량 시각 표시가 추가됐습니다. 공식 changelog에는 “earlier context can be dropped without warning and performance can degrade”라고 나옵니다. (출처: windsurf.com/changelog, Wave 13) Skills가 많이 호출된 세션에서 컨텍스트가 차면 앞부분이 잘릴 수 있습니다. 표시기가 높아지면 새 세션을 여는 게 낫습니다.

④ Enterprise System Skills는 읽기 전용입니다

기업 환경에서 IT 부서가 배포한 System Skills는 사용자가 수정할 수 없습니다. macOS는 /Library/Application Support/Windsurf/skills/, Windows는 C:\ProgramData\Windsurf\skills\ 경로입니다. 같은 이름의 Workspace Skills를 만들어도 System Skills와 충돌하지 않는다는 이유는 공식 문서에서 별도로 밝히지 않았습니다.

▲ 목차로 돌아가기

자주 묻는 질문 (Q&A)

▲ 목차로 돌아가기

마치며

Windsurf Skills는 생각보다 실용적인 기능입니다. 복잡한 배포 절차, 팀 코드 리뷰 체크리스트, 테스트 실행 순서처럼 매번 설명하기 번거로운 작업을 한 번 정의해 두면 Cascade가 알아서 꺼내 씁니다. 컨텍스트 창도 아낍니다.

다만 3월 19일 요금 개편 이후 쿼터 설계는 좀 더 신경 써야 합니다. 특히 Skills의 description을 광범위하게 쓰면 불필요한 호출이 잦아지고 쿼터가 빨리 닳습니다. 일·주간 한도에 걸리기 쉬운 몰아쓰기 패턴이라면 요금 구조 변화가 체감될 수 있습니다.

Windsurf가 Cognition에 인수된 뒤 Devin과의 통합이 예고됐지만, 2026년 3월 현재 두 제품은 별도로 운영 중입니다. Skills 기능이 앞으로 어떻게 발전할지 지켜볼 만합니다. 서비스 업데이트로 이 글의 내용이 달라질 수 있으니 공식 문서를 같이 확인하는 걸 권장합니다.

▲ 목차로 돌아가기

본 포스팅 참고 자료

1. Cascade Skills 공식 문서 — docs.windsurf.com
2. Windsurf Editor Changelog (Wave 13 포함) — windsurf.com
3. Windsurf Workflows 공식 문서 — docs.windsurf.com
4. Windsurf 요금 개편 공식 발표 및 Reddit 사용자 반응 (2026.03.18)
5. Cursor vs Windsurf vs Claude Code 2026 비교 — DEV Community