도구는 가능성, Skill 은 일관성 | CLI·MCP

Overview

CLI 연결·MCP 연결·Custom MCP 세 레슨에서 Claude 에게 외부 시스템 접근을 세 가지 방식으로 열었습니다. gh CLI, Claude in Chrome, 직접 만든 날씨 MCP 입니다. Claude 는 이제 이슈를 조회하고, 내 Chrome 세션을 관찰하고, 사내 API 를 호출할 수 있습니다.

그런데 같은 작업을 시킬 때마다 결과가 다릅니다. "이 PR 리뷰해줘", "이 페이지 어디가 이상해" 라고만 시키면 어떤 날은 깊고, 어떤 날은 대충, 포맷도 들쭉날쭉합니다. 접근할 수 있는 것과 매번 같은 방식으로 쓰는 것은 다른 문제 입니다.

이번 레슨에서는 외부 도구(CLI · MCP)에 Skill 을 결합해 반복 워크플로우를 일관되게 만드는 원리와 두 가지 사례를 배웁니다.

학습 목표

• 도구 (Capability) 와 Skill (Procedure) 의 역할 차이를 구분합니다
• 외부 도구 + Skill 결합이 어떻게 일관성을 만드는지 이해합니다
• CLI+Skill, MCP+Skill 각각의 실전 구성을 설계할 수 있습니다

도구와 Skill 의 역할 나누기

망가진 캐비닛을 고치러 철물점에 갔다고 해봅니다. 작업대 위에는 접착제·클램프·경첩·전동 드릴이 전부 준비돼 있습니다. 도구가 어디서 왔는지는 중요하지 않습니다. 매대에서 새로 사 온 것이든, 집에서 가져온 것이든 작업대 위에 올라오는 순간 그냥 도구 입니다.

그런데 도구가 아무리 많아도, 어떤 순서로 써야 하는지 모르면 캐비닛은 고쳐지지 않습니다. 옆에 있는 숙련된 직원이 순서를 안내해야 비로소 작업이 시작됩니다.

이것이 이 레슨의 핵심 구분입니다.

• 도구 (Capability Layer): CLI 와 MCP. "Claude 가 무엇에 닿을 수 있는가"를 결정합니다. gh CLI 가 있으면 GitHub 에 닿고, Claude in Chrome 이 있으면 내 실제 Chrome 세션에 닿습니다.
• 절차 (Procedure Layer): Skill. "그 도구를 어떤 순서로 · 어떤 기준으로 · 어떤 형식으로 쓸지"를 정의합니다.

도구 없이는 일을 시작할 수 없고, 절차 없이는 매번 결과가 달라집니다.

CLI + Skill 로 코드 리뷰 일관되게 만들기

gh CLI 로 PR diff 를 가져오려면 명령 한 줄이면 됩니다. 그런데 "이 PR 리뷰해줘" 라고만 하면 매번 리뷰 범위 · 형식 · 심각도 기준이 달라집니다. 여기에 code-review Skill 을 붙이면 달라집니다.

역할 분담

• gh CLI (Capability): PR diff 조회, 파일 목록 확인, 리뷰 코멘트 등록
• code-review Skill (Procedure): 검사 항목(네이밍 · 에러 처리 · 테스트 커버리지), 리뷰 형식, 심각도 기준 정의

돌아가는 순서

1. 탐색 (Skill): 리뷰 대상 PR 을 확인하고 팀 검사 항목을 불러옵니다
2. 접근 (CLI): gh pr diff 로 변경 사항을 가져옵니다
3. 조율 (Skill): 팀 컨벤션 기준으로 코드를 분석하고 피드백을 구조화합니다
4. 실행 (CLI): gh pr review 로 구조화된 리뷰 코멘트를 등록합니다

Skill 없이 CLI 만 있으면 diff 는 볼 수 있지만 리뷰 기준이 매번 달라집니다. CLI 없이 Skill 만 있으면 기준은 완벽해도 PR 데이터에 닿지 못합니다. CLI + Skill 결합 이 있어야 "같은 기준으로 매번 같은 형식의 리뷰" 가 나옵니다.

MCP + Skill 로 버그 리포트 형식 통일하기

두 번째 사례는 MCP 를 씁니다. Claude in Chrome 으로 내 Chrome 세션을 볼 수 있지만, "이 페이지 이상해" 라고만 하면 Claude 는 감으로 몇 가지를 확인할 뿐입니다. ui-bug-report Skill 을 붙이면 매번 같은 형식의 리포트가 나옵니다.

역할 분담

• Claude in Chrome (Capability): 현재 탭의 콘솔 · 네트워크 · DOM · 스크린샷 수집
• ui-bug-report Skill (Procedure): 심각도 분류 기준, 리포트 템플릿, 재현 스텝 형식 정의

돌아가는 순서

1. 접근 (MCP): 현재 탭에서 read_console · 네트워크 요청 로그로 에러 · 실패 요청을 수집합니다
2. 조율 (Skill): critical / major / minor 기준으로 분류합니다
3. 조율 (Skill): 재현 스텝 · 환경 정보 · 영향 범위를 팀 버그 리포트 템플릿에 채웁니다
4. 접근 (MCP): screenshot 으로 현재 탭을 찍어 리포트에 첨부합니다

