Skills

Skills는 지시문, 스크립트, 템플릿을 하나의 휴대 가능한 패키지로 묶어 Kiro가 필요한 순간에만 불러오도록 하는 표준 기반 확장 메커니즘입니다.

Skills란 무엇인가

Skills는 오픈 표준인 Agent Skills(agentskills.io) 사양을 따르는 재사용 가능한 지시문 패키지입니다. 하나의 폴더 안에 에이전트가 따라야 할 절차, 보조 스크립트, 참고 문서, 템플릿을 함께 담을 수 있어서 같은 작업 흐름을 여러 프로젝트나 팀원과 손쉽게 공유할 수 있습니다. Kiro는 이 표준을 지원하기 때문에 커뮤니티에서 공개한 Skill이나 다른 호환 AI 도구에서 만들어진 Skill을 그대로 가져올 수 있고, 반대로 직접 작성한 Skill도 외부 생태계로 내보낼 수 있습니다.

동작 방식: Progressive Disclosure

모든 컨텍스트를 한꺼번에 주입하면 에이전트의 응답 품질이 떨어집니다. Skills는 이 문제를 해결하기 위해 단계적으로 정보를 노출하는 방식을 사용합니다.

  1. Discovery — Kiro가 시작될 때 각 Skill의 name과 description만 메모리에 적재합니다.
  2. Activation — 사용자의 요청이 특정 Skill의 설명과 매칭되면 그때 비로소 본문 지시문을 전부 불러옵니다.
  3. Execution — 실행 중에 필요해지는 스크립트나 reference 파일은 그 시점에만 로드합니다.

Skill 사용하기

요청 내용이 Skill의 설명과 일치하면 Kiro가 자동으로 활성화합니다. 직접 호출하고 싶다면 채팅 입력창에 /를 입력해 슬래시 커맨드 목록에서 선택할 수 있습니다. 설치된 Skill의 관리·편집·삭제는 Kiro 패널의 Agent Steering & Skills 영역에서 수행합니다.

적용 범위

Workspace skills

Global skills

이름 충돌 시 Workspace skill이 Global skill보다 우선 적용됩니다. 같은 이름의 Skill을 프로젝트별로 덮어쓸 수 있어 환경에 맞춘 커스터마이즈가 가능합니다.

Skill 가져오기

  1. Kiro 패널에서 Agent Steering & Skills를 엽니다.
  2. + 버튼을 클릭하고 Import a skill을 선택합니다.
  3. 가져올 출처를 고릅니다.
    • GitHub — Skill 폴더나 SKILL.md 파일을 가리키는 공개 저장소 URL. 저장소 루트가 아니라 하위 디렉터리여야 합니다.
    • Local folder — 로컬 파일 시스템의 디렉터리.

가져온 Skill은 본인의 skills 디렉터리로 복사되어 보관됩니다.

Skill 만들기

Skill은 SKILL.md 파일을 포함한 폴더 하나로 구성됩니다. 보조 자료는 정해진 하위 디렉터리에 두는 것이 권장됩니다.

my-skill/
├── SKILL.md           # 필수
├── scripts/           # 실행 가능한 코드 (선택)
├── references/        # 상세 문서 (선택)
└── assets/            # 템플릿 (선택)

SKILL.md 형식

---
name: pr-review
description: Review pull requests for code quality, security issues, and test coverage. Use when reviewing PRs or preparing code for review.
---

## Review process

1. Check for security vulnerabilities
2. Verify error handling
3. Confirm test coverage
4. Review naming and structure

Frontmatter 필드

필드필수설명
name예폴더명과 일치해야 합니다. 소문자, 숫자, 하이픈만 허용되며 최대 64자.
description예이 Skill을 언제 써야 하는지 설명. 사용자 요청과 매칭에 활용되며 최대 1024자.
license아니오라이선스 이름 또는 동봉된 라이선스 파일 참조.
compatibility아니오필요한 도구나 네트워크 접근 같은 환경 요구 사항.
metadata아니오작성자, 버전 등의 추가 key-value 데이터.

전체 사양은 agentskills.io/specification에서 확인할 수 있습니다.

Skills, Steering, Powers의 차이

MCP 통합이 목적이라면 일반적으로 Powers가 더 적합합니다. 도구와 사용 가이드가 함께 묶여 있고 컨텍스트에 따라 자동으로 활성화되기 때문입니다.

모범 사례

GitHub에서 Skill을 가져올 때 저장소의 루트 URL은 사용할 수 없습니다. 반드시 Skill 폴더나 SKILL.md를 가리키는 하위 경로 URL을 지정해야 합니다.

관련 문서