Skill vs Rule · 3단계 로딩 · SKILL.md · 6단계 Runbook · Mac 7×24
Cursor에서 매번 “PR 생성 + 테스트 + CHANGELOG 업데이트” 긴 프롬프트를 붙여 넣고 계신가요? Agent Skill은 복잡한 흐름을 재사용 가능한 Runbook으로 정리하고, Rule과 역할을 나누며 3단계 점진 로딩으로 2026년 Agent를 일회성 채팅이 아닌 SOP를 갖춘 동료처럼 동작하게 합니다. 본문은 Skill vs Rule 비교, SKILL.md 구조, agentskills.io 생태계(커뮤니티 스킬 31,000+), 6단계 Runbook으로 첫 Skill을 만드는 방법, Mac Mini M4 월 대여로 7×24 Agent·Skill 복리를 지원하는 구성을 다룹니다.
2024-2025년 'AI 코딩 조수'는 본질적으로 대화형 보완으로 매번 컨텍스트, 제약 및 절차를 다시 설명해야 했습니다. 2026년 Cursor Agent(2.4 이후 Skills 강화)는 작업 완료로: 리포지토리를 읽고, 여러 파일을 변경하고, 도구를 불러, 팀 규약대로 납품합니다. 지식은 채팅 기록에만 국한되지 않으며 버전 관리 가능한 Skill 패키지로 외부에 배치해야 합니다.
Agent Skill은 .cursor/skills/ 또는 사용자급 ~/.cursor/skills/ 아래 폴더입니다. 핵심은 SKILL.md(YAML frontmatter + Markdown 본문)이며, scripts/, references/, 템플릿, 체크리스트를 붙일 수 있습니다. Agent는 발견 단계에서 name·description만 읽고, 작업이 맞으면 활성화해 전문과 필요한 부속 파일을 온디맨드로 로드합니다. 50페이지 Runbook을 한꺼번에 Context에 넣지 마세요.
.cursor/rules에서 "댓글 금지", "pnpm 필수"라고 쓰는 경우 전체 가드 레일입니다. 동일한 '릴리스 + 코드 리뷰 + 문서 업데이트'가 주 3회 반복되면 Rule을 계속 늘리면 매회 대화에서 토큰을 많이 지불하여 동료들과 공유하기 어려워집니다. Skill은 플로우 재사용이고 Rule은 행동 경계——다음 절의 표에서 대조됩니다.
긴 프롬프트는 버전 관리할 수 없습니다. 좋은 지침은 Notion 등에 흩어져 있고 Agent는 읽을 수 없습니다. 한 곳의 변경이 팀 전체에 닿지 않는다.
컨텍스트 팽창:Runbook 전문을 대화에 붙이면 코드와 diff의 여지를 빼앗아 긴 태스크가 도중에 끊어진다.
트리거 불안정:구조화된 description 라우팅 절이 없으며 어떤 매뉴얼을 열어야 하는지 Agent가 결정할 수 없습니다.
단계적으로 공개할 수 없음: 긴 스크립트와 API 문서가 상주하며 간단한 하위 작업에서도 전체 토큰을 지불합니다.
팀에서 재사용할 수 없음: 개인 채팅의 성공 경험을 Git처럼 검토 및 병합 롤백할 수 없습니다.
Rule은 앞유리에 붙인 교통 규칙; Skill은 차재 매뉴얼——고장 개소까지 모든 페이지를 넘길 필요는 없다.
Cursor Rules(.cursor/rules/*.mdc 또는 프로젝트 Rules)는 세션 시작 시 항상 또는 glob으로 주입되어 코딩 스타일, 보안 레드라인, 리포지토리 구조 규약을 다룹니다. Agent Skills는 agentskills.io 개방형 표준(2025년 이후 다중 도구 상호 인증)을 따르며, 기본적으로 온디맨드 3단계 로드입니다. 다단계 워크플로, 도메인 지식, 실행 스크립트에 적합합니다.
| 관점 | Rule | Agent Skill |
|---|---|---|
| 로드 타이밍 | 세션 시작 또는 경로 일치 시 주입 | 발견 → 활성화 → references/scripts 주문형 |
| 전형 장면 | 코멘트 금지, 커밋 규칙, 프레임워크 선택 | PR 생성, 배포 확인, 도메인 API 연계, /slash 워크플로 |
| 컨텍스트 점유 | 상주. 조수가 많으면 지속적으로 점유 | 미트리거시는 metadata 만. 트리거 후 단계 전개 |
| 비유 | 직원 핸드북/컴플라이언스 조항 | 역할 SOP + 도구 상자(스크립트, 템플릿, 외부 문서) |
references/에 두고 온디맨드로 읽습니다.scripts/validate.sh를 호출하고 결과를 대화에 반환합니다.커뮤니티에는 create-hook, create-rule, babysit(PR 병합 및 CI), split-to-prs 등의 공식/준공식 Skill이 있습니다. MCP와의 관계: MCP가 외부 시스템에 연결되고 Skill이 Agent에 언제/어떤 순서로도구를 사용할지 가르치는——병용이며 배타적이지 않습니다.
다음은 Cursor 2.4+에서 확인되었습니다. 내장 /create-skill 로 골격을 생성하고 팀 규약에 맞게 수렴시킵니다. 목표는 "3 번째로 마침내 작성한 Prompt"를 리포지토리에서 검토 가능한 폴더로 만드는 것입니다.
Agent 대화에서 /create-skill 입력: 작업 유형, 트리거어, 입출력, 금기 사항을 적고 초판 SKILL.md와 디렉터리 트리를 생성합니다.
스코프 선택: 프로젝트급 .cursor/skills/<skill-name>/는 Git으로 공유합니다. 개인급 ~/.cursor/skills/는 여러 리포지토리 공통 습관용입니다(비밀키는 커밋하지 않음).
frontmatter description 작성: 요약이 아니라 라우팅 키입니다. “USE when user asks to …”, “DO NOT use for …”처럼 발견 단계 매칭 정확도를 높입니다.
본문은 단계적 공개: 핵심 절차는 SKILL.md에 두고, 긴 문서·OpenAPI·샘플 JSON은 references/, 스크립트는 scripts/에 둡니다.
트리거 테스트: 정례 prompt 3건(활성화되어야 함)과 반례 2건(활성화되지 않아야 함)을 새 세션에서 검증하고, Context에 필요한 파일만 로드되는지 확인합니다.
이전 자산 마이그레이션: 비대한 Rules나 일회성 Commands는 /migrate-to-skills(또는 수동 분할)로 Skill로 옮기고, Rule에는 짧은 레드라인만 남깁니다.
--- name: release-pr-runbook description: USE when the user asks to open a release PR, ship a version bump, or run the pre-merge checklist. DO NOT use for hotfix without changelog or for dependency-only bumps. --- # Release PR Runbook ## Gather - Read package.json version and recent git tags. - List open PRs targeting main. ## Act - Bump version per semver. - Update CHANGELOG.md with user-facing bullets. ## Verify - Run test suite and lint. - Confirm CI green before requesting review.
| 경로/필드 | 역할 |
|---|---|
SKILL.md | 필수. frontmatter + 주 Runbook(< 500 줄 권장) |
name | 소문자 하이픈 ID입니다. 폴더 이름과 일치 |
description | 트리거 라우팅 절입니다. USE when / DO NOT 포함 |
scripts/ | 실행 가능한 검증 생성기. 에이전트가 주문형 호출 |
references/ | 장문 문서, API 설명. 활성화 후 읽기 |
assets/ | 템플릿, 다이어그램, 샘플 설정(선택 사항) |
Cursor의 Skills 구현은 agentskills.io 와 일치하며 다음 세 단계로 구성할 수 있습니다. token 청구와 안정성에 직접 연결합니다.
발견(Discovery): 시작·스캔 시 각 Skill의 name + description만(Skill당 수십 token 수준) 로드해 “사용 가능 매뉴얼 목록”을 만듭니다.
활성화(Activation): 사용자 의도 또는 키워드가 맞으면 SKILL.md 전문을 주입합니다(보통 수백~수천 token).
온디맨드(On-demand): 본문 링크가 references/*.md를 가리키거나 scripts/*를 호출할 때만 로드·실행합니다. “두꺼운 책을 매번 펼치지” 않습니다.
Skill 디자인에서는 결정 트리를 본문 전반에(앞으로 장면 A/B를 판정), 두꺼운 자료는 references에. 스크립트 출력이 큰 경우 Skill이 Agent에 중요한 행만 요약하고 반환하도록 요청하고 전체 텍스트를 Context에 붙여 넣지 않습니다.
포인트:description을 마케팅 요약과 같이 작성하면 잘못된 트리거가 증가합니다. 라우팅 규칙(조건 + 제외)으로 작성하면 처음으로 L1의 가치가 나옵니다. 공식 create-skill 는 트리거어를 반복해서 듣는다——시간을 걸리는 가치가 있습니다.
고품질 Skill은 네 가지 원칙을 따릅니다. description 루트, 단계적 공개, 단일 책임(1 Skill 1 작업 유형), gather-act-verify의 3단 구성. Rule과 겹치지 않음——Rule은 "테스트 필수", Skill은 "본 리포지토리에서 통합 테스트를 돌려 실패 로그를 읽는 절차".
| Skill / 방향 | 향하는 장면 | 요점 |
|---|---|---|
| Prompt Lookup | 중복 Prompt 최적화, 커뮤니티 템플리 대조 | 바퀴의 재발명을 줄이고 설명 형식을 정렬 |
| React Best Practices | 컴포넌트, RSC, 성능 및 a11y | Vercel/팀 약관을 수동으로 외치 |
| babysit / PR skill | PR 코멘트, CI 실패, 병합 충돌 | GitHub CLI, CI 로그와 협력 |
| create-rule / create-skill | Cursor 설정 자체의 거버넌스 | 메타 Skill. 팀의 발판을 통일 |
| sdk | Cursor SDK / Agent API 통합 | 백엔드 및 파이프라인에서 Agent를 프로그램 호출 |
| loop | 정시 순찰, cron형 Agent | 안정 호스트 7×24가 필요. 6절 참조 |
SKILL.md입니다. /create-skill, /migrate-to-skills를 기본 워크플로에 포함합니다.description 은 기사 요약이 아니라 라우팅 술어——공식 문서와 create-skill 가이드가 강조. 주의: 비공개 키나 고객 PII를 description에 쓰지 않는다(L1에서 항상 볼 수 있음). 스크립트는 환경 변수를 사용한다. references/ 의 기밀 부록은 gitignore 하고, Skill 본문으로 취득 방법을 설명한다.
스킬 생태계는 단일 IDE로 닫히지 않습니다. agentskills.io는 표준, 검증 아이디어 및 색인 입구를 제공하며 팀은 내부 Skill을 하위 모듈화하고 게시할 수 있습니다(내부 npm에 가깝습니다). 개인 개발자의 현실적인 루트는 커뮤니티에서 가까운 Skill을 fork → description 과 references/ 를 조정 → PR 로 diff 를 review 입니다.
Skill이 “코딩 보조”에서 7×24 자동화로 확장되면 /loop 정시 저장소 스캔, Telegram/Slack의 /mac-quote 견적 흐름, 서버 측 Cursor SDK 상주 Agent 등 호스트 선택이 Skill 복리를 좌우합니다.
~/.cursor/skills (을)를 「조직 기억」으로서 장기 기르는 팀용. 일반 구성: 매월 Mac에서 프로젝트 clone 및 Skills 리포지토리 submodule을 고정하고 merge 후 Hook에서 scripts/verify.sh를 자동 실행합니다. IM Bot은 의도적인 배송만, 중복 처리는 Mac에서 Skill 실행——Hermes Gateway 7×24, 영구 메모리와 동일한 "Agent 인프라"사상에서 Cursor Skills는 일상 IDE 워크플로에 가깝습니다.
노트북·저가 VPS는 Skill 작성·단발 검증에는 충분하지만, 슬립·macOS 네이티브 자동화 부재·~/.cursor 장기 상주 약화로 7×24 체감이 떨어집니다. 순 API Skill은 클라우드에서도 되지만 Runbook이 로컬 스크립트·Keychain·Apple 도구에 의존하면 이전 비용이 큽니다. Agent Skill을 “상주 동료”로 두고 트리거 곡선·token 절약을 주 단위로 누적하려면 VpsMesh Mac Mini M4 클라우드 임대가 uptime·원격 KVM·고정 월 비용을 예측 가능 OpEx로 묶어 줍니다. 요금은 Mac Mini M4 렌탈 요금, 문의는 고객 센터, 신청은 주문 페이지에서 확인하세요.
MCP(Model Context Protocol)는 외부 세계에 대한 연결 계층입니다. 데이터베이스, GitHub API, 브라우저 및 내부 마이크로서비스를 서버를 통해 tools/resources로 게시합니다. Agent Skill은 MCP를 대체하지 않으며 Markdown의 Runbook으로 어떤 작업에서 먼저 무엇을 gather하고 어떤 MCP 도구를 어떤 순서로 호출하고 어떻게 verify할지 지정합니다. 비록 : MCP는 콘센트와 케이블이고 Skill은 장비 설명서의 시작 절차입니다.
'코드를 작성할 때마다 보호' 짧은 규칙은 Rule(코멘트 금지, 지정 패키지 관리자 필수 등)입니다. '가끔 실행하고, 절차가 많고, 스크립트와 부록이 필요하다' 흐름은 Skill. 경험칙: 같은 긴 Prompt가 세 번째로 나오면 /create-skill 로 Skill 화. Rule의 총 수는 적고 L0에서 세션이 채워지지 않도록합니다. 비대 Rule의 흐름 부분은 /migrate-to-skills에서 Skill로 옮길 수 있습니다.
필수가 아닙니다. 순 클라우드 API, macOS 독립적인 Skill은 Linux VPS에서 Cursor CLI/SDK에서 예약할 수 있습니다. Apple 에코 자동화, 로컬 Keychain, ~/.cursor/skills를 Gateway와 마찬가지로 뚜껑 닫아서 멈추고 싶지 않다면 Mac Mini M4 월 금액이 편리합니다. 먼저 한 달 임대에서 트리거 및 토큰 곡선을 확인하십시오. 요금은 Mac Mini M4 렌탈 요금, 신청은 주문 페이지입니다.