KIRO의 Powers와 Claude의 Agent Skills 비교하기

에이전트가 단순히 답변을 생성하는 도구를 넘어, 실제 파일을 다루고, 외부 서비스를 호출하고, 배포와 문서 작업까지 수행하는 방향으로 발전하고 있습니다. 이 흐름에서 다시 보게 되는 질문이 있습니다.

에이전트에게 우리 팀의 일하는 방식을 어떻게 가르칠 수 있을까요?

AWS Kiro의 Powers와 Claude의 Agent Skills는 이 질문에 대한 서로 다른 접근입니다. 둘 다 파일과 폴더를 사용해 에이전트의 능력을 패키징하지만, 초점은 다릅니다.

Kiro Powers는 IDE 안에서 필요한 도구와 MCP 서버를 필요한 순간에 연결하는 쪽에 가깝습니다. Claude Agent Skills는 특정 업무 절차와 도메인 지식을 재사용 가능한 폴더 포맷으로 정리하는 데 초점을 둡니다.

이 글에서는 다음 내용을 정리합니다.

• Kiro Powers가 해결하려는 문제
• Claude Agent Skills의 구조와 동작 방식
• POWER.md와 SKILL.md의 역할 차이
• 두 방식의 공통점과 차이점
• 업무에서 어떤 기준으로 적용해 볼 수 있는지

1. Kiro Powers란 무엇인가

Kiro Powers는 에이전트가 특정 기술이나 도메인에 필요한 지식, 도구, 워크플로를 필요할 때 불러올 수 있도록 만든 패키지입니다.

핵심은 “언제 어떤 도구와 지침을 컨텍스트에 올릴 것인가”를 Power 단위로 관리한다는 점입니다.

에이전트 개발 환경에서는 여러 MCP 서버를 한꺼번에 연결해 두는 경우가 많습니다. 이 방식은 처음에는 편해 보이지만, MCP 서버가 늘어날수록 모델이 읽어야 하는 툴 설명도 함께 늘어납니다. 결과적으로 컨텍스트 사용량이 커지고, 응답 속도와 품질에도 영향을 줄 수 있습니다.

Kiro Powers는 이 문제를 온디맨드 방식으로 다룹니다. 사용자의 작업 설명이나 대화 내용이 특정 Power와 관련 있다고 판단되면, 그때 해당 Power의 지침과 도구를 컨텍스트에 올립니다.

예를 들어 사용자가 “이 프로젝트를 AgentCore Runtime에 배포하고 싶습니다”라고 말하면, Kiro는 AgentCore와 관련된 Power를 활성화할 수 있습니다. 이때 AgentCore 관련 설명, 배포 흐름, MCP 서버 설정이 함께 로드됩니다.

2. POWER.md의 역할

하나의 Power는 보통 다음 요소로 구성됩니다.

my-power/
├── POWER.md
├── mcp.json
└── steering 또는 hooks

각 요소의 역할은 다음과 같습니다.

POWER.md는 보통 YAML frontmatter와 Markdown 본문으로 구성됩니다. frontmatter에는 Power의 이름, 설명, 키워드, 작성자, 연결할 도구 같은 메타데이터가 들어갑니다. Markdown 본문에는 사용 시점, 단계별 절차, 주의할 점, 예시 요청 등이 들어갑니다.

간단히 표현하면 POWER.md는 에이전트를 위한 도구 사용 설명서입니다. 사람이 읽을 수 있는 문서이면서, 동시에 Kiro가 언제 이 Power를 활성화할지 판단하는 데 필요한 신호를 제공합니다.

예를 들어 AWS AgentCore Power라면 다음과 같은 내용을 담을 수 있습니다.

---
name: "aws-agentcore"
displayName: "Build an agent with Amazon Bedrock AgentCore"
description: "Build, test, and deploy AI agents using AWS Bedrock AgentCore with local development workflow."
keywords: ["agentcore", "bedrock", "aws", "agents", "development"]
author: "AWS"
---

본문에는 이런 내용이 들어갑니다.