패턴이 같습니다. CLI 든 MCP 든 도구가 접근을 제공하고 Skill 이 절차를 정의합니다. 도구를 바꿔도 Skill 이 유지되고, Skill 을 개선해도 도구 연결은 그대로입니다.

[실습] ui-bug-report 로 버그 리포트 만들기

위에서 설명한 MCP + Skill 결합을 직접 만들어 봅니다. 같은 페이지에서 두 번 돌려 "매번 같은 형식" 이 실제로 나오는지 확인합니다.

Step 1: ui-bug-report Skill 작성

프로젝트 루트에 .claude/skills/ui-bug-report/SKILL.md 파일을 생성하고 아래 내용을 넣습니다.

---
name: ui-bug-report
description: 열린 Chrome 탭의 콘솔 · 네트워크 · DOM 상태를 수집해 팀 버그 리포트 템플릿으로 정리한다. "버그 리포트 만들어줘", "이 페이지 이상한 것 좀 정리해줘" 같은 요청에 호출.
---

# UI Bug Report Skill

열려 있는 Chrome 탭을 조사해 아래 템플릿에 맞춰 버그 리포트를 작성한다.

## 심각도 분류

- **critical** — 페이지 동작 불가, 5xx 에러
- **major** — 일부 기능 실패, 4xx 에러, 주요 UI 깨짐
- **minor** — 콘솔 경고, 사소한 이슈

## 리포트 템플릿

- **URL**: 대상 페이지
- **심각도**: critical | major | minor
- **증상**: 한 줄 요약
- **콘솔 에러**: 원문
- **네트워크 실패**: URL · 상태 코드
- **재현 스텝**: 1) ... 2) ...
- **환경**: 브라우저 / OS / 뷰포트
- **스크린샷**: 첨부

Step 2: 페이지 열고 Skill 호출

Chapter 04 의 Todo 앱을 실행하고 Chrome 으로 엽니다. Claude in Chrome 이 활성화된 상태에서 Claude Code 를 켜고 요청합니다.

Todo 앱 탭에 대해 버그 리포트 만들어줘

Claude 는 ui-bug-report 의 description 을 보고 Skill 을 자동으로 불러와, Claude in Chrome 의 Tool 을 호출하고 정의된 템플릿 그대로 리포트를 출력합니다.

핵심 포인트 정리

1. 도구는 가능성, Skill 은 일관성: CLI · MCP 는 Claude 가 닿을 수 있는 범위를 넓히고, Skill 은 그 도구를 매번 같은 방식으로 씁니다. 하나만 있으면 절반만 해결됩니다.
2. CLI 든 MCP 든 패턴은 동일: 도구로 접근하고 Skill 로 절차를 정의합니다. 코드 리뷰든 버그 리포트든, 실전 워크플로우는 전부 이 결합으로 설계됩니다.
3. 관심사 분리가 유연성을 만든다: 도구를 바꿔도 Skill 이 유지되고, Skill 을 개선해도 도구 연결은 그대로입니다. 예를 들어 리뷰 Skill 의 CLI 부분만 MCP 로 바꾸어도 Skill 의 리뷰 기준은 그대로 작동합니다.

FAQ

• Q: MCP 서버에도 사용 지침이 포함돼 있다고 들었습니다. 그럼 Skill 이 필요 없지 않나요?

  • A: MCP 서버가 제공하는 설명은 "이 Tool 을 어떻게 호출하는가" 에 한정됩니다 (예: "이 쿼리 문법을 써라"). Skill 이 담는 건 "이 도구를 업무 흐름에서 언제 · 어떤 순서로 · 어떤 형식으로 쓸까" 입니다. 범위가 다릅니다. MCP 지침은 Tool 수준, Skill 은 워크플로우 수준입니다.

• Q: 하나의 Skill 이 여러 외부 도구를 쓸 수 있나요?

  • A: 가능합니다. 리서치 Skill 이 gh CLI 로 PR 을 가져오고, Linear MCP 로 관련 이슈를 검색하고, Claude in Chrome 으로 운영 대시보드를 확인하는 식입니다. 반대로 같은 외부 도구를 여러 Skill 이 공유할 수도 있습니다.

• Q: 외부 도구만 연결한 상태에서도 잘 되는 것 같은데요?

  • A: 단발성 작업엔 충분합니다. Skill 이 필요한 순간은 반복 워크플로우 에서 매번 같은 결과를 내야 할 때입니다. 혼자 쓰는 한두 번짜리 작업엔 과할 수 있지만, 팀이 공유하거나 주기적으로 돌리는 워크플로우에서는 Skill 이 결정적입니다.

이어서 배울 내용

이번 Chapter 에서 Claude 의 접근 범위를 외부로 넓히는 세 가지 경로(CLI · MCP · Custom MCP)와 Skill 결합으로 일관된 워크플로우를 만드는 법을 배웠습니다. 다만 Claude 가 언제 · 어떤 조건에서 · 무엇을 멈춰야 하는지는 아직 통제 아래에 있지 않습니다. 다음 Chapter 에서는 실행 흐름 자체를 제어하고 대화 컨텍스트를 분리하는 두 가지 장치를 배웁니다.

• 특정 시점에 자동으로 실행되는 검증·포맷팅 규칙 걸기 (Hooks)
• 메인 대화와 분리된 컨텍스트로 작업을 위임하기 (Custom Agent)