Skill과 MCP의 차이는?

MCP는 외부 API·도구 호출 프로토콜입니다. Skill은 Agent에게 언제·어떤 순서로 쓸지 알려 주는 운영 매뉴얼이며 서로 보완합니다.

Skill과 Rule은 어디에 두나?

코드 스타일·네이밍 등 지속 규칙은 Rule에, 다단계 배포·PR·보안 감사 등 복잡한 흐름은 Skill에 두고 필요할 때만 로드해 컨텍스트를 절약합니다.

Agent 게이트웨이를 원격 Mac에 두는 이유는?

노트북 절전·덮개·가정용 회선 변동으로 OpenClaw/Hermes가 끊깁니다. 7×24 원격 macOS에서는 launchd 상시 실행과 안정적인 아웃바운드를 기대할 수 있습니다.

2026 Cursor Agent Skill 완전 가이드: SKILL.md 작성, 트리거 라우팅과 원격 Mac 7×24 의사결정 매트릭스

새 대화마다 「테스트 통과 후 커밋, 프로덕션은 이중 확인」을 붙여 넣는다면 Agent Skill이 필요한 시점입니다. 2026년 Cursor·Claude Code·OpenClaw는 모두 agentskills.io 오픈 표준을 따르며, SKILL.md로 반복 가능한 절차를 필요 시에만 읽는 「운영 매뉴얼」로 캡슐화합니다. 본문은 Skill vs Rule 매트릭스, 3단계 로드, 5단계 생성, 7×24 Agent 게이트웨이를 원격 Mac에 두는 이유를 다룹니다.

1. 세 가지 고통: Prompt 반복, 컨텍스트 비대, 절차 미전승

AI 코딩 도우미는 「채팅」에서 「저장소 수정·API 호출」 Agent로 진화했습니다. 팀이 커질수록 다음 마찰이 늘어납니다.

반복 노동: 구성원마다 배포 체크리스트를 대화에 다시 쓰고, 모델·대화를 바꾸면 사라집니다.
컨텍스트 고갈: 운영 매뉴얼 전체를 시스템 프롬프트에 넣어 실제 코드용 토큰이 줄어듭니다.
버전 관리 불가 지식: 구두 규칙은 리뷰할 수 없고 온보딩이 인맥에 의존합니다.

Skill은 적절한 순간에 자동 로드되는 Runbook으로, Rule의 상시 점유나 일회성 Prompt와 다릅니다.

2. Skill vs Rule: 로드 시점 비교

관점	Rule(규칙)	Skill(스킬)
로드 시점	세션 내내 유효	관련 작업 시에만
전형 내용	네이밍, force push 금지, Git 안전	배포 파이프라인, PR, 감사, OpenClaw doctor 단계
컨텍스트 비용	고정 점유	활성화 시만. 스크립트는 출력만 반환 가능
팀 비유	온보딩 안내	릴리스 매니저 Runbook
MCP	외부 API 직접 호출 안 함	「언제 어떤 MCP 체인을 쓸지」 편성 가능

3. 디렉터리 구조와 SKILL.md 규격

프로젝트 Skill은 .cursor/skills/(Cursor) 또는 .agents/skills/(Claude Code·Gemini CLI 공통)에 둡니다. Skill당 폴더 하나, 핵심은 SKILL.md입니다.

.cursor/skills/deploy-staging/
├── SKILL.md          # 필수: frontmatter + 지시
├── scripts/          # 선택: 실행 스크립트
│   └── validate.py
├── references/       # 선택: 긴 문서는 필요 시
└── assets/           # 선택: 템플릿·설정 예시

frontmatter 필수: name, description(라우팅 키). 선택: paths, disable-model-invocation(/skill-name 수동).

4. 3단계 로드: 발견 → 활성화 → references/scripts

트리거: 자동, /skill-name, @skill. Monorepo는 하위에 .cursor/skills/ 중첩 가능.

5. 5단계로 첫 Skill 만들기

단일 책임: 「staging 배포」까지. 넓은 운영은 Skill을 나눠 조합합니다.
폴더와 SKILL.md: Cursor 2.4+에서는 /create-skill로 골격 생성도 가능합니다.
description을 트리거 문장으로: 「사용자가 배포·프로덕션 반영·staging 게시를 언급할 때」처럼 씁니다. 「배포 관련 Skill」은 약합니다.
Gather → Act → Verify: 환경 수집, 스크립트 실행, 프로브·로그 검증 순을 명시합니다.
실작업 회귀: 표현을 바꿔 오작동 여부를 봅니다. 필요 시 paths: apps/web/**로 좁힙니다.

.cursorrules나 slash command가 많은 팀은 내장 /migrate-to-skills로 일괄 이전해 이중 유지보수를 피하세요.

6. description과 모범 사례

핵심 500줄 이내, 상세는 references/. 단계에 이유를 쓰고 용어·실패 롤백을 명시합니다.

7. 2026 생태계: agentskills.io와 인기 Skill

agentskills.io가 오픈 표준을 유지하고, Cursor Marketplace에서는 Rules+Skills+MCP를 원클릭 설치할 수 있습니다. addyosmani/agent-skills(품질 게이트), Vercel 프론트 감사 팩, 당사 《OpenClaw 채널 무응답 런북》 같은 운영 Skill도 참고할 만합니다.

8. 실전: PR 배포와 원격 Mac 연결

원클릭 PR Skill: git status → 브랜치 → push → gh pr create, Git 안전 Rule 병행.OpenClaw/Hermes 게이트웨이는 SFTPMAC 원격 macOS 7×24 노드 권장(《Hermes 설치》).

운영면	로컬 Mac 노트북	원격 macOS(SFTPMAC)
7×24 게이트웨이	절전·덮개로 중단 쉬움	launchd 상시, SLA 협의 가능
Skill 동기화	로컬 .cursor만	Git + SFTP/rsync로 팀 Skill 통일
로컬 추론	메모리·발열 제약	M4/M5 대메모리 SKU로 시험 후 구매 판단
월 비용(대략)	0원이나 기회비용 큼	월 수십~수백만 원대, 잦은 교체보다 낫기도

9. 자주 묻는 질문

Skill과 MCP? MCP는 도구 연결, Skill은 절차 정의. 범용 Skill은 ~/.cursor/skills/, 프로젝트 전용은 .cursor/skills/입니다.

정리: 절차는 Skill에, 게이트웨이는 안정된 Mac에

Skill은 SKILL.md로 Prompt 반복을 줄입니다. 상시 온라인 Agent는 노트북 절전이 병목입니다.

SFTPMAC 원격 Mac으로 Git/SFTP·7×24 게이트웨이를 구현하세요. 오늘 /create-skill부터 시작하세요.