• AgentCore 기반 에이전트를 로컬에서 개발하는 방법
• AgentCore Runtime으로 테스트하고 배포하는 절차
• 필요한 CLI와 환경 설정
• MCP 도구를 언제 사용해야 하는지
• 배포 전후에 확인해야 할 체크리스트

이 구조 덕분에 Kiro는 처음부터 모든 MCP 도구를 컨텍스트에 올리지 않아도 됩니다. 작업이 AgentCore와 관련 있다고 판단되는 순간에만 해당 Power를 활성화합니다.

3. Powers의 사용 경험

Powers는 Kiro IDE와 밀접하게 연결되어 있습니다. 사용자는 Kiro의 Powers 카탈로그나 GitHub 저장소에서 필요한 Power를 설치할 수 있습니다.

사용 흐름은 대략 다음과 같습니다.

1. 개발자가 필요한 Power를 설치합니다.
2. 대화 중 특정 기술, 서비스, 작업 흐름과 관련된 요청을 입력합니다.
3. Kiro가 설치된 Powers 중 관련성이 높은 Power를 평가합니다.
4. 선택된 Power의 지침과 도구가 컨텍스트에 로드됩니다.
5. 에이전트는 해당 Power에 정의된 절차와 MCP 도구를 활용해 작업을 수행합니다.

예를 들어 Stripe Power가 설치되어 있다면, 사용자가 결제나 checkout 관련 작업을 언급했을 때 Stripe 관련 MCP 도구와 지침이 활성화될 수 있습니다. 이후 데이터베이스 작업으로 넘어가면 Supabase나 Neon 같은 다른 Power가 활성화되는 식입니다.

정리하면 Kiro Powers는 특정 기술이나 서비스에 필요한 도구와 지침을 IDE 안에서 필요할 때 장착하는 번들 포맷입니다.

4. Claude Agent Skills란 무엇인가

Claude Agent Skills는 에이전트가 특정 업무를 더 일관되게 수행할 수 있도록 절차, 스크립트, 참고자료, 템플릿을 하나의 폴더로 묶는 방식입니다.

가장 단순한 Skill은 SKILL.md 파일 하나로 시작합니다.

my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/

각 요소의 역할은 다음과 같습니다.

Agent Skills의 중요한 설계 원칙은 progressive disclosure입니다. 처음부터 모든 내용을 모델 컨텍스트에 올리지 않고, 필요한 수준만 단계적으로 읽게 하는 방식입니다.

동작 흐름은 다음과 같습니다.

1. 시작 시점에는 각 Skill의 name과 description만 로드합니다.
2. 사용자의 요청이 특정 Skill과 맞다고 판단되면 SKILL.md 본문을 읽습니다.
3. 필요한 경우 references/, scripts/, assets/ 안의 파일을 추가로 사용합니다.

이 방식은 많은 Skill을 설치해도 초기 컨텍스트 사용량을 낮게 유지할 수 있게 해 줍니다. 동시에 특정 작업이 시작되면 그 작업에 필요한 절차와 자료를 충분히 불러올 수 있습니다.

5. SKILL.md의 구조

SKILL.md도 YAML frontmatter와 Markdown 본문으로 구성됩니다. 최소한 name과 description이 필요하고, 필요에 따라 라이선스, 작성자, 버전, 호환성 정보 등을 추가할 수 있습니다.

예를 들어 PDF 처리 Skill은 다음과 비슷한 구조를 가질 수 있습니다.

---
name: pdf-processing
description: "PDF에서 텍스트와 테이블을 추출하고, 폼을 채우고, 여러 PDF를 병합하는 작업에 사용합니다."
license: Apache-2.0
metadata:
  author: anthropic
  version: "1.0"
---

# PDF Processing Skill

## 언제 사용할까

- 사용자가 PDF 파일을 업로드하고 내용을 요약해 달라고 할 때
- 특정 테이블이나 양식 데이터를 추출해 달라고 할 때
- 여러 PDF를 하나로 병합하거나 분할해야 할 때

## 이 스킬이 하는 일

