콘텐츠로 이동

Agent Skills

Skills이란?

Skills는 오픈 Agent Skills 표준을 따르는 이식 가능한 명령 패키지입니다. 명령, 스크립트 및 템플릿을 Kiro가 작업과 관련이 있을 때 활성화할 수 있는 재사용 가능한 패키지로 번들링합니다.

Kiro는 Agent Skills 표준을 지원하므로 커뮤니티나 다른 호환 가능한 AI 도구에서 스킬을 가져오고, 생태계 전체에서 자신의 스킬을 공유할 수 있습니다.

Skills 작동 방식

AI 에이전트는 점점 더 능력이 향상되고 있지만, 종종 실제 작업에 필요한 특정 컨텍스트가 부족합니다. 팀의 배포 프로세스, 회사의 코드 리뷰 표준 또는 프로젝트의 데이터 분석 파이프라인에 대한 지식이 없으면 에이전트는 새로운 것을 배울 때와 마찬가지로 추측하고 반복합니다.

모든 컨텍스트를 미리 로드하는 것도 실용적이지 않습니다. 너무 많은 정보는 에이전트를 압도하여 응답을 느리게 하고 품질을 저하시킵니다.

Skills는 점진적 공개로 이를 해결합니다:

  1. 발견 - 시작 시 Kiro는 각 스킬의 이름과 설명만 로드합니다
  2. 활성화 - 요청이 스킬의 설명과 일치하면 Kiro가 전체 명령을 로드합니다
  3. 실행 - Kiro는 명령을 따르며 필요에 따라 스크립트나 참조 파일만 로드합니다

이를 통해 컨텍스트를 집중적으로 유지하면서 Kiro가 필요에 따라 광범위한 전문 지식에 접근할 수 있습니다.

Skills 사용

Kiro는 요청이 스킬의 설명과 일치할 때 자동으로 스킬을 활성화합니다. Kiro 패널의 Agent Steering & Skills 섹션에서 스킬을 보고 관리합니다.

Skill 범위

Skills는 워크스페이스 범위 또는 전역 범위로 생성할 수 있습니다.

워크스페이스 skills

워크스페이스 스킬은 .kiro/skills/ 아래 프로젝트에 있으며 해당 특정 워크스페이스에만 적용됩니다. 배포 절차나 팀 규칙과 같은 프로젝트별 워크플로우에 워크스페이스 스킬을 사용합니다.

전역 skills

전역 스킬은 ~/.kiro/skills/ 아래 홈 디렉토리에 있으며 모든 워크스페이스에서 사용할 수 있습니다. 코드 리뷰 프로세스나 문서화 표준과 같이 프로젝트에 관계없이 사용하는 개인 워크플로우에 전역 스킬을 사용합니다.

전역 스킬과 워크스페이스 스킬 간에 이름이 충돌하는 경우 Kiro는 워크스페이스 스킬을 우선시합니다. 이를 통해 일반적으로 모든 워크스페이스에 적용되는 전역 스킬을 정의하면서 특정 프로젝트에 대해 재정의할 수 있는 기능을 유지할 수 있습니다.

Skills 가져오기

  1. Kiro 패널에서 Agent Steering & Skills 섹션을 엽니다
  2. +를 클릭하고 Import a skill을 선택합니다
  3. 소스를 선택합니다:
    • GitHub - 공개 저장소 URL에서 가져오기
    • Local folder - 파일 시스템에서 가져오기

가져온 스킬은 스킬 디렉토리에 복사되며 즉시 작동합니다.

Skill 생성

스킬은 SKILL.md 파일을 포함하는 폴더입니다:

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

SKILL.md 형식

markdown

--- 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

프론트매터 필드

필드 필수 설명
name 예 폴더 이름과 일치해야 합니다. 소문자, 숫자, 하이픈만 (최대 64자).
description 예 이 스킬을 사용할 시기. Kiro는 이를 요청과 매칭합니다 (최대 1024자).
license 아니오 라이선스 이름 또는 번들된 라이선스 파일에 대한 참조.
compatibility 아니오 환경 요구사항 (예: 필요한 도구, 네트워크 액세스).
metadata 아니오 작성자나 버전과 같은 추가 키-값 데이터.

자세한 필드 제약 조건은 전체 사양을 참조하세요.

Skills와 steering 및 powers의 차이점

Skills는 오픈 표준을 따르는 이식 가능한 패키지입니다. 필요에 따라 로드되며 스크립트를 포함할 수 있습니다. 공유하거나 다른 사람에게서 가져오려는 재사용 가능한 워크플로우에 사용합니다.

Steering은 에이전트 동작을 형성하는 Kiro 전용 컨텍스트입니다. always, auto, fileMatch, manual 모드를 지원합니다. 프로젝트 표준 및 규칙에 사용합니다.

Powers는 MCP 도구를 지식 및 워크플로우와 번들링합니다. 컨텍스트를 기반으로 동적으로 활성화됩니다. 도구와 가이드가 모두 필요한 통합에 사용합니다.

팁

MCP 통합의 경우 powers가 일반적으로 더 적합합니다. 내장된 가이드와 함께 도구를 번들링하고 작업 중인 내용을 기반으로 자동으로 활성화됩니다.

모범 사례

정확한 설명 작성 - Kiro는 설명을 사용하여 활성화 시기를 결정합니다. 구체적인 키워드를 포함하세요: "Review pull requests for security and test coverage"가 "helps with code review"보다 낫습니다.

SKILL.md를 집중적으로 유지 - 상세한 문서는 references/ 파일에 넣으세요. Kiro는 활성화 시 전체 SKILL.md를 로드합니다.

결정론적 작업에는 스크립트 사용 - 검증, 파일 생성 및 API 호출은 LLM이 생성한 코드보다 스크립트로 더 잘 작동합니다.

올바른 범위 선택 - 개인 워크플로우(검토 체크리스트)에는 전역, 팀 절차(프로젝트 배포)에는 워크스페이스를 사용합니다.