1. 텍스트 기반 PDF에서 텍스트와 테이블을 추출합니다.
2. 스캔 PDF의 경우 OCR을 사용해 텍스트를 추출합니다.
3. PDF 양식 필드를 확인하고 필요한 값을 채웁니다.
4. 여러 PDF를 병합하거나 분할합니다.

Claude는 먼저 description을 보고 이 Skill이 현재 요청과 관련 있는지 판단합니다. 관련성이 높다고 판단하면 SKILL.md 본문을 읽고, 필요에 따라 추가 파일이나 스크립트를 사용합니다.

여기서 중요한 점은 Skill이 단순 프롬프트 묶음에 머물지 않는다는 것입니다. 절차 문서, 참고자료, 실행 코드, 템플릿까지 함께 담을 수 있기 때문에 실제 업무 단위로 에이전트의 행동을 정리할 수 있습니다.

6. 디렉토리 구조 비교

두 구조를 나란히 놓고 보면 차이가 더 분명해집니다.

Kiro Power 예시

aws-agentcore/
├── POWER.md
├── mcp.json
└── steering 또는 hooks

Kiro Power에는 보통 특정 기술이나 서비스와 연결된 도구 설정이 포함됩니다.

예를 들어 aws-agentcore Power라면 다음 내용을 포함할 수 있습니다.

• AgentCore 개념과 사용 시점
• AgentCore 프로젝트 생성 절차
• 로컬 Runtime 테스트 방법
• 배포 흐름
• agentcore-mcp-server 같은 MCP 서버 연결 정보
• IDE 안에서 실행할 수 있는 세부 워크플로

이 구조는 특정 플랫폼이나 도구를 IDE 안에서 바로 사용할 수 있게 만드는 데 적합합니다.

Agent Skill 예시

pdf/
├── SKILL.md
├── reference.md
├── forms.md
└── scripts/

Agent Skill은 특정 업무 절차를 중심으로 구성됩니다. PDF Skill을 예로 들면 다음 내용을 담을 수 있습니다.

• PDF에서 텍스트와 테이블을 추출하는 절차
• PDF 양식을 채우는 방법
• 여러 PDF를 병합하거나 분할하는 방법
• 복잡한 PDF 작업을 위한 참고 문서
• 반복 실행할 수 있는 Python 스크립트

이 구조는 특정 벤더 인프라보다 업무 도메인에 초점을 둡니다. “PDF 처리”, “브랜드 가이드에 맞춘 발표자료 작성”, “PR 리뷰”, “데이터 분석 보고서 작성”처럼 반복되는 업무를 폴더 단위로 정리하기 좋습니다.

7. 공통점

Kiro Powers와 Claude Agent Skills는 겉으로는 다르게 보이지만, 공통으로 향하는 방향이 있습니다.

첫째, 둘 다 필요한 순간에만 컨텍스트를 확장합니다.

Kiro Powers는 작업 설명이나 키워드를 보고 관련 Power를 로드합니다. Agent Skills는 시작 시점에 name과 description만 읽고, 필요할 때 전체 SKILL.md와 추가 파일을 읽습니다.

둘 다 “모든 지식을 시스템 프롬프트에 미리 넣어두는 방식”의 한계를 피하려고 합니다.

둘째, 사람이 읽는 문서와 기계가 읽는 메타데이터를 함께 사용합니다.

YAML frontmatter는 에이전트가 파싱하기 쉬운 메타데이터입니다. Markdown 본문은 개발자나 팀원이 읽을 수 있는 운영 문서입니다.

셋째, Git으로 관리할 수 있습니다.

Power와 Skill은 폴더와 파일로 구성되기 때문에 코드처럼 버전 관리할 수 있습니다. 변경 이력을 남길 수 있고, 리뷰할 수 있으며, 팀 단위로 공유할 수 있습니다.

이 관점에서 보면 Powers와 Skills는 단순한 프롬프트 확장 기법이 아닙니다. 에이전트가 사용할 수 있는 지식과 절차를 소프트웨어 자산처럼 관리하려는 시도에 가깝습니다.

8. 차이점

공통점이 많지만 두 방식의 중심축은 다릅니다.

Kiro Powers는 에이전트가 “어떤 도구를 사용할 수 있는가”를 IDE 환경 안에서 잘 다룹니다. MCP 서버와의 연결이 중심에 있고, 설치와 활성화 경험도 Kiro IDE에 맞춰 설계되어 있습니다.

Agent Skills는 에이전트가 “어떤 방식으로 일해야 하는가”를 파일과 폴더로 표현합니다. 특정 업무의 절차, 참고자료, 코드, 템플릿을 하나의 Skill로 묶어 여러 환경에서 재사용할 수 있게 만드는 쪽에 가깝습니다.

9. MCP와 scripts의 차이

도구 연결 방식에서도 차이가 있습니다.

Kiro Powers는 MCP를 중심에 둡니다. Power 정의 안에 어떤 MCP 서버를 사용할지, 해당 서버를 어떻게 실행할지, 어떤 환경 변수가 필요한지 같은 정보가 들어갑니다. 따라서 외부 API, SaaS, 클라우드 서비스, 개발 도구를 IDE 안에서 바로 연결하는 데 잘 맞습니다.

Agent Skills는 MCP를 필수 전제로 삼지 않습니다. 대신 Skill 폴더 안에 스크립트, 참고 문서, 템플릿을 둘 수 있습니다. 실제로 스크립트를 어떻게 실행할지는 해당 Skill을 사용하는 호스트 환경의 책임입니다.

이 차이는 업무 설계에서 중요합니다.

외부 시스템과 연결해야 한다면 Power 방식이 자연스럽습니다. 예를 들어 결제, 모니터링, 데이터베이스, 클라우드 배포처럼 API 호출과 도구 실행이 많은 작업입니다.

반복되는 업무 절차를 가르치고 싶다면 Skill 방식이 자연스럽습니다. 예를 들어 “우리 팀의 PR 리뷰 기준”, “장애 리포트 작성 방식”, “고객사 제안서 검토 절차”, “PDF 보고서 요약 방식” 같은 작업입니다.

10. 업무에서는 어떻게 조합할 수 있을까

제품은 다르지만, 설계 관점에서는 두 방식을 함께 참고할 수 있습니다.

핵심은 도구 연결 계층과 업무 절차 계층을 분리해서 보는 것입니다.

예를 들어 다음과 같이 나눌 수 있습니다.

이렇게 보면 Powers와 Skills는 경쟁 관계로만 볼 필요가 없습니다. 하나는 에이전트가 사용할 도구를 관리하고, 다른 하나는 에이전트가 따라야 할 업무 방식을 관리합니다.

실제 업무에서 더 중요한 질문은 “어느 제품이 더 좋은가”보다 “우리 팀의 반복 업무를 어떤 단위로 패키징할 것인가”에 가깝습니다.

11. 적용할 때 주의할 점

Powers와 Skills를 도입할 때는 몇 가지를 먼저 점검하는 것이 좋습니다.

11.1 트리거 문구가 정확해야 합니다

Power의 keywords, Skill의 description은 에이전트가 해당 패키지를 사용할지 판단하는 첫 번째 단서입니다.

설명이 너무 넓으면 불필요한 상황에서도 활성화될 수 있습니다. 반대로 너무 좁으면 필요한 순간에 로드되지 않을 수 있습니다.

좋은 설명은 다음 조건을 만족해야 합니다.

• 어떤 작업에 사용하는지 분명합니다.
• 사용하지 말아야 할 상황도 어느 정도 드러납니다.
• 팀원이 읽어도 같은 의미로 이해할 수 있습니다.
• 실제 요청 문장과 잘 매칭됩니다.

11.2 하나의 Power나 Skill에 너무 많은 일을 넣지 않습니다

너무 큰 Power나 Skill은 다시 거대한 시스템 프롬프트와 비슷해질 수 있습니다. 처음에는 작은 단위로 시작하는 편이 좋습니다.

예를 들어 “우리 팀의 모든 개발 규칙”을 하나의 Skill로 만들기보다 다음처럼 나눌 수 있습니다.

• PR 리뷰 Skill
• 배포 체크리스트 Skill
• 장애 리포트 Skill
• API 설계 리뷰 Skill
• 고객사 제안서 검토 Skill

각 Skill이 실제로 자주 쓰이는지, 에이전트가 제대로 선택하는지 관찰하면서 확장하는 편이 안전합니다.

11.3 보안과 신뢰 경계를 확인해야 합니다

Power와 Skill은 에이전트에게 새로운 능력을 제공합니다. 그 안에는 외부 도구 연결, 실행 코드, 참고자료, 민감한 업무 절차가 들어갈 수 있습니다.

따라서 외부에서 가져온 Power나 Skill은 그대로 사용하기 전에 내용을 확인해야 합니다.

특히 다음 항목을 봐야 합니다.

• 외부 네트워크로 데이터를 보내는 코드가 있는지
• 민감한 파일이나 환경 변수에 접근하는지
• 의도하지 않은 명령 실행이 가능한지
• 팀 보안 정책과 충돌하는 지침이 있는지
• 오래된 라이브러리나 취약한 의존성이 있는지

에이전트에게 일을 맡길수록, 에이전트가 읽는 지침과 실행하는 코드도 리뷰 대상이 되어야 합니다.

11.4 평가 루프가 필요합니다

Power와 Skill은 한 번 작성하고 끝나는 문서가 아닙니다. 실제 작업에서 에이전트가 어떻게 사용하는지 관찰하고 계속 수정해야 합니다.

좋은 운영 방식은 다음과 같습니다.

1. 대표 작업 5~10개를 정합니다.
2. Power나 Skill 적용 전후의 결과를 비교합니다.
3. 실패한 요청을 모읍니다.
4. 실패 원인이 설명 부족인지, 트리거 문제인지, 도구 문제인지 분류합니다.
5. description, 절차, 예시, 스크립트를 수정합니다.
6. 같은 작업을 다시 실행해 개선 여부를 확인합니다.

이 루프가 없으면 Power와 Skill도 결국 또 하나의 방치된 문서가 될 수 있습니다.

12. 프롬프트 복사에서 스킬 폴더로

Kiro Powers와 Claude Agent Skills가 보여주는 방향은 분명합니다. 에이전트에게 긴 지시문을 매번 붙여 넣는 방식에서, 도메인별·업무별 지식 폴더를 만들고 필요할 때 불러오는 방식으로 이동하고 있습니다.

Kiro Powers는 IDE 안에서 필요한 도구와 MCP 서버를 동적으로 연결합니다. Claude Agent Skills는 업무 절차와 참고자료, 스크립트를 폴더 단위로 패키징합니다.

둘의 공통점은 에이전트의 능력을 일회성 프롬프트가 아니라 버전 관리 가능한 자산으로 다룬다는 점입니다.

팀에 적용해 보고 싶다면 거창하게 시작할 필요는 없습니다. 다음 두 가지부터 해볼 수 있습니다.

1. 우리 팀이 에이전트에게 자주 연결시키는 도구 목록을 정리합니다.
   예: AgentCore, GitHub, Datadog, DB, Figma, Slack, 사내 API
2. 우리 팀이 반복해서 설명하는 업무 절차 하나를 SKILL.md 형태로 정리합니다.
   예: PR 리뷰 기준, 배포 체크리스트, 장애 리포트 작성법, PDF 보고서 처리 방식

이렇게 시작하면 “에이전트에게 일을 맡긴다”는 말이 더 구체적으로 바뀝니다. 모델에게 매번 긴 지시문을 붙여 넣는 대신, 코드와 함께 관리되는 Power와 Skill을 하나씩 쌓아가는 방식으로 일하는 구조를 만들 수 있습니다.

결국 중요한 것은 도구 자체보다 패키징 단위입니다. 우리 팀의 지식, 절차, 판단 기준을 어떤 폴더에 넣고, 언제 불러오게 할 것인지가 에이전트 활용의 핵심 설계 문제가 되고 있습니다.

참고자료

[1] https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills

[2] https://kiro.dev/docs/powers/

[3] https://github.com/anthropics/skills

[4] https://github.com/kirodotdev/